@autotest/plugin 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -12
- package/dist/index.js +1 -1
- package/dist/skills/autotest-batch-executor/SKILL.md +16 -13
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -119,10 +119,10 @@ NPM_CONFIG_REGISTRY=http://127.0.0.1:4873 deveco plugin @autotest/plugin
|
|
|
119
119
|
工具参数 > 工厂 options > sidecar > 环境变量 > 默认值
|
|
120
120
|
```
|
|
121
121
|
|
|
122
|
-
-
|
|
122
|
+
- 工具参数为 `task` / `task_name` / `max_loops` / `config_path` / `report_dir` / `device_sn`(调用时覆盖);`max_loops` 取 0–3,缺省 2(默认闭环、最多两轮;0 禁用闭环、1 单次执行);其中 `device_sn` 只覆盖目标设备序列号(`config.device.deviceSn`)——缺省跟随 config(该值为空则自动选首台在线设备),**不改** `device.ip` / `device.port`(远程设备地址仍取 config);
|
|
123
123
|
- 工厂 options(插件工厂第二参数)与 sidecar 同 schema,优先级高于 sidecar;
|
|
124
124
|
- 环境变量只提供 `AUTOTEST_BIN`(→ cliPath)与 `AUTOTEST_CONFIG`(→ configPath);
|
|
125
|
-
- 报告根 / 解释器 /
|
|
125
|
+
- 报告根 / 解释器 / 超时走默认值;`cliPath` 四源全失败(含包内解析)→ 错误码 T3。
|
|
126
126
|
|
|
127
127
|
### sidecar:`.deveco/autotest-plugin.json`
|
|
128
128
|
|
|
@@ -134,8 +134,7 @@ NPM_CONFIG_REGISTRY=http://127.0.0.1:4873 deveco plugin @autotest/plugin
|
|
|
134
134
|
| `configPath` | string | 无 | AutoTest `config.yaml` 绝对路径(**可选**:模型段由 devco 凭据注入,见 §模型配置;该文件只承载非模型配置) |
|
|
135
135
|
| `reportsRoot` | string | `<devco 工程目录>/autotest-reports` | 报告根目录;非绝对路径按工程目录解析 |
|
|
136
136
|
| `nodePath` | string | `"node"` | 子进程解释器;受限环境兜底 |
|
|
137
|
-
| `timeoutMinutes` | number | `30` | 超时 kill
|
|
138
|
-
| `maxConcurrent` | number | `1` | 最大并发任务数;当前版本恒为 1(busy 即拒绝、不排队) |
|
|
137
|
+
| `timeoutMinutes` | number | `30` | 超时 kill 阈值(分钟);**默认闭环两轮,建议调大**(见 §生命周期) |
|
|
139
138
|
| `env` | object | `{}` | 透传给子进程的附加环境变量(合并进宿主环境,同名覆盖) |
|
|
140
139
|
|
|
141
140
|
示例(`cliPath` 通常无需填写;仅当使用自定义 CLI 路径时才加入该字段):
|
|
@@ -145,7 +144,6 @@ NPM_CONFIG_REGISTRY=http://127.0.0.1:4873 deveco plugin @autotest/plugin
|
|
|
145
144
|
"configPath": "<AUTOTEST_CONFIG_ABS>",
|
|
146
145
|
"reportsRoot": "<AUTOTEST_REPORTS_ABS>",
|
|
147
146
|
"timeoutMinutes": 30,
|
|
148
|
-
"maxConcurrent": 1,
|
|
149
147
|
"env": {}
|
|
150
148
|
}
|
|
151
149
|
```
|
|
@@ -258,11 +256,22 @@ devco 宿主在工具 `execute` 返回后立即触发该次工具调用的 `Abor
|
|
|
258
256
|
|
|
259
257
|
### Loop 任务建议调大 timeoutMinutes
|
|
260
258
|
|
|
261
|
-
闭环任务(`max_loops ≥ 2
|
|
259
|
+
闭环任务(`max_loops ≥ 2`,**缺省即 2**)总耗时按轮数成倍增长——默认 30 分钟可能不足。若闭环任务被超时 kill(查询返回 KILLED),在 `.deveco/autotest-plugin.json` 调大 `timeoutMinutes` 后重试。
|
|
262
260
|
|
|
263
|
-
###
|
|
261
|
+
### 并发使用(同一窗口多任务)
|
|
264
262
|
|
|
265
|
-
|
|
263
|
+
插件**不限制**同一 devco 实例内的并发任务数:已有任务在跑时再次调用 `autotest_run_task` 会照常创建新子进程并立即返回新的 `taskId` / `reportDir`,不排队、不拒绝。每个任务各自 spawn 子进程,`reportDir`、超时计时、abort 监听与临时 config 清理也都各自独立。
|
|
264
|
+
|
|
265
|
+
并发安全由调用方掌握,插件不做防护:
|
|
266
|
+
|
|
267
|
+
- **并发跑不同设备**:每次调用传不同的 `device_sn` 即可,**同一个 `config_path` 可以共用**(设备由该参数决定,config 只提供 `ip` / `port` 等其余字段)。`device_sn` 只覆盖序列号,不改 `device.ip` / `device.port`——远程设备地址仍取 config。
|
|
268
|
+
- **同一设备并发 = 多个任务抢同一台设备**:两个任务传同一个 `device_sn`(或都不传而落到同一 config 设备)即共享同一台设备,两个 agent 会互相干扰 UI 状态,插件不做防护。设备解析链为 `device_sn` 参数 > config 的 `device.device_sn`;两者都没有时 hypium 在连接期静默 auto-pick 首台在线设备,没有 guard——需要并行时请显式传 `device_sn`(或为 config 显式指定设备)。
|
|
269
|
+
- **`device_sn` 生效的前提是 CLI 为含该修复的构建**:运行环境里的 CLI 必须真正实现 `--device` 对 `config.device.deviceSn` 的覆盖。旧构建会把 `--device` 解析后忽略,任务静默落到 config 设备或 auto-pick 的首台设备——自查方法见 §故障排查(报告目录 stream log 的 banner `sn=`)。
|
|
270
|
+
- **并发任务显式传同一 `report_dir` = 报告互相覆盖**:多个任务落到同一目录时,报告文件同名互相覆盖,插件不做防护。不传 `report_dir` 时各任务默认落在 `<reportsRoot>/<taskId>`(`taskId` 含时间戳 + 随机后缀),天然隔离。
|
|
271
|
+
|
|
272
|
+
### 跨 devco 实例的任务表竞态
|
|
273
|
+
|
|
274
|
+
进程内并发任务数**没有上限**,任务表因此允许同时存在多条 `status: "running"` 记录(同进程内落盘为同步整段执行,不会交错)。同一工程若同时运行多个 devco 实例,任务表文件(`<reportsRoot>/.plugin-tasks.json`)存在 last-write-wins 竞态。实际危害低——报告读取不依赖任务表(文件系统是最终事实源),但多实例并发发起任务不作为常态使用。
|
|
266
275
|
|
|
267
276
|
---
|
|
268
277
|
|
|
@@ -270,7 +279,7 @@ devco 宿主在工具 `execute` 返回后立即触发该次工具调用的 `Abor
|
|
|
270
279
|
|
|
271
280
|
### 版本与缓存
|
|
272
281
|
|
|
273
|
-
插件版本号硬编码在 `integrations/deveco/
|
|
282
|
+
插件版本号硬编码在 `integrations/deveco/shared/version.ts` 的 `PLUGIN_VERSION` 常量(index.ts 的版本日志与 update_checker 的自更新比较共用),与 `integrations/deveco/package.json` 的 `version` 必须一致(契约测试断言)——它同时是版本漂移的诊断锚点(宿主 server logs 的 `loaded, version=<semver>`)。
|
|
274
283
|
|
|
275
284
|
devco 的包缓存目录名固定为 `<name>@latest`,**命中即复用,上游发新版不会自动拉取**。本包的缓存目录即 `%USERPROFILE%\.cache\deveco\packages\@autotest\plugin@latest`——升级必须先手删它,否则重装仍在用旧包:
|
|
276
285
|
|
|
@@ -281,6 +290,18 @@ rmdir /s /q "%USERPROFILE%\.cache\deveco\packages\@autotest\plugin@latest"
|
|
|
281
290
|
deveco plugin @autotest/plugin
|
|
282
291
|
```
|
|
283
292
|
|
|
293
|
+
### 自更新检测(L1:检测 + 提示)
|
|
294
|
+
|
|
295
|
+
插件在每次装配(devco 启动)时后台检测安装源 registry 是否有新版本,**只检测、只提示,绝不自动安装**(devco 缓存命中即复用,自动安装也装不进去——见上节):
|
|
296
|
+
|
|
297
|
+
- **registry 自发现**:从插件产物根上溯到 devco 包缓存根,读 `package-lock.json` 里本包条目的 `resolved` 提取安装源(如本地镜像 `http://127.0.0.1:4873`)——提示里的重装命令带的就是这个源,无需用户记得装包时用的哪个 registry。
|
|
298
|
+
- **提示通道**(toast 通道已实测不可用:宿主 `client.tui.showToast` 调用永不返回且不弹窗,正式实现不碰):
|
|
299
|
+
1. 宿主 server logs(`update available: <旧> -> <新>(cache: <缓存目录>;reinstall: …)`);
|
|
300
|
+
2. 工具响应附带 `update_hint` 块(`autotest_run_task` / `autotest_get_report` 的 output 末尾 + metadata)——**仅随每个会话的首个工具响应附带一次**(会话级一次性消费,同会话后续工具响应不重复)。块内自带转述指令行(真实会话实测:提示正文出现三次、模型零转述,纯提示词规则显著性不足),与 Test agent prompt 注入的「升级提示纪律」段互为双保险,agent 向用户转述一次(含精确缓存目录、重装命令与重启步骤)。
|
|
301
|
+
- **版本比较**:严格 x.y.z 语义比较,仅 registry `latest` **大于**本地版本才提示(registry 落后本地不误报);非严格格式(预发布等)降级字符串不等比较。
|
|
302
|
+
- **提示频率**:检测每次 devco 启动(插件装配)一次;检测到新版后,升级提示**仅随每个会话的首个工具响应出现一次**(同会话后续工具响应不重复);版本差距消除前,每个新会话(含重启 devco)各提示一次。
|
|
303
|
+
- **fail-silent**:检测链路任何失败(缓存布局不适用、registry 不可达、超时 5s、dist-tags 形状异常)都静默降级为「无提示」,只留一条 pluginLog 诊断行——绝不影响插件装配与工具执行;仓库内直跑(无缓存布局)自然跳过。
|
|
304
|
+
|
|
284
305
|
### 发布顺序(兼容断点)
|
|
285
306
|
|
|
286
307
|
本包只依赖 `@autotest/agent` 的 **CLI**(`dist/autotest-cli.js`),不依赖它的插件入口。因此切换顺序是:
|
|
@@ -330,7 +351,7 @@ npm run release:check # 聚合门:主包 build → check:pack → 本包 npm
|
|
|
330
351
|
|
|
331
352
|
| 错误码 | 场景 | 处理 |
|
|
332
353
|
|---|---|---|
|
|
333
|
-
| T1 |
|
|
354
|
+
| T1 | 已退役(0.1.1 移除进程内并发互斥) | 无需处理——并发发起任务不再被拒绝,任务表可同时存在多条 `running` |
|
|
334
355
|
| T2 | `configPath` 三源全空的状态描述(**不是报错**:`configPath` 可选) | 无需处理——模型段由 devco 凭据注入;仅当还要携带非模型配置(设备 / Agent / 输出)时才三选一提供 `configPath`:① sidecar 写 `{"configPath": "<绝对路径>/config.yaml"}`;② 环境变量 `AUTOTEST_CONFIG=<绝对路径>`;③ 调用工具时传 `config_path` 参数 |
|
|
335
356
|
| T3 | 未找到 CLI(四源全失败,含包内解析) | 确认 `@autotest/agent` 安装完整(含 `dist/autotest-cli.js` 且版本落在 `>=0.0.25 <0.2.0`);仍失败时在 `.deveco/autotest-plugin.json` 写 `{"cliPath": "<绝对路径>/dist/autotest-cli.js"}` 显式指定 |
|
|
336
357
|
| T4 | 子进程启动失败 | 检查 `node` 是否在 PATH(或 sidecar `nodePath` 指向有效解释器)、CLI 文件是否存在 |
|
|
@@ -338,10 +359,9 @@ npm run release:check # 聚合门:主包 build → check:pack → 本包 npm
|
|
|
338
359
|
| T6 | 任务启动前已被取消 | abort 预检命中,未创建子进程 |
|
|
339
360
|
| T7 | 报告目录发现多个候选 JSON | 传精确的 `report_dir` 重查(单任务报告与目录同名;loop 任务传含 `loop_result.json` 的任务根目录) |
|
|
340
361
|
| T8 | 报告 JSON 解析失败 | 文件可能损坏或为非报告 JSON;可重试或人工检查该文件 |
|
|
362
|
+
| — | 传了 `device_sn` 但连接的设备没变 | `device_sn` 只覆盖序列号(不改 `device.ip` / `device.port`,远程地址仍取 config);若运行环境里的 CLI 不是含该修复的构建,`--device` 会被解析后忽略——用报告目录 stream log 的 banner 行(`sn=`)自查实际连接的设备:banner 显示 config 值或 `(auto)` 即覆盖未生效,请改用含该修复的 CLI(如 sidecar `cliPath` 指向该构建) |
|
|
341
363
|
| — | 模型凭据不可用(未配置 `model.unified` 且 devco 登录态 / `UI_VERIFY_*` 均不可用) | 三选一:① 确认已登录 DevEco Code(OAuth 凭据依赖有效登录态);② 设置 `UI_VERIFY_BASE_URL` / `UI_VERIFY_API_KEY` / `UI_VERIFY_MODEL_NAME`(可只设 `api_key`);③ 在 AutoTest 配置文件中显式配置 `model.unified` 的 `base_url` / `api_key` / `name` |
|
|
342
364
|
|
|
343
|
-
busy(T1)时的推荐动作:`autotest_get_report` 传错误信息里的 `task_id`,先查旧任务的进度/结果,完成后再发起新任务——不要反复发起新任务。
|
|
344
|
-
|
|
345
365
|
### 回滚(已发布版本出问题时)
|
|
346
366
|
|
|
347
367
|
1. **标记问题版本**(安装方会看到弃用提示;已装工程需按 §升级须知 改回配置):
|