docs: record emby runtime validation

memory/2026-08-31.md

@@ -15,3 +15,9 @@
 文件变更: ../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

memory/MEMORY.md

@@ -12,7 +12,8 @@
 - VUI1：主 App 完成沉浸式全屏 Hero、Ambient Palette、4 级材质、官方 HDS 沉浸导航、响应式详情页与自动隐藏播放器控制层；手机/平板/深色已回归，Core 未修改。
 - 部署约定：服务器只按 `deploy.sh`、`deploy.sh status/logs/clean/clean-all` 执行。
 - 详细状态：`memory/projects.md`；基础设施：`memory/infra.md`；教训：`memory/lessons.md`。
-- Emby/Alpha foundation：主 App 已接入 Emby Views、Items、Resume、Latest、Next Up、Seasons/Episodes、Search/Hints、ProviderIds 资源匹配、PlaybackInfo/DirectPlay、Playback Start/Progress/Stop 生命周期；提交 `540aee5`，debug HAP 构建并在模拟器启动通过。真实账号仍返回 401，未保存凭据。
+- Emby/Alpha foundation：主 App 已接入 Emby Views、Items、Resume、Latest、Next Up、Seasons/Episodes、Search/Hints、ProviderIds 资源匹配、PlaybackInfo/DirectPlay、Playback Start/Progress/Stop 生命周期；提交 `540aee5`，debug HAP 构建并在模拟器启动通过。后续真实运行兼容修复见 Emby runtime 条目。
 - Alpha diagnostics：主 App 提交 `33c39ff`，已接入脱敏 VelixLogger、1000 条 ring、2 MiB/5 级轮转、日志查看/筛选/复制、15/30 分钟诊断模式、系统文件选择器 ZIP 导出及播放异常标记；debug/release unsigned HAP 构建并在模拟器无崩溃启动。真实 Emby、真机和正式签名仍待完成。
-- Alpha playback/settings：主 App 提交 `30aa760`，Emby Resume 位置、音轨/字幕选择、暂停/Seek/切轨强制 Progress 已接入 Core；Settings/About 页面可用，快进/快退设置持久化并由 PlayerPage 读取。Debug/Release 构建及模拟器启动无崩溃；有效 Emby 账号、真机和正式签名仍待完成。
-- Alpha interactions：主 App 提交 `b9380df`，播放器 Slider/速度/音轨字幕/双击/长按临时倍速、Ability 前后台桥接、详情骨架与重试、服务器管理和媒体卡长按菜单已接入；debug 构建、安装、详情跳转与模拟器崩溃窗口检查通过。真实 Emby 账号仍返回 401，正式签名/真机/横屏仍待完成。
+- Alpha playback/settings：主 App 提交 `30aa760`，Emby Resume 位置、音轨/字幕选择、暂停/Seek/切轨强制 Progress 已接入 Core；Settings/About 页面可用，快进/快退设置持久化并由 PlayerPage 读取。Debug/Release 构建及模拟器启动无崩溃；真机、正式签名和 HTTPS Core TLS 验证仍待完成。
+- Alpha interactions：主 App 提交 `b9380df`，播放器 Slider/速度/音轨字幕/双击/长按临时倍速、Ability 前后台桥接、详情骨架与重试、服务器管理和媒体卡长按菜单已接入；debug 构建、安装、详情跳转与模拟器崩溃窗口检查通过。
+- Emby runtime：主 App 当前修复 `Pw` 登录字段、ArkUI HTTP headers 对象和 Asset Token 明文读取；真实登录/Token 恢复、Views/Items/详情/Series Seasons-Episodes/Search 回退、PlaybackInfo 已在模拟器通过。HTTP Direct Play 首帧约 3.5 秒且 Playing/Progress/Stopped 返回 204；HTTPS API 可用但原生 Core 播放受 TLS 信任链阻塞，服务器为 Emby 4.8.11.0，尚未宣称 Alpha 完成。

memory/projects.md

@@ -9,7 +9,7 @@
 - Phase 8 UI：主 App `../Velix` 已初始化独立 Git，提交 `058c7a8`；`HomeSource`、Discovery/Media Provider 边界、Mock/TMDB skeleton、RemoteImage/cache、Source Capsule/Sheet、Floating Navigation、Home/Detail、Player token integration 已完成。TMDB live credentials 已在本地注入并完成模拟器验证；Core 未修改。
 - Phase 8 模拟器：`127.0.0.1:5555` 已安装主 App HAP；首页远程图片、来源 Sheet、Hero → Detail、PlayerPage 本地 MP4 均已回归。截图见 `../Velix/design-qa.md`。
 - Alpha 诊断基础：主 App 提交 `33c39ff`；`VelixLogger` 统一接入并自动脱敏，内存 ring 1000 条、本地日志 2 MiB/5 级轮转；LogViewer 支持实时刷新、暂停、Level/Category/关键词筛选、复制与清空；诊断模式支持 15/30 分钟；ZIP 导出已通过系统文件选择器在模拟器保存验证；播放异常结束 marker 已接入。debug/release unsigned HAP 均构建成功并启动无崩溃。
-- Alpha 当前阻塞：真实 Emby 账户仍 HTTP 401，无法完成真实库/PlaybackInfo/Direct Play/音轨/字幕/Resume/Session E2E；正式 Alpha 还缺 AGC `.p7b` Profile、真机与压力回归，诊断包的部分正式构建/设备字段仍为 `unknown`。
+- Alpha 当前阻塞：真实 Emby 4.8.11.0 账号已完成认证、库/详情/搜索/PlaybackInfo 及 HTTP Direct Play+Session E2E；HTTPS 原生 Core 播放仍受模拟器 TLS 信任链阻塞，4.9.x 目标版本、AGC `.p7b` Profile、真机与压力回归仍待完成。
 - VUI1：主 App 沉浸式视觉重构已完成；`AmbientPalette` 驱动全屏 Hero/页面氛围色，浮层共用 1–4 级 `MaterialSurface`，底部导航使用 HDS `HdsTabs` immersive material。Pura 90 Pro Max 已回归首页、Sheet、详情、播放器自动隐藏和深色；MatePad Pro 13 已回归宽屏首页与详情分栏。Core 未修改，主 App 等待提交。
 - VUI1 修正：首页的来源胶囊、搜索与个人入口已从 Scroll 抽离，与底部导航一样作为固定浮层；Pura 90 Pro Max 上滑回归通过。
 - VUI1 首页重构：首页改为 Full-Bleed Immersive Home；Hero 的 backdrop/transition/ambient browsing surface 三层连续，环境色改用语义 Ambient Palette，顶部与 HDS 底栏统一使用动态氛围材质；Pura 90 Pro Max 初始态与滚动回归通过，主 App 待提交。
@@ -26,10 +26,10 @@
 - VUI1 HTTP/打包验证：emulator 已播放公开 HTTP MP4；`111.cer` 已导入匹配 `.p12`，Release HAP 已构建，但正式签名包还缺 AGC 对应 `.p7b Profile`。
 - Emby 阶段：已完整解析项目根 `embyapi.json`（OpenAPI 3.0.1、356 paths、447 operations），生成 `../docs/emby/` 五份清单/模型/播放链路/风险文档；主 App 提交 `2d3c255`/`ff28ae1` 加入 EmbyApiClient、EmbyRequestContext、EmbyAuthProvider 与 DTO 基础骨架，未实现具体业务 endpoint；debug HAP 构建通过。
 - Emby Phase 8.1：主 App 提交 `1cd396d`。Source Capsule 已可打开添加 Emby 表单；`EmbyServerUrlNormalizer` 支持 host/host:port、http(s) 与单一 `/emby` 后缀；`VelixDeviceIdentity` 持久化安装级 DeviceId；`EmbySecureTokenStore` 使用 Asset persistent/accessibility tags（API 24 SDK 需目标签名确认 `STORE_PERSISTENT_DATA`）；`EmbyServerManager` 支持多服务器、活动源、登出/移除与 Token 失效；`EmbyRuntimeProbe` 执行 PublicSystemInfo、AuthenticateByName、User、System、Views、MediaFolders、Items 和条件 PlaybackInfo，输出脱敏 `EMBY_RUNTIME_VALIDATION.md`。模拟器已安装并启动 debug HAP，表单必填错误态可见、无新增崩溃；真实 Emby 4.9.x 网络/ProviderIds/ticks/PlaybackInfo 仍待运行时验证。
-- Emby 连接实测：使用用户提供的地址与账号在模拟器及主机复核；`/System/Info/Public` 返回 `SaturDay.Lite`、Emby `4.8.11.0`，`/Users/AuthenticateByName` 返回 HTTP 401 且服务器明确提示账号或密码无效。应用已将 401 文案改为“用户名或密码不正确”，未写入密码/token；真实库、ProviderIds、PlaybackInfo 与 Asset 持久化仍待有效账号。
-- Alpha Emby foundation：主 App 提交 `540aee5`，补齐 Emby Resume/Latest/Next Up、Series Seasons/Episodes、`/Search/Hints` 分页搜索、ProviderIds 优先资源匹配、DirectPlay PlaybackInfo/URL/headers；`PlaybackLaunch.remoteSession` 已接入 PlayerPage 的 Start/8 秒节流 Progress/Stop。debug HAP 构建、安装、启动回归通过；真实库/播放仍被 401 阻塞，产物仍为 unsigned debug HAP。
+- Emby 连接实测：服务器返回 `SaturDay.Lite`、Emby `4.8.11.0`；该实例要求 `Pw` 登录字段，修复后 `/Users/AuthenticateByName`、用户/库/Items/Resume/Latest/NextUp 均成功，Token 可在应用重启后恢复。`/Search/Hints` 空数组由 Items 搜索回退；Series Seasons/Episodes 与 PlaybackInfo 已验证。HTTPS API 正常但 Core 播放报 `NETWORK: loading failed`，HTTP Direct Play 首帧/Session 204 已验证，禁止关闭 TLS 校验。
+- Alpha Emby foundation：主 App 提交 `540aee5`，补齐 Emby Resume/Latest/Next Up、Series Seasons/Episodes、`/Search/Hints` 分页搜索、ProviderIds 优先资源匹配、DirectPlay PlaybackInfo/URL/headers；`PlaybackLaunch.remoteSession` 已接入 PlayerPage 的 Start/8 秒节流 Progress/Stop。后续兼容修复尚未提交，当前产物仍为 unsigned debug HAP。
 - Alpha playback/settings：主 App 提交 `30aa760`，`UserData.PlaybackPositionTicks` 进入 PlaybackLaunch/Core 起播位置，详情页提供继续/从头，音轨/字幕选择会同步 Emby Session；暂停、Seek、切轨强制上报 Progress。新增持久化 Settings/About 入口，PlayerPage 读取快进/快退时长；Debug/Release HAP 与模拟器启动通过。
-- Alpha interactions：主 App 提交 `b9380df`；播放器加入 Slider、速度、音轨/字幕、双击快进/快退和长按临时倍速，前后台桥接按 Alpha 策略暂停并补报进度；详情骨架/错误重试、搜索/连接诊断入口、Emby 源退出/移除、媒体卡长按上下文菜单已完成。模拟器已验证长按菜单与详情跳转，无新增崩溃；真实 Emby、真机横屏、压力和正式签名仍待完成。
+- Alpha interactions：主 App 提交 `b9380df`；播放器加入 Slider、速度、音轨/字幕、双击快进/快退和长按临时倍速，前后台桥接按 Alpha 策略暂停并补报进度；详情骨架/错误重试、搜索/连接诊断入口、Emby 源退出/移除、媒体卡长按上下文菜单已完成。模拟器已验证长按菜单与详情跳转，无新增崩溃；真实 Emby HTTP Direct Play 已验证，HTTPS Core、真机横屏、压力和正式签名仍待完成。
 - 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`。