3.5 KiB
[PROJECT:Velix Alpha] 诊断与构建回归
结论: 修复 API 24 设备上的 TabBarSymbol 运行时崩溃，改用稳定 TabBarOptions；完成统一脱敏日志、轮转文件、LogViewer、诊断模式、ZIP 导出和播放异常 marker。debug/release unsigned HAP 构建成功，模拟器安装启动与诊断导出无崩溃。
文件变更: ../Velix/entry/src/main/ets/domain/diagnostics/*, ../Velix/entry/src/main/ets/pages/{DiagnosticsPage,LogViewerPage}.ets, ../Velix/entry/src/main/ets/ui/components/FloatingNavigation.ets, ../Velix/entry/src/main/ets/entryability/EntryAbility.ets, ../Velix/entry/src/main/ets/pages/PlayerPage.ets, ../Velix/{DOCS,ALPHA_BUILD_PROFILE.md,CHANGELOG.md,KNOWN_ISSUES_ALPHA.md}
教训: API 24 不应实例化会引用更新运行时符号的 BottomTabBarStyle；unsigned HAP 只能用于本地回归，正式 Alpha 仍需匹配签名 Profile。诊断包验证必须通过系统保存选择器，且所有输出持续脱敏。
标签: #alpha #diagnostics #logging #crash-marker #emulator #unsigned-hap
[PROJECT:Velix Alpha] Resume 与设置回归
结论: 主 App 提交 30aa760；Emby Resume/起播位置、音轨字幕选择和强制 Progress 已接入，设置/关于页可用且快进/快退时长持久化读取；Debug/Release 构建、安装启动和崩溃窗口检查通过。
文件变更: ../Velix/entry/src/main/ets/domain/{emby,home,playback,settings}, ../Velix/entry/src/main/ets/pages/{HomePage,MediaDetailPage,PlayerPage,SettingsPage,AboutPage}.ets, ../Velix/DOCS/ALPHA_STATUS.md
教训: ArkUI @Builder 参数是值传递时不会可靠刷新动态文本，使用 getter 闭包读取状态；真实 Emby 账号仍需有效凭据，unsigned HAP 不能替代正式签名。
标签: #alpha #resume #playback #settings #emulator #unsigned-hap
[PROJECT:Velix Alpha] 播放交互与状态回归
结论: 主 App 提交 b9380df；播放器 Slider/速度/音轨字幕/双击/长按临时倍速、前后台桥接、详情骨架与重试、Emby 源管理和媒体卡长按菜单已完成。Debug HAP 构建、安装、媒体卡菜单→详情跳转和模拟器崩溃窗口检查通过。
文件变更: ../Velix/entry/src/main/ets/{pages/{PlayerPage,MediaDetailPage,HomePage,SettingsPage}.ets,ui/components/MediaCard.ets,domain/playback/PlaybackLifecycleBridge.ets,domain/{emby,home,playback}/*,entryability/EntryAbility.ets}, ../Velix/DOCS/ALPHA_STATUS.md
教训: 滚动容器中自定义图片节点的长按可能被消费，卡片需在可触摸显示层上用短计时器判定，并把上下文菜单放入同一 Stack；真实 Emby 账号仍返回 401，未保存凭据。
标签: #alpha #player #gesture #emby #emulator #unsigned-hap
[PROJECT:Velix Alpha] Emby 真实运行验证
结论: 修复服务器要求的 Pw 登录字段、ArkUI headers 对象和 Asset Token 读取后，真实 Emby 登录/Token 恢复、库/详情/Series/Search、PlaybackInfo 已通过模拟器；HTTP Direct Play 首帧约 3.5 秒，Playing/Progress/Stopped 均 204；HTTPS Core 播放仍受 TLS 信任链阻塞。
文件变更: ../Velix/entry/src/main/ets/domain/emby/{EmbyApiClient,EmbyMediaProvider,EmbyModels,EmbyRuntimeProbe,EmbySecureTokenStore}.ets, ../Velix/entry/src/main/ets/pages/HomePage.ets, ../Velix/docs/emby/{EMBY_RUNTIME_VALIDATION,EMBY_API_RISKS}.md, ../Velix/Velix/DOCS/ALPHA_STATUS.md
教训: Emby 运行时 body/响应形状可能偏离 OpenAPI；嵌套 CollectionFolder 需要 Recursive=true，Hints 空数组应回退 Items 搜索；HTTPS 不能通过关闭证书校验规避。
标签: #emby #alpha #directplay #tls #emulator #runtime