# 内部试用：artemis-device-test 0.5.0

这个 Skill 让 Codex 准备和检查工具环境、选择执行工具，与 Artemis 配合测试，并生成带证据的报告。首次部署也可以直接交给 Codex 按本包说明完成。建议先跑简单子检查，再根据反馈扩大用例范围。

## 1. 安装 Skill

解压发布 ZIP，将整个 `artemis-device-test` 文件夹放到当前用户的 `$CODEX_HOME/skills`；未设置 `CODEX_HOME` 时使用用户目录下 `.codex/skills`。最终目录应是 `skills/artemis-device-test/SKILL.md`，避免多套一层目录。已有同名 Skill 时，将旧目录备份到 skills 目录以外再替换，防止重复发现；不要覆盖你单独保存的本机配置。重新加载技能或新开 Codex 对话。

包中有调用脚本、原用例路由、安装/修复手册、Artemis 基线补丁、验收流程及反馈模板。**工具安装包、Artemis 主程序、Python、驱动、模型 Key、账号、设备信息、原始测试数据均不随包提供。** 工具取自团队批准的软件库，安装位置可自行选择；无须复制开发者的磁盘目录。

## 2. 在 Codex 中开始环境准备

把下面文字中的路径替换为本机实际路径后发送：

```text
使用 $artemis-device-test 帮我准备内部试用环境。
工具安装包目录：D:/TeamTools/packages
已安装工具目录：D:/TeamTools/installed
Artemis 项目目录：D:/Artemis
本机配置保存到：D:/TeamConfig/tools.local.json
测试证据保存到：D:/TestEvidence
先检查已有环境，再按需要安装、修复并验证；保留已有正常配置。
完成后列出可调用、等待人工登录、环境阻塞和仍未验证的项目。
遇到无法实现或阻塞记录后跳过，不升级设备或改路由器配置。
```

配置示例在 [profile.example.json](assets/profile.example.json)。由 Codex 按真实安装位置填写 tools / runtimes / libraries；设备和平台资料留在本机配置中，密码和 Key 不写入 JSON。GUI 客户端路径不塞进 `tools` 字典，放在编排备注或独立本机资料中。详细准备方式见 [环境安装与修复](references/environment-repair.md) 与 [团队使用](references/team-setup.md)。

Artemis 需要可用 Android 设备或模拟器、APP、模型配置及 MCP 连接。客诉、联楹、移动视联先由人登录，Codex 确认业务页后继续自动操作。PC 窗口操作还需要宿主提供可用的 Windows 控制能力；CLI 能运行不代表窗口控制已可用。

## 3. 做一次小范围试用

```text
使用 $artemis-device-test，按 references/pilot-smoke.md 选择简单子项验证工具调用。
先做离线样本检查，再做我指定设备的只读查询、有限抓包/端口检查及 Artemis APP 观察。
设备 IP、完整 SN、型号、Android 序列号、COM 口和波特率使用我本次提供的配置；不使用文档示例值。
已有 RTSP 环境变量和固件/媒体样本才使用；缺失就记录跳过。
遇到阻塞保留证据和原因后跳过，不重复登录、不升级、不恢复出厂。
输出每项实际调用状态、业务判定、证据位置和反馈所需版本信息。
```

先读 [试用验收及当前能力](references/pilot-smoke.md)。所有工具有路由，并不表示所有 GUI 业务或原 Excel 完整用例均可自动通过。原表“无法实现”项排除；实际执行仍以当前用例原文和设备适用性为准。

涉及设备配置或升级时，先运行 `python scripts/device_adapter.py capabilities`。V1/V2 支持搜索、身份/版本查询和固件下发；默认只预检，显式执行才传包。不能从配置工具软件版本号推断设备协议；按 [协议范围](references/protocol-support.md) 选择路由，V1 操作见 [接口说明](references/v1-protocol.md)。

执行原 Excel 用例时，另外提供原工作簿或完整的前置条件、步骤和预期。包内 357 条路由只保留来源、标题及分析摘要，不含原工作簿，也不能代替完整用例规格。

## 4. 反馈与更新

复制填写 [反馈模板](assets/feedback-template.md)，附本次 `doctor` JSON 和必要的脱敏证据；不要直接发整个工作目录、账号配置、原始 PCAP 或录像。后续更新通过版本号和发布哈希核对，保留上一版包及本机配置，便于回退和对比。