@buaa_smat/hometrans 0.1.9 → 0.1.11

package/dist/cli/uninstall.js

@@ -17,7 +17,7 @@ import chalk from 'chalk';
 import inquirer from 'inquirer';
 import { modify, applyEdits } from 'jsonc-parser';
 import { expandHome, loadHomeTransConfig, } from './config-store.js';
-import { dirExists, prettyHome } from './init.js';
+import { dirExists, isPromptAbort, prettyHome } from './init.js';
 const execFileAsync = promisify(execFile);
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -291,14 +291,25 @@ export async function uninstallCommand() {
     if (plan.deletions.length === 0 && plan.modifications.length === 0) {
         return;
     }
-    const { proceed } = await inquirer.prompt([
-        {
-            type: 'confirm',
-            name: 'proceed',
-            message: 'Continue?',
-            default: false,
-        },
-    ]);
+    let proceed;
+    try {
+        ({ proceed } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'proceed',
+                message: 'Continue?',
+                default: false,
+            },
+        ]));
+    }
+    catch (err) {
+        // Ctrl-C / Esc at the confirm prompt — cancel cleanly, no stack trace.
+        if (isPromptAbort(err)) {
+            console.log(chalk.yellow('\n  Uninstall cancelled. No files modified.\n'));
+            process.exit(130);
+        }
+        throw err;
+    }
     if (!proceed) {
         console.log(chalk.yellow('\n  Uninstall cancelled. No files modified.\n'));
         return;

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");
 }
@@ -73,6 +96,19 @@ function defaultEditors() {
         path: "~/.codex/config.toml",
         section: "mcp_servers.hometrans"
       }
+    },
+    {
+      // CodeBuddy（腾讯）：与 Claude Code 同构的 .codebuddy/ 目录，
+      // 全局安装映射到 ~/.codebuddy/{skills,agents}，MCP 走 mcpServers JSON。
+      name: "CodeBuddy",
+      markerDir: "~/.codebuddy",
+      skillsDir: "~/.codebuddy/skills",
+      agentsDir: "~/.codebuddy/agents",
+      mcp: {
+        format: "jsonc-object",
+        path: "~/.codebuddy/mcp.json",
+        keyPath: ["mcpServers", "hometrans"]
+      }
     }
   ];
 }
@@ -86,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: ""
   };
 }
@@ -132,8 +171,41 @@ 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)
+  );
+  if (missingEditors.length > 0) {
+    config.editors.push(...missingEditors);
+    await saveHomeTransConfig(config);
+  }
   return config;
 }
+async function saveHomeTransConfig(config) {
+  const configPath = getConfigPath();
+  await fs.mkdir(getConfigDir(), { recursive: true });
+  await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
 
 // src/context/analysis/ArkTsGitInfoAnalysis.ts
 import {

package/package.json

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

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).