@buaa_smat/hometrans 0.1.14 → 0.1.16

package/dist/cli/uninstall.js

@@ -22,9 +22,13 @@ import { removeEnvVars } from './env-vars.js';
 const execFileAsync = promisify(execFile);
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-/** Names + readable count of env vars that have a non-empty value in config. */
-function plannedEnvVarNames(env) {
-    return MACHINE_ENV_KEYS.filter((k) => (env[k] ?? '').trim().length > 0);
+/**
+ * Machine env var names that `ht init` may have set and that have a non-empty
+ * value in config.env: the SDK paths / tool dir plus the mirrored unified model
+ * fields (HOMETRANS_MODEL_*, kept in sync with autotest.unified_model on load).
+ */
+function plannedEnvVarNames(config) {
+    return MACHINE_ENV_KEYS.filter((k) => (config.env[k] ?? '').trim().length > 0);
 }
 /* ------------------------------------------------------------------ */
 /*  Bundled content discovery                                          */
@@ -398,7 +402,8 @@ export async function uninstallCommand() {
         console.log(chalk.gray('  Reinstall hometrans or manually remove skill/agent directories from your editors.\n'));
         return;
     }
-    const { editors, env } = await loadHomeTransConfig();
+    const config = await loadHomeTransConfig();
+    const { editors } = config;
     const plan = {
         deletions: [],
         modifications: [],
@@ -409,9 +414,9 @@ export async function uninstallCommand() {
     for (const editor of editors) {
         await buildPlanForEditor(editor, skillNames, agentEntries, plan);
     }
-    // Env vars to remove come from config.json `env`; the ~/.hometrans dir
-    // (which holds config.json) is deleted last.
-    plan.envVars = plannedEnvVarNames(env);
+    // Env vars to remove come from config.json (`env` + the unified model
+    // fields); the ~/.hometrans dir (which holds config.json) is deleted last.
+    plan.envVars = plannedEnvVarNames(config);
     const configDir = getConfigDir();
     if (await dirExists(configDir)) {
         plan.configDir = configDir;

package/dist/context/index.js

@@ -10,8 +10,25 @@ import {
 } from "arkanalyzer";
 
 // src/cli/config-store.ts
+import { readFileSync } from "node:fs";
 import path from "node:path";
 import os from "node:os";
+function getConfigDir() {
+  return path.join(os.homedir(), ".hometrans");
+}
+function getConfigPath() {
+  return path.join(getConfigDir(), "config.json");
+}
+function readConfigEnvFieldSync(key) {
+  try {
+    const raw = readFileSync(getConfigPath(), "utf-8");
+    const parsed = JSON.parse(raw);
+    const v = parsed?.env?.[key];
+    return typeof v === "string" ? v : "";
+  } catch {
+    return "";
+  }
+}
 function expandHome(p) {
   if (!p) return p;
   if (p === "~") return os.homedir();
@@ -594,10 +611,10 @@ async function extractCommitContext(input) {
   const { projectPath, commitId } = input;
   const mode = input.mode ?? "default";
   const ohosSdkPath = expandHome(
-    input.ohosSdkPath ?? process.env.OHOS_SDK_PATH ?? ""
+    input.ohosSdkPath || process.env.OHOS_SDK_PATH || readConfigEnvFieldSync("OHOS_SDK_PATH")
   );
   const hmsSdkPath = expandHome(
-    input.hmsSdkPath ?? process.env.HMS_SDK_PATH ?? ""
+    input.hmsSdkPath || process.env.HMS_SDK_PATH || readConfigEnvFieldSync("HMS_SDK_PATH")
   );
   if (!projectPath) {
     throw new Error("extractCommitContext: projectPath is required");

package/env-requirements.json

@@ -1,181 +1,177 @@
-{
-  "$comment": [
-    "Declarative environment requirements for `ht init`.",
-    "`ht init` reads this file to (1) detect external tools and (2) report which",
-    "skills/agents are BLOCKED / LIMITED / OK by anything missing.",
-    "",
-    "tools[<id>]:",
-    "  source        'path'    -> locate a runnable command (where/which) trying each alias;",
-    "                'env-dir' -> a directory existence check (envVar resolved from ht config).",
-    "  aliases       command names to try in order (e.g. python, python3, py). First hit wins.",
-    "  verify        argv passed to the resolved command to print its version (existence proof too).",
-    "                Use a flag that prints-and-exits. NEVER use `python -v` (verbose REPL -> hangs);",
-    "                use `python --version`.",
-    "  versionStream 'stdout' (default) or 'stderr' (java -version prints to stderr).",
-    "  versionRegex  capture group(s) for the numeric version in the verify output.",
-    "  version       default required range for this tool, {min, max} as [min, max) — min",
-    "                inclusive, max exclusive; either may be null/omitted = unbounded. A",
-    "                requirement dependency may override this.",
-    "  fallback      when not on PATH, probe <base>/<segments>/<exe>. base is a config env key",
-    "                (DEVECO_SDK_HOME / DEVECO_HOME). Mirrors how the skills resolve hdc/java.",
-    "  hint          shown when the tool is missing.",
-    "",
-    "requirements[]: name + kind (skill|agent) + dependencies[] of",
-    "  { tool, level: 'required'|'optional', version?: {min,max} }.",
-    "  A missing 'required' tool -> BLOCKED; only 'optional' missing -> LIMITED; else OK."
-  ],
-
-  "tools": {
-    "deveco": {
-      "source": "env-dir",
-      "envVar": "DEVECO_SDK_HOME",
-      "hint": "set DEVECO_SDK_HOME via `ht init` (DevEco Studio install)"
-    },
-    "adb": {
-      "source": "path",
-      "aliases": ["adb"],
-      "verify": ["version"],
-      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
-      "hint": "Android SDK platform-tools (needed for Android-device capture)"
-    },
-    "hdc": {
-      "source": "path",
-      "aliases": ["hdc"],
-      "verify": ["-v"],
-      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
-      "fallback": { "base": "DEVECO_SDK_HOME", "segments": ["default", "openharmony", "toolchains"], "exe": "hdc" },
-      "hint": "ships with DevEco: <sdk>/default/openharmony/toolchains"
-    },
-    "python": {
-      "source": "path",
-      "aliases": ["python", "python3", "py"],
-      "verify": ["--version"],
-      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
-      "version": { "min": "3.10.0", "max": null },
-      "hint": "install Python >= 3.10 and add to PATH (UI-align capture/parse scripts)"
-    },
-    "uv": {
-      "source": "path",
-      "aliases": ["uv"],
-      "verify": ["--version"],
-      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
-      "hint": "https://docs.astral.sh/uv (AutoTest runs under uv)"
-    },
-    "java": {
-      "source": "path",
-      "aliases": ["java"],
-      "verify": ["-version"],
-      "versionStream": "stderr",
-      "versionRegex": "(\\d+(?:\\.\\d+){1,2})",
-      "fallback": { "base": "DEVECO_HOME", "segments": ["jbr", "bin"], "exe": "java" },
-      "hint": "any JDK 17+, or reuse DevEco jbr: <deveco>/jbr/bin"
-    },
-    "gitnexus": {
-      "source": "path",
-      "aliases": ["gitnexus"],
-      "verify": ["--version"],
-      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
-      "hint": "npm i -g gitnexus && gitnexus setup"
-    }
-  },
-
-  "requirements": [
-    {
-      "name": "hmos-spec-generate",
-      "kind": "skill",
-      "dependencies": [{ "tool": "gitnexus", "level": "required" }]
-    },
-    {
-      "name": "hmos-resources-convert",
-      "kind": "skill",
-      "dependencies": [{ "tool": "java", "level": "optional" }],
-      "note": "no java -> falls back to source res/"
-    },
-    {
-      "name": "hmos-batch-ui-align",
-      "kind": "skill",
-      "dependencies": [
-        { "tool": "python", "level": "required", "version": { "min": "3.10.0", "max": null } },
-        { "tool": "adb", "level": "optional" }
-      ],
-      "note": "adb only for page exploration"
-    },
-    {
-      "name": "hmos-incremental-ui-align",
-      "kind": "skill",
-      "dependencies": [
-        { "tool": "deveco", "level": "required" },
-        { "tool": "python", "level": "required", "version": { "min": "3.10.0", "max": null } },
-        { "tool": "hdc", "level": "required" },
-        { "tool": "adb", "level": "required" }
-      ]
-    },
-    {
-      "name": "hmos-integration-test",
-      "kind": "skill",
-      "dependencies": [
-        { "tool": "deveco", "level": "required" },
-        { "tool": "uv", "level": "required" },
-        { "tool": "hdc", "level": "required" }
-      ]
-    },
-    {
-      "name": "hmos-fix-build-errors",
-      "kind": "skill",
-      "dependencies": [{ "tool": "deveco", "level": "required" }]
-    },
-    {
-      "name": "hmos-convert-pipeline",
-      "kind": "skill",
-      "dependencies": [
-        { "tool": "deveco", "level": "required" },
-        { "tool": "uv", "level": "optional" },
-        { "tool": "hdc", "level": "optional" }
-      ],
-      "note": "test stage skippable via skip_test"
-    },
-    {
-      "name": "logic-context-builder",
-      "kind": "agent",
-      "dependencies": [{ "tool": "python", "level": "optional" }]
-    },
-    {
-      "name": "logic-coder",
-      "kind": "agent",
-      "dependencies": [{ "tool": "python", "level": "optional" }]
-    },
-    {
-      "name": "spec-generator",
-      "kind": "agent",
-      "dependencies": [{ "tool": "gitnexus", "level": "required" }]
-    },
-    {
-      "name": "build-fixer",
-      "kind": "agent",
-      "dependencies": [{ "tool": "deveco", "level": "required" }]
-    },
-    {
-      "name": "code-reviewer",
-      "kind": "agent",
-      "dependencies": [{ "tool": "deveco", "level": "optional" }]
-    },
-    {
-      "name": "review-fixer",
-      "kind": "agent",
-      "dependencies": []
-    },
-    {
-      "name": "self-tester",
-      "kind": "agent",
-      "dependencies": [
-        { "tool": "uv", "level": "required" },
-        { "tool": "hdc", "level": "required" }
-      ]
-    },
-    {
-      "name": "self-test-fixer",
-      "kind": "agent",
-      "dependencies": []
-    }
-  ]
-}
+{
+  "$comment": [
+    "Declarative environment requirements for `ht init`.",
+    "`ht init` reads this file to (1) detect external tools and (2) report which",
+    "skills/agents are BLOCKED / LIMITED / OK by anything missing.",
+    "",
+    "tools[<id>]:",
+    "  source        'path'    -> locate a runnable command (where/which) trying each alias;",
+    "                'env-dir' -> a directory existence check (envVar resolved from ht config).",
+    "  aliases       command names to try in order (e.g. python, python3, py). First hit wins.",
+    "  verify        argv passed to the resolved command to print its version (existence proof too).",
+    "                Use a flag that prints-and-exits. NEVER use `python -v` (verbose REPL -> hangs);",
+    "                use `python --version`.",
+    "  versionStream 'stdout' (default) or 'stderr' (java -version prints to stderr).",
+    "  versionRegex  capture group(s) for the numeric version in the verify output.",
+    "  version       default required range for this tool, {min, max} as [min, max) — min",
+    "                inclusive, max exclusive; either may be null/omitted = unbounded. A",
+    "                requirement dependency may override this.",
+    "  fallback      when not on PATH, probe <base>/<segments>/<exe>. base is a config env key",
+    "                (DEVECO_SDK_HOME / DEVECO_HOME). Mirrors how the skills resolve hdc/java.",
+    "  hint          shown when the tool is missing.",
+    "",
+    "requirements[]: name + kind (skill|agent) + dependencies[] of",
+    "  { tool, level: 'required'|'optional', version?: {min,max} }.",
+    "  A missing 'required' tool -> BLOCKED; only 'optional' missing -> LIMITED; else OK."
+  ],
+
+  "tools": {
+    "deveco": {
+      "label": "harmony sdk",
+      "source": "env-dir",
+      "envVar": "DEVECO_SDK_HOME",
+      "hint": "set DEVECO_SDK_HOME via `ht init` (DevEco Studio install)"
+    },
+    "adb": {
+      "source": "path",
+      "aliases": ["adb"],
+      "verify": ["version"],
+      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
+      "hint": "Android SDK platform-tools (needed for Android-device capture)"
+    },
+    "hdc": {
+      "source": "path",
+      "aliases": ["hdc"],
+      "verify": ["-v"],
+      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
+      "fallback": { "base": "DEVECO_SDK_HOME", "segments": ["default", "openharmony", "toolchains"], "exe": "hdc" },
+      "hint": "ships with DevEco: <sdk>/default/openharmony/toolchains"
+    },
+    "uv": {
+      "source": "path",
+      "aliases": ["uv"],
+      "verify": ["--version"],
+      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
+      "hint": "https://docs.astral.sh/uv — runs every Python script (AutoTest, UI-align, logic) via `uv run` and provides Python ≥ 3.10 on demand (no standalone Python needed)"
+    },
+    "java": {
+      "source": "path",
+      "aliases": ["java"],
+      "verify": ["-version"],
+      "versionStream": "stderr",
+      "versionRegex": "(\\d+(?:\\.\\d+){1,2})",
+      "fallback": { "base": "DEVECO_HOME", "segments": ["jbr", "bin"], "exe": "java" },
+      "hint": "any JDK 17+, or reuse DevEco jbr: <deveco>/jbr/bin"
+    },
+    "homegraph": {
+      "source": "path",
+      "aliases": ["homegraph"],
+      "verify": ["--version"],
+      "versionRegex": "(\\d+\\.\\d+(?:\\.\\d+)?)",
+      "hint": "npm install -g homegraph arkanalyzer (code-graph backend for spec generation)"
+    }
+  },
+
+  "requirements": [
+    {
+      "name": "hmos-spec-generate",
+      "kind": "skill",
+      "dependencies": [{ "tool": "homegraph", "level": "required" }]
+    },
+    {
+      "name": "hmos-resources-convert",
+      "kind": "skill",
+      "dependencies": [{ "tool": "java", "level": "optional" }],
+      "note": "no java -> falls back to source res/"
+    },
+    {
+      "name": "hmos-batch-ui-align",
+      "kind": "skill",
+      "dependencies": [
+        { "tool": "uv", "level": "required" },
+        { "tool": "adb", "level": "optional" }
+      ],
+      "note": "android_parse_fast.py runs via `uv run` (uv provides Python); adb only for page exploration"
+    },
+    {
+      "name": "hmos-incremental-ui-align",
+      "kind": "skill",
+      "dependencies": [
+        { "tool": "deveco", "level": "required" },
+        { "tool": "uv", "level": "required" },
+        { "tool": "hdc", "level": "required" },
+        { "tool": "adb", "level": "required" }
+      ],
+      "note": "app_feature_verify.py / page_capture.py run via `uv run` (PEP 723 inline deps; uv provides Python)"
+    },
+    {
+      "name": "hmos-integration-test",
+      "kind": "skill",
+      "dependencies": [
+        { "tool": "deveco", "level": "required" },
+        { "tool": "uv", "level": "required" },
+        { "tool": "hdc", "level": "required" }
+      ],
+      "note": "self_test_runner.py runs via `uv run --no-project python` (uv provides Python) and then `uv sync`s the AutoTest venv"
+    },
+    {
+      "name": "hmos-fix-build-errors",
+      "kind": "skill",
+      "dependencies": [{ "tool": "deveco", "level": "required" }]
+    },
+    {
+      "name": "hmos-convert-pipeline",
+      "kind": "skill",
+      "dependencies": [
+        { "tool": "deveco", "level": "required" },
+        { "tool": "uv", "level": "optional" },
+        { "tool": "hdc", "level": "optional" }
+      ],
+      "note": "test stage skippable via skip_test; when run it needs uv + hdc"
+    },
+    {
+      "name": "logic-context-builder",
+      "kind": "agent",
+      "dependencies": [{ "tool": "uv", "level": "optional" }]
+    },
+    {
+      "name": "logic-coder",
+      "kind": "agent",
+      "dependencies": [{ "tool": "uv", "level": "optional" }]
+    },
+    {
+      "name": "spec-generator",
+      "kind": "agent",
+      "dependencies": [{ "tool": "homegraph", "level": "required" }]
+    },
+    {
+      "name": "build-fixer",
+      "kind": "agent",
+      "dependencies": [{ "tool": "deveco", "level": "required" }]
+    },
+    {
+      "name": "code-reviewer",
+      "kind": "agent",
+      "dependencies": [{ "tool": "deveco", "level": "optional" }]
+    },
+    {
+      "name": "review-fixer",
+      "kind": "agent",
+      "dependencies": []
+    },
+    {
+      "name": "self-tester",
+      "kind": "agent",
+      "dependencies": [
+        { "tool": "uv", "level": "required" },
+        { "tool": "hdc", "level": "required" }
+      ],
+      "note": "invokes `uv run --no-project python self_test_runner.py run/status/kill` (uv provides Python; --no-project keeps the interpreter out of the .venv it rebuilds)"
+    },
+    {
+      "name": "self-test-fixer",
+      "kind": "agent",
+      "dependencies": []
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buaa_smat/hometrans",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "HomeTrans (Android-to-HarmonyOS) skill + agent installer. Run `ht init` to distribute conversion skills and subagents into AI editors.",
   "license": "MIT",
   "repository": {

package/resource/migration_process.svg

@@ -0,0 +1,94 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1120 1080" width="1120" height="1080">
+  <style>
+    text { font-family: 'Helvetica Neue', Helvetica, Arial, 'PingFang SC', 'Microsoft YaHei', 'Microsoft JhengHei', 'SimHei', sans-serif; }
+    .title { font-size: 20px; font-weight: 600; fill: #111827; }
+    .sub   { font-size: 12px; fill: #6b7280; }
+    .banner{ font-size: 12px; fill: #047857; font-weight: 600; }
+    .nt    { font-size: 14px; font-weight: 600; fill: #111827; }
+    .ns    { font-size: 11px; fill: #6b7280; }
+    .pin   { font-size: 11px; fill: #1d4ed8; }
+    .pout  { font-size: 11px; fill: #047857; }
+    .dlab  { font-size: 11px; font-weight: 600; fill: #047857; }
+    .lg    { font-size: 12px; fill: #374151; }
+  </style>
+  <defs>
+    <marker id="arrow" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#2563eb"/>
+    </marker>
+    <marker id="arrowg" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#059669"/>
+    </marker>
+  </defs>
+  <rect width="1120" height="1080" fill="#ffffff"/>
+  <text x="40" y="40" class="title">Android → HarmonyOS 迁移流程 · 含参数传递</text>
+  <text x="40" y="62" class="sub">蓝箭头=执行顺序；绿色=参数/产物传递；橙色框=人工介入</text>
+  <rect x="280" y="70" width="560" height="44" rx="8" fill="#ecfdf5" stroke="#10b981" stroke-width="1.4" stroke-dasharray="6,4"/>
+  <text x="560" y="90" text-anchor="middle" class="banner">公共入参（所有步骤共享）：android_project_dir · harmony_project_dir</text>
+  <text x="560" y="106" text-anchor="middle" class="banner">步骤2 产物写入 harmony_project_dir，步骤4 据此构建</text>
+  <rect x="340" y="140" width="440" height="50" rx="25.0" fill="#f0fdf4" stroke="#16a34a" stroke-width="1.6"/>
+  <text x="560" y="170" text-anchor="middle" class="nt">开始：准备 Android 源项目 + 鸿蒙目标项目</text>
+  <rect x="100" y="292" width="440" height="96" rx="9" fill="#eff6ff" stroke="#2563eb" stroke-width="1.6"/>
+  <text x="320" y="310" text-anchor="middle" class="nt">步骤1.1 UI 迁移</text>
+  <text x="320" y="328" text-anchor="middle" class="ns">skill:hmos-batch-ui-align</text>
+  <text x="320" y="348" text-anchor="middle" class="pin">入参: 公共入参 + [ui_info_root, pages]</text>
+  <text x="320" y="367" text-anchor="middle" class="pout">出参: ArkTS页面 + 资源(含资源转换) + 批量报告</text>
+  <rect x="580" y="292" width="440" height="96" rx="9" fill="#f5f9ff" stroke="#2563eb" stroke-width="1.6" stroke-dasharray="6,4"/>
+  <text x="800" y="310" text-anchor="middle" class="nt">步骤1.2 UI 对齐</text>
+  <text x="800" y="328" text-anchor="middle" class="ns">skill:hmos-incremental-ui-align</text>
+  <text x="800" y="348" text-anchor="middle" class="pin">入参: 公共入参 + [capture_output_dir]</text>
+  <text x="800" y="367" text-anchor="middle" class="pout">出参: 修改后ArkTS页面 + 双端截图/视图树 + 对齐报告</text>
+  <rect x="330" y="448" width="460" height="64" rx="9" fill="#fff7ed" stroke="#ea580c" stroke-width="1.6"/>
+  <circle cx="354.0" cy="473" r="4.5" fill="#ea580c"/>
+  <path d="M 347.0,488 Q 354.0,479 361.0,488" fill="none" stroke="#ea580c" stroke-width="2.2" stroke-linecap="round"/>
+  <text x="574" y="472" text-anchor="middle" class="nt">编写 REQ.txt（需求描述）</text>
+  <text x="574" y="492" text-anchor="middle" class="ns">使用自然语言描述原始需求，用空行分隔多个需求</text>
+  <text x="574" y="509" text-anchor="middle" class="pout">产出: REQ.txt</text>
+  <rect x="310" y="562" width="500" height="96" rx="9" fill="#eff6ff" stroke="#2563eb" stroke-width="1.6"/>
+  <text x="560" y="580" text-anchor="middle" class="nt">步骤2 生成需求规格</text>
+  <text x="560" y="598" text-anchor="middle" class="ns">skill:hmos-spec-generate</text>
+  <text x="560" y="618" text-anchor="middle" class="pin">入参: 公共入参 + requirement_description_file(=REQ.txt) + spec_output_dir</text>
+  <text x="560" y="637" text-anchor="middle" class="pout">出参: 〈feature〉-SPEC.md + .trace/〈feature〉.md</text>
+  <rect x="310" y="710" width="500" height="80" rx="9" fill="#fff7ed" stroke="#ea580c" stroke-width="1.6"/>
+  <circle cx="334.0" cy="743" r="4.5" fill="#ea580c"/>
+  <path d="M 327.0,758 Q 334.0,749 341.0,758" fill="none" stroke="#ea580c" stroke-width="2.2" stroke-linecap="round"/>
+  <text x="574" y="734" text-anchor="middle" class="nt">编写测试用例 + 连鸿蒙真机 / 配置签名</text>
+  <text x="574" y="754" text-anchor="middle" class="ns">如果不执行步骤4中的集成测试（skip_test=true）可跳过此步骤</text>
+  <text x="574" y="771" text-anchor="middle" class="pout">产出: test_case.md / pre_test_case.md</text>
+  <rect x="300" y="842" width="520" height="96" rx="9" fill="#eff6ff" stroke="#2563eb" stroke-width="1.6"/>
+  <text x="560" y="860" text-anchor="middle" class="nt">步骤3 逻辑代码转换流水线</text>
+  <text x="560" y="878" text-anchor="middle" class="ns">skill:hmos-convert-pipeline</text>
+  <text x="560" y="898" text-anchor="middle" class="pin">入参: 公共入参 + spec_file_path(=SPEC.md) + [test_case_path, pre_test_case_path, skip_test …]</text>
+  <text x="560" y="917" text-anchor="middle" class="pout">出参: 已签名HAP + pipeline-manifest.md + 各阶段报告</text>
+  <rect x="400" y="983" width="320" height="54" rx="9" fill="#ede9fe" stroke="#7c3aed" stroke-width="1.6"/>
+  <text x="560" y="1015" text-anchor="middle" class="nt">产物：已签名 HAP</text>
+  <path d="M560,190 V250 H320 V292" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,190 V250 H800 V292" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M320,388 V418 H558 V448" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M800,388 V418 H562 V448" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,512 V562" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,658 V710" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,790 V842" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M560,938 V983" fill="none" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+  <path d="M810,610 H865 V890 H822" fill="none" stroke="#059669" stroke-width="1.6" stroke-dasharray="6,4" marker-end="url(#arrowg)"/>
+  <rect x="415" y="528" width="290" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="540" text-anchor="middle" class="dlab">REQ.txt ⇒ requirement_description_file</text>
+  <rect x="445" y="797" width="230" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="809" text-anchor="middle" class="dlab">test_case.md ⇒ test_case_path</text>
+  <rect x="415" y="815" width="290" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="827" text-anchor="middle" class="dlab">pre_test_case.md ⇒ pre_test_case_path</text>
+  <rect x="440" y="949" width="240" height="16" rx="3" fill="#ffffff" opacity="0.92"/>
+  <text x="560" y="961" text-anchor="middle" class="dlab">已签名HAP · pipeline-manifest.md</text>
+  <text x="872" y="745" class="dlab">〈feature〉-SPEC.md ⇒ spec_file_path</text>
+  <g transform="translate(40,920)">
+    <line x1="0" y1="6" x2="26" y2="6" stroke="#2563eb" stroke-width="1.6" marker-end="url(#arrow)"/>
+    <text x="34" y="10" class="lg">执行顺序</text>
+    <line x1="0" y1="26" x2="26" y2="26" stroke="#059669" stroke-width="1.6" stroke-dasharray="6,4" marker-end="url(#arrowg)"/>
+    <text x="34" y="30" class="lg">参数 / 产物传递</text>
+    <rect x="0" y="42" width="20" height="14" rx="3" fill="#eff6ff" stroke="#2563eb" stroke-width="1.4"/>
+    <text x="34" y="53" class="lg">自动化步骤（skill）</text>
+    <rect x="0" y="64" width="20" height="14" rx="3" fill="#fff7ed" stroke="#ea580c" stroke-width="1.4"/>
+    <text x="34" y="75" class="lg">人工介入</text>
+    <rect x="0" y="86" width="20" height="14" rx="3" fill="#f5f9ff" stroke="#2563eb" stroke-width="1.4" stroke-dasharray="6,4"/>
+    <text x="34" y="97" class="lg">可选 / 按需</text>
+  </g>
+</svg>