@harmonyos-arkts/d2h 0.1.2 → 0.1.5

package/docs/environment-check.md

@@ -0,0 +1,86 @@
+# 迁移工具环境检查
+
+先手动安装 Node.js 22.5–24.x，确认 `node --version`。脚本只使用 Node 内置模块，无需 npm install，支持 Windows/macOS/Linux。
+
+npx 集成入口（包含本次更新的包发布后可用）：
+
+```sh
+npx --yes @harmonyos-arkts/d2h@0.1.5 --check-env --output-dir ./environment-report
+```
+
+本地构建后：`node dist/bin/install-opencode.js --check-env`。检查参数在 --check-env 后传入；使用 --check-env --help 查看。检查模式不执行 Agent/Skill 安装；不能与 --force、--agent、--config-dir 等安装参数混用，误用时返回参数错误。npx 自身可能下载并缓存 npm 包。
+
+```powershell
+node scripts/check-environment.mjs --output-dir D:/reports/hmos-environment
+```
+
+```sh
+node scripts/check-environment.mjs --output-dir ~/reports/hmos-environment
+```
+
+## 当前检查项
+
+| 项目 | 条件 |
+| --- | --- |
+| Node.js | 当前运行时为 24.x |
+| Git | git --version 成功 |
+| npm | npm --version 成功 |
+| Java/JDK | java -version 成功，不固定 JDK 主版本 |
+| Python | 找到 Python 3.10+，优先 PYTHON_BINARY |
+| AppGraph | appgraph --version 成功且匹配 D2H 锁定的 0.0.10 |
+| droid2hmos | droid2hmos --version 成功且匹配 D2H 锁定的 0.0.11 |
+| DevEco 工具链目录 | 安装目录存在 |
+| Hvigor | 版本命令成功 |
+| ohpm | 版本命令成功 |
+| DevEco CLI | devecocli --version 成功 |
+| 开发者账号 | DevEco CLI 登录状态成功，报告不保留账号输出 |
+| HarmonyOS SDK 目录 | 辅助诊断，不作为必需门禁 |
+
+按需检查：指定插件生产脚本导入 json5 时检查相同 Python 的 json5 模块；传入 --android-project 时检查源码 Gradle 配置标记；传入 --harmony-project 时枚举工程可用 SDK 版本。
+
+SQLite/WASM 随 Node 提供，不单独检测。Android SDK/ADB/模拟器/构建、CLI capability/help、Agent 宿主、插件安装/启用/引用、所有设备发现和 Shell 检查均不执行。
+
+## 参数
+
+兼容组合以 `skills/managing-d2h-toolchain/toolchain.json` 为准；`skills/managing-d2h-toolchain/environment-requirements.json` 提供检查器的版本边界，构建检查确保 Node、AppGraph 与 droid2hmos 约束与兼容组合一致。默认 Node 为 `>=22.5.0 <25.0.0`，Python 为 `>=3.10.0`；其余未锁定的工具仅检查可用性。
+
+每项可配置 `minimum`（含下界）和 `maximumExclusive`（不含上界），支持 1–4 段纯数字版本，不能使用 latest、通配符、^ 或 ~。例如将 appgraph 改为 `{ "minimum": "0.0.8" }`，即可检测最低版本。保留全部工具键，无版本要求时使用 null。未知工具、无效边界或空区间会报错，不静默放宽约束。
+
+可使用自定义文件：
+
+```sh
+npx --yes @harmonyos-arkts/d2h@0.1.5 --check-env --requirements ./environment-requirements.json
+```
+
+报告记录实际配置路径和约束；版本不符合时，命令行显示当前版本、要求和修复指导。此配置仅控制诊断命令，不修改 npm 包自身 engines 或 droid2hmos 的 preflight 规则。
+
+- --plugin-root：用于判断插件生产 Python 脚本是否需要 json5，默认当前脚本所在仓库。
+- --requirements：覆盖默认版本配置文件路径。
+- --android-project：Android 源码目录，仅检查配置标记，不要求 Gradle Wrapper。
+- --harmony-project：在该工程执行 DevEco CLI 的只读 SDK 版本枚举。
+- --sdk-path：声明 SDK 根目录。
+- --timeout：每条命令超时秒数，1–60，默认 15。
+- --output-dir：报告目录，默认当前目录的 environment-report。
+- --help：使用说明。
+
+不再提供 --host、--host-binary、--skip-devices 参数。
+
+工具环境变量：DEVECO_STUDIO_HOME、DEVECO_HOME、DROID2HMOS_HVIGOR、DROID2HMOS_OHPM、DEVECO_CLI_BINARY、PYTHON_BINARY、HARMONYOS_SDK_HOME、OHOS_SDK_HOME、DEVECO_SDK_HOME。macOS 包含 DevEco 默认 Contents 目录和常见 Python 安装路径。
+
+## 输出
+
+命令行先显示总体结果，然后逐项显示 `[通过]`、`[未通过]`、`[提醒]` 或 `[未检查]` 及版本/原因。未通过、提醒和未检查项下方直接显示修复指导，最后显示报告路径。完整明细、证据和修复指导保存在 environment.md/environment.json，重复执行覆盖。脚本只提供指导，不自动安装或修改环境。
+
+退出码：0=必需检查通过；1=必需失败或执行错误；2=必需项未检查或参数错误。SDK 辅助诊断 warning 不阻断通过。
+
+本报告仅确认上述主机依赖，不代表 CLI 分析能力、Agent 安装、项目构建、签名、SDK API 匹配、设备运行或端到端验收已通过。后续项目门禁仍由 droid2hmos preflight/test/device/complete 负责。脚本不自动安装、登录、构建或修改配置；被调用工具自身可能写缓存。
+
+## 源码依据
+
+2026-10-13 复核：AppGraph origin/dev c1d2ed1（仓库版本 0.0.8）、droid2hmos dev 0caabce（仓库版本 0.0.7）、插件 origin/skill 4a21758（仓库版本 0.1.3）。此前发现的插件 Agent 命名差异不属于当前环境检查范围。
+
+测试：
+
+```sh
+node --test --test-concurrency=1 scripts/tests/environment.test.mjs
+```

package/opencode/agents.json

@@ -1,5 +1,5 @@
 {
-  "android-to-hmos-00-orchestrator": {
+  "d2h_v2": {
     "mode": "all",
     "hidden": false,
     "permissions": {

package/opencode/vscode-d2h-package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@harmonyos-arkts/d2h-vscode-plugin",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "src/index.js"
+}

package/opencode/vscode-d2h-plugin.mjs

@@ -0,0 +1,29 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const agentFile = path.join(packageRoot, 'agents', 'd2h.md');
+const skillsDirectory = path.join(packageRoot, 'skills');
+
+export const plugin = async () => ({
+  config(config) {
+    config.agent ??= {};
+    const previous = config.agent.d2h ?? {};
+    config.agent.d2h = {
+      ...previous,
+      description: '安卓转鸿蒙',
+      mode: 'primary',
+      hidden: false,
+      prompt: fs.readFileSync(agentFile, 'utf8'),
+      tools: { ...previous.tools, question: true, task: true, read: true, write: true, edit: true },
+      permission: { ...previous.permission, read: 'allow', edit: 'allow' },
+    };
+    config.skills ??= {};
+    const paths = Array.isArray(config.skills.paths) ? config.skills.paths : [];
+    if (!paths.includes(skillsDirectory)) paths.push(skillsDirectory);
+    config.skills.paths = paths;
+  },
+});
+
+export default plugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harmonyos-arkts/d2h",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Install Android-to-HarmonyOS migration agents and skills into OpenCode or DevEco Code",
   "type": "module",
   "bin": {
@@ -15,18 +15,20 @@
     "opencode/",
     ".claude-plugin/",
     "install-opencode.sh",
+    "scripts/check-environment.mjs",
+    "docs/environment-check.md",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "check": "tsc --noEmit && npm run build && node dist/scripts/check-skill-refs.js",
-    "test": "npm run build && node --test dist/test/*.test.js",
+    "check": "tsc --noEmit && npm run build && node dist/scripts/check-skill-refs.js && node dist/scripts/check-toolchain.js",
+    "test": "npm run build && node --test dist/test/*.test.js scripts/tests/*.test.mjs",
     "prepack": "npm run build",
     "prepublishOnly": "npm run check && npm test"
   },
   "engines": {
-    "node": ">=20 <25"
+    "node": ">=22.5.0 <25.0.0"
   },
   "repository": {
     "type": "git",

package/schemas/task-envelope.schema.json

@@ -1,15 +1,44 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://harmonyos-ai.dev/schemas/task-envelope.schema.json",
-  "title": "Android to HarmonyOS Task Envelope Page",
+  "title": "Android to HarmonyOS Model Input Envelope Page",
   "type": "object",
-  "required": ["taskEnvelopeVersion", "taskPlanSha256", "task", "brief", "coreFacts", "sourceContext", "continuation"],
+  "required": ["taskEnvelopeVersion", "taskPlanSha256", "targetKind", "targetId", "task", "pageWorkPackage", "contract", "brief", "coreFacts", "dependencyInterfaces", "acceptance", "sourceContext", "continuation"],
   "properties": {
-    "taskEnvelopeVersion": { "const": "1.0.0" },
+    "taskEnvelopeVersion": { "const": "3.0.0" },
     "taskPlanSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
-    "task": { "type": "object" },
+    "targetKind": { "enum": ["resolution-task", "page-work-package"] },
+    "targetId": { "type": "string", "pattern": "^(task|package):[a-f0-9]{16}$" },
+    "task": { "type": ["object", "null"] },
+    "pageWorkPackage": { "type": ["object", "null"] },
+    "contract": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["executionPlanSha256", "baseline", "task"],
+          "properties": {
+            "executionPlanSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+            "baseline": { "type": "object" },
+            "task": { "type": "object" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["executionPlanSha256", "baseline", "pageWorkPackage"],
+          "properties": {
+            "executionPlanSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+            "baseline": { "type": "object" },
+            "pageWorkPackage": { "type": "object" }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
     "brief": { "type": "string", "minLength": 1 },
     "coreFacts": { "type": "array" },
+    "dependencyInterfaces": { "type": "array", "items": { "type": "object" } },
+    "acceptance": { "type": "object" },
     "sourceContext": {
       "description": "Bounded source location indexes only. Source text/snippets are forbidden.",
       "type": "array",
@@ -26,6 +55,30 @@
       "additionalProperties": false
     }
   },
+  "allOf": [
+    {
+      "if": { "properties": { "targetKind": { "const": "resolution-task" } } },
+      "then": {
+        "properties": {
+          "targetId": { "pattern": "^task:[a-f0-9]{16}$" },
+          "task": { "type": "object" },
+          "pageWorkPackage": { "const": null },
+          "contract": { "required": ["task"] }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "targetKind": { "const": "page-work-package" } } },
+      "then": {
+        "properties": {
+          "targetId": { "pattern": "^package:[a-f0-9]{16}$" },
+          "task": { "const": null },
+          "pageWorkPackage": { "type": "object" },
+          "contract": { "required": ["pageWorkPackage"] }
+        }
+      }
+    }
+  ],
   "$defs": {
     "sourceIndex": {
       "type": "object",
@@ -41,6 +94,7 @@
             "symbol": { "type": ["string", "null"] },
             "kind": { "type": "string" },
             "type": { "type": "string" },
+            "capabilityRef": { "type": "string" },
             "line": { "type": ["integer", "null"], "minimum": 1 },
             "startLine": { "type": "integer", "minimum": 1 },
             "endLine": { "type": ["integer", "null"], "minimum": 1 }