# 项目现状

更新日期：2026-09-21。

## 已确认范围

自家 Android 8.0 电视使用；React Native 优先，保留分平台构建与部署。首版采用电视客户端连接独立 Node 内容服务；Apple TV 保留工程骨架，其他平台尚未交付。

## v0.1.1 TV 适配

已修复焦点卡片被裁切、详情返回丢失位置、分页后丢焦点；加入电视安全边距、两行剧名、20 集分组与播放遥控器直接操作。构建与验收详情见 [v0.1.1 交付说明](RELEASE_0.1.1.md)。

## 已实现

- RN TV 0.81.5-2、React 19.1.0、react-native-video 6.19.3、TypeScript 工程与锁文件。
- 推荐、搜索、分页、详情选集、播放器控制和自动连播。
- 本地收藏、最近观看和按分集 ID 恢复进度。
- 服务设置、进程连通检测、错误展示与一次播放重新解析。
- 独立内容服务、媒体 Range / HEAD / 背压处理、可选口令、缓存清理。
- 内容探测脚本、续播与 HTTP 行为测试、Android APK 构建脚本和 Docker 部署配置。

## 已取得证据

- v0.1.1 的 12 项自动化测试与 TypeScript 检查通过；APK 版本号 2，与首版同签名。
- API 36 TV 模拟器中验证了 720p / 1080p、1.3 倍字体、第二页返回、末尾选集分组、单键暂停与长按快进释放。
- 2026-09-21 首页实际返回 24 部剧。
- 3 部测试剧的搜索均匹配目标 ID，分集数为 86、85、71；分集 ID 无重复。
- 每部首、中、末集共 9 个媒体片段均返回 206，64 KiB 长度与 MP4 文件头符合预期。
- 第一部首集前 10 秒通过 FFmpeg 解码。
- GitHub Actions 的 Node 22 检查和测试、两份 Compose 配置校验、AMD64 / ARM64 镜像构建与容器启动检查通过。ARM64 使用 QEMU；具体部署见 [Docker 指南](DOCKER.md)。

构建和模拟器的最终证据见 [首版交付说明](FIRST_RELEASE.md)，脱敏原始探测结果保存在 `outputs/probe.json`。

## 尚需验收

- 用户实际 Android 8.0 电视的安装、硬件解码、遥控器、长时间连播和休眠恢复。
- 自然过期的播放地址、网络中断恢复、长时间服务资源占用。
- Apple TV / iOS / Web 的构建、交互与媒体兼容性；现有共享边界不等于这些平台已可用。

平台请求签名和媒体处理仍依赖固定版本的第三方实现，成功记录只代表本次样本与时间点，不能保证后续平台兼容性。