npm - @harmonyos-arkts/d2h - Versions diffs - 0.1.13 → 0.1.15 - Mend

@harmonyos-arkts/d2h 0.1.13 → 0.1.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/.claude-plugin/plugin.json +1 -1
package/README.md +36 -180
package/agents/d2h.md +7 -15
package/dist/bin/install-opencode.js +12 -0
package/dist/src/install-opencode.js +66 -3
package/dist/src/install-vscode.js +3 -2
package/package.json +1 -1
package/skills/d2h-page-develop/SKILL.md +1 -1
package/skills/d2h-page-spec-generate/SKILL.md +1 -1

package/.claude-plugin/plugin.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "android-to-hmos-migration",
   "description": "基于确定性 facts、迁移报告与端到端验证的 Android 到 HarmonyOS 迁移插件",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "license": "MIT",
   "keywords": [
     "android",

package/README.md CHANGED Viewed

@@ -1,213 +1,69 @@
-# android-to-hmos-migration
-Android 应用迁移到 HarmonyOS 的报告驱动 AI 插件，支持 Claude Code 与 OpenCode。
-插件以 Android 源码、外部依赖和 AppGraph 确定性 facts 为防遗漏基线，由一个主 Agent 持续完成原生 HarmonyOS 实现、测试和端到端验证。迁移报告只记录 Android→HarmonyOS 映射与测试证据，不替代真实实现。
-## 主流程
-1. 检查 Android 技术栈、构建基线和设备环境。HarmonyOS HDC 设备是必需门禁；Android 运行环境依赖（SDK/adb/模拟器/Android 侧构建测试）已移除，相关检查固定为 `not_applicable`。
-2. 运行 AppGraph 纯源码静态分析（无需编译 Android 工程），生成只读 `.migration/spec/facts/` 与人工查看的 `spec.html`。
-3. 加载 `appgraph-rule-audit`，只读分析页面、跳转、归属、规则贡献和未解析结果，生成 `.migration/rule-audit/` 规则提升候选；它不修改 facts 或规则，也不阻塞迁移。
-4. 从 facts 初始化 `.migration/report/` 报告分片。
-5. 从 `.migration/spec/` 的 Facts 分片契约 `2.0.0` 与受管 correction/review 编译 `.migration/tasks/`，校验 Launcher、行为闭包、Fact 所有权和 Task DAG。
-6. AI 通过 `task next`/`task show` 在 Resolution 阶段取得裁决 Task，在 Execution 阶段取得一个完整 Page Work Package；以 Android 源码和运行行为为权威持续实现 HarmonyOS 应用。
-7. 每完成一个可验证 Page Work Package，同步填写内部 Work Item/Behavior 的实现映射和测试证据，并创建 Git 检查点。
-8. 在 HarmonyOS 模拟器或真机上执行端到端功能验证。Android 运行时对照能力已移除，一致性基准为 Android 源码、静态 facts 与 `evidence compare` 对既有证据目录的比较；发现 facts 遗漏时写入报告 discoveries。
-9. 使用 Task Plan 与报告门禁检查已知 facts 覆盖；最终完成必须同时满足真实应用验收。
-Task Planning 的跨仓实现映射、架构图、Agent 生效检查和端到端运行命令见 [`docs/task-planning-implementation-and-runbook.md`](docs/task-planning-implementation-and-runbook.md)。
-Task 从真实入口到提取、闭包、合并、所有权、依赖、推荐和执行的完整原则见 [`docs/task-planning-principles.md`](docs/task-planning-principles.md)。
-## 保留结构
-```text
-android-to-hmos-migration/
-├── .claude-plugin/          # Claude Code 插件清单
-├── agents/                  # 报告驱动主 Agent
-├── docs/                    # 流程与 Task Planning Strategy 设计
-├── opencode/agents.json     # OpenCode Agent 权限
-├── schemas/                 # facts、报告与 Preflight 契约
-├── skills/                  # 工作区准备、工程架构规范、报告、经验和流程复盘
-└── install-opencode.sh      # OpenCode Agent/Skill 安装器
-```
-## 安装
+# d2h
-D2H 安装器按 `skills/managing-d2h-toolchain/toolchain.json` 中联测的版本安装 AppGraph、droid2hmos 和 Agent/Skill，原有行为保持不变。[`managing-d2h-toolchain`](skills/managing-d2h-toolchain/SKILL.md) 现在也能独立检查、按需安装同一工具组合，不依赖 `d2h` 命令：在 Skill 目录运行 `node scripts/manage-toolchain.mjs check`，未通过时运行 `node scripts/manage-toolchain.mjs install`。以下命令可使用 D2H 安装器；独立 Skill 脚本随本版本提供：
+`@harmonyos-arkts/d2h` 为 Android 应用迁移到 HarmonyOS 安装 AI Agent、Skill 和配套命令行工具。
-```sh
-npx --yes @harmonyos-arkts/d2h@0.1.11 install --agent opencode
-npx --yes @harmonyos-arkts/d2h@0.1.11 install --agent vscode
-npx --yes @harmonyos-arkts/d2h@0.1.11 install --agent vscode --remote
-npx --yes @harmonyos-arkts/d2h@0.1.11 doctor --agent vscode
-npx --yes @harmonyos-arkts/d2h@0.1.11 upgrade --check
-npx --yes @harmonyos-arkts/d2h@0.1.11 --check-env --output-dir ./environment-report
-```
+安装后，`d2h` Agent 会通过 AppGraph 分析 Android 源码，规划迁移页面与功能，辅助生成 HarmonyOS 实现，并通过 droid2hmos 执行环境检查、构建、测试和迁移报告维护。
-VS Code 目标是 Huawei HarmonyOS Dev Assistant 扩展；安装器复制 Agent/Skill、注册 `d2h` 并设置读写编辑权限，同时将模式名显示为“安卓转鸿蒙”。扩展使用已解包的 OpenCode 缓存运行，安装器会同步更新当前活动缓存并备份改动；请先启动扩展一次以生成缓存，安装后在 VS Code 中执行“Developer: Reload Window”使对话后端重新读取配置。`doctor --agent vscode` 会检查扩展文件和活动缓存。详细用法见 [环境检查说明](docs/environment-check.md)。受管 CLI 的全局 npm link 默认保留；显式运行 `d2h install --force --agent vscode` 或 Skill 的 `node scripts/manage-toolchain.mjs install --force` 才会替换全局链接，不会修改链接指向的源码目录。
+## 环境要求
-Claude Code：
+- Node.js 22.5–24.x
+- OpenCode、DevEco Code，或安装了 HarmonyOS Dev Assistant 的 VS Code
-```text
-/plugin marketplace add D:/code/a2h/android-to-hmos-migration
-/plugin install android-to-hmos-migration@android-to-hmos-migration-local
-```
+## 安装
-OpenCode（Node.js 22.5–24.x，支持 Windows/macOS/Linux，无需克隆仓库或安装 Shell）：
+默认安装到 OpenCode：
-```sh
-npx --yes @harmonyos-arkts/d2h@0.1.11
+```bash
+npx --yes @harmonyos-arkts/d2h@latest install --agent opencode --force
 ```
-安装器把 npm 包内的 `skills/` 和 `agents/` 复制到当前用户的 OpenCode 全局配置目录。更新已有安装时使用：
+安装到 DevEco Code：
-```sh
-npx --yes @harmonyos-arkts/d2h@0.1.11 --force
+```bash
+npx --yes @harmonyos-arkts/d2h@latest install --agent deveco --force
 ```
-先预览或指定目录：
+安装到 VS Code 的 HarmonyOS Dev Assistant：
-```sh
-npx --yes @harmonyos-arkts/d2h@0.1.11 --dry-run
-npx --yes @harmonyos-arkts/d2h@0.1.11 --config-dir /path/to/opencode
+```bash
+npx --yes @harmonyos-arkts/d2h@latest install --agent vscode --force
 ```
-默认目标为 OpenCode，也可显式使用 `--agent opencode`。安装到 DevEco Code：
+默认使用本地轻量指标插件 `opencode-metrics-plugin-lite`。需要远端指标能力时增加 `--remote`：
-```sh
-npx --yes @harmonyos-arkts/d2h@0.1.11 --agent deveco
-npx --yes @harmonyos-arkts/d2h@0.1.11 --agent deveco --force
+```bash
+npx --yes @harmonyos-arkts/d2h@latest install --agent vscode --force --remote
 ```
-DevEco Code 默认安装到 `~/.config/deveco`（Windows 为 `%USERPROFILE%\.config\deveco`），目录优先级为 `--config-dir` → `DEVECO_CONFIG_DIR` → `$XDG_CONFIG_HOME/deveco` → `~/.config/deveco`。OpenCode 使用 `OPENCODE_CONFIG_DIR`，两者互不混用。安装时会在目标的 `opencode.json` 插件数组中加入仅用于 `d2h` 的 `opencode-metrics-plugin-lite`；加 `--remote` 则使用 `opencode-metrics-plugin`。重复安装会切换版本，不会同时启用两者。安装完成后重启对应应用；已有其他配置保留。`--config-dir` 与 `--agent` 的参数顺序不影响结果。
+安装器会安装清单中验证过的 AppGraph 和 droid2hmos 版本，并安装迁移 Skill 和 `d2h` Agent。安装完成后请完全退出并重新启动对应应用。
-默认目录按 `OPENCODE_CONFIG_DIR` → `$XDG_CONFIG_HOME/opencode` → `~/.config/opencode` 解析；Windows 默认 `%USERPROFILE%\.config\opencode`。安装器仅更新 `opencode.json` 的 metrics 插件条目，不会复制仓库的 `AGENTS.md`。已有相同内容保持不变，冲突时提示 `--force`，其他用户 Agent/Skill 保留。
-从仓库安装仍可使用原 Shell 脚本：
-```sh
-sh ./install-opencode.sh
-```
+## 检查与升级
-该脚本把 `skills/` 和 `agents/` 安装到当前用户的 OpenCode 全局配置目录，不读取或改写 `opencode.json`。更新已有安装时使用 `--force`；本地开发需要让全局安装实时跟随仓库时使用 `--link --force`。可通过 `--config-dir` 和 `--source-dir` 适配自定义目录，先用 `--dry-run` 检查操作。完整参数见 `sh ./install-opencode.sh --help`。
-npm 安装器支持同样的参数，完整说明见 `npx --yes @harmonyos-arkts/d2h@0.1.11 --help`。本地开发可使用 `npm run build && node dist/bin/install-opencode.js --source-dir /path/to/repository --link --force`。Windows 下 Agent 文件符号链接需要开发者模式或管理员权限；默认复制模式不需要。不要将 `npx` 缓存作为长期链接来源，缓存清理后链接可能失效。
-维护者发布：安装开发依赖后运行 `npm run build`，将 TypeScript 源码编译到 `dist/`；`npm run check && npm test` 检查类型并测试编译后的 CLI，然后 `npm publish`。npm 包使用 `dist/bin/install-opencode.js` 作为入口，包含编译后的运行代码、Agent、完整 Skill 资源树及 schema，不包含 TypeScript 源码、研发文档和测试；发布时不会自动修改用户配置，只有显式执行 `npx` 安装器才会安装。
-完全退出并重新启动 OpenCode 后，选择 `d2h_v2` 执行完整迁移。`android-to-hmos-00-orchestrator` 和 `d2h` 仅为旧名称兼容入口。
-## 命令
-```text
-droid2hmos init <android-project> [--target <harmony-project>]
-droid2hmos status <android-project>
-droid2hmos complete <android-project>
-droid2hmos analyze <android|harmony|all> <android-project>
-droid2hmos report init <android-project>
-droid2hmos report validate <android-project> [--require-complete]
-droid2hmos report update <android-project> --ref <ref> [--status <status>] [--harmony-file <path>] [--android-source <path>] [--evidence <path>]
-droid2hmos report <android-project> [--require-complete]
-droid2hmos report render <android-project>
-droid2hmos task plan <android-project>
-droid2hmos task validate <android-project>
-droid2hmos task status <android-project>
-droid2hmos task next <android-project>
-droid2hmos task show <android-project> <task-id> [--cursor <cursor>] [--max-source-context <count>]
-droid2hmos build harmony <android-project>
-droid2hmos test harmony <android-project> --runner python --hypium-project <path> (--test-list <name>...|--all) [--target <id>] [--ref <report-ref>...]
-droid2hmos test harmony <android-project> --class <class> [--case <case>] [--target <id>] [--case-timeout-ms <ms>] [--ref <report-ref>...]
-droid2hmos test harmony <android-project> --all [--target <id>] [--case-timeout-ms <ms>] [--ref <report-ref>...]
-droid2hmos service start <name> <android-project> [--health-url <url>] -- <command> [args...]
-droid2hmos service status <name> <android-project>
-droid2hmos service stop <name> <android-project>
-```
+检查安装和环境：
-- `init`：从受管 DevEco 模板创建 HarmonyOS 工程壳。
-- `status`：从项目、配置、Preflight、facts、报告、Task Plan、源码指纹和受管证据只读推导当前阶段、允许动作与完成缺口，不维护可漂移的手工状态。
-- `complete`：最终完成硬门禁；任何 guard 模式都不能绕过当前分析、全量回归、报告和逐项证据的新鲜度检查。
-- `analyze android`：通过 AppGraph 对 Android 源码做纯静态分析，生成确定性 facts 和 `spec.html`，无需编译 Android 工程；同时只读清点既有 APK，仅作参考信息（Android 运行时对照能力已移除）。
-- `report init`：从 facts 初始化报告 `1.2.0`；存量 `1.1.0` 报告原地升级但不会伪造来源。
-- `report update/validate`：为 implemented/verified 条目强制记录 Android `sourceProvenance`，校验受管成员、文件 hash、可用 Task closure 和 HarmonyOS 路径；项目内事件文件不被当作可信 D1 来源，缺少运行器集成时返回 `unavailable`，D2 抽样只产生 warning。当前不拦截宿主普通文件写入，最高默认证据级别为 `declared-hash-validated`。
-- `report`：校验后生成 `.migration/report/report.html`。HTML 主体面向用户展示迁移结论、未完成内容、下一步、端到端测试、差异和阻塞；页面/控件/导航、内部 ref 与文件映射仅作为默认折叠的技术追溯附录。
-- `task plan/validate`：确定性生成并校验 `.migration/tasks/`；计划基线绑定 Facts、correction/review 和 Android 指纹，并按可观察行为而不是单个 Entry/Issue 聚合责任。
-- `task status/next/show`：只读推导 Task 运行态、选择 Ready Frontier，并按需分页返回源码上下文；不写新的状态机文件。
-- `build harmony`：直接读取 DevEco JSON5 配置生成应用构建命令；Hvigor 增量命中时可复用不早于当前构建输入的非空 HAP，过期产物会失败；`config.json` 不保存 HarmonyOS 构建命令。
-- `test harmony`：确定性构建应用 HAP 并运行 Hypium。迁移流程统一使用 `--runner python --hypium-project <path> --test-list <name>...` 执行 `d2h-hypium-forge` 生成的 `.hypium_forge/` Python 用例（定向执行、无 `--all`，需 `python -m pip install hypium -U`）；`--class/--case/--all` 的 ArkTS ohosTest runner 仅用于存量资产。多设备时必须传 `--target`，测试失败、忽略、零执行或缺少结果摘要都会失败。用重复的 `--ref` 声明本次测试实际覆盖的报告项，未覆盖的 `verified` 项不能通过 `complete`。
-## 核心产物
-迁移产物统一存放在安卓工程父目录下的独立工作区 `<AndroidProject>-migration/` 中，不再写入安卓工程内部。CLI 在创建 `.migration/` 前会自动在工作区根目录生成 `.gitignore`（内容 `.migration/`），防止迁移产物被上层 Git 仓库提交到远端：
-```text
-AndroidProject/.migration/
-├── preflight-report.json
-├── spec/
-│   ├── index.json
-│   ├── facts/
-│   └── spec.html
-├── report/
-│   ├── index.json
-│   ├── pages/
-│   ├── interactions/
-│   ├── discoveries.json
-│   ├── summary.json            # AI填写的用户总结
-│   ├── final-acceptance.json
-│   ├── validation.json
-│   └── report.html             # 脚本生成的用户报告
-├── tasks/
-│   ├── graph.json              # droid2hmos 生成的派生 Task DAG
-│   ├── index.json
-│   ├── briefs/*.md
-│   └── acceptance/*.json
-├── evidence/
-│   ├── index.json              # 最近一次受管动作证据索引
-│   ├── blobs/<sha256>/         # 完成门禁校验的内容寻址证据产物
-│   └── managed/*.json          # 与 facts/源码指纹绑定的 CLI 收据
-├── audit/
-│   ├── source-events.jsonl     # 可选可信有序事件输入
-│   ├── android-source-manifest.json # 受管 Android 成员与 hash
-│   ├── checkpoint-provenance.json  # 随受管 checkpoint 强制进入 Git commit
-│   ├── source-order-audit.json
-│   └── literal-drift-audit.json
-└── experience/lessons.md
+```bash
+npx --yes @harmonyos-arkts/d2h@latest doctor --agent opencode
+npx --yes @harmonyos-arkts/d2h@latest doctor --agent deveco
+npx --yes @harmonyos-arkts/d2h@latest doctor --agent vscode
 ```
-AppGraph 保持独立仓库。Preflight 安装器始终解析 `Harmony-Ai-Tool/appgraph` 的 `main` 当前提交，按精确 SHA 隔离缓存到 `~/.android-to-hmos/tools/`；远端不可达时 Preflight 失败。
+查看升级状态并重新安装：
-## CLI 与校验
-```text
-droid2hmos --version
-droid2hmos --help
+```bash
+npx --yes @harmonyos-arkts/d2h@latest upgrade --check --agent opencode
+npx --yes @harmonyos-arkts/d2h@latest upgrade --agent opencode --force
 ```
-本仓库不再内置 CLI Implementation，也没有 Node.js 构建入口。Task Planning 的策略、Agent 流程和 JSON 契约维护在本仓库；Facts Adapter、闭包/所有权/DAG 编译、计划落盘和所有确定性命令由独立 `droid2hmos` 包实现。生成的计划位于被迁移 Android 工程的 `.migration/tasks/`，不写回任一工具仓库。
-Migration Kernel 在独立 CLI 中实现 `inspect → guard → execute → record`：阶段只是解释性快照，AI 仍自主决定批次和实现方式；命令前置条件、失败重试分类、证据新鲜度和最终完成条件由确定性代码检查。正常流程不依赖 AI 猜测“已经到达哪个节点”，也不要求写入 `.migration/state.json`。
-报告通过只证明已知 facts 有记录，不证明迁移成功。最终标准始终是：HarmonyOS 应用中的所有页面、控件、导航、Dialog 和业务功能与 Android 的外部可观察行为一致，并通过真实设备端到端验证。
-Windows 下所有 Gradle/Hvigor 测试与构建均由 Preflight 的有限命令运行器执行：禁用 Daemon、禁止输出管道、日志直接落盘并设置超时，避免构建成功后 OpenCode 因继承的输出句柄永久卡死。
-## AppGraph 静态 UTG
-AppGraph 与 droid2hmos 的包、精确版本和命令能力只在 `skills/managing-d2h-toolchain/toolchain.json` 中声明。其他 Agent/Skill 直接使用已检查的 CLI，不再维护依赖块；`npm run check` 验证清单与环境约束一致。D2H 安装器与 `managing-d2h-toolchain/scripts/manage-toolchain.mjs` 均使用这份清单；Skill 脚本可在没有 D2H 命令时独立执行。
-主流程加载 `d2h-utg-static-generate` 完成 Android 静态分析，由 Skill 内部调用 `droid2hmos analyze android` 生成受管 Facts，再复用本次 AppGraph 构建基础 UTG、完成 AI 源码核验与独立修补，统一重建并输出离线 `utg.html`。主流程不另行调用分析 CLI，图生成不重复执行 AppGraph 分析。生成后的原始图和 facts 保持只读，不操作设备。
-主流程操作步骤见 [Skill 的迁移主流程入口](skills/d2h-utg-static-generate/SKILL.md)。独立生成 UTG 可运行：
+只检查主机环境：
 ```bash
-python skills/d2h-utg-static-generate/scripts/generate.py --project-root <Android源码> --workspace <迁移现场>/.migration/utg
+npx --yes @harmonyos-arkts/d2h@latest --check-env --output-dir ./environment-report
 ```
-可用 `--appgraph <app-graph.json>` 消费现有图。Agent 阅读 `review-worklist.json`、核对源码后填写 `discoveries.json`，用相同命令加 `--force` 重建；源码和输入图变化会拒绝旧修补。完整契约见 [新 Skill](skills/d2h-utg-static-generate/SKILL.md)。静态到达性不是运行时确认；缺少到达规则或执行选择器的页面不安排采集。设备采集通过现有 AI Skill 的已有 `page.json` 入口执行。
-验证：
+查看全部参数：
 ```bash
-python -X utf8 -m unittest discover -s skills/d2h-utg-static-generate/tests -v
-python -X utf8 -m unittest discover -s skills/d2h-utg-ai-generate/tests -v
+npx --yes @harmonyos-arkts/d2h@latest --help
 ```
+项目地址：<https://github.com/Harmony-Ai-Tool/android-to-hmos-migration>

package/agents/d2h.md CHANGED Viewed

@@ -15,7 +15,7 @@ description: Android 应用到 HarmonyOS 的 AI 驱动迁移主 Agent；按迁
 ## 产物边界
-- `.migration/spec/` 中的 Facts 是范围索引，不替代 Android 源码阅读。
+- `.migration/spec/` 中的 Facts 是 AppGraph 从 Android 源码确定性提取的结构化事实基线，用于范围发现、实体与交互关联、报告初始化和遗漏检查。Facts 可能包含 unresolved 项或存在抽取遗漏，不能替代对 Android 源码及必要运行行为的阅读核验。
 - `.migration/utg/page.json` 是页面、到达路径和导航计划的输入，也是页面 Spec 使用的运行路径依据。
 - `.migration/page-specs/pages.json` 保存 AI 作出的页面范围、顺序、评分和证据决策。
 - 每个 `.migration/page-specs/page_NNNN_<name>-<id>/` 只包含 `spec.md`。不得生成 `ui-design.md`，也不得复制截图或 `view.xml` 到页面包。
@@ -85,14 +85,14 @@ description: Android 应用到 HarmonyOS 的 AI 驱动迁移主 Agent；按迁
 ### 五、逐页代码串行开发
-加载 `d2h-page-develop`，以严格串行方式执行页面开发。任意时刻最多只能有一个页面处于开发或修复状态：
+加载 `d2h-page-develop`，由当前主 Agent 以严格串行方式执行页面开发。任意时刻最多只能有一个页面处于开发或修复状态，页面实现、构建、测试、报告、提交和账本更新不得委派给独立 worker 或其他子 Agent：
 1. 主 Agent 按 `batch_report.md` 选择顺序最前且未达到 `implemented/passed/passed` 的页面。
-2. 只派发一个独立 page-worker，且该 worker 只负责当前一个页面。worker 必须加载 `d2h-page-develop`，不得领取、预研或修改后续页面。
+2. 主 Agent 只处理当前一个页面，不得领取、预研或修改后续页面，并负责执行 `d2h-page-develop` 定义的完整单页闭环。
 3. 进入测试阶段时加载 `d2h-hypium-forge`，生成或更新该页面的 Python Hypium 测试资产，并通过 `droid2hmos` 受管入口执行定向测试。
 4. 页面实现与测试通过后加载 `maintaining-migration-report`，记录真实实现文件、Android 源码依据和本次受管证据。
-5. worker 完成实现提交并原位更新 `batch_report.md`；主 Agent 独立复核实现、构建、测试、证据、提交和工作区状态。
-6. 当前页面未闭环、仍有页面所属未提交修改或复核失败时，只能继续修复当前页面。当前页面完整闭环并通过主 Agent 复核后，才能按顺序选择并派发下一页。
+5. 主 Agent 完成当前页面的实现提交，原位更新 `batch_report.md`，并按 Skill 的页面完成清单复核实现、构建、测试、证据、提交和工作区状态。
+6. 当前页面未闭环、仍有页面所属未提交修改或复核失败时，只能继续修复当前页面。当前页面完整闭环并通过复核后，才能按顺序选择下一页。
 ### 六、批次回归与最终门禁
@@ -101,20 +101,13 @@ description: Android 应用到 HarmonyOS 的 AI 驱动迁移主 Agent；按迁
 1. 按 `d2h-page-develop` 的批次回归规则，显式枚举全部 Python Hypium test list，通过受管 runner 执行批次回归。Python runner 不使用 `--all`。
 2. 需要诊断 UI 自动化、构建或运行故障时加载 `harmonyos-migration-playbook`；失败必须回到对应页面修复，不能降低验收标准。
 3. 更新并校验迁移报告及 final acceptance。
-4. 按 Migration Kernel 最终门禁执行独立的 ArkTS full-run：
-   ```text
-   droid2hmos test harmony <ANDROID_PROJECT> --runner arkts --all ...
-   ```
-5. 执行 `droid2hmos complete <ANDROID_PROJECT>`。只有成功退出后才能宣布迁移完成。
-6. 执行 `droid2hmos report render <ANDROID_PROJECT>` 生成交付报告。
-7. 完整结束或明确中止后加载 `reviewing-migration-process` 生成流程复盘；复盘不是完成条件。
+4. 完整结束或明确中止后加载 `reviewing-migration-process` 生成流程复盘；复盘不是完成条件。
 ## 持续执行与人工介入
 迁移开始后默认连续执行，不得在页面或阶段之间询问“是否继续”。只有以下情况允许暂停：
+- 禁止依据模型自行估算的“剩余 token”“上下文百分比”“本轮剩余容量”等决定停止、收尾、汇报后等待或要求用户开启新会话。此类估算不可信。
 - 用户主动中断、修改需求或发出新指令。
 - 真机签名、开发者账号、权限或凭据必须由用户完成，且没有可用替代方案。
 - 设备、CLI、构建环境或外部服务持续不可用，完成自诊和有限重试后仍确认是外部问题。
@@ -152,6 +145,5 @@ description: Android 应用到 HarmonyOS 的 AI 驱动迁移主 Agent；按迁
 - Facts 或 UTG 遗漏、但经源码或运行时发现的行为也已实现并验证。
 - 无法等价的差异已经明确呈现，没有被静默标记为完成。
 - 每个页面实现都有可恢复提交，用户已有和无关改动未被覆盖。
-- ArkTS full-run 和 `droid2hmos complete <ANDROID_PROJECT>` 均成功。
 完成报告不等于完成迁移；机器门禁成功也不能替代对真实用户可观察结果的 AI 审查。

package/dist/bin/install-opencode.js CHANGED Viewed

@@ -150,6 +150,18 @@ try {
                 installVSCode({ sourceDir: options.sourceDir, extensionDir, remote, dryRun: options.dryRun });
             else
                 installOpenCode({ ...options, remote });
+            if (!options.dryRun) {
+                const target = options.agent === 'vscode' ? 'VS Code HarmonyOS Dev Assistant' :
+                    options.agent === 'deveco' ? 'DevEco Code' : 'OpenCode';
+                const packageVersion = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8')).version;
+                console.log('\n============================================================');
+                console.log(`[D2H] Installation successful / 安装成功`);
+                console.log(`Target / 目标: ${target}`);
+                console.log(`Version / 版本: ${packageVersion}`);
+                console.log('Agent: d2h');
+                console.log(`Next / 下一步: restart ${target}, then select the d2h Agent.`);
+                console.log('============================================================');
+            }
         }
     }
 }

package/dist/src/install-opencode.js CHANGED Viewed

@@ -41,6 +41,57 @@ function digest(file) {
         hash.update(name).update(digest(path.join(file, name)));
     return hash.digest('hex');
 }
+function parseJsonConfig(source) {
+    let output = '';
+    let quoted = false;
+    let escaped = false;
+    for (let index = 0; index < source.length; index++) {
+        const character = source[index];
+        if (quoted) {
+            output += character;
+            if (escaped)
+                escaped = false;
+            else if (character === '\\')
+                escaped = true;
+            else if (character === '"')
+                quoted = false;
+            continue;
+        }
+        if (character === '"') {
+            quoted = true;
+            output += character;
+            continue;
+        }
+        if (character === '/' && source[index + 1] === '/') {
+            while (index < source.length && source[index] !== '\n')
+                index++;
+            output += '\n';
+            continue;
+        }
+        if (character === '/' && source[index + 1] === '*') {
+            index += 2;
+            while (index < source.length && !(source[index] === '*' && source[index + 1] === '/'))
+                index++;
+            index++;
+            continue;
+        }
+        output += character;
+    }
+    return JSON.parse(output.replace(/,\s*([}\]])/g, '$1'));
+}
+function configFileFor(root, agent) {
+    return path.join(root, agent === 'deveco' ? 'deveco.jsonc' : 'opencode.json');
+}
+function updateAgentConfig(config, remote) {
+    updateMetricsPlugin(config, remote);
+    config.agent ??= {};
+    const previous = config.agent.d2h ?? {};
+    config.agent.d2h = {
+        ...previous,
+        tools: { ...previous.tools, read: true, write: true, edit: true, bash: true },
+        permission: { ...previous.permission, edit: 'allow', bash: 'allow', external_directory: 'allow' },
+    };
+}
 export function inspectInstallation(configDir) {
     const root = path.resolve(configDir);
     const receipt = path.join(root, '.d2h-installation.json');
@@ -55,6 +106,18 @@ export function inspectInstallation(configDir) {
         const target = path.join(root, entry.kind, entry.name);
         return !stat(target) || digest(target) !== entry.digest;
     }).map(entry => `${entry.kind}/${entry.name}`);
+    const configFile = configFileFor(root, value.agent);
+    try {
+        const config = parseJsonConfig(fs.readFileSync(configFile, 'utf8'));
+        const d2h = config.agent?.d2h;
+        if (!d2h || !['read', 'write', 'edit', 'bash'].every(tool => d2h.tools?.[tool] === true) ||
+            !['edit', 'bash', 'external_directory'].every(permission => d2h.permission?.[permission] === 'allow')) {
+            changed.push(path.basename(configFile));
+        }
+    }
+    catch {
+        changed.push(path.basename(configFile));
+    }
     return { status: changed.length ? 'failed' : 'passed', packageVersion: value.packageVersion, agent: value.agent,
         summary: changed.length ? `changed or missing: ${changed.join(', ')}` : `${value.entries.length} installed definitions verified` };
 }
@@ -81,12 +144,12 @@ export function installOpenCode({ sourceDir, configDir, agent = 'opencode', link
         contains(sourceRoot, configRoot) || contains(configRoot, sourceRoot)) {
         throw new Error(`refusing unsafe OpenCode config directory: ${configDir}`);
     }
-    const configFile = path.join(configRoot, 'opencode.json');
+    const configFile = configFileFor(configRoot, agent);
     const existingConfig = stat(configFile);
     if (existingConfig?.isSymbolicLink())
         throw new Error(`refusing linked OpenCode config file: ${configFile}`);
-    const config = existingConfig ? JSON.parse(fs.readFileSync(configFile, 'utf8')) : {};
-    updateMetricsPlugin(config, remote);
+    const config = existingConfig ? parseJsonConfig(fs.readFileSync(configFile, 'utf8')) : {};
+    updateAgentConfig(config, remote);
     const configText = JSON.stringify(config, null, 2) + '\n';
     const entries = [];
     for (const kind of ['skills', 'agents']) {

package/dist/src/install-vscode.js CHANGED Viewed

@@ -77,8 +77,9 @@ function updateConfig(source, remote) {
     const value = JSON.parse(source);
     value.agent ??= {};
     value.agent.d2h = { ...value.agent.d2h, description: modeLabel,
-        tools: { ...value.agent.d2h?.tools, read: true, write: true, edit: true },
-        permission: { ...value.agent.d2h?.permission, read: 'allow', edit: 'allow' } };
+        tools: { ...value.agent.d2h?.tools, read: true, write: true, edit: true, bash: true },
+        permission: { ...value.agent.d2h?.permission, read: 'allow', edit: 'allow',
+            bash: 'allow', external_directory: 'allow' } };
     delete value.agent.d2h.permission.write;
     value.plugin ??= [];
     if (!Array.isArray(value.plugin))

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@harmonyos-arkts/d2h",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Install Android-to-HarmonyOS migration agents and skills into OpenCode or DevEco Code",
   "type": "module",
   "bin": {

package/skills/d2h-page-develop/SKILL.md CHANGED Viewed

@@ -105,7 +105,7 @@ After every page task is complete:
 2. Run one managed command with all required `--test-list` values on the qualified device, using only refs actually asserted by the batch.
 3. Require non-zero execution with no failures, errors, or ignored tests.
 4. Append the managed batch evidence and timestamp to `batch_report.md`, then update and validate the migration report.
-5. A targeted Python batch receipt does not replace the separate ArkTS `--all` receipt required by the Migration Kernel final completion gate.
+5. Treat this managed Python batch as the primary application-wide regression for the page-spec workflow. Run ArkTS `--all` only as supplemental coverage when the project maintains relevant ArkTS ohosTest assets; it is not a fixed completion gate for this workflow.
 ## Final result

package/skills/d2h-page-spec-generate/SKILL.md CHANGED Viewed

@@ -21,7 +21,7 @@ Resolve these paths before writing:
 - `legacy_tasks_root`: optional `<migration_root>/.migration/tasks`; use existing briefs, core facts, source context, and acceptance files only as read-only evidence from an older flow.
 - `output_root`: default `<migration_root>/.migration/page-specs`.
-Facts and legacy Task artifacts are indexes, not substitutes for Android source. Existing HarmonyOS files and tests are implementation evidence, not proof that a behavior is complete.
+Facts are the deterministic structured evidence baseline extracted from Android source. They support scope discovery, entity and interaction linkage, report initialization, and omission checks, but unresolved items and extraction gaps mean they are not substitutes for reading Android source and, where necessary, observing runtime behavior. Legacy Task artifacts are read-only indexes from the older flow. Existing HarmonyOS files and tests are implementation evidence, not proof that a behavior is complete.
 ## Output contract