chenmingxuan
be6e8c2abd
Unify task scheduling and queue state, fix Android input and observation recovery, preserve screenshot paths, and match final review criteria accurately. Add collapsible copyable results and publish the complete 2.1.0 upgrade notes. Validation: 3189 backend tests, 326 frontend tests, 24 client tests, production build and quality gates.
29 lines
2.4 KiB
Markdown
29 lines
2.4 KiB
Markdown
# 插件任务参数
|
||
|
||
先调用 `mobile_workspace`，只选实际存在、已启用且配置已授权的插件。纯电脑任务使用 `include_devices=false`，避免不必要的 ADB 查询。通过现有 `mobile_run_task` 发起电脑任务：
|
||
|
||
```json
|
||
{
|
||
"request_id": "本次提交的唯一编号",
|
||
"task_desc": "观察已打开的测试控制台，确认参数值符合用户预期，并保留证据。",
|
||
"model": "Flash",
|
||
"runtime_overrides": {
|
||
"execution_target": "computer",
|
||
"plugins": [{"id": "cua-driver", "profile": "default"}],
|
||
"timeout_seconds": 1800
|
||
}
|
||
}
|
||
```
|
||
|
||
示例中的插件必须已安装；不要为解决缺插件而调用宿主私有电脑工具代替 ARTEMIS 执行。`computer` 无需 `device_serial`，`mixed` 同时需要手机与插件资源。批次每个用例的 `task_config` 使用相同字段，可混合不同配置和执行目标。
|
||
|
||
网页首页的“仅 PC”勾选项与 `runtime_overrides.execution_target="computer"` 等价，Flash、Pro、探索均支持；Android 离线、锁屏或未安装 ADB 不阻止电脑任务。电脑任务仍需有效模型配置及至少一个已启用、已授权并提供画面观察的电脑插件。探索创建时使用 `task_config`，批量 Excel 的“任务配置(JSON)”可直接填写 `{"execution_target":"computer"}`。不要把 `pc_only` 或 `include_devices` 当作提交参数；后者只用于工作区发现。
|
||
|
||
未提供 `plugins` 表示使用该目标下已启用插件的授权默认配置；空数组明确不用插件。只提供插件 ID 和配置名称，版本由服务在入队时固定。安装、授权、连接凭据和资源保护解除由用户在插件页面处理。
|
||
|
||
插件超时/取消后先查任务状态和错误，不自动重放点击或配置写入。`mobile_workspace.blocked_resources` 非空时说明存在尚未确认停止的资源，不能声称暂停已安全完成。工具返回成功还需从后续画面或结构化读数验证业务结果。
|
||
|
||
普通安卓测试无需指定 execution_target 或 mixed：省略 plugins 时，AI 可以按需加载已启用、默认配置已授权且支持 android/mixed 的插件。仅需手机能力或不希望预留桌面资源时使用 plugins: []。网页、MCP 和批次采用相同规则。
|
||
|
||
连接失败可使用 `mobile_workspace(include_devices=false, plugin_id=实际插件ID, probe_plugin=true)`；它会启动已授权插件做连接和工具声明检查，不执行测试动作。读取清单不等于实测通过。
|