docs: record tmdb data integration

memory/2026-08-30.md

@@ -23,3 +23,21 @@
 结论: 背景改为覆盖 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

memory/projects.md

@@ -13,6 +13,9 @@
 - VUI1 首页重构：首页改为 Full-Bleed Immersive Home；Hero 的 backdrop/transition/ambient browsing surface 三层连续，环境色改用语义 Ambient Palette，顶部与 HDS 底栏统一使用动态氛围材质；Pura 90 Pro Max 初始态与滚动回归通过，主 App 待提交。
 - VUI1 底栏修正：保留 HDS 沉浸光感底材，Tab 前景保持不透明，选中图标继续使用当前影片的环境取色；Pura 90 Pro Max 回归通过。
 - VUI1 Scene Continuity：首页背景重构为跨 Hero 与第一分区的单一 Background Scene；Backdrop 长尾衰减至正文，正文 Column 透明，Hero 轮播时背景 URL 与环境色同步刷新；Pura 90 Pro Max 已回归。
+- VUI1 Motion Handoff：保留双层 artwork 复用；Hero visual 底部加入纵向渐隐交接区，背景仅在原生 Swiper settle 后以 420ms 固定位置过渡；拖动/回弹/快速 flick 已在 127.0.0.1:5555 回归。
+- VUI1 VUI3：Hero 顶部保持原生 100% 跟手，底部 160–220vp 以 smoothstep 位移渐衰 + Alpha 交接固定同图背景；静止、30/50% 中帧、回弹、flick 与 settle 已回归。
+- VUI1 TMDB：生产首页已移除 Mock fallback，接入 API key/Bearer、统一 DTO/Mapper、内存+Preferences 缓存、详情/TV season/搜索；模拟器已验证无 key 与 401 错误态不崩溃，真实 key 待本地填入后做 live feed 回归。
 - Phase 6 产物：`benchmark/runner/run_emulator.py` 与场景 manifest；启动 P50/P95 506/1150ms，seek recovery P50/P95 277/631ms；100 load/stop、200 play/pause 无错误，PSS/精确 heap/CPU permille unavailable。
 - Phase 6 文档：`DOCS/PHASE6_STATUS.md`、`PERFORMANCE_METRICS.md`、`PERFORMANCE_CHANGES.md`、`BENCHMARK_METHODOLOGY.md`、`STARTUP_PIPELINE.md`、`SEEK_PIPELINE.md`、`BUFFERING_MODEL.md`。