From 9280c0080935c95bd93f2a001518eb78a38c784b Mon Sep 17 00:00:00 2001 From: lanterngamescn Date: Thu, 25 Jun 2026 08:40:24 +0800 Subject: [PATCH] =?UTF-8?q?=E8=AE=A1=E5=88=92=E8=BF=9B=E5=BA=A6=E6=9B=B4?= =?UTF-8?q?=E6=96=B0=E6=9C=BA=E5=88=B6=20+=20=E6=A0=87=E8=AE=B0=20M0=20?= =?UTF-8?q?=E5=AE=8C=E6=88=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - CLAUDE.md 工作约定新增「及时更新计划进度」：按 Plan 实施时主动更新 01_任务分解WBS 任务状态，与代码提交同节奏 - 01_任务分解WBS 新增「进度总览」：M0 全部 7 任务标记完成 ☑，M1~M6 未开始； 记录 M0 期间确立的项目决策（包名/横屏/验证策略/devecocli 无 test） Co-Authored-By: Claude Opus 4.8 (1M context) --- CLAUDE.md | 1 + docs/设计文档/Plan/01_任务分解WBS.md | 31 ++++++++++++++++++++++++++++ 2 files changed, 32 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 7d38e47..10ee7db 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -15,6 +15,7 @@ HarmonyOS NEXT（API 12+，目标 SDK `6.1.1(24)`，runtimeOS `HarmonyOS`）上 - **🔴 H5 零改动是最高铁律**：H5 网页（大厅 + 全部子游戏）必须**完美适配新项目，不做任何修改**。所有适配工作只能发生在原生侧——H5 向原生注册的接口、原生向 H5 注册的接口、双向接口的调用时机/参数/数据结构，全部以《契约规范》为准、与原 Android 行为完全一致。**任何"改一下 H5 就好了"的方案都不被接受**；H5 行为存疑时改原生实现去迁就 H5，而非反过来。这是判断一切技术方案是否成立的首要判据。 - **原生内部实现自由**：在不违背上述铁律的前提下，原生侧的内部实现（分层、模块拆分、数据结构、设计模式、用何种 HarmonyOS API/SDK、性能优化手段等）可以**根据实际情况自由设计**，不必拘泥于原 Android 的内部写法或设计文档的伪代码细节。铁律只约束"对 H5 暴露的边界行为"，边界以内怎么实现由开发者按 HarmonyOS 最佳实践决定。 - **及时自动提交 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 桥。 - **禁止直接编辑 `project.godot` 类生成文件**；本项目对应的是 **不要手改 `oh-package-lock.json5`、`build/` 产物、`.hvigor/`**——它们由工具生成。 diff --git a/docs/设计文档/Plan/01_任务分解WBS.md b/docs/设计文档/Plan/01_任务分解WBS.md index 93570e8..506c872 100644 --- a/docs/设计文档/Plan/01_任务分解WBS.md +++ b/docs/设计文档/Plan/01_任务分解WBS.md @@ -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 · 工程脚手架 + 契约类型 | ID | 目标 | 产出物 | 依赖 | 验收 | 估时 | 角色 |