计划进度更新机制 + 标记 M0 完成

- CLAUDE.md 工作约定新增「及时更新计划进度」:按 Plan 实施时主动更新
  01_任务分解WBS 任务状态,与代码提交同节奏
- 01_任务分解WBS 新增「进度总览」:M0 全部 7 任务标记完成 ☑,M1~M6 未开始;
  记录 M0 期间确立的项目决策(包名/横屏/验证策略/devecocli 无 test)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
lanterngamescn
2026-06-25 08:40:24 +08:00
co-authored by Claude Opus 4.8
parent 82459c708c
commit 9280c00809
2 changed files with 32 additions and 0 deletions
+1
View File
@@ -15,6 +15,7 @@ HarmonyOS NEXTAPI 12+,目标 SDK `6.1.1(24)`runtimeOS `HarmonyOS`)上
- **🔴 H5 零改动是最高铁律**:H5 网页(大厅 + 全部子游戏)必须**完美适配新项目,不做任何修改**。所有适配工作只能发生在原生侧——H5 向原生注册的接口、原生向 H5 注册的接口、双向接口的调用时机/参数/数据结构,全部以《契约规范》为准、与原 Android 行为完全一致。**任何"改一下 H5 就好了"的方案都不被接受**;H5 行为存疑时改原生实现去迁就 H5,而非反过来。这是判断一切技术方案是否成立的首要判据。 - **🔴 H5 零改动是最高铁律**:H5 网页(大厅 + 全部子游戏)必须**完美适配新项目,不做任何修改**。所有适配工作只能发生在原生侧——H5 向原生注册的接口、原生向 H5 注册的接口、双向接口的调用时机/参数/数据结构,全部以《契约规范》为准、与原 Android 行为完全一致。**任何"改一下 H5 就好了"的方案都不被接受**;H5 行为存疑时改原生实现去迁就 H5,而非反过来。这是判断一切技术方案是否成立的首要判据。
- **原生内部实现自由**:在不违背上述铁律的前提下,原生侧的内部实现(分层、模块拆分、数据结构、设计模式、用何种 HarmonyOS API/SDK、性能优化手段等)可以**根据实际情况自由设计**,不必拘泥于原 Android 的内部写法或设计文档的伪代码细节。铁律只约束"对 H5 暴露的边界行为",边界以内怎么实现由开发者按 HarmonyOS 最佳实践决定。 - **原生内部实现自由**:在不违背上述铁律的前提下,原生侧的内部实现(分层、模块拆分、数据结构、设计模式、用何种 HarmonyOS API/SDK、性能优化手段等)可以**根据实际情况自由设计**,不必拘泥于原 Android 的内部写法或设计文档的伪代码细节。铁律只约束"对 H5 暴露的边界行为",边界以内怎么实现由开发者按 HarmonyOS 最佳实践决定。
- **及时自动提交 git**:每完成一个可独立验收的小步骤(一个 Provider、一个状态机节点、一处可编译通过的改动)后,**主动执行 git 提交**,无需等待用户要求。提交信息用中文、说明"做了什么 + 对应契约/设计条目(如 §8、T-M1-04)"。⚠️ 仓库当前尚未 `git init`,首次提交前需先初始化。 - **及时自动提交 git**:每完成一个可独立验收的小步骤(一个 Provider、一个状态机节点、一处可编译通过的改动)后,**主动执行 git 提交**,无需等待用户要求。提交信息用中文、说明"做了什么 + 对应契约/设计条目(如 §8、T-M1-04)"。⚠️ 仓库当前尚未 `git init`,首次提交前需先初始化。
- **及时更新计划进度**:按 `docs/设计文档/Plan/` 的计划实施时,每完成一个任务(`T-M{里程碑}-{序号}`)或推进一个里程碑,**主动更新对应计划文档的进度**——在 `01_任务分解WBS.md` 标记任务状态(`☐ 未开始 / ◐ 进行中 / ☑ 完成 / ⚠ 受阻`),受阻项同步登记到 `03_风险登记册.md`(见 `00_总体规划.md` §8 进度跟踪机制)。与代码提交同节奏,无需等用户提醒。
- HarmonyOS 相关操作(构建、运行、调试、设备、日志、查文档/SDK 签名)**必须**走 `deveco-cli` skill / `devecocli`,不要手搓 `hvigorw` 命令或直连 MCP HTTP 桥。 - HarmonyOS 相关操作(构建、运行、调试、设备、日志、查文档/SDK 签名)**必须**走 `deveco-cli` skill / `devecocli`,不要手搓 `hvigorw` 命令或直连 MCP HTTP 桥。
- **禁止直接编辑 `project.godot` 类生成文件**;本项目对应的是 **不要手改 `oh-package-lock.json5`、`build/` 产物、`.hvigor/`**——它们由工具生成。 - **禁止直接编辑 `project.godot` 类生成文件**;本项目对应的是 **不要手改 `oh-package-lock.json5`、`build/` 产物、`.hvigor/`**——它们由工具生成。
@@ -6,6 +6,37 @@
--- ---
## 进度总览
> 状态图例:☐ 未开始 / ◐ 进行中 / ☑ 完成 / ⚠ 受阻。每完成任务或里程碑**及时更新**(CLAUDE.md 工作约定)。最后更新:2026-06-25。
| 里程碑 | 状态 | 说明 |
|---|---|---|
| **M0** 脚手架 + 契约类型 | ☑ 完成 | 7 任务全完成并真机/模拟器验证 |
| **M1** 桥引擎 | ☐ 未开始 | 下一步;含 V1 阻塞性验证 |
| **M2** 容器 + 启动 + 资源 | ☐ 未开始 | 含 V2 阻塞性验证 |
| **M3** 本期能力 | ☐ 未开始 | — |
| **M4** 通用网页容器 | ☐ 未开始 | — |
| **M5** 性能与加固 | ☐ 未开始 | — |
| **M6** 暂缓能力集成 | ☐ 未开始 | 按需 |
**M0 任务明细(全部 ☑)**
- ☑ T-M0-01 多模块工程(entry + 6 HAR
- ☑ T-M0-02 模块依赖与导出(单向向下、无环)
- ☑ T-M0-03 构建/签名/CI(签名已配 `tsgames.p12`CI = `scripts/ci.sh`
- ☑ T-M0-04 契约类型 SSOT45 入站 + 21 出站 + 17 DTO + Result/Errors
- ☑ T-M0-05 公共设施 commonLogger/Tracer/EventBus/DI/ErrorCenter
- ☑ T-M0-06 引入桥 JSlzyzsd 原文件 + BridgeJsLoader
- ☑ T-M0-07 App 入口与路由壳(Navigation;真机验证启动→路由→回传→横屏)
**M0 期间确立的项目决策(超出原计划的补充)**
- 包名 `com.lobby.daoqi`;横屏项目,`module.json5``auto_rotation_landscape`(横屏两朝向跟随旋转、不进竖屏,H5 显式方向控制保留)。
- ArkTS 验证用 `devecocli build`(其 CompileArkTS 为权威编译器);deveco-mcp 的 LSP check 因 70s 索引 / 20s 超时不可用。
- `devecocli``test` 子命令,单测运行方式待 M1 解决。
---
## M0 · 工程脚手架 + 契约类型 ## M0 · 工程脚手架 + 契约类型
| ID | 目标 | 产出物 | 依赖 | 验收 | 估时 | 角色 | | ID | 目标 | 产出物 | 依赖 | 验收 | 估时 | 角色 |