@buaa_smat/hometrans 0.1.10 → 0.1.11

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