From 38307e8d719826d05f7353a106ae7d2eec5b081d Mon Sep 17 00:00:00 2001 From: lanterngamescn Date: Thu, 25 Jun 2026 09:07:49 +0800 Subject: [PATCH] =?UTF-8?q?=E8=AE=A1=E5=88=92=E8=BF=9B=E5=BA=A6=EF=BC=9AM1?= =?UTF-8?q?=20=E6=A0=B8=E5=BF=83+V1=20=E9=80=9A=E8=BF=87=E3=80=81=E5=8D=95?= =?UTF-8?q?=E6=B5=8B=E5=8F=97=E9=98=BB=E7=99=BB=E8=AE=B0=20R-18?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 01_WBS 进度总览：M1 近完成，T-M1-01~07 全 ☑、V1 真机通过；T-M1-08 单测代码就位待运行 - 03_风险登记册：新增 R-18（单测运行工具链缺口）+ 受阻任务记录 T-M1-08 Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/设计文档/Plan/01_任务分解WBS.md | 14 +++++++++++++- docs/设计文档/Plan/03_风险登记册.md | 3 ++- 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/设计文档/Plan/01_任务分解WBS.md b/docs/设计文档/Plan/01_任务分解WBS.md index 6609367..28c0928 100644 --- a/docs/设计文档/Plan/01_任务分解WBS.md +++ b/docs/设计文档/Plan/01_任务分解WBS.md @@ -13,7 +13,7 @@ | 里程碑 | 状态 | 说明 | |---|---|---| | **M0** 脚手架 + 契约类型 | ☑ 完成 | 7 任务全完成并真机/模拟器验证 | -| **M1** 桥引擎 | ◐ 进行中 | 含 V1 阻塞性验证 | +| **M1** 桥引擎 | ◐ 近完成 | 核心 + **V1 真机通过** ✓；仅 T-M1-08 单测运行待工具链（R-18） | | **M2** 容器 + 启动 + 资源 | ☐ 未开始 | 含 V2 阻塞性验证 | | **M3** 本期能力 | ☐ 未开始 | — | | **M4** 通用网页容器 | ☐ 未开始 | — | @@ -30,6 +30,18 @@ - ☑ T-M0-06 引入桥 JS（lzyzsd 原文件 + BridgeJsLoader） - ☑ T-M0-07 App 入口与路由壳（Navigation；真机验证启动→路由→回传→横屏） +**M1 任务明细**： + +- ☑ T-M1-01 IWebController + WebviewControllerAdapter(emitter UI 线程守卫) + FakeWebController +- ☑ T-M1-02 Message + MessageCodec（lzyzsd 二次转义逐字复刻 + 单引号转义修复） +- ☑ T-M1-03 HandlerRegistry + 空实现 DefaultHandler 兜底 +- ☑ T-M1-04 BridgeController（对能力零感知、纯逻辑可测） +- ☑ T-M1-05 桥 JS 注入（onPageEnd） +- ☑ T-M1-06 最小回显 H5 + 容器接桥（BridgeGameContainer 挂 Web） +- ☑ **T-M1-07 V1 阻塞性验证真机通过**：yy:// 被 onLoadIntercept 捕获、_fetchQueue 经 + yy://return 回传、双向回执、含 `\"\\/'中文` 特殊字符转义往返一致。技术路线成立。 +- ⚠ T-M1-08 桥引擎单测：13 用例代码就位，运行+覆盖率待工具链（R-18） + **M0 期间确立的项目决策（超出原计划的补充）**： - 包名 `com.lobby.daoqi`；横屏项目，`module.json5` 配 `auto_rotation_landscape`（横屏两朝向跟随旋转、不进竖屏，H5 显式方向控制保留）。 - ArkTS 验证用 `devecocli build`（其 CompileArkTS 为权威编译器）；deveco-mcp 的 LSP check 因 70s 索引 / 20s 超时不可用。 diff --git a/docs/设计文档/Plan/03_风险登记册.md b/docs/设计文档/Plan/03_风险登记册.md index d2d8b6b..863a5a7 100644 --- a/docs/设计文档/Plan/03_风险登记册.md +++ b/docs/设计文档/Plan/03_风险登记册.md @@ -33,12 +33,13 @@ | **R-15** | 契约理解偏差导致 handler 行为不符，后期返工 | 中 | 中 | `contracts` HAR 固化为 SSOT；契约探针 H5 每周回归；评审对照 | Q | | **R-16** | 能力并行开发接口/风格不统一 | 低 | 低 | `CapabilityProvider` 统一接口 + Provider 样板；代码评审 | 桥 | | **R-17** | 真机/设备不足影响联调与回归 | 低 | 中 | 早期备真机 + 模拟器；CI 夜间冒烟 | PM | +| **R-18** | **单测运行工具链缺口**：`devecocli` 无 `test` 子命令，本地单测（src/test/hypium）的 hvigor task 未常规暴露，CLI 难跑覆盖率 | 中 | 中 | 单测代码已就位；运行候选：① DevEco IDE 跑 Local Test；② 确认 hvigorw 本地单测 task 并纳入 CI；③ 以真机契约探针 H5 为主回归。待定方案 | 桥/技术负责人 | ## 4. 受阻任务记录（动态更新） | 日期 | 受阻任务 | 关联风险 | 描述 | 处置 | 状态 | |---|---|---|---|---|---| -| — | — | — | （执行期间填写） | — | — | +| 2026-06-25 | T-M1-08 桥引擎单测 | R-18 | 13 用例代码已就位，但 devecocli 无 test 命令、本地单测 hvigor task 未常规暴露，无法 CLI 跑覆盖率 | 代码入库；运行方式待用户定夺（IDE/CI/hvigorw 例外） | 开放 | ## 5. 风险闸门（与里程碑绑定）