docs: preserve daily tmdb history

memory/2026-08-30.md

@@ -1,3 +1,63 @@
+[PROJECT:Velix VUI1] 沉浸式视觉重构完成
+结论: 首页完成全屏 Hero、内容氛围色、4 级材质和 HDS 沉浸浮动导航；详情、来源 Sheet、播放器及手机/平板/深色回归均通过，Core 未修改。
+文件变更: ../Velix/entry/src/main/ets/{domain/home,pages,ui}, ../Velix/DOCS/PHASE8_UI.md, ../Velix/design-qa.md, memory/*
+教训: API 24 可用 HDS 导航沉浸材质，但通用 uiMaterial 需 API 26；平板模拟器需单独启动以避免与手机 HDC 端口冲突。
+标签: #vui1 #harmonyos #hds #immersive #responsive #emulator
+
+[PROJECT:Velix VUI1] 首页顶部控件固定
+结论: 来源胶囊、搜索和个人入口已与 Scroll 解耦，上滑时与底部导航一样固定浮在内容之上。
+文件变更: ../Velix/entry/src/main/ets/pages/HomePage.ets, memory/projects.md, memory/2026-08-30.md
+标签: #vui1 #fixed-overlay #home #emulator
+
+[PROJECT:Velix VUI1] Full-Bleed Immersive Home
+结论: 首页以 Hero 的 backdrop、transition 与 ambient browsing surface 连续构成；语义环境色控制内容面和悬浮材质，Pura 90 Pro Max 初始态及滚动回归通过。
+文件变更: ../Velix/entry/src/main/ets/{domain/home,pages,ui}, ../Velix/design-qa.md, memory/projects.md, memory/2026-08-30.md
+标签: #vui1 #full-bleed #ambient-palette #hds #emulator
+
+[PROJECT:Velix VUI1] 底栏图标实心化
+结论: HDS 底栏保留沉浸光感，Tab 前景保持实心，选中图标继续按当前影片环境色取色。
+文件变更: ../Velix/entry/src/main/ets/ui/components/FloatingNavigation.ets, ../Velix/design-qa.md, memory/projects.md, memory/2026-08-30.md
+标签: #vui1 #bottom-navigation #hds #emulator
+
+[PROJECT:Velix VUI1] Scene Continuity
+结论: 背景改为覆盖 Hero 与首个 Section 的单一长尾 Scene，Backdrop 与环境色在正文后方逐步衰减，轮播同步更新背景。
+文件变更: ../Velix/entry/src/main/ets/{pages,ui,domain/home}, ../Velix/design-qa.md, memory/projects.md, memory/2026-08-30.md
+标签: #vui1 #scene-continuity #ambient #emulator
+
+[PROJECT:Velix VUI1] Hero Motion Handoff
+结论: 原生 Swiper 保持拖拽/速度吸附；Hero visual 底部用纵向场景渐隐交接固定 Background，只有分页 settle 后才以 420ms 固定位置过渡背景 A→B。
+文件变更: ../Velix/entry/src/main/ets/pages/HomePage.ets, ../Velix/entry/src/main/ets/ui/components/HeroSection.ets
+教训: loop Swiper 的 animation-end 可能返回回收页索引，需优先使用 animation-start target，并在回弹时清理 pager 状态；背景切换不能放在逐帧拖动回调。
+标签: #swiper #motion-handoff #ambient
+
+[PROJECT:Velix VUI1] VUI3 位移渐衰
+结论: Hero visual 采用 160–220vp smoothstep 分段反向位移与 Alpha 交接，固定背景只在 Swiper settle 后固定位置换图；静止态保持原有 full-page scene。
+文件变更: ../Velix/entry/src/main/ets/pages/HomePage.ets, ../Velix/entry/src/main/ets/ui/components/HeroSection.ets, ../Velix/entry/src/main/ets/ui/components/RemoteImage.ets
+教训: 静止态由 FixedBackgroundScene 承担当前画面，滑动时才显示独立 Hero artwork bands；HDC 远程 shell 后台执行手势再延时 snapshot 可抓到真实中帧。
+标签: #vui3 #hero-paging #handoff
+
+[PROJECT:Velix VUI1] TMDB Live Data Foundation
+结论: 首页生产路径已移除 Mock fallback，接入 TmdbRepository/DiscoveryProvider/API client；认证支持 API key/Bearer，首页、详情、TV season 与搜索均走统一 DTO Mapper 和 CDN resolver，凭据缺失明确报错。
+文件变更: ../Velix/entry/src/main/ets/domain/home/{HomeModels,HomeRepository,DiscoveryProvider,TmdbRepository,TmdbDiscoveryProvider,tmdb/*}, ../Velix/entry/src/main/ets/pages/{HomePage,MediaDetailPage}.ets, ../Velix/scripts/build-velix-app.sh, ../Velix/TMDB.md
+教训: rawfile 是本地构建注入点，tmdb.local.properties 与生成的 rawfile 必须忽略；没有真实凭据时只能验证未配置/401 错误态，不能声称 TMDB live feed 已通过。
+标签: #tmdb #data-layer #cache #search
+
+[PROJECT:Velix VUI1] TMDB Edge Fixes
+结论: 详情请求等待凭据初始化，Hero 显式过滤 person；补齐 imdbId/tvdbId 映射，详情主操作改为“查找可播放资源”，演员列表支持展开查看全部。
+文件变更: ../Velix/entry/src/main/ets/domain/home/{HomeModels,HomeRepository,TmdbDiscoveryProvider,tmdb/TmdbMapper}.ets, ../Velix/entry/src/main/ets/pages/MediaDetailPage.ets
+标签: #tmdb #detail #edge-cases
+
+[PROJECT:Velix VUI1] TMDB Search Pagination
+结论: 搜索 UI 增加真实 TMDB total_pages/total_results 状态与“加载更多”，继续沿用 380ms 防抖和旧查询结果隔离。
+文件变更: ../Velix/entry/src/main/ets/pages/HomePage.ets
+标签: #tmdb #search #pagination
+
+[PROJECT:Velix VUI1] TMDB Detail Completeness
+结论: 详情模型补齐 first/last air date 与 tvdbId，推荐为空时回退 similar，Specials 可作为首个可见季；详情失败显示重试态，最终应用提交 `42c23e5`。
+文件变更: ../Velix/entry/src/main/ets/domain/home/{HomeModels,tmdb/TmdbMapper}.ets, ../Velix/entry/src/main/ets/pages/MediaDetailPage.ets
+教训: 详情页请求必须等待 Repository 初始化，否则合法凭据也可能被未配置竞态抢先返回。
+标签: #tmdb #detail #tv #error-state
+
 [PROJECT:Velix VUI1] TMDB Live Emulator Verification
 结论: 用户提供的 Bearer Token 仅写入主 App 被 .gitignore 忽略的本地配置；模拟器实测首页 6 个 Hero、7 个分区共 130 项，电影详情、TV 详情/首季与第 2 季、搜索与加载更多均返回真实 TMDB 数据。
 文件变更: ../Velix/entry/src/main/ets/domain/home/TmdbDiscoveryProvider.ets, ../Velix/entry/src/main/ets/pages/MediaDetailPage.ets, ../Velix/tmdb.local.properties（忽略）