@buaa_smat/hometrans 0.1.14 → 0.1.16

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

@@ -14,11 +14,10 @@ HarmonyOS 应用自测执行器。负责把自然语言写的测试用例（`tes
 
 | 工具 | 用途 | 验证命令 |
 |------|------|----------|
-| `uv` | Python 包管理 / 启动 `harmony-autotest` | `uv --version` |
+| `uv` | Python 包管理 / 启动 `harmony-autotest` / 提供 Python 解释器 | `uv --version` |
 | `hdc` | 设备连接 / 安装 HAP | `hdc version` |
-| `python` ≥ 3.10 | 入口脚本 | `python --version` |
 
-> `uv sync`（从本地 `tools/test-tools/` 目录加载 6 个 whl）由 `self_test_runner.py` 自动执行，无需手动 `pip install`。
+> 入口脚本经 `uv run --no-project python self_test_runner.py` 运行 —— uv 自带 Python（≥ 3.10），无需单独安装 Python。`uv sync`（从本地 `tools/test-tools/` 目录加载 6 个 whl）由 `self_test_runner.py` 自动执行，无需手动 `pip install`。
 
 ### 2. 配置 `autotest`（在 `~/.hometrans/config.json` 中）
 
@@ -45,8 +44,8 @@ AutoTest 配置不再使用本目录下的 `config.yaml`，而是集中存放在
 }
 ```
 
-- `ht init` 的 **测试配置** 环节会展示该块默认内容并提示填写 `api_key`（及 `name`/`base_url`/`provider`），写入 `~/.hometrans/config.json` 的 `autotest` 块。该 key 不再写入系统环境变量。
-- `api_key` 兜底：若该字段仍是占位符/空，`self_test_runner.py` 跑用例前会尝试用 OS 环境变量 `TEST_API_KEY` 补全（一般用不到，仅作手动设置时的安全网）；二者都没有才报错退出。
+- `ht init` 的 **模型配置** 环节会展示该块默认内容并提示填写 `api_key`（及 `name`/`base_url`/`provider`），写入 `~/.hometrans/config.json` 的 `autotest.unified_model`，并导出为 `HOMETRANS_MODEL_*` 环境变量（与 UI 对齐共用同一个模型）。
+- 模型字段解析链路「环境变量 → config.json → 报错」：`self_test_runner.py` 跑用例前用 OS 环境变量 `HOMETRANS_MODEL_API_KEY` / `HOMETRANS_MODEL_NAME` / `HOMETRANS_MODEL_BASE_URL` 覆盖 config.json 里 `unified_model` 的对应字段（api_key 兼容老版本 `TEST_API_KEY` 作兜底；`provider` 不导出为环境变量，始终取 config.json，默认 openai）；覆盖后 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"`。
 
@@ -128,7 +127,7 @@ agent 内部用的就是这个脚本，开发自测时可以直接调：
 cd agents/test-tools/autotest
 
 # 启动一次自测（前台同步做准备 + 后台启动 batch，立即返回 PID）
-python self_test_runner.py run \
+uv run --no-project python self_test_runner.py run \
     --testcases <path-to-testcases.json>  \
     --hap       <path-to-app.hap>          \
     --bundle-name com.example.xxx          \
@@ -137,14 +136,14 @@ python self_test_runner.py run \
     --output-dir <out>
 
 # 轮询状态（agent 每 60s 查一次）
-python self_test_runner.py status --task-dir <out>/task --output-dir <out>
+uv run --no-project python self_test_runner.py status --task-dir <out>/task --output-dir <out>
 
 # 强行终止后台 batch
-python self_test_runner.py kill   --task-dir <out>/task
+uv run --no-project python self_test_runner.py kill   --task-dir <out>/task
 
 # 重置本地状态（杀残留进程 + 删 .venv + 删本目录残留中间产物）
 # 用它代替手工 `rm -rf .venv` / `uv cache clean`，不会动全局 uv 缓存
-python self_test_runner.py clean
+uv run --no-project python self_test_runner.py clean
 ```
 
 ### `report_tool.py` — 单独重渲染报告
@@ -215,7 +214,7 @@ agents/test-tools/autotest/
 ## 六、常见问题
 
 **Q: `autotest 配置缺失 / api_key 没填`**
-A: 跑 `ht init` 重新生成 `~/.hometrans/config.json` 的 `autotest` 块并填好 `TEST_API_KEY`；或手动把 `autotest.unified_model.api_key` 改成真实 key；或设置 OS 环境变量 `TEST_API_KEY` 后重试。
+A: 跑 `ht init` 配置统一模型，它会写入 `~/.hometrans/config.json` 的 `autotest.unified_model` 并导出 `HOMETRANS_MODEL_*` 环境变量；或手动把 `autotest.unified_model.api_key` 改成真实 key；或设置 OS 环境变量 `HOMETRANS_MODEL_API_KEY`（兼容老版本 `TEST_API_KEY`）后重试。
 
 **Q: `uv sync` 卡住或失败**
 A: 6 个 whl 改为从本地 `tools/test-tools/` 目录加载（`pyproject.toml` 的 `[tool.uv.sources]` 用相对路径 `../*.whl`）。失败时确认这 6 个 whl 文件存在于上一级目录；其余依赖仍从清华 PyPI 镜像拉取，需基本网络。也可以 `--force-reinit` 强制重建。
@@ -224,7 +223,7 @@ A: 6 个 whl 改为从本地 `tools/test-tools/` 目录加载（`pyproject.toml`
 A: 不会。`self_test_runner.py run` 启动时会扫描并 kill 残留的 `AutoTest.batch` / `hypium_mcp` / `harmony_autotest` 进程（不止靠 PID 文件，按命令行名兜底），并自动清掉本目录顶层的 `tmp_hypium/` / `hypium_mcp.log` 等遗留中间产物。`task/` 目录在 agent 流程里也会被清空。
 
 **Q: 想彻底重置一遍本地状态再跑？**
-A: 跑一次 `python self_test_runner.py clean`：杀残留 → 删 `.venv` → 删 `tmp_hypium/` / `hypium_mcp.log` / `batch.pid` / `batch_stdout.log`。**不要**手工 `uv cache clean`——全局缓存清空后重装 6 个 whl 要从 gitcode 重新拉（1–3 分钟）；这 6 个 whl 现在从本地加载、不走网络，但其余依赖仍走缓存，保留缓存的话 `uv sync` 只需几秒。
+A: 跑一次 `uv run --no-project python self_test_runner.py clean`：杀残留 → 删 `.venv` → 删 `tmp_hypium/` / `hypium_mcp.log` / `batch.pid` / `batch_stdout.log`。**不要**手工 `uv cache clean`——全局缓存清空后重装 6 个 whl 要从 gitcode 重新拉（1–3 分钟）；这 6 个 whl 现在从本地加载、不走网络，但其余依赖仍走缓存，保留缓存的话 `uv sync` 只需几秒。
 
 **Q: 想自己改 `testcases.json` 后再跑？**
 A: 改完后跑一遍校验，再交给 `self-tester`（`setup=false`）：

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

@@ -333,9 +333,15 @@ def get_uv():
 
 
 def _uv_env():
+    # Isolate inner uv calls (`uv sync`, `uv run --project`) from the outer
+    # `uv run --no-project` context that launches this script: drop the
+    # recursion marker and any inherited VIRTUAL_ENV so the inner uv always
+    # targets SCRIPT_DIR/.venv, never the launcher's ephemeral environment.
     env = os.environ.copy()
     env["UV_NO_PROGRESS"] = "1"
     env["RUST_LOG"] = "off"
+    env.pop("UV_RUN_RECURSION_DEPTH", None)
+    env.pop("VIRTUAL_ENV", None)
     return env
 
 
@@ -433,8 +439,9 @@ def load_autotest_config(explicit: str | None) -> dict:
     """从 `~/.hometrans/config.json` 读取 `autotest` 配置并校验。
 
     - 缺文件 / 缺 `autotest` 字段 → 报错退出，提示运行 `ht init`。
-    - 任一模型端点的 api_key 仍为占位符/空时，用 OS 环境变量 TEST_API_KEY 兜底填充。
-    - 兜底后仍有未填的 api_key → 报错退出。
+    - 模型字段优先用 OS 环境变量 HOMETRANS_MODEL_* 覆盖 config.json
+      （api_key 兼容老版本 TEST_API_KEY 作兜底）。
+    - 覆盖后仍有未填的 api_key → 报错退出。
     - 缺 `agent_mode` 时默认补 "single"。
     返回可直接物化成 YAML 的 dict。
     """
@@ -462,16 +469,34 @@ def load_autotest_config(explicit: str | None) -> dict:
     # 深拷贝，避免改动原始 dict（虽然这里只读不写回）
     autotest = json.loads(json.dumps(autotest))
 
-    # 用 OS 环境变量 TEST_API_KEY 兜底填充占位/空 api_key
-    env_key = os.environ.get("TEST_API_KEY", "").strip()
+    # 统一配置链路「环境变量 → config.json → 报错」：UI 对齐与自测共用同一个多模态
+    # 模型，由 `ht init` 导出为 HOMETRANS_MODEL_*。环境变量优先级最高——存在即覆盖
+    # config.json 里 unified_model 的对应字段；缺失时才用 config.json 的值。
+    # provider 不导出为环境变量（默认 openai），始终取 config.json 的值。
+    env_model = {
+        "api_key": (
+            os.environ.get("HOMETRANS_MODEL_API_KEY", "").strip()
+            or os.environ.get("TEST_API_KEY", "").strip()  # 兼容老版本
+        ),
+        "name": os.environ.get("HOMETRANS_MODEL_NAME", "").strip(),
+        "base_url": os.environ.get("HOMETRANS_MODEL_BASE_URL", "").strip(),
+    }
+    um = autotest.get("unified_model")
+    if isinstance(um, dict):
+        for field in ("api_key", "name", "base_url"):
+            if env_model[field]:
+                um[field] = env_model[field]
+    # api_key 为各端点共用：环境变量存在时一并覆盖 execute/decision 双层模式的端点。
+    if env_model["api_key"]:
+        for _name, model in _model_dicts(autotest):
+            model["api_key"] = env_model["api_key"]
+
+    # 覆盖后仍为占位符/空的 api_key → 收集后报错（链路最后一层：提示用户配置）。
     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")
+            missing.append(f"{name}.api_key")
 
     if not list(_model_dicts(autotest)):
         logger.error(
@@ -484,7 +509,7 @@ def load_autotest_config(explicit: str | None) -> dict:
         logger.error(
             f"autotest 配置中以下 api_key 仍为占位符/空：{', '.join(missing)}。\n"
             f"请在 {config_path} 的 autotest 配置里填入真实 api_key，"
-            f"或设置 OS 环境变量 TEST_API_KEY 后重试。"
+            f"或设置 OS 环境变量 HOMETRANS_MODEL_API_KEY 后重试（可运行 `ht init` 一并配置）。"
         )
         sys.exit(1)
 
@@ -536,8 +561,9 @@ def cmd_run(args):
         msg = (
             f"Refusing to run: this script is executing inside {target_venv}, "
             f"which it is about to delete and recreate (Windows file locks will leave "
-            f"the venv in a broken state). Invoke with the system Python instead, e.g. "
-            f"`python self_test_runner.py run ...` (NOT `uv run python ...`)."
+            f"the venv in a broken state). Invoke it so the interpreter stays OUT of "
+            f"that venv, e.g. `uv run --no-project python self_test_runner.py run ...` "
+            f"(NOT plain `uv run python ...`, which would execute inside the project venv)."
         )
         logger.error(msg)
         print(json.dumps({"status": "ERROR", "reason": msg}))
@@ -622,7 +648,9 @@ def cmd_run(args):
 
         # 后台启动 AutoTest.batch
         logger.info("=== Step 3: 后台启动 AutoTest.batch ===")
-        batch_env = os.environ.copy()
+        # _uv_env() so the detached `uv run --project` also stays isolated from
+        # the outer `uv run --no-project` launcher context.
+        batch_env = _uv_env()
         batch_env["PYTHONIOENCODING"] = "utf-8"
         batch_env["PYTHONUTF8"] = "1"
         batch_env["PYTHONUNBUFFERED"] = "1"