@harmonyos-arkts/d2h 0.1.8 → 0.1.9

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 (3) hide show
  1. package/README.md +13 -13
  2. package/agents/d2h.md +2 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -37,12 +37,12 @@ android-to-hmos-migration/
37
37
  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 脚本随本版本提供：
38
38
 
39
39
  ```sh
40
- npx --yes @harmonyos-arkts/d2h@0.1.8 install --agent opencode
41
- npx --yes @harmonyos-arkts/d2h@0.1.8 install --agent vscode
42
- npx --yes @harmonyos-arkts/d2h@0.1.8 install --agent vscode --remote
43
- npx --yes @harmonyos-arkts/d2h@0.1.8 doctor --agent vscode
44
- npx --yes @harmonyos-arkts/d2h@0.1.8 upgrade --check
45
- npx --yes @harmonyos-arkts/d2h@0.1.8 --check-env --output-dir ./environment-report
40
+ npx --yes @harmonyos-arkts/d2h@0.1.9 install --agent opencode
41
+ npx --yes @harmonyos-arkts/d2h@0.1.9 install --agent vscode
42
+ npx --yes @harmonyos-arkts/d2h@0.1.9 install --agent vscode --remote
43
+ npx --yes @harmonyos-arkts/d2h@0.1.9 doctor --agent vscode
44
+ npx --yes @harmonyos-arkts/d2h@0.1.9 upgrade --check
45
+ npx --yes @harmonyos-arkts/d2h@0.1.9 --check-env --output-dir ./environment-report
46
46
  ```
47
47
 
48
48
  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` 才会替换全局链接，不会修改链接指向的源码目录。
@@ -57,27 +57,27 @@ Claude Code：
57
57
  OpenCode（Node.js 22.5–24.x，支持 Windows/macOS/Linux，无需克隆仓库或安装 Shell）：
58
58
 
59
59
  ```sh
60
- npx --yes @harmonyos-arkts/d2h@0.1.8
60
+ npx --yes @harmonyos-arkts/d2h@0.1.9
61
61
  ```
62
62
 
63
63
  安装器把 npm 包内的 `skills/` 和 `agents/` 复制到当前用户的 OpenCode 全局配置目录。更新已有安装时使用：
64
64
 
65
65
  ```sh
66
- npx --yes @harmonyos-arkts/d2h@0.1.8 --force
66
+ npx --yes @harmonyos-arkts/d2h@0.1.9 --force
67
67
  ```
68
68
 
69
69
  先预览或指定目录：
70
70
 
71
71
  ```sh
72
- npx --yes @harmonyos-arkts/d2h@0.1.8 --dry-run
73
- npx --yes @harmonyos-arkts/d2h@0.1.8 --config-dir /path/to/opencode
72
+ npx --yes @harmonyos-arkts/d2h@0.1.9 --dry-run
73
+ npx --yes @harmonyos-arkts/d2h@0.1.9 --config-dir /path/to/opencode
74
74
  ```
75
75
 
76
76
  默认目标为 OpenCode，也可显式使用 `--agent opencode`。安装到 DevEco Code：
77
77
 
78
78
  ```sh
79
- npx --yes @harmonyos-arkts/d2h@0.1.8 --agent deveco
80
- npx --yes @harmonyos-arkts/d2h@0.1.8 --agent deveco --force
79
+ npx --yes @harmonyos-arkts/d2h@0.1.9 --agent deveco
80
+ npx --yes @harmonyos-arkts/d2h@0.1.9 --agent deveco --force
81
81
  ```
82
82
 
83
83
  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` 的参数顺序不影响结果。
@@ -92,7 +92,7 @@ sh ./install-opencode.sh
92
92
 
93
93
  该脚本把 `skills/` 和 `agents/` 安装到当前用户的 OpenCode 全局配置目录，不读取或改写 `opencode.json`。更新已有安装时使用 `--force`；本地开发需要让全局安装实时跟随仓库时使用 `--link --force`。可通过 `--config-dir` 和 `--source-dir` 适配自定义目录，先用 `--dry-run` 检查操作。完整参数见 `sh ./install-opencode.sh --help`。
94
94
 
95
- npm 安装器支持同样的参数，完整说明见 `npx --yes @harmonyos-arkts/d2h@0.1.8 --help`。本地开发可使用 `npm run build && node dist/bin/install-opencode.js --source-dir /path/to/repository --link --force`。Windows 下 Agent 文件符号链接需要开发者模式或管理员权限；默认复制模式不需要。不要将 `npx` 缓存作为长期链接来源，缓存清理后链接可能失效。
95
+ npm 安装器支持同样的参数，完整说明见 `npx --yes @harmonyos-arkts/d2h@0.1.9 --help`。本地开发可使用 `npm run build && node dist/bin/install-opencode.js --source-dir /path/to/repository --link --force`。Windows 下 Agent 文件符号链接需要开发者模式或管理员权限；默认复制模式不需要。不要将 `npx` 缓存作为长期链接来源，缓存清理后链接可能失效。
96
96
 
97
97
  维护者发布：安装开发依赖后运行 `npm run build`，将 TypeScript 源码编译到 `dist/`；`npm run check && npm test` 检查类型并测试编译后的 CLI，然后 `npm publish`。npm 包使用 `dist/bin/install-opencode.js` 作为入口，包含编译后的运行代码、Agent、完整 Skill 资源树及 schema，不包含 TypeScript 源码、研发文档和测试；发布时不会自动修改用户配置，只有显式执行 `npx` 安装器才会安装。
98
98
 
package/agents/d2h.md CHANGED
@@ -50,6 +50,8 @@ description: Android 应用到 HarmonyOS 的 AI 驱动迁移主 Agent；按迁
50
50
 
51
51
  ### 一、启动或恢复
52
52
 
53
+ 加载 `managing-d2h-toolchain` skill 完成基础工具链预检和安装，仅需要执行一次
54
+
53
55
  加载 `preparing-migration-workspace`，完成工具链、Android/HarmonyOS 工程、迁移工作区、配置、基线和设备检查。迁移工作区使用 Android 工程父目录下的 `<工程名>-migration/.migration/`，不得写入 Android 工程内部。
54
56
 
55
57
  设备暂不可用时可以继续静态分析、页面规划和不依赖设备的实现，但交互页面不能标记为验证通过，也不能进入最终完成门禁。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@harmonyos-arkts/d2h",
3
- "version": "0.1.8",
3
+ "version": "0.1.9",
4
4
  "description": "Install Android-to-HarmonyOS migration agents and skills into OpenCode or DevEco Code",
5
5
  "type": "module",
6
6
  "bin": {