计划进度更新机制 + 标记 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:
co-authored by
Claude Opus 4.8
parent
82459c708c
commit
9280c00809
@@ -15,6 +15,7 @@ HarmonyOS NEXT(API 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 契约类型 SSOT(45 入站 + 21 出站 + 17 DTO + Result/Errors)
|
||||||
|
- ☑ T-M0-05 公共设施 common(Logger/Tracer/EventBus/DI/ErrorCenter)
|
||||||
|
- ☑ T-M0-06 引入桥 JS(lzyzsd 原文件 + 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 | 目标 | 产出物 | 依赖 | 验收 | 估时 | 角色 |
|
||||||
|
|||||||
Reference in New Issue
Block a user