@buaa_smat/hometrans 0.1.13 → 0.1.15

package/skills/hmos-spec-generate/references/spec-sample-3.md

@@ -1,116 +1,116 @@
-# Spec Sample 3 — Shared-mechanic + Per-value Decomposition (Enumerated Setting with Multiple Entries)
-
-**Style focus**: enumerated settings (a "三选一" choice) accessible from MULTIPLE entry points where (a) the menu interaction is identical across all entries AND all values, (b) each value carries its own runtime semantics. Factor the shared menu interaction across all entries into ONE scenario (do NOT split per entry); give each enum value its OWN runtime-semantics scenario (do NOT bundle "user picks X" with "what X does"); cover entry-point synchronization as a separate scenario.
-
-**Anti-pattern**: splitting the mechanical scenario per entry point, or bundling "user picks X" with "what X does" in the same scenario per value — both lose information (menu mechanics get silently dropped, and per-entry duplication breaks DRY).
-
-**Read when**: 3.5 Synthesize.
-
----
-
-# 视频自动播放SPEC
-
-用户在"设置-视频偏好"入口或"视频列表页"入口的"自动播放"项中选择视频自动播放策略, 决定视频列表里视频卡片的自动播放范围。
-
-## 场景一
-
-### 场景概述
-
-用户在"设置-视频偏好"入口或"视频列表页"入口的"自动播放"项中选择一种策略
-
-### 场景逻辑步骤
-
-- 1. 用户在"设置-视频偏好"页面点击"自动播放"项, 或者用户在"视频列表页"右上角菜单中点击"自动播放"项
-- 2. 弹出三选一选项菜单, 按顺序列出: "始终自动播放" / "仅 Wi-Fi 下自动播放" / "从不自动播放"
-- 3. 选项菜单中当前生效的策略处于选中高亮状态
-- 4. 用户点击其中一个选项
-- 5. 选项菜单关闭, 新选中的策略立即生效; "自动播放"项的副标题刷新为新选中选项的文案
-- 6. 当前视频列表按新策略立即重新判定每张可见视频卡片的自动播放行为并刷新
-
-## 场景二
-
-### 场景概述
-
-应用启动时加载"自动播放"策略的上次保存值, 未设置过时按默认值生效
-
-### 场景逻辑步骤
-
-- 1. 应用启动
-- 2. 读取上次保存的"自动播放"策略值, 作为本次启动后的当前生效策略
-- 3. 如果从未设置过该选项, 或读取到的值无法识别, 则当前生效策略回退为默认值"仅 Wi-Fi 下自动播放"
-- 4. 用户从任一入口打开"自动播放"项时, 副标题与选项菜单的选中高亮均反映该当前生效值
-
-## 场景三
-
-### 场景概述
-
-当策略为"始终自动播放"时, 任意网络下可见视频卡片均自动播放
-
-### 场景逻辑步骤
-
-- 1. 当前生效策略为"始终自动播放"
-- 2. 视频列表中每张滚入可视区域的视频卡片自动开始静音播放, 不区分当前网络类型
-- 3. 视频卡片滚出可视区域时停止播放; 再次滚回时恢复播放
-
-## 场景四
-
-### 场景概述
-
-当策略为"仅 Wi-Fi 下自动播放"时, 仅 Wi-Fi 网络下视频卡片自动播放
-
-### 场景逻辑步骤
-
-- 1. 当前生效策略为"仅 Wi-Fi 下自动播放"
-- 2. 实时判定当前网络类型:
-  - 2.1 当前为 Wi-Fi 时, 视频列表中每张滚入可视区域的视频卡片自动开始静音播放
-  - 2.2 当前为蜂窝数据或离线状态时, 视频卡片显示首帧静态封面, 不自动播放
-- 3. 播放过程中网络类型切换时, 立即按新网络类型重新判定
-
-## 场景五
-
-### 场景概述
-
-当策略为"从不自动播放"时, 所有视频卡片均不自动播放
-
-### 场景逻辑步骤
-
-- 1. 当前生效策略为"从不自动播放"
-- 2. 视频列表中所有视频卡片显示首帧静态封面, 不自动启动播放
-- 3. 仅当用户主动点击视频卡片中央播放按钮时开始播放
-
-## 场景六
-
-### 场景概述
-
-用户在任一入口修改策略后, 另一入口与视频列表同步反映新值
-
-### 场景逻辑步骤
-
-- 1. 用户在"设置-视频偏好"入口或"视频列表页"入口任一处修改"自动播放"策略
-- 2. 当前视频列表立即按新策略重新判定每张可见视频卡片的自动播放行为并刷新
-- 3. 用户随后打开另一入口的"自动播放"项时, 副标题与选项菜单的选中高亮均显示为刚刚修改后的值
-- 4. 下次启动应用, 该策略依然保持为修改后的值
-
-## 场景七
-
-### 场景概述
-
-用户打开"自动播放"选项菜单后未做选择就关闭
-
-### 场景逻辑步骤
-
-- 1. 用户在任一入口打开"自动播放"项, 弹出选项菜单
-- 2. 用户通过点击菜单外部区域或按系统返回键关闭菜单, 未做任何选择
-- 3. 当前生效策略保持不变, 副标题保持原值, 视频列表自动播放行为保持原状
-
-## 场景八
-
-### 场景概述
-
-"视频自动播放"策略的作用范围与不作用范围
-
-### 场景逻辑步骤
-
-- 1. **仅作用于** 以下界面: "视频列表页"的视频卡片自动播放行为; "设置-视频偏好"页和"视频列表页"右上角菜单的"自动播放"项副标题与选项菜单选中态
-- 2. **不作用于** 以下界面: "视频详情页"(用户进入后总是自动播放, 不受策略约束) / "首页轮播视频"(由首页独立策略控制) / "搜索结果中的视频项"(不显示自动播放) / "评论区嵌入视频"(由评论区独立策略控制)
-- 3. **不作用于** 以下设备情形: 车载模式下视频卡片均不自动播放, 与策略无关
+# Spec Sample 3 — Shared-mechanic + Per-value Decomposition (Enumerated Setting with Multiple Entries)
+
+**Style focus**: enumerated settings (a "三选一" choice) accessible from MULTIPLE entry points where (a) the menu interaction is identical across all entries AND all values, (b) each value carries its own runtime semantics. Factor the shared menu interaction across all entries into ONE scenario (do NOT split per entry); give each enum value its OWN runtime-semantics scenario (do NOT bundle "user picks X" with "what X does"); cover entry-point synchronization as a separate scenario.
+
+**Anti-pattern**: splitting the mechanical scenario per entry point, or bundling "user picks X" with "what X does" in the same scenario per value — both lose information (menu mechanics get silently dropped, and per-entry duplication breaks DRY).
+
+**Read when**: 3.5 Synthesize.
+
+---
+
+# 视频自动播放SPEC
+
+用户在"设置-视频偏好"入口或"视频列表页"入口的"自动播放"项中选择视频自动播放策略, 决定视频列表里视频卡片的自动播放范围。
+
+## 场景一
+
+### 场景概述
+
+用户在"设置-视频偏好"入口或"视频列表页"入口的"自动播放"项中选择一种策略
+
+### 场景逻辑步骤
+
+- 1. 用户在"设置-视频偏好"页面点击"自动播放"项, 或者用户在"视频列表页"右上角菜单中点击"自动播放"项
+- 2. 弹出三选一选项菜单, 按顺序列出: "始终自动播放" / "仅 Wi-Fi 下自动播放" / "从不自动播放"
+- 3. 选项菜单中当前生效的策略处于选中高亮状态
+- 4. 用户点击其中一个选项
+- 5. 选项菜单关闭, 新选中的策略立即生效; "自动播放"项的副标题刷新为新选中选项的文案
+- 6. 当前视频列表按新策略立即重新判定每张可见视频卡片的自动播放行为并刷新
+
+## 场景二
+
+### 场景概述
+
+应用启动时加载"自动播放"策略的上次保存值, 未设置过时按默认值生效
+
+### 场景逻辑步骤
+
+- 1. 应用启动
+- 2. 读取上次保存的"自动播放"策略值, 作为本次启动后的当前生效策略
+- 3. 如果从未设置过该选项, 或读取到的值无法识别, 则当前生效策略回退为默认值"仅 Wi-Fi 下自动播放"
+- 4. 用户从任一入口打开"自动播放"项时, 副标题与选项菜单的选中高亮均反映该当前生效值
+
+## 场景三
+
+### 场景概述
+
+当策略为"始终自动播放"时, 任意网络下可见视频卡片均自动播放
+
+### 场景逻辑步骤
+
+- 1. 当前生效策略为"始终自动播放"
+- 2. 视频列表中每张滚入可视区域的视频卡片自动开始静音播放, 不区分当前网络类型
+- 3. 视频卡片滚出可视区域时停止播放; 再次滚回时恢复播放
+
+## 场景四
+
+### 场景概述
+
+当策略为"仅 Wi-Fi 下自动播放"时, 仅 Wi-Fi 网络下视频卡片自动播放
+
+### 场景逻辑步骤
+
+- 1. 当前生效策略为"仅 Wi-Fi 下自动播放"
+- 2. 实时判定当前网络类型:
+  - 2.1 当前为 Wi-Fi 时, 视频列表中每张滚入可视区域的视频卡片自动开始静音播放
+  - 2.2 当前为蜂窝数据或离线状态时, 视频卡片显示首帧静态封面, 不自动播放
+- 3. 播放过程中网络类型切换时, 立即按新网络类型重新判定
+
+## 场景五
+
+### 场景概述
+
+当策略为"从不自动播放"时, 所有视频卡片均不自动播放
+
+### 场景逻辑步骤
+
+- 1. 当前生效策略为"从不自动播放"
+- 2. 视频列表中所有视频卡片显示首帧静态封面, 不自动启动播放
+- 3. 仅当用户主动点击视频卡片中央播放按钮时开始播放
+
+## 场景六
+
+### 场景概述
+
+用户在任一入口修改策略后, 另一入口与视频列表同步反映新值
+
+### 场景逻辑步骤
+
+- 1. 用户在"设置-视频偏好"入口或"视频列表页"入口任一处修改"自动播放"策略
+- 2. 当前视频列表立即按新策略重新判定每张可见视频卡片的自动播放行为并刷新
+- 3. 用户随后打开另一入口的"自动播放"项时, 副标题与选项菜单的选中高亮均显示为刚刚修改后的值
+- 4. 下次启动应用, 该策略依然保持为修改后的值
+
+## 场景七
+
+### 场景概述
+
+用户打开"自动播放"选项菜单后未做选择就关闭
+
+### 场景逻辑步骤
+
+- 1. 用户在任一入口打开"自动播放"项, 弹出选项菜单
+- 2. 用户通过点击菜单外部区域或按系统返回键关闭菜单, 未做任何选择
+- 3. 当前生效策略保持不变, 副标题保持原值, 视频列表自动播放行为保持原状
+
+## 场景八
+
+### 场景概述
+
+"视频自动播放"策略的作用范围与不作用范围
+
+### 场景逻辑步骤
+
+- 1. **仅作用于** 以下界面: "视频列表页"的视频卡片自动播放行为; "设置-视频偏好"页和"视频列表页"右上角菜单的"自动播放"项副标题与选项菜单选中态
+- 2. **不作用于** 以下界面: "视频详情页"(用户进入后总是自动播放, 不受策略约束) / "首页轮播视频"(由首页独立策略控制) / "搜索结果中的视频项"(不显示自动播放) / "评论区嵌入视频"(由评论区独立策略控制)
+- 3. **不作用于** 以下设备情形: 车载模式下视频卡片均不自动播放, 与策略无关

package/skills/hmos-spec-generate/references/step4-report-template.md

@@ -1,33 +1,33 @@
-# Step 4 — Summary Report Template
-
-**Read when**: Step 4, for the report output format.
-
-Produce the report following the structure below. Keep the in-session reply within ~40 lines; per-block detail belongs in spec / trace files, not in the report.
-
-## Per-block table
-
-| feature | input title | spec path | trace path | recall | scenarios | deviations |
-|---|---|---|---|---|---|---|
-| `<feature-1>` | `<title-1>` | `<feature-1>-SPEC.md` | `.trace/<feature-1>.md` | ok | 4 | 1 |
-| `<feature-2>` | `<title-2>` | `<feature-2>-SPEC.md` | `.trace/<feature-2>.md` | ok | 2 | 0 |
-| `<feature-3>` | `<title-3>` | — | — | no_recall | — | — |
-| ... | | | | | | |
-
-Recall column values: `ok`, `no_recall`, `skipped`.
-
-## Skipped blocks
-
-If any blocks were skipped (`empty body` / `no_recall` / `error`), list them:
-
-- `<feature>` — `<title>` — reason: `empty body`
-- `<feature>` — `<title>` — reason: `no_recall`
-- `<feature>` — `<title>` — reason: `error: <verbatim error message>`
-
-## Aggregates
-
-- Total REQ blocks parsed: `<N>`
-- Total specs generated: `<M>` (M ≤ N)
-- Total atomic scenarios produced: `<S>`
-- Total deviations recorded across all traces: `<D>`
-- Count of `no_recall`: `<X>`
-- Count of `skipped`: `<Y>`
+# Step 4 — Summary Report Template
+
+**Read when**: Step 4, for the report output format.
+
+Produce the report following the structure below. Keep the in-session reply within ~40 lines; per-block detail belongs in spec / trace files, not in the report.
+
+## Per-block table
+
+| feature | input title | spec path | trace path | recall | scenarios | deviations |
+|---|---|---|---|---|---|---|
+| `<feature-1>` | `<title-1>` | `<feature-1>-SPEC.md` | `.trace/<feature-1>.md` | ok | 4 | 1 |
+| `<feature-2>` | `<title-2>` | `<feature-2>-SPEC.md` | `.trace/<feature-2>.md` | ok | 2 | 0 |
+| `<feature-3>` | `<title-3>` | — | — | no_recall | — | — |
+| ... | | | | | | |
+
+Recall column values: `ok`, `no_recall`, `skipped`.
+
+## Skipped blocks
+
+If any blocks were skipped (`empty body` / `no_recall` / `error`), list them:
+
+- `<feature>` — `<title>` — reason: `empty body`
+- `<feature>` — `<title>` — reason: `no_recall`
+- `<feature>` — `<title>` — reason: `error: <verbatim error message>`
+
+## Aggregates
+
+- Total REQ blocks parsed: `<N>`
+- Total specs generated: `<M>` (M ≤ N)
+- Total atomic scenarios produced: `<S>`
+- Total deviations recorded across all traces: `<D>`
+- Count of `no_recall`: `<X>`
+- Count of `skipped`: `<Y>`

package/tools/test-tools/autotest/README.md

@@ -20,17 +20,35 @@ HarmonyOS 应用自测执行器。负责把自然语言写的测试用例（`tes
 
 > `uv sync`（从本地 `tools/test-tools/` 目录加载 6 个 whl）由 `self_test_runner.py` 自动执行，无需手动 `pip install`。
 
-### 2. 填写 `config.yaml`（包含真实 api_key）
-
-```bash
-cd agents/test-tools/autotest
-cp config.yaml.example config.yaml
-# 编辑 config.yaml，把所有 YOUR_API_KEY_HERE 替换成真实 api_key
+### 2. 配置 `autotest`（在 `~/.hometrans/config.json` 中）
+
+AutoTest 配置不再使用本目录下的 `config.yaml`，而是集中存放在 HomeTrans 全局配置
+`~/.hometrans/config.json` 的 **`autotest`** 字段（与 `env`、`editors` 同级）。
+
+```jsonc
+{
+  "editors": [ /* ... */ ],
+  "env": { /* ... */ },
+  "autotest": {
+    "unified_model": {
+      "name": "",
+      "base_url": "",
+      "api_key": "YOUR_API_KEY_HERE",
+      "provider": "openai",
+      "temperature": 0.1,
+      "top_p": 0.9,
+      "frequency_penalty": 0.5
+    },
+    "device":  { "device_sn": null, "ip": "127.0.0.1", "port": 8710, "device_log_level": "debug" },
+    "agent":   { "max_steps": 50, "verbose": true, "lang": "zh", "enable_preprocess": false, "debug_mode": null }
+  }
+}
 ```
 
-- `config.yaml` 已加入 `.gitignore`，不会被提交到仓库。
-- `self_test_runner.py` 启动时会校验：文件存在 + 不含占位符；任一不满足则直接拒绝执行，并输出错误原因。
-- 单层模式只需填 `unified_model.api_key`；双层模式需要同时填 `execute_model.api_key` 与 `decision_model.api_key`。模式由 `agent_mode` 字段决定。
+- `ht init` 的 **测试配置** 环节会展示该块默认内容并提示填写 `api_key`（及 `name`/`base_url`/`provider`），写入 `~/.hometrans/config.json` 的 `autotest` 块。该 key 不再写入系统环境变量。
+- `api_key` 兜底：若该字段仍是占位符/空，`self_test_runner.py` 跑用例前会尝试用 OS 环境变量 `TEST_API_KEY` 补全（一般用不到，仅作手动设置时的安全网）；二者都没有才报错退出。
+- 运行时 `self_test_runner.py` 读取该块、物化成本次任务专属的临时 YAML（`task_<ts>/autotest_config.yaml`）再交给 `AutoTest.batch`，缺 `agent_mode` 时默认补 `"single"`。
+- 默认单层模式只需填 `unified_model.api_key`；如需双层模式，可在 `autotest` 块里手动加 `execute_model` / `decision_model`（各自含 `api_key`）并把 `agent_mode` 设为 `"layered"`。
 
 ---
 
@@ -87,7 +105,7 @@ hdc list targets
 
 agent 会调用 `self_test_runner.py run` 完成前 4 步（1-3 同步、4 后台启动）：
 
-1. 校验 `config.yaml`
+1. 读取并校验 `autotest` 配置（`~/.hometrans/config.json`），物化成临时 YAML
 2. `uv sync`（首次 1–3 分钟，后续按 `pyproject.toml` 的 SHA256 自动跳过）
 3. `hdc uninstall` + `hdc install -r`
 4. 后台启动 `python -m AutoTest.batch`
@@ -162,7 +180,7 @@ uv run python report_tool.py validate <out>/self-test-report.md
 | `--category` | 测试分类标签，会传给 `AutoTest.batch`，建议直接用 `app_name` |
 | `--task-dir` | 任务工作目录，脚本会在内部创建 `task_<timestamp>` 子目录 |
 | `--output-dir` | 日志目录（`self_test_*.log`） |
-| `--config` | 指定 `config.yaml` 路径；默认用本脚本同目录的 `config.yaml` |
+| `--config` | 指定 HomeTrans 配置文件（`config.json`）路径；默认 `~/.hometrans/config.json`，从中读取 `autotest` 配置 |
 | `--force-reinit` | 强制清空 `.venv` 重新 `uv sync`；默认只在 `pyproject.toml` 内容变化时重建 |
 
 `status` 子命令的 JSON 响应字段：
@@ -182,12 +200,10 @@ uv run python report_tool.py validate <out>/self-test-report.md
 ```
 agents/test-tools/autotest/
 ├── README.md                       # 本文件
-├── .gitignore                      # 排除 .venv / config.yaml / 运行期日志等
+├── .gitignore                      # 排除 .venv / 运行期日志等
 ├── pyproject.toml                  # 声明 6 个本地 whl 路径（harmony-autotest / hypium_mcp / hypium / xdevice*3，均在上一级 tools/test-tools/）
 ├── uv.lock                         # 与 pyproject.toml 配套的版本锁定文件
-├── config.yaml.example             # 用户拷贝填 api_key 的模板
-├── config.yaml                     # 用户填好的真实配置（.gitignore 中，不入库）
-├── self_test_runner.py             # 入口脚本：run / status / kill / clean
+├── self_test_runner.py             # 入口脚本：run / status / kill / clean（autotest 配置读自 ~/.hometrans/config.json）
 ├── testcases_tool.py               # 子命令 generate / validate（_extracted.json → testcases.json，含格式校验）
 ├── report_tool.py                  # 子命令 generate / validate（task_<ts>/ → self-test-report.md，含格式校验）
 ├── testcases_schema.md             # testcases.json 字段规范
@@ -198,8 +214,8 @@ agents/test-tools/autotest/
 
 ## 六、常见问题
 
-**Q: `config.yaml missing or api_key not filled`**
-A: 复制 `config.yaml.example` → `config.yaml` 并填入真实 api_key 后重试。
+**Q: `autotest 配置缺失 / api_key 没填`**
+A: 跑 `ht init` 重新生成 `~/.hometrans/config.json` 的 `autotest` 块并填好 `TEST_API_KEY`；或手动把 `autotest.unified_model.api_key` 改成真实 key；或设置 OS 环境变量 `TEST_API_KEY` 后重试。
 
 **Q: `uv sync` 卡住或失败**
 A: 6 个 whl 改为从本地 `tools/test-tools/` 目录加载（`pyproject.toml` 的 `[tool.uv.sources]` 用相对路径 `../*.whl`）。失败时确认这 6 个 whl 文件存在于上一级目录；其余依赖仍从清华 PyPI 镜像拉取，需基本网络。也可以 `--force-reinit` 强制重建。

package/tools/test-tools/autotest/self_test_runner.py

@@ -18,7 +18,7 @@
 `--testcases` 同时接受 JSON 数组（旧 `testcases.json`）与 JSONL，JSON 数组会自动转换成 JSONL。
 
 执行流程：
-    主进程：清理 + 校验 config.yaml + uv sync + hdc install hap（等待完成）
+    主进程：清理 + 读取/校验 autotest 配置（~/.hometrans/config.json）+ uv sync + hdc install hap（等待完成）
             ↓
     后台：python -m AutoTest.batch（循环执行 testcases.jsonl，cwd 为 task_<timestamp> 子目录）
 
@@ -398,27 +398,119 @@ def _prepare_testcases_jsonl(input_path: Path, task_subdir: Path) -> Path:
     return input_path
 
 
-def validate_config(config_path: Path) -> None:
-    """确保用户已提供 config.yaml 且 api_key 已替换。"""
+_MODEL_KEYS = ("unified_model", "execute_model", "decision_model")
+DEFAULT_AGENT_MODE = "single"
+
+
+def _find_hometrans_config(explicit: str | None) -> Path:
+    """定位 HomeTrans 全局配置 `~/.hometrans/config.json`（含 `autotest` 字段）。
+
+    优先级：显式 --config > 环境变量 HOMETRANS_CONFIG > 由 HOMETRANS_TOOL_PATH
+    反推（tools 目录的父目录）> 默认 ~/.hometrans/config.json。
+    """
+    if explicit:
+        return Path(explicit).resolve()
+    env_cfg = os.environ.get("HOMETRANS_CONFIG")
+    if env_cfg:
+        return Path(env_cfg).resolve()
+    tool_path = os.environ.get("HOMETRANS_TOOL_PATH")
+    if tool_path:
+        cand = Path(tool_path).resolve().parent / "config.json"
+        if cand.exists():
+            return cand
+    return Path.home() / ".hometrans" / "config.json"
+
+
+def _model_dicts(autotest: dict):
+    """遍历 autotest 里存在的模型端点（单层 unified_model / 双层 execute+decision）。"""
+    for key in _MODEL_KEYS:
+        model = autotest.get(key)
+        if isinstance(model, dict):
+            yield key, model
+
+
+def load_autotest_config(explicit: str | None) -> dict:
+    """从 `~/.hometrans/config.json` 读取 `autotest` 配置并校验。
+
+    - 缺文件 / 缺 `autotest` 字段 → 报错退出，提示运行 `ht init`。
+    - 任一模型端点的 api_key 仍为占位符/空时，用 OS 环境变量 TEST_API_KEY 兜底填充。
+    - 兜底后仍有未填的 api_key → 报错退出。
+    - 缺 `agent_mode` 时默认补 "single"。
+    返回可直接物化成 YAML 的 dict。
+    """
+    config_path = _find_hometrans_config(explicit)
     if not config_path.exists():
         logger.error(
-            f"未找到配置文件: {config_path}\n"
-            f"请复制 `config.yaml.example` 为 `config.yaml` 并填入真实 api_key 后重试。"
+            f"未找到 HomeTrans 配置文件: {config_path}\n"
+            f"请先运行 `ht init` 生成 ~/.hometrans/config.json（其中包含 autotest 配置）。"
         )
         sys.exit(1)
 
     try:
-        text = config_path.read_text(encoding="utf-8")
-    except OSError as e:
-        logger.error(f"无法读取配置文件 {config_path}: {e}")
+        data = json.loads(config_path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError) as e:
+        logger.error(f"无法解析配置文件 {config_path}: {e}")
         sys.exit(1)
 
-    if API_KEY_PLACEHOLDER in text:
+    autotest = data.get("autotest") if isinstance(data, dict) else None
+    if not isinstance(autotest, dict):
         logger.error(
-            f"配置文件 {config_path} 中仍包含占位符 `{API_KEY_PLACEHOLDER}`，请将所有 api_key 替换为真实值后重试。"
+            f"配置文件 {config_path} 缺少 `autotest` 配置。请运行 `ht init` 重新生成。"
         )
         sys.exit(1)
 
+    # 深拷贝，避免改动原始 dict（虽然这里只读不写回）
+    autotest = json.loads(json.dumps(autotest))
+
+    # 用 OS 环境变量 TEST_API_KEY 兜底填充占位/空 api_key
+    env_key = os.environ.get("TEST_API_KEY", "").strip()
+    missing = []
+    for name, model in _model_dicts(autotest):
+        cur = str(model.get("api_key", "")).strip()
+        if not cur or cur == API_KEY_PLACEHOLDER:
+            if env_key:
+                model["api_key"] = env_key
+            else:
+                missing.append(f"{name}.api_key")
+
+    if not list(_model_dicts(autotest)):
+        logger.error(
+            f"配置文件 {config_path} 的 autotest 未定义任何模型端点"
+            f"（unified_model / execute_model / decision_model）。"
+        )
+        sys.exit(1)
+
+    if missing:
+        logger.error(
+            f"autotest 配置中以下 api_key 仍为占位符/空：{', '.join(missing)}。\n"
+            f"请在 {config_path} 的 autotest 配置里填入真实 api_key，"
+            f"或设置 OS 环境变量 TEST_API_KEY 后重试。"
+        )
+        sys.exit(1)
+
+    autotest.setdefault("agent_mode", DEFAULT_AGENT_MODE)
+    logger.info(
+        f"已从 {config_path} 读取 autotest 配置（agent_mode={autotest.get('agent_mode')}）"
+    )
+    return autotest
+
+
+def materialize_config(autotest: dict, dest: Path) -> Path:
+    """把 autotest dict 物化成 YAML 文件交给 `AutoTest.batch --config`。
+
+    优先用 PyYAML 输出标准块状 YAML；系统 Python 没装 PyYAML 时退回写 JSON
+    内容（JSON 是合法的 YAML，AutoTest 的 yaml.safe_load 同样可解析）。
+    """
+    dest.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        import yaml  # type: ignore
+
+        text = yaml.safe_dump(autotest, allow_unicode=True, sort_keys=False)
+    except Exception:
+        text = json.dumps(autotest, ensure_ascii=False, indent=2)
+    dest.write_text(text, encoding="utf-8")
+    return dest
+
 
 def cmd_run(args):
     """run 子命令：准备环境 + 后台执行 AutoTest.batch"""
@@ -475,12 +567,13 @@ def cmd_run(args):
             pass
 
     try:
-        # 在删 venv / 跑 uv 之前先校验 uv 与 config.yaml，避免清理后才发现缺东西
+        # 在删 venv / 跑 uv 之前先校验 uv 与 autotest 配置，避免清理后才发现缺东西
         uv = get_uv()
 
-        config_path = Path(args.config).resolve() if args.config else (SCRIPT_DIR / "config.yaml")
-        validate_config(config_path)
-        logger.info(f"配置文件: {config_path}")
+        # 从 ~/.hometrans/config.json 读取 autotest 配置，物化成本次任务专属的 YAML
+        autotest_cfg = load_autotest_config(args.config)
+        config_path = materialize_config(autotest_cfg, task_subdir / "autotest_config.yaml")
+        logger.info(f"配置文件（由 config.json 的 autotest 字段生成）: {config_path}")
 
         cleanup_before_run(force_reinit=args.force_reinit)
 
@@ -742,7 +835,8 @@ def main():
     p_run.add_argument("--output-dir", default=None, help="日志目录")
     p_run.add_argument("--category", default=DEFAULT_CATEGORY, help="测试分类名称，传给 AutoTest.batch")
     p_run.add_argument("--config", default=None,
-                       help="AutoTest 配置文件绝对路径；默认为脚本同目录下的 config.yaml")
+                       help="HomeTrans 配置文件（config.json）路径；默认 ~/.hometrans/config.json，"
+                            "从中读取 autotest 配置并物化成临时 YAML 交给 AutoTest.batch")
     p_run.add_argument("--force-reinit", action="store_true",
                        help="强制清理 .venv 并重新 uv sync；默认仅在 pyproject.toml 内容变更时才重建")
     p_run.set_defaults(func=cmd_run)

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

@@ -1,11 +0,0 @@
-{
-  "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": ""
-}

package/tools/test-tools/autotest/config.yaml.example

@@ -1,58 +0,0 @@
-# AutoTest Configuration — User-provided overlay
-#
-# 使用方法：
-#   1. 复制本文件为同目录下的 `config.yaml`
-#   2. 填入所有 `YOUR_API_KEY_HERE` 占位的真实 api_key（至少 unified_model 或对应模式下的 model）
-#   3. self_test_runner.py 在启动前会校验 config.yaml 存在且 api_key 已替换，否则拒绝执行
-#
-# 该文件最终通过 `python -m AutoTest.batch --config <绝对路径>` 注入到 AutoTest，
-# 覆盖 whl 内置的同名默认配置（默认配置里 api_key 全是占位符）。
-
-# Agent Mode: "layered" (双层模式) | "single" (单层模式)
-agent_mode: "single"
-
-# ===== 双层模式配置 =====
-execute_model:
-  name: "gui-plus-2026-02-26"
-  base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"
-  api_key: "YOUR_API_KEY_HERE"
-  provider: "mai-ui"
-  max_steps: 3
-
-decision_model:
-  name: "qwen3.5-plus"
-  base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"
-  api_key: "YOUR_API_KEY_HERE"
-  provider: "openai"
-  temperature: 0.0
-  top_p: 0.1
-  frequency_penalty: 1.0
-
-# ===== 单层模式配置 =====
-unified_model:
-  name: "qwen3.5-plus"
-  base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"
-  api_key: "YOUR_API_KEY_HERE"
-  provider: "openai"
-  temperature: 0.1
-  top_p: 0.9
-  frequency_penalty: 0.5
-
-# ===== 设备配置 =====
-device:
-  device_sn: null
-  ip: "127.0.0.1"
-  port: 8710
-  device_log_level: "debug"
-
-# ===== Agent 通用配置 =====
-agent:
-  max_steps: 50
-  verbose: true
-  lang: "zh"
-  enable_preprocess: false
-  # debug_mode: null | "memory" | "file"
-  debug_mode: null
-
-# ===== 自定义适配器（可选） =====
-# adapter_class: "external.custom_adapter.CustomMCPAdapter"