From fe1935c3b3a37e217f14c7b5f01e5542cb37caf2 Mon Sep 17 00:00:00 2001 From: BoatingCloud <1759888028@qq.com> Date: Sun, 30 Aug 2026 13:40:56 +0800 Subject: [PATCH] docs: record tmdb data integration --- memory/2026-08-30.md | 18 ++++++++++++++++++ memory/projects.md | 3 +++ 2 files changed, 21 insertions(+) diff --git a/memory/2026-08-30.md b/memory/2026-08-30.md index 4ccb08ca34..0db286a470 100644 --- a/memory/2026-08-30.md +++ b/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 diff --git a/memory/projects.md b/memory/projects.md index 379e447200..f1ac79cc1f 100644 --- a/memory/projects.md +++ b/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`。