# TSGame HarmonyOS 开发计划（Plan）

> 本目录是《[TSGame_HarmonyOS框架设计与开发指南](../TSGame_HarmonyOS框架设计与开发指南.md)》的**落地实施计划**，把"设计"拆解为"可执行、可验收、可追踪"的任务。
>
> 上游依据（单一事实来源 SSOT）：
> - 《[TSGame_原生与H5接口契约总规范](../TSGame_原生与H5接口契约总规范.md)》—— 对外不可变契约（H5 零改动的判据）
> - 《[TSGame_HarmonyOS框架设计与开发指南](../TSGame_HarmonyOS框架设计与开发指南.md)》—— HarmonyOS 侧如何实现

## 文档导航

| 文件 | 内容 | 读者 |
|---|---|---|
| [00_总体规划.md](./00_总体规划.md) | 里程碑、关键路径、依赖 DAG、并行轨道、角色分工、环境/分支、DoD、进度机制 | 全员 / PM |
| [01_任务分解WBS.md](./01_任务分解WBS.md) | **核心**：按里程碑的全量任务（ID/目标/产出/依赖/验收/估时/角色） | 开发 |
| [02_测试与验收计划.md](./02_测试与验收计划.md) | 测试策略、回显 H5、两个阻塞性验证、契约一致性回归、里程碑验收 Gate | 开发 / QA |
| [03_风险登记册.md](./03_风险登记册.md) | 风险、概率/影响、缓解、触发条件、负责人 | PM / 技术负责人 |

## 一页速览（TL;DR）

- **目标**：在 HarmonyOS 上实现原生外壳，使现有 H5（大厅 + 全部子游戏 + 活动/收银台等网页）**一行不改**即可运行。
- **本期范围**：桥引擎、双容器、启动/配置/资源、本期全部设备能力。**视频房、支付用占位桩**（不报错/不卡死），**闲聊不涉及**。真实视频房/支付列入 M6 按需集成。
- **最高优先 & 最大风险**：M1 桥引擎，以及两个"阻塞性验证"——`yy://` 拦截（M1）、`file://` 跨域（M2）。这两点必须**最先证伪**，决定整体可行性。
- **关键路径**：M0 → M1 → M2 →（M3 能力并行）→ M4 → M5。M6 可延后。
- **判据**：以《契约规范》§8/§9/§11 的 handler 名、参数、数据结构、调用时机为唯一验收标准。

## 任务 ID 规范

`T-M{里程碑}-{序号}`，例：`T-M1-04` = 里程碑 M1 的第 4 个任务。跨文档引用任务用此 ID。

## 状态约定

`☐ 未开始` · `◐ 进行中` · `☑ 完成` · `⚠ 受阻`（受阻须在 [03_风险登记册](./03_风险登记册.md) 记录）。
