chenmingxuan
e1ea099592
Install and update artemis-use with task diagnostics and plugin guidance. Preserve cross-device file receipts, review canonical reports, guard stage transitions and reduce small history summaries. Improve exploration lifecycle, request recovery and browser live connections.
48 lines
4.7 KiB
Markdown
48 lines
4.7 KiB
Markdown
---
|
||
name: artemis-use
|
||
description: 使用 ARTEMIS 执行安卓、电脑和跨端测试，指导探索用例，排查或复盘任务，以及开发符合 ARTEMIS 规范的扩展插件。用户提到 ARTEMIS 任务编号、测试报告、缓存消耗或插件适配时使用。
|
||
---
|
||
|
||
# ARTEMIS 使用与插件开发
|
||
|
||
ARTEMIS 自己编排手机和已授权插件，共用网页的任务队列、历史与报告。主程序由用户启动；Codex 的 MCP 仅连接，不另起后台或独立执行器。主程序离线时告知用户先启动 ARTEMIS，不能反复重提任务。
|
||
|
||
## 按任务选择参考
|
||
|
||
| 用户要做什么 | 阅读什么 |
|
||
| --- | --- |
|
||
| 选择模式、执行或指导单任务 | [执行模式与操作流程](references/modes.md) |
|
||
| 边交流边探索、亲自示范、提炼复用用例 | [探索流程与 MCP 参数](references/exploration.md) |
|
||
| 批量、循环压测、选择导入项、交付资料 | [批次与报告](references/batches.md) |
|
||
| 给出任务编号，问失败原因、token、缓存、录像或最终结论 | [诊断与复盘](references/diagnostics.md) |
|
||
| 使用电脑、路由器、终端等已安装能力 | [插件任务参数](references/plugins.md) |
|
||
| 编写、适配、验证或发布 ARTEMIS 插件 | [插件开发规范](references/plugin-development.md)，按需读取 [清单与市场协议](references/plugin-manifest.md) |
|
||
|
||
只读当前任务相关参考。普通执行不加载插件开发文档。
|
||
|
||
## 三种模式
|
||
|
||
- **Flash**：路径明确的快速执行，单个执行模型观察并操作；适合冒烟、稳定流程与探索后复跑。可以接受中途指导，也有结束验收。任务长不自动等于需要 Pro。
|
||
- **Pro**：需要持久计划、多个分支、检查点、ADB/日志诊断或详细报告；按计划执行并验证。`explorer_mode` 是 Pro 的视觉定位深度，不是探索任务模式。
|
||
- **探索**：用户只有大概流程，需要与模型交流、纠正方向或人工示范；以 Pro 的执行能力推进，最终提炼一个可复用用例。超时保存并暂停，可继续。探索成功、生成用例和 Flash/Pro 复跑成功是三个不同结果。
|
||
|
||
以上是 ARTEMIS 执行模式，不是 API 模型名。每种模式的适用场景、能力差异、参数及跟踪方式见 [modes.md](references/modes.md)。沿用用户选定模式和模型；信息足够时直接执行，不反复要求批准。
|
||
|
||
## 共用规则
|
||
|
||
1. `mobile_workspace` 发现当前设备、队列、实际插件。沿用用户指定设备；多台设备而目标不明时先问。纯电脑任务用 `include_devices=false`，无需手机；普通安卓任务可按需使用已授权扩展。
|
||
2. 明确任务目标、前置条件和通过标准；用户没有要求时不擅自清数据、重装或重置环境。不假设启动时画面与旧任务相同。
|
||
3. 提交前保存唯一 `request_id`。同一次提交网络异常时保留原 ID 和内容，先反查，不用新 ID 自动重跑。模型请求重试不等于业务用例重跑。
|
||
4. 用 MCP 返回的任务编号跟踪；查看实际动作与证据，不把“已接收指导”当作“已经执行”。同一设备或桌面资源串行，其他资源可并行。
|
||
5. `completed` 只表示执行结束。读取 `test_result.status/reason/source`：passed、failed、inconclusive、blocked。人工复验优先，同时保留 AI 原判；Agent 自己的判断不能标成人工。
|
||
6. 失败或停滞先看当前任务诊断，再决定是否检查环境；不要靠连续重提测试排错。证据不足明确说明未验证，工具成功不能代替业务验收。
|
||
7. 用户明确要求删除时先查看 `deletion_preview` 的实际影响，再执行。已有明确授权不重复询问。人工复验只代录用户明确给出的通过/不通过及理由。
|
||
8. 密钥在网页或环境中配置，MCP 不接收；不读出或回显凭据。`mobile_config` 修改默认配置需要用户明确要求，临时任务用单任务配置。
|
||
9. 通过 `mobile_export_report` 交付真实路径或下载链接。手机和电脑证据按来源区分，未录到的画面不能推断。插件写操作结果不确定时先观察，不自动重复。
|
||
|
||
## 安装与版本
|
||
|
||
本目录是 ARTEMIS 管理的官方 `artemis-use`，服务启动时按内容检查并覆盖更新，不在这里定制个人规则。显式修复安装用 `artemis mcp --install codex`（源码环境前加 `uv run`）。Skill 与参考、模板一并更新；MCP 握手不安装、不启动主程序。
|
||
|
||
以当前连接服务和实际工具参数为准；旧版缺少动作时明确说明版本限制，不能假装执行成功或直接改数据库。升级 ARTEMIS 使用 `update.bat` / `update-cn.bat`，会停止该项目任务，只在用户要求升级时执行。
|