@buaa_smat/hometrans 0.1.10 → 0.1.12

package/dist/cli/mcp-setup.js

@@ -227,12 +227,8 @@ async function writeTomlSection(editor, result) {
     }
 }
 function prettyConfigPath(p) {
-    // 与 init.ts 中 prettyHome 行为一致，但避免循环引用：就地实现。
-    const home = process.env.HOME || process.env.USERPROFILE || '';
-    if (home && p.startsWith(home)) {
-        return '~' + p.slice(home.length).replace(/\\/g, '/');
-    }
-    return p.replace(/\\/g, '/');
+    // 与 init.ts 中 prettyHome 行为一致：完整绝对路径、OS 原生分隔符，不做 ~ 缩写。
+    return p;
 }
 async function setupOneEditor(editor, result) {
     const marker = expandHome(editor.markerDir);

package/dist/context/index.js

@@ -13,6 +13,29 @@ import {
 import fs from "node:fs/promises";
 import path from "node:path";
 import os from "node:os";
+function deriveSdkPaths(devecoSdkHome) {
+  const home = devecoSdkHome.trim().replace(/[\\/]+$/, "");
+  if (!home) {
+    return { DEVECO_SDK_HOME: "", DEVECO_PATH: "", OHOS_SDK_PATH: "", HMS_SDK_PATH: "" };
+  }
+  return {
+    DEVECO_SDK_HOME: home,
+    DEVECO_PATH: path.dirname(home),
+    OHOS_SDK_PATH: path.join(home, "default", "openharmony", "ets"),
+    HMS_SDK_PATH: path.join(home, "default", "hms", "ets")
+  };
+}
+function sdkHomeFromLegacyPaths(env) {
+  const tryStrip = (p, suffix) => {
+    if (!p) return "";
+    const norm = p.replace(/[\\/]+$/, "").split(/[\\/]/);
+    if (norm.length <= suffix.length) return "";
+    const tail = norm.slice(-suffix.length).map((s) => s.toLowerCase());
+    if (tail.join("/") !== suffix.join("/")) return "";
+    return norm.slice(0, -suffix.length).join(path.sep);
+  };
+  return tryStrip(env.OHOS_SDK_PATH, ["default", "openharmony", "ets"]) || tryStrip(env.HMS_SDK_PATH, ["default", "hms", "ets"]);
+}
 function getConfigDir() {
   return path.join(os.homedir(), ".hometrans");
 }
@@ -99,9 +122,12 @@ async function fileExists(p) {
 }
 function defaultEnv() {
   return {
+    DEVECO_SDK_HOME: "",
+    DEVECO_PATH: "",
     OHOS_SDK_PATH: "",
     HMS_SDK_PATH: "",
     TEST_API_KEY: "",
+    GLM_API_KEY: "",
     TOOL_PATH: ""
   };
 }
@@ -145,6 +171,26 @@ async function loadHomeTransConfig() {
   delete anyParsed.sdkPaths;
   delete anyParsed.params;
   delete anyParsed.tool_path;
+  let envDirty = false;
+  if (!config.env.DEVECO_SDK_HOME) {
+    const migrated = sdkHomeFromLegacyPaths(config.env);
+    if (migrated) {
+      config.env.DEVECO_SDK_HOME = migrated;
+      envDirty = true;
+    }
+  }
+  if (config.env.DEVECO_SDK_HOME) {
+    const derived = deriveSdkPaths(config.env.DEVECO_SDK_HOME);
+    for (const key of ["DEVECO_PATH", "OHOS_SDK_PATH", "HMS_SDK_PATH"]) {
+      if (!config.env[key]) {
+        config.env[key] = derived[key];
+        envDirty = true;
+      }
+    }
+  }
+  if (envDirty) {
+    await saveHomeTransConfig(config);
+  }
   const existingNames = new Set(config.editors.map((e) => e.name));
   const missingEditors = defaultEditors().filter(
     (e) => !existingNames.has(e.name)

package/env-requirements.json

@@ -0,0 +1,181 @@
+{
+  "$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_PATH). 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_PATH", "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": []
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buaa_smat/hometrans",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "HomeTrans (Android-to-HarmonyOS) skill + agent installer. Run `ht init` to distribute conversion skills and subagents into AI editors.",
   "license": "MIT",
   "repository": {
@@ -17,7 +17,8 @@
     "skills",
     "agents",
     "tools",
-    "resource"
+    "resource",
+    "env-requirements.json"
   ],
   "scripts": {
     "build": "node scripts/build.js",

package/skills/hmos-convert-pipeline/SKILL.md

@@ -17,12 +17,17 @@ Parse `$ARGUMENTS` as positional tokens:
 
 - **Arg 1** (`android-project-path`): Path to the Android source project (required)
 - **Arg 2** (`harmonyos-project-path`): Path to the target HarmonyOS project directory (required)
-- **Arg 3** (`assets-output-path`): Directory to store all output/report files (required)
-- **Arg 4** (`max-rounds-review`): Maximum number of Stage 3→3a→3b code-review-fix rounds to run (optional, default `2`). Must be a positive integer `>= 1`.
-- **Arg 5** (`max-rounds-test`): Maximum number of Stage 4→4a→4b self-test rounds to run (optional, default `2`). Must be a positive integer `>= 1`.
-- **Arg 6** (`skip-test`): `true` or `false` (optional, default `false`). When `true`, skip Stage 4 / 4a / 4b (Self-Testing Loop) entirely. Use this when no real HarmonyOS device is available for on-device testing. To pass this arg, provide explicit values for Args 4 and 5 first.
+- **Arg 3** (`spec-file-path`): Path to the requirement spec document (required). This is the plan/spec that drives Stage 1 logic development and Stage 3 code review — both stages read it directly from this path.
+- **Arg 4** (`assets-output-path`): Directory to store all output/report files (optional). When omitted, default to `<harmonyos-project-path>/.hometrans_output` — create the directory if it does not exist.
+- **Arg 5** (`test-case-path`): Path to the self-test case file driving the Stage 4 self-testing loop (optional). When omitted, default to `OUTPUT/test_case.md`. If the resolved file does not exist, the Stage 4 loop is skipped (see Loop Setup).
+- **Arg 6** (`pre-test-case-path`): Path to the pre-test case file (optional). When omitted, default to `OUTPUT/pre_test_case.md`. Only passed to the self-tester when the resolved file exists.
+- **Arg 7** (`max-rounds-review`): Maximum number of Stage 3→3a→3b code-review-fix rounds to run (optional, default `2`). Must be a positive integer `>= 1`.
+- **Arg 8** (`max-rounds-test`): Maximum number of Stage 4→4a→4b self-test rounds to run (optional, default `2`). Must be a positive integer `>= 1`.
+- **Arg 9** (`skip-test`): `true` or `false` (optional, default `false`). When `true`, skip Stage 4 / 4a / 4b (Self-Testing Loop) entirely. Use this when no real HarmonyOS device is available for on-device testing.
 
-If any required argument is missing, ask the user before proceeding. If `max-rounds-review` or `max-rounds-test` is provided but is not a positive integer, ask the user before proceeding. If `skip-test` is provided but is not `true` or `false`, ask the user before proceeding.
+Args are positional: to pass any optional arg, provide explicit values for all optional args before it (e.g., passing `test-case-path` requires an explicit `assets-output-path`; passing `skip-test` requires explicit Args 4–8).
+
+If any required argument is missing, ask the user before proceeding. If `spec-file-path` does not exist or is not a readable file, ask the user before proceeding. If `max-rounds-review` or `max-rounds-test` is provided but is not a positive integer, ask the user before proceeding. If `skip-test` is provided but is not `true` or `false`, ask the user before proceeding.
 
 Define shorthand variables for the instructions below:
 
@@ -30,7 +35,10 @@ Define shorthand variables for the instructions below:
 |----------|---------|
 | `ANDROID` | android-project-path |
 | `HMOS` | harmonyos-project-path |
-| `OUTPUT` | assets-output-path (resolved or generated) |
+| `SPEC` | spec-file-path — requirement spec document, consumed directly by Stage 1 (`spec-file`) and Stage 3 (`test-case-path`) |
+| `OUTPUT` | assets-output-path; defaults to `HMOS/.hometrans_output` when not provided (created on demand) |
+| `TEST_CASE` | test-case-path; defaults to `OUTPUT/test_case.md` when not provided |
+| `PRE_TEST_CASE` | pre-test-case-path; defaults to `OUTPUT/pre_test_case.md` when not provided |
 | `MAX_ROUNDS_REVIEW` | max-rounds-review — positive integer (default `2`). Controls Stage 3→3a→3b code-review-fix loop. |
 | `MAX_ROUNDS_TEST`   | max-rounds-test — positive integer (default `2`). Controls Stage 4→4a→4b self-test loop. |
 | `SKIP_TEST` | skip-test — `true` or `false` (default `false`). When `true`, skip Stage 4 / 4a / 4b entirely (no real device available). |
@@ -147,7 +155,7 @@ Prompt format (applies to both Stage 1 and Stage 1a): ONLY the key-value lines b
    ```
    Agent(
      subagent_type="logic-context-builder",
-     prompt="harmonyos-project-path: HMOS\nspec-file: OUTPUT/plan.md\noutput-path: OUTPUT/logic"
+     prompt="harmonyos-project-path: HMOS\nspec-file: SPEC\noutput-path: OUTPUT/logic"
    )
    ```
 2. Verify `OUTPUT/logic/plan.md` exists.
@@ -200,7 +208,7 @@ For each `review_round` from `1..MAX_ROUNDS_REVIEW`, set `REVIEW_ROUND_DIR = OUT
    - `harmonyos-project-path`: `HMOS`
    - `commit-id`: For Round 1, use `REVIEW_COMMIT_ID`. For Round 2+, review the project holistically (omit `commit-id` or pass `none`) since fixes have modified the codebase beyond the original commit scope.
    - `output-path`: `REVIEW_ROUND_DIR`
-   - `test-case-path`: `OUTPUT/plan.md`
+   - `test-case-path`: `SPEC`
 3. If a valid `commit-id` is available, the agent will automatically call the `extract_commit_context` MCP tool to extract commit-scoped code context before reviewing. If the MCP call fails, the agent falls back to direct git-diff analysis. If no `commit-id` is available, the agent reviews the project holistically without commit-scoped extraction.
 4. The agent writes `REVIEW_ROUND_DIR/code-review-report.md` with per-scenario verdicts.
 5. **Extract defect stats**: Read `REVIEW_ROUND_DIR/code-review-report.md`, extract the verdict breakdown (PASS/PARTIAL/FAIL/UNABLE TO VERIFY counts) and overall verdict.
@@ -277,7 +285,7 @@ Treat Stage 4 → 4a → 4b as a loop that runs up to `MAX_ROUNDS_TEST` times.
 
 1. **Locate the initial HAP file**: Use the `.hap` mirrored to `OUTPUT/` by the Stage 3 review loop finalization (or from Stage 2 if the review loop did not produce one). The default location is `OUTPUT/entry-default-signed.hap`. If that file does not exist, search for `*-signed.hap` files in `OUTPUT/` and use the first match. If no `.hap` is found in `OUTPUT/`, fall back to searching `HMOS/entry/build/default/outputs/default/`.
 2. Store the resolved path as `CURRENT_HAP`.
-3. **`OUTPUT/test_case.md` existence guard**: If `OUTPUT/test_case.md` does not exist, mark Stage 4 / 4a / 4b as failed with note "No test case file available" and skip the loop entirely.
+3. **`TEST_CASE` existence guard**: If `TEST_CASE` does not exist, mark Stage 4 / 4a / 4b as failed with note "No test case file available" and skip the loop entirely.
 4. Initialize loop state:
    - `round = 1`
    - `rounds_executed = 0`
@@ -297,8 +305,8 @@ For each `round` from `1..MAX_ROUNDS_TEST`, set `ROUND_DIR = OUTPUT/round-{round
 3. Input (round 1):
    - `hap-path`: `CURRENT_HAP`
    - `output-path`: `OUTPUT` (the ROOT — the agent always writes here)
-   - `test-case-path`: `OUTPUT/test_case.md`
-   - `pre-test-case-path`: `OUTPUT/pre_test_case.md` (only include this line when the file exists)
+   - `test-case-path`: `TEST_CASE`
+   - `pre-test-case-path`: `PRE_TEST_CASE` (only include this line when the file exists)
    - `setup`: `true`
 4. Input (round 2+):
    - `hap-path`: `CURRENT_HAP`

package/skills/hmos-fix-build-errors/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: hmos-fix-build-errors
 description: Build a HarmonyOS project via CLI and automatically fix compile errors in a loop until the build succeeds. Default unsigned HAP; pass --signed to build a signed HAP (signing config must already exist in the project's build-profile.json5).
-argument-hint: <harmonyos-project-path> <deveco-studio-path> [--signed]
+argument-hint: <harmonyos-project-path> [deveco-studio-path] [--signed]
 allowed-tools: Agent, Read, Write, Edit, Glob, Grep, Bash
 type: tool
 domain: engineering
@@ -12,8 +12,8 @@ domain: engineering
 Automatically build a HarmonyOS NEXT project from the command line, parse compile errors, fix them, and retry — repeating until the build succeeds.
 
 - **HarmonyOS Project**: `$ARGUMENTS[0]` (the HarmonyOS project root, e.g. `D:/MyHmosApp`)
-- **DevEco Studio Path**: `$ARGUMENTS[1]` (DevEco Studio installation root, e.g. `D:/DevEco Studio`)
-- **--signed** (optional): `$ARGUMENTS[2]` — if set to `--signed`, the build produces a **signed HAP**. If omitted, the build produces an **unsigned HAP** (default).
+- **DevEco Studio Path** (optional): `$ARGUMENTS[1]` (DevEco Studio installation root, e.g. `D:/DevEco Studio`) — when omitted, resolved automatically (see Step 0.2)
+- **--signed** (optional): if any argument equals `--signed`, the build produces a **signed HAP**. If omitted, the build produces an **unsigned HAP** (default).
 
 ---
 
@@ -21,12 +21,20 @@ Automatically build a HarmonyOS NEXT project from the command line, parse compil
 
 1. **Verify project exists** — Check that `$ARGUMENTS[0]` contains a valid HarmonyOS project (look for `build-profile.json5`, `entry/src` directory, `oh-package.json5`).
 
-2. **Verify DevEco installation** — Check that `$ARGUMENTS[1]` contains:
+2. **Resolve `<deveco-path>`** — stop at the first source that yields a valid path:
+   1. `$ARGUMENTS[1]` if provided (and not `--signed`).
+   2. `~/.hometrans/config.json` (on Windows `%USERPROFILE%\.hometrans\config.json`): `env.DEVECO_PATH`; else parent dir of `env.DEVECO_SDK_HOME`; else strip the trailing `/sdk/default/openharmony/ets` from `env.OHOS_SDK_PATH` (legacy).
+   3. Environment variables, same precedence: `DEVECO_PATH` → parent of `DEVECO_SDK_HOME` → strip suffix from `OHOS_SDK_PATH`.
+   4. **Ask the user** for the DevEco Studio install path (suggest running `ht init` to persist it).
+
+   **Verify the resolved `<deveco-path>`** contains:
    - `tools/node/node.exe`
    - `tools/hvigor/bin/hvigorw.js`
    - `tools/ohpm/bin/ohpm`
    - `sdk/` directory
 
+   If verification fails for a config/env-sourced path, treat that source as invalid and continue down the list; if it fails for a user-supplied path, report what is missing and ask again.
+
 3. **Set up `local.properties`** — Ensure the project root has `local.properties` with:
    ```properties
    hwsdk.dir=<deveco-path>/sdk
@@ -40,7 +48,7 @@ Automatically build a HarmonyOS NEXT project from the command line, parse compil
    "<deveco-path>/tools/ohpm/bin/ohpm" install
    ```
 
-5. **Determine Build Mode** — Check if `$ARGUMENTS[2]` equals `--signed`:
+5. **Determine Build Mode** — Check if any argument equals `--signed` (it may be `$ARGUMENTS[1]` when the DevEco path is omitted, or `$ARGUMENTS[2]` when it is provided):
    - **If NOT `--signed`** → **Unsigned build mode**. Ensure `build-profile.json5` does NOT have `signingConfigs` or `signingConfig` references in products (remove them if present). Go to Step 1.
    - **If `--signed`** → **Signed build mode**. Proceed to Step 0.5 to validate signing config.
 

package/skills/hmos-incremental-ui-align/SKILL.md

@@ -17,7 +17,13 @@ You are writing ArkTS codes.
 - 不要做和用户需求无关的其他修改
 - 
 ## Step 0: Load Config
-The user MUST provide a `config-path` when invoking this skill (e.g., `config-path: D:\path\to\config.json`). The config file must exist before running — verify with a Read, and if it's missing or unreadable, ask the user for a valid path. Refer to `config-example.json` in this skill's directory for the expected schema.
+Resolve the config file in this order — stop at the first hit:
+
+1. **`config-path` argument** if the user provided one (e.g., `config-path: D:\path\to\config.json`).
+2. **`config.json` in this skill's own directory** — `ht init` seeds it from `config-example.json` and fills `glm_api_key` + `hmos_sdk_dir` from `~/.hometrans/config.json`.
+3. Neither exists → **ask the user** for a valid path.
+
+Verify the resolved file with a Read; if it's missing or unreadable, fall through to the next source (or ask the user). Refer to `config-example.json` in this skill's directory for the expected schema.
 
 Config fields:
 
@@ -33,6 +39,14 @@ Config fields:
 | `glm_api_key` | Zhipu GLM API key for phone-agent |
 | `capture_output_dir` | Base directory for captured page data |
 
+**Fallbacks for `hmos_sdk_dir` and `glm_api_key`** when empty or missing in the resolved config — stop at the first hit:
+
+1. `~/.hometrans/config.json` (on Windows `%USERPROFILE%\.hometrans\config.json`): `hmos_sdk_dir` = `<env.DEVECO_SDK_HOME>/default`; `glm_api_key` = `env.GLM_API_KEY`.
+2. Environment variables: derive `hmos_sdk_dir` from `DEVECO_SDK_HOME` (append `/default`); `glm_api_key` from `GLM_API_KEY`.
+3. **Ask the user** (suggest running `ht init` to persist them).
+
+Validate that `hmos_sdk_dir` exists on disk before use; if it doesn't, continue down the fallback list.
+
 ## Step 1: Capture All Related Pages on Android & HarmonyOS Devices
 
 Read `scripts/navigation-capure.md` to learn the usage of `scripts/app_feature_verify.py` (navigation) and `scripts/page_capture.py` (capture).

package/skills/hmos-incremental-ui-align/config-example.json

@@ -1,11 +1,11 @@
 {
-  "android.app_name": "Salt Player",
-  "android.package": "com.salt.music",
-  "android.project_dir": "E:\\SaltPlayerAndroid-main\\SuvineMusicX",
-  "harmony.app_name": "Salt Player",
-  "harmony.package": "com.xuncorp.sp2",
-  "harmony.project_dir": "E:\\SPH_branches\\SaltPlayerHarmony",
-  "hmos_sdk_dir": "E:\\DevEco Studio\\sdk\\default",
+  "android.app_name": "",
+  "android.package": "com.xxxxxx",
+  "android.project_dir": "",
+  "harmony.app_name": "",
+  "harmony.package": "com.xxxxxx",
+  "harmony.project_dir": "",
+  "hmos_sdk_dir": "",
   "glm_api_key": "",
-  "capture_output_dir": "E:\\tmp_saltplayer"
+  "capture_output_dir": ""
 }