feat: add Android task file evidence and finalize plugin design

This commit is contained in:
chenmingxuan committed 2026-10-15 18:27:11 +08:00
1 parent 96fedc816f
commit 72ff342605
20 files changed
+1005 -35

No files matched your search

+7
View File
@@ -35,6 +35,13 @@ Windows 启动脚本只提示源码更新。升级使用 `update.bat`(国内
- 执行状态与业务判定分开:`completed` 只说明执行结束,不等于测试通过。Flash 和 Pro 默认根据任务提示词、用户指导、执行结论和实际证据进行只读终检,不需要另填预期结果。读取 `test_result.status`(`passed` 通过、`failed` 不通过、`inconclusive` 未验证、`blocked` 阻塞)、`reason` 与 `evidence`,结合验证摘要和 `mobile_inspect_trace` 的步骤/截图交付结果。执行失败不能直接认定产品缺陷;已确认的断言失败不得被后续成功覆盖。终检关闭、出错或证据不足时不得宣称通过。
- 用 `mobile_export_report(session_id=...)` 获取单任务报告;`formats=["screenshots"]` 获取排序截图,`["video"]` 获取保存的录屏分段,`["all"]` 获取 Word、Excel 和所有可用资料的 ZIP。批次传 `batch_id` 获取汇总、各项任务报告、步骤截图及已有录屏的 ZIP。未指定格式时使用保存的 Word/Excel 偏好。执行中的导出只是当前快照。
- 工具返回 MCP 主机上的绝对文件路径和下载 URL。向用户交付真实生成的文件链接,并说明完成、失败、未验证、跳过数量及重要限制。不要只说“报告已生成”而不交付文件。
### 安卓截图和文件
- Flash/Pro 任务内部均提供 `android_file`,由任务已分配的 Android 设备执行。外层 MCP 使用现有 `mobile_run_task` 提交目标,不直接绕过任务队列传文件。
- 保存当前手机画面使用 `action="screenshot"`;原生 PNG 默认位于 `traces/<trace_id>/artifacts/android/`。明确要求保存电脑桌面时用 `destination="desktop"`,同时保留 trace 副本;无需电脑插件或截图快捷键。自动步骤截图原本保存在 `traces/images/`,不能把旧截图当作新的截屏结果。
- `list`、`read_text`、`write_text` 的 `device_path` 是 Android 绝对路径;文本使用 UTF-8,单次不超过 64 KiB。`pull` 下载手机文件,`push` 将 trace 中的文件或用户指定的桌面文件上传手机,单文件不超过 64 MiB。`filename` 仅是文件名,不能传 Windows 路径;目录由 `destination` 选择。不能绕过 Android 的应用私有目录权限。
- 保存、上传和下载会校验内容,已有文件默认不覆盖。只有工具成功并返回真实路径/校验结果后才可宣称保存成功;截图内容是否符合测试预期仍需核对。单任务“全部资料”及批次 ZIP 包含这些文件,位于 `任务文件/安卓/`。
- 用 `mobile_search_history` 按名称、目标、编号或标签搜索全部历史;日期先按用户时区转换为 Unix 秒,`start` 含边界、`end` 不含边界。按返回的 `total/page/size` 翻页,不能把第一页当作全部历史。
- `mobile_inspect_trace` 是只读步骤证据查看;其中历史上下文的 replay 术语不表示重新执行设备动作。