@buaa_smat/hometrans 0.1.3 → 0.1.5

package/README.md

@@ -45,13 +45,15 @@ Requires Node.js **>= 18**.
    - `OHOS_SDK_PATH` — OpenHarmony SDK ETS path
    - `HMS_SDK_PATH` — HMS SDK ETS path
    - `TEST_API_KEY` — API key written into the autotest `config.yaml`
-3. **Seeds/refreshes the autotest config**: if `agents/test-tools/autotest/config.yaml` is missing it is created from `config.yaml.example`, and every `api_key:` line is filled with the supplied `TEST_API_KEY`.
-4. For every selected editor, **copies**:
+   These are stored under a single `env` object in `~/.hometrans/config.json` (alongside `TOOL_PATH`, set in the next step).
+3. **Installs bundled tools** to `~/.hometrans/tools` (the AutoTest toolchain lives at `~/.hometrans/tools/test-tools/autotest`) and records the destination as `env.TOOL_PATH` in `~/.hometrans/config.json`. Agents/skills resolve the AutoTest dir from `env.TOOL_PATH`.
+4. **Seeds/refreshes the autotest config**: if `<TOOL_PATH>/test-tools/autotest/config.yaml` is missing it is created from `config.yaml.example`, and every `api_key:` line is filled with the supplied `TEST_API_KEY`.
+5. For every selected editor, **copies**:
    - every skill folder under `skills/` (those containing a `SKILL.md`) → `<editor>/skills/<skill-name>/` (recursive — preserves subdirectory structure)
-   - every agent under `agents/` → `<editor>/agents/` (recursive — preserves `<agent>/scripts/` and `test-tools/` subtrees)
-5. **Registers the MCP server** (auto-adapts to editor config format: jsonc-object / jsonc-command-array / codex-cli / toml-section).
-6. Editors whose marker directory is missing are reported as **`skipped`** — nothing is written for them.
-7. The install is **idempotent** — re-running overwrites bundled content only. It never touches files under `<editor>/skills/` or `<editor>/agents/` that don't share a name with a bundled item.
+   - every agent under `agents/` → `<editor>/agents/` (recursive — preserves `<agent>/scripts/` subtrees)
+6. **Registers the MCP server** (auto-adapts to editor config format: jsonc-object / jsonc-command-array / codex-cli / toml-section).
+7. Editors whose marker directory is missing are reported as **`skipped`** — nothing is written for them.
+8. The install is **idempotent** — re-running overwrites bundled content only. It never touches files under `<editor>/skills/` or `<editor>/agents/` that don't share a name with a bundled item.
 
 ### Target directories
 

package/agents/build-fixer.md

@@ -36,15 +36,16 @@ Read the config file written by `ht init` at `~/.hometrans/config.json` (`$HOME/
 ```jsonc
 {
   "editors": [ /* ... */ ],
-  "params": {
+  "env": {
     "OHOS_SDK_PATH": "...",   // OpenHarmony SDK ETS path, e.g. "D:/DevEco Studio/sdk/default/openharmony/ets"
     "HMS_SDK_PATH": "...",    // HMS SDK ETS path, e.g. "D:/DevEco Studio/sdk/default/hms/ets"
-    "TEST_API_KEY": "..."
+    "TEST_API_KEY": "...",
+    "TOOL_PATH": "..."        // HomeTrans tools dir, e.g. "C:/Users/<you>/.hometrans/tools"
   }
 }
 ```
 
-Read `params.OHOS_SDK_PATH` from this file.
+Read `env.OHOS_SDK_PATH` from this file.
 
 ### 0b. Derive the DevEco Studio root and tool paths
 
@@ -58,11 +59,11 @@ From `<deveco>`, derive:
 - **ohpm**: `<deveco>/tools/ohpm/bin/ohpm`
 - **SDK directory**: `<deveco>/sdk`
 
-Verify these files exist. If they do, use them and skip auto-detection. (Fall back to `params.HMS_SDK_PATH` — stripping `/sdk/default/hms/ets` — if `OHOS_SDK_PATH` is absent but `HMS_SDK_PATH` is present.)
+Verify these files exist. If they do, use them and skip auto-detection. (Fall back to `env.HMS_SDK_PATH` — stripping `/sdk/default/hms/ets` — if `OHOS_SDK_PATH` is absent but `HMS_SDK_PATH` is present.)
 
 ### 0c. Auto-detect if config is missing or invalid
 
-If `~/.hometrans/config.json` is missing, has empty `params.OHOS_SDK_PATH`/`HMS_SDK_PATH`, or the derived paths don't point to real files, auto-detect:
+If `~/.hometrans/config.json` is missing, has empty `env.OHOS_SDK_PATH`/`HMS_SDK_PATH`, or the derived paths don't point to real files, auto-detect:
 
 1. **Find DevEco Studio installation**:
    - Search common locations: `D:\DevEco Studio`, `C:\DevEco Studio`, `C:\Program Files\DevEco Studio`

package/agents/code-review-fix.md

@@ -41,7 +41,7 @@ If `commit-id` is provided and is not `none`:
    - `projectPath`: `<harmonyos-project-path>`
    - `commitId`: `<commit-id>`
    - `mode`: `"default"`
-   - `ohosSdkPath` / `hmsSdkPath`: omit to let the tool read `params.OHOS_SDK_PATH` / `params.HMS_SDK_PATH` from the `ht init` config (`~/.hometrans/config.json`), falling back to the `OHOS_SDK_PATH` / `HMS_SDK_PATH` env vars
+   - `ohosSdkPath` / `hmsSdkPath`: omit to let the tool read `env.OHOS_SDK_PATH` / `env.HMS_SDK_PATH` from the `ht init` config (`~/.hometrans/config.json`), falling back to the `OHOS_SDK_PATH` / `HMS_SDK_PATH` env vars
 
 2. **On failure**, fall back to:
    ```bash
@@ -231,14 +231,14 @@ Classify: **CONFIRMED** (fix) | **FALSE_POSITIVE** (skip, record reason) | **UNC
 
 ### Step 3.0: Resolve Build Environment
 
-1. Read the `ht init` config at `~/.hometrans/config.json` (Windows: `%USERPROFILE%\.hometrans\config.json`). Take `params.OHOS_SDK_PATH` (e.g. `D:/DevEco Studio/sdk/default/openharmony/ets`) and strip the trailing `/sdk/default/openharmony/ets` to get the DevEco Studio root `<deveco>`. Fall back to `params.HMS_SDK_PATH` (strip `/sdk/default/hms/ets`) if needed.
+1. Read the `ht init` config at `~/.hometrans/config.json` (Windows: `%USERPROFILE%\.hometrans\config.json`). Take `env.OHOS_SDK_PATH` (e.g. `D:/DevEco Studio/sdk/default/openharmony/ets`) and strip the trailing `/sdk/default/openharmony/ets` to get the DevEco Studio root `<deveco>`. Fall back to `env.HMS_SDK_PATH` (strip `/sdk/default/hms/ets`) if needed.
 
 2. Derive tool paths:
    - `NODE_EXE`: `<deveco>/tools/node/node.exe`
    - `HVIGORW_JS`: `<deveco>/tools/hvigor/bin/hvigorw.js`
    - `OHPM`: `<deveco>/tools/ohpm/bin/ohpm`
 
-3. If the config is missing or `params.OHOS_SDK_PATH`/`HMS_SDK_PATH` are empty, auto-detect: search `D:\DevEco Studio`, `C:\DevEco Studio`, `C:\Program Files\DevEco Studio` for `tools/hvigor/bin/hvigorw.js`.
+3. If the config is missing or `env.OHOS_SDK_PATH`/`HMS_SDK_PATH` are empty, auto-detect: search `D:\DevEco Studio`, `C:\DevEco Studio`, `C:\Program Files\DevEco Studio` for `tools/hvigor/bin/hvigorw.js`.
 
 4. If detection fails, stop and report clearly what is missing so the user can run `ht init` to configure it.
 

package/agents/self-tester.md

@@ -38,25 +38,36 @@ You are a self-tester for HarmonyOS applications. You run a single pipeline: par
 
 ### AutoTest Directory Locator
 
-Used independently by S5 and T4. **Anchor the search at `<output-path>` — sub-agent cwd is not guaranteed to sit anywhere in particular.** Walk up from `<output-path>` looking for a sibling `agents/test-tools/autotest`:
+Used independently by S5 and T4. The AutoTest tools are installed by `ht init` under the HomeTrans tools dir; resolve their location from config rather than searching the filesystem.
+
+**Primary — read `env.TOOL_PATH` from the HomeTrans config** at `~/.hometrans/config.json` (`$HOME/.hometrans/config.json`; on Windows `%USERPROFILE%\.hometrans\config.json`). The autotest dir is `<TOOL_PATH>/test-tools/autotest`:
+
+```bash
+cfg="$HOME/.hometrans/config.json"; [ -n "$USERPROFILE" ] && [ -f "$USERPROFILE/.hometrans/config.json" ] && cfg="$USERPROFILE/.hometrans/config.json"
+tool_path="$(python -c "import json,os;print(json.load(open(os.path.expanduser(r'$cfg'),encoding='utf-8')).get('env',{}).get('TOOL_PATH',''))" 2>/dev/null)"
+if [ -n "$tool_path" ] && [ -d "$tool_path/test-tools/autotest" ]; then echo "$tool_path/test-tools/autotest"; fi
+```
+
+If config is missing or `TOOL_PATH` is empty/invalid, **fall back** to walking up from `<output-path>` for a sibling `test-tools/autotest` (then `agents/test-tools/autotest` for legacy layouts) — **anchor the search at `<output-path>`, the sub-agent cwd is not guaranteed**:
 
 ```bash
 d="<output-path>"; while [ "$d" != "/" ] && [ "$d" != "" ]; do \
+  if [ -d "$d/test-tools/autotest" ]; then echo "$d/test-tools/autotest"; break; fi; \
   if [ -d "$d/agents/test-tools/autotest" ]; then echo "$d/agents/test-tools/autotest"; break; fi; \
   d="$(dirname "$d")"; \
 done
 ```
 
-If the walk-up yields nothing, fall back to a `$(pwd)`-anchored search **only as a last resort**:
+As a last resort, a `$(pwd)`-anchored search:
 
 ```bash
-find "$(pwd)" -type d -path "*/agents/test-tools/autotest" -print -quit 2>/dev/null
+find "$(pwd)" -type d -path "*/test-tools/autotest" -print -quit 2>/dev/null
 ```
 
 | Caller | Purpose | On failure |
 |--------|---------|------------|
-| S5 | Locate then run testcases_tool.py | Emit `Error: cannot locate agents/test-tools/autotest from <output-path>` and exit |
-| T4 | Locate then verify config.yaml | Write `self-test-report.md` with status **FAIL** and reason "AutoTest directory not found from output-path", then exit |
+| S5 | Locate then run testcases_tool.py | Emit `Error: cannot locate test-tools/autotest from config env.TOOL_PATH or <output-path>` and exit |
+| T4 | Locate then verify config.yaml | Write `self-test-report.md` with status **FAIL** and reason "AutoTest directory not found from config TOOL_PATH or output-path", then exit |
 
 ### Input Validation Template
 
@@ -173,7 +184,7 @@ Write to `<output-path>/_extracted.json`:
 
 ### S5 — Generate testcases.json via Python script
 
-Find the `agents/test-tools/autotest` directory using the **AutoTest Directory Locator** in Shared Utilities (walk up from `<output-path>`). Set `<autotest_dir>` to the resolved path. If not found, emit the documented error and exit. Run:
+Find the `test-tools/autotest` directory using the **AutoTest Directory Locator** in Shared Utilities (prefer config `env.TOOL_PATH`, fall back to walking up from `<output-path>`). Set `<autotest_dir>` to the resolved path. If not found, emit the documented error and exit. Run:
 
 ```bash
 cd "<autotest_dir>" && uv run python testcases_tool.py generate "<output-path>/_extracted.json" "<output-path>/testcases.json" --validate
@@ -236,7 +247,7 @@ Record the device serial number.
 
 ### T4 — Locate AutoTest Directory & Verify config.yaml
 
-Find the `agents/test-tools/autotest` directory using the **AutoTest Directory Locator** in Shared Utilities (walk up from `<output-path>`). If not found, write a `self-test-report.md` with the sentinel format (`status: FAIL` / `reason: AutoTest directory not found from output-path`), then stop.
+Find the `test-tools/autotest` directory using the **AutoTest Directory Locator** in Shared Utilities (prefer config `env.TOOL_PATH`, fall back to walking up from `<output-path>`). If not found, write a `self-test-report.md` with the sentinel format (`status: FAIL` / `reason: AutoTest directory not found from config TOOL_PATH or output-path`), then stop.
 
 Set `<autotest_dir>` to the found path. Check config.yaml:
 
@@ -370,7 +381,7 @@ cd "<autotest_dir>" && uv run python report_tool.py validate "<output-path>/self
 - **Two-phase architecture**: When the parse phase runs, the LLM writes `_extracted.json` → `testcases_tool.py` writes `testcases.json`. Never write `testcases.json` directly. If `testcases.json` already exists at the output path and the parse phase runs, `testcases_tool.py` overwrites it — never skip the script.
 - **App name → bundle_name is critical**: `test_steps` must use `bundle_name` (e.g., `com.example.tuku`), NOT the display name. AutoTest uses this to launch the correct app. Using the display name instead may launch the wrong app entirely.
 - **JSON contract**: `app-metadata.json` and `testcases.json` always live at `<output-path>/app-metadata.json` and `<output-path>/testcases.json`. T2 reads from the file (not from memory).
-- **AutoTest directory locator**: Walk up from `<output-path>` (see Shared Utilities). Do not assume `$(pwd)` is anchored anywhere in particular.
+- **AutoTest directory locator**: Resolve `<TOOL_PATH>/test-tools/autotest` from `~/.hometrans/config.json` (`env.TOOL_PATH`); fall back to walking up from `<output-path>` (see Shared Utilities). Do not assume `$(pwd)` is anchored anywhere in particular.
 - **Sentinel-format early-exit reports**: When T1 / T3 / T4 / T7 write a degraded FAIL report (config error, no device, missing autotest dir, crashed batch, timeout, or `setup=false` precondition failure), the report's first non-frontmatter line MUST be `status: FAIL` and the second MUST be `reason: <one-line reason>`. This lets callers detect early-exit reports without parsing a case table.
 - **Quote all paths** — paths may contain spaces.
 - **Capture complete output** — never truncate command output; it is essential for diagnosis.

package/dist/cli/config-store.js

@@ -14,6 +14,10 @@ export function getConfigDir() {
 export function getConfigPath() {
     return path.join(getConfigDir(), 'config.json');
 }
+/** 工具目录：~/.hometrans/tools，`ht init` 把打包的 tools/ 拷贝到此。 */
+export function getToolsDir() {
+    return path.join(getConfigDir(), 'tools');
+}
 /** 把 ~/foo 展开为 $HOME/foo；非 ~ 开头原样返回。 */
 export function expandHome(p) {
     if (!p)
@@ -87,11 +91,12 @@ async function fileExists(p) {
  * 加载 editors 配置。文件不存在时写入默认值再返回。
  * 解析失败时抛错，避免静默覆盖用户手动修改。
  */
-export function defaultUserParams() {
+export function defaultEnv() {
     return {
         OHOS_SDK_PATH: '',
         HMS_SDK_PATH: '',
         TEST_API_KEY: '',
+        TOOL_PATH: '',
     };
 }
 export async function loadHomeTransConfig() {
@@ -99,7 +104,7 @@ export async function loadHomeTransConfig() {
     if (!(await fileExists(configPath))) {
         const config = {
             editors: defaultEditors(),
-            params: defaultUserParams(),
+            env: defaultEnv(),
         };
         await fs.mkdir(getConfigDir(), { recursive: true });
         await fs.writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
@@ -117,15 +122,23 @@ export async function loadHomeTransConfig() {
         throw new Error(`Invalid config.json shape at ${configPath}: top-level must be { "editors": [...] }.`);
     }
     const config = parsed;
-    // Migrate legacy `sdkPaths` field, fill in any missing params keys.
-    const legacy = parsed.sdkPaths;
-    if (!config.params) {
-        config.params = { ...defaultUserParams(), ...(legacy ?? {}) };
-    }
-    else {
-        config.params = { ...defaultUserParams(), ...config.params };
+    const anyParsed = parsed;
+    // Migrate legacy fields into `env`:
+    //   - `sdkPaths` / `params` held OHOS_SDK_PATH / HMS_SDK_PATH / TEST_API_KEY.
+    //   - `tool_path` held the tools dir, now env.TOOL_PATH.
+    const legacyParams = (anyParsed.params ?? anyParsed.sdkPaths);
+    const legacyToolPath = typeof anyParsed.tool_path === 'string' ? anyParsed.tool_path : undefined;
+    config.env = {
+        ...defaultEnv(),
+        ...(legacyParams ?? {}),
+        ...(config.env ?? {}),
+    };
+    if (legacyToolPath && !config.env.TOOL_PATH) {
+        config.env.TOOL_PATH = legacyToolPath;
     }
-    delete config.sdkPaths;
+    delete anyParsed.sdkPaths;
+    delete anyParsed.params;
+    delete anyParsed.tool_path;
     return config;
 }
 export async function saveHomeTransConfig(config) {

package/dist/cli/config.js

@@ -17,15 +17,16 @@ export async function configCommand() {
     console.log(`  Path: ${configPath}`);
     console.log('');
     // User parameters
-    const maskedKey = config.params.TEST_API_KEY
-        ? config.params.TEST_API_KEY.slice(0, 4) +
+    const maskedKey = config.env.TEST_API_KEY
+        ? config.env.TEST_API_KEY.slice(0, 4) +
             '***' +
-            config.params.TEST_API_KEY.slice(-4)
+            config.env.TEST_API_KEY.slice(-4)
         : '(not set)';
     console.log('  Parameters:');
-    console.log(`    OHOS_SDK_PATH : ${config.params.OHOS_SDK_PATH || '(not set)'}`);
-    console.log(`    HMS_SDK_PATH  : ${config.params.HMS_SDK_PATH || '(not set)'}`);
+    console.log(`    OHOS_SDK_PATH : ${config.env.OHOS_SDK_PATH || '(not set)'}`);
+    console.log(`    HMS_SDK_PATH  : ${config.env.HMS_SDK_PATH || '(not set)'}`);
     console.log(`    TEST_API_KEY  : ${maskedKey}`);
+    console.log(`    TOOL_PATH     : ${config.env.TOOL_PATH || '(not set)'}`);
     console.log('');
     // Full config content
     console.log('  Full Content:');

package/dist/cli/init.js

@@ -13,7 +13,7 @@ import chalk from 'chalk';
 import figlet from 'figlet';
 import inquirer from 'inquirer';
 import { setupMcpForAllEditors } from './mcp-setup.js';
-import { expandHome, loadHomeTransConfig, saveHomeTransConfig, } from './config-store.js';
+import { expandHome, getConfigPath, getToolsDir, loadHomeTransConfig, saveHomeTransConfig, } from './config-store.js';
 function ensureChalkColor() {
     if (process.stdout.isTTY && chalk.level === 0) {
         chalk.level = 1;
@@ -50,8 +50,30 @@ function resolveSkillsRoot() {
 function resolveAgentsRoot() {
     return path.resolve(__dirname, '..', '..', 'agents');
 }
-function resolveAutotestDir(agentsRoot) {
-    return path.join(agentsRoot, 'test-tools', 'autotest');
+function resolveToolsRoot() {
+    return path.resolve(__dirname, '..', '..', 'tools');
+}
+/**
+ * Copy the bundled `tools/` folder into ~/.hometrans/tools and record the
+ * destination in config.env.TOOL_PATH. Returns the destination path, or null if
+ * the package ships no tools/ folder.
+ */
+async function installTools(toolsRoot, config) {
+    if (!(await dirExists(toolsRoot)))
+        return null;
+    const toolsDest = getToolsDir();
+    await copyDirRecursive(toolsRoot, toolsDest);
+    config.env.TOOL_PATH = toolsDest;
+    await saveHomeTransConfig(config);
+    return toolsDest;
+}
+/**
+ * The AutoTest tools live under the installed HomeTrans tools dir
+ * (~/.hometrans/tools/test-tools/autotest) once `installTools` has run.
+ * This is the same location the self-tester agent resolves via config.env.TOOL_PATH.
+ */
+function resolveAutotestDir(toolPath) {
+    return path.join(toolPath, 'test-tools', 'autotest');
 }
 /**
  * Initialize / refresh `agents/test-tools/autotest/config.yaml`:
@@ -198,6 +220,7 @@ export async function initCommand(options = {}) {
     console.log(chalk.gray('\n   Android-to-HarmonyOS skill & agent installer for AI editors\n'));
     const skillsRoot = resolveSkillsRoot();
     const agentsRoot = resolveAgentsRoot();
+    const toolsRoot = resolveToolsRoot();
     const hasSkills = await dirExists(skillsRoot);
     const hasAgents = await dirExists(agentsRoot);
     if (!hasSkills && !hasAgents) {
@@ -261,36 +284,54 @@ export async function initCommand(options = {}) {
                 type: 'input',
                 name: 'OHOS_SDK_PATH',
                 message: 'OHOS_SDK_PATH:',
-                default: config.params.OHOS_SDK_PATH || undefined,
+                default: config.env.OHOS_SDK_PATH || undefined,
             },
             {
                 type: 'input',
                 name: 'HMS_SDK_PATH',
                 message: 'HMS_SDK_PATH:',
-                default: config.params.HMS_SDK_PATH || undefined,
+                default: config.env.HMS_SDK_PATH || undefined,
             },
             {
                 type: 'input',
                 name: 'TEST_API_KEY',
                 message: 'TEST_API_KEY (for autotest config.yaml):',
-                default: config.params.TEST_API_KEY || undefined,
+                default: config.env.TEST_API_KEY || undefined,
             },
         ]);
-        config.params.OHOS_SDK_PATH = answers.OHOS_SDK_PATH.trim();
-        config.params.HMS_SDK_PATH = answers.HMS_SDK_PATH.trim();
-        config.params.TEST_API_KEY = answers.TEST_API_KEY.trim();
+        config.env.OHOS_SDK_PATH = answers.OHOS_SDK_PATH.trim();
+        config.env.HMS_SDK_PATH = answers.HMS_SDK_PATH.trim();
+        config.env.TEST_API_KEY = answers.TEST_API_KEY.trim();
         await saveHomeTransConfig(config);
     }
     catch {
         console.log(chalk.yellow('  Parameter prompts skipped (non-interactive mode).'));
     }
-    // Initialize / refresh autotest config.yaml from the example template.
+    // Copy bundled tools/ into ~/.hometrans/tools and record env.TOOL_PATH.
+    // Must run before the autotest config step below, which seeds config.yaml
+    // into the installed tools dir (the location agents read via env.TOOL_PATH).
+    let installedToolPath = null;
     try {
-        const autotestDir = resolveAutotestDir(agentsRoot);
-        const status = await refreshAutotestConfig(autotestDir, config.params.TEST_API_KEY);
-        if (status) {
-            console.log(chalk.green(`  + ${status}`));
-            console.log(chalk.gray(`    ${path.join(autotestDir, 'config.yaml')}`));
+        installedToolPath = await installTools(toolsRoot, config);
+        if (installedToolPath) {
+            console.log(chalk.green(`  + tools copied -> ${prettyHome(installedToolPath)}`));
+            console.log(chalk.gray(`    TOOL_PATH set in ${prettyHome(getConfigPath())}`));
+        }
+    }
+    catch (err) {
+        console.log(chalk.red(`  ! tools copy: ${err.message}`));
+    }
+    // Initialize / refresh autotest config.yaml from the example template,
+    // inside the installed tools dir (<TOOL_PATH>/test-tools/autotest).
+    try {
+        const toolPath = installedToolPath ?? config.env.TOOL_PATH;
+        if (toolPath) {
+            const autotestDir = resolveAutotestDir(toolPath);
+            const status = await refreshAutotestConfig(autotestDir, config.env.TEST_API_KEY);
+            if (status) {
+                console.log(chalk.green(`  + ${status}`));
+                console.log(chalk.gray(`    ${path.join(autotestDir, 'config.yaml')}`));
+            }
         }
     }
     catch (err) {

package/dist/context/index.js

@@ -84,11 +84,12 @@ async function fileExists(p) {
     return false;
   }
 }
-function defaultUserParams() {
+function defaultEnv() {
   return {
     OHOS_SDK_PATH: "",
     HMS_SDK_PATH: "",
-    TEST_API_KEY: ""
+    TEST_API_KEY: "",
+    TOOL_PATH: ""
   };
 }
 async function loadHomeTransConfig() {
@@ -96,7 +97,7 @@ async function loadHomeTransConfig() {
   if (!await fileExists(configPath)) {
     const config2 = {
       editors: defaultEditors(),
-      params: defaultUserParams()
+      env: defaultEnv()
     };
     await fs.mkdir(getConfigDir(), { recursive: true });
     await fs.writeFile(configPath, JSON.stringify(config2, null, 2) + "\n", "utf-8");
@@ -117,13 +118,20 @@ async function loadHomeTransConfig() {
     );
   }
   const config = parsed;
-  const legacy = parsed.sdkPaths;
-  if (!config.params) {
-    config.params = { ...defaultUserParams(), ...legacy ?? {} };
-  } else {
-    config.params = { ...defaultUserParams(), ...config.params };
+  const anyParsed = parsed;
+  const legacyParams = anyParsed.params ?? anyParsed.sdkPaths;
+  const legacyToolPath = typeof anyParsed.tool_path === "string" ? anyParsed.tool_path : void 0;
+  config.env = {
+    ...defaultEnv(),
+    ...legacyParams ?? {},
+    ...config.env ?? {}
+  };
+  if (legacyToolPath && !config.env.TOOL_PATH) {
+    config.env.TOOL_PATH = legacyToolPath;
   }
-  delete config.sdkPaths;
+  delete anyParsed.sdkPaths;
+  delete anyParsed.params;
+  delete anyParsed.tool_path;
   return config;
 }
 
@@ -701,10 +709,10 @@ async function extractCommitContext(input) {
   const mode = input.mode ?? "default";
   const config = await loadHomeTransConfig();
   const ohosSdkPath = expandHome(
-    input.ohosSdkPath ?? config.params.OHOS_SDK_PATH ?? process.env.OHOS_SDK_PATH ?? ""
+    input.ohosSdkPath ?? config.env.OHOS_SDK_PATH ?? process.env.OHOS_SDK_PATH ?? ""
   );
   const hmsSdkPath = expandHome(
-    input.hmsSdkPath ?? config.params.HMS_SDK_PATH ?? process.env.HMS_SDK_PATH ?? ""
+    input.hmsSdkPath ?? config.env.HMS_SDK_PATH ?? process.env.HMS_SDK_PATH ?? ""
   );
   if (!projectPath) {
     throw new Error("extractCommitContext: projectPath is required");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buaa_smat/hometrans",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "HomeTrans (Android-to-HarmonyOS) skill + agent installer. Run `ht init` to distribute conversion skills and subagents into AI editors.",
   "license": "MIT",
   "type": "module",
@@ -11,7 +11,8 @@
   "files": [
     "dist",
     "skills",
-    "agents"
+    "agents",
+    "tools"
   ],
   "scripts": {
     "build": "node scripts/build.js",

package/skills/self-test/readme.md

@@ -159,7 +159,7 @@
 | 达到最大轮数 | `max_rounds_reached` | 已完成配置的最大轮数循环（`max-rounds`，默认 3），仍有失败未解决 |
 | 编译未产出 HAP（异常） | `no_signed_hap` | build-fixer 未产出签名 HAP，无法继续测试 |
 | 用例列表为空（异常） | `no_testcases` | `testcases.json` 里 0 条用例，没有可跑的内容。常见原因：解析阶段没识别到 `### Scenario:` 区块 |
-| 自测 agent 早退（异常） | `agent_early_exit` | `self-tester` 在跑用例之前就退出了（设备没连、`config.yaml` 没填、`agents/test-tools/autotest` 目录找不到、batch 启动失败 / 超时 / 崩溃、`setup=false` 但所需 JSON 缺失等）。报告首行会是 `status: FAIL`，第二行 `reason: <原因>`。**这种情况下不会进入 fix 循环**——这些是环境/前置条件问题，不是应用缺陷 |
+| 自测 agent 早退（异常） | `agent_early_exit` | `self-tester` 在跑用例之前就退出了（设备没连、`config.yaml` 没填、`test-tools/autotest` 目录找不到（`env.TOOL_PATH` 未配置或失效）、batch 启动失败 / 超时 / 崩溃、`setup=false` 但所需 JSON 缺失等）。报告首行会是 `status: FAIL`，第二行 `reason: <原因>`。**这种情况下不会进入 fix 循环**——这些是环境/前置条件问题，不是应用缺陷 |
 
 ---
 
@@ -242,7 +242,7 @@ build-fixer 的输出摘要：编译状态、签名类型、迭代次数、修
 - 操作系统：**Windows** 是主要测试目标；macOS/Linux 上的核心命令（`hdc`、`uv`、POSIX 工具链）也能跑，Skill 里涉及到的复制操作会按可用 shell 自适应
 - `hdc` 已安装并在 PATH 中
 - `uv` 已安装（Python 包管理）
-- `agents/test-tools/autotest/config.yaml` 已配置真实 api_key
+- `<TOOL_PATH>/test-tools/autotest/config.yaml` 已配置真实 api_key（`TOOL_PATH` 取自 `~/.hometrans/config.json` 的 `env.TOOL_PATH`，默认即 `~/.hometrans/tools`；`ht init` 填好 `TEST_API_KEY` 后会自动写入）
 - 鸿蒙真机通过 USB 连接，`hdc list targets` 能看到设备
 - 签名后的 `.hap` 文件
 
@@ -262,7 +262,7 @@ A: 检查 USB 连接，跑 `hdc list targets` 看看有没有设备 SN。重新
 
 **Q: 报 config.yaml missing 或 api_key 没填？**
 
-A: 复制 `agents/test-tools/autotest/config.yaml.example` 为 `config.yaml`，把 `YOUR_API_KEY_HERE` 替换成真实的 API Key。
+A: 在 AutoTest 目录 `<TOOL_PATH>/test-tools/autotest`（`TOOL_PATH` 取自 `~/.hometrans/config.json` 的 `env.TOOL_PATH`，默认 `~/.hometrans/tools`）下，复制 `config.yaml.example` 为 `config.yaml`，把 `YOUR_API_KEY_HERE` 替换成真实的 API Key。或者重新跑 `ht init` 并填入 `TEST_API_KEY`，它会自动生成。
 
 **Q: 前置用例失败了要不要修代码？**