Menu
Runner - 测试执行。通过 Dashboard 或 CLI 执行用例。 Triggers on: /onekey-runner, "执行测试", "run case", "run test".
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/OneKeyHQ/QA-AGENTS --skill onekey-runnerThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Recorder - CDP 录制器。捕获用户在 OneKey 上的操作，生成操作清单。 Triggers on: /onekey-recorder, "录制", "record", "开始录制".
Use when 用户发送图片（包含带序号的单词，如测试钱包助记词/恢复短语卡片截图、硬件设备助记词屏幕、单词列表截图）并要求提取时。Triggers on: "提取测试单词", "提取单词", "extract test words".
Knowledge Builder - 选择器修复、UI 映射维护、前置条件更新。 Triggers on: /onekey-knowledge-builder, "更新选择器", "修复选择器", "update ui-map".
| name | onekey-runner |
| description | Runner - 测试执行。通过 Dashboard 或 CLI 执行用例。 Triggers on: /onekey-runner, "执行测试", "run case", "run test". |
| user-invocable | true |
你是 Runner — 纯执行者。通过 Dashboard API 或 CLI 运行测试用例，输出结果到 shared/results/。
/Users/chole/onekey-agent-test/
Dashboard 需要先启动：
# 检查 Dashboard 是否在运行
curl -s http://localhost:5050/api/status
# 启动 Dashboard（如果没运行）
cd /Users/chole/onekey-agent-test && npx tsx src/dashboard/server.ts &
执行测试：
# 运行指定用例
curl -X POST http://localhost:5050/api/run \
-H 'Content-Type: application/json' \
-d '{"cases": ["SEARCH-001", "SEARCH-002"]}'
Dashboard 执行器在 src/dashboard/test-executor.ts，通过 testCases.fn(page) 或 mod.run() 调用。
# 列出所有可用测试
node /Users/chole/onekey-agent-test/src/tests/run.mjs
# 运行整个特性模块（如 perps 目录下所有测试）
node /Users/chole/onekey-agent-test/src/tests/run.mjs perps
# 运行子路径
node /Users/chole/onekey-agent-test/src/tests/run.mjs settings/language-switch
# 运行单个测试模块（执行所有 testCases）
node /Users/chole/onekey-agent-test/src/tests/perps/token-search.test.mjs
# 运行特定用例（如果脚本支持参数过滤）
node /Users/chole/onekey-agent-test/src/tests/perps/token-search.test.mjs SEARCH-001
每个 .test.mjs 必须导出：
export const testCases = [
{ id: 'SEARCH-001', name: '英文搜索', fn: async (page) => { /* ... */ } },
{ id: 'SEARCH-002', name: '中文搜索', fn: async (page) => { /* ... */ } },
];
export async function setup(page) {
// 解锁钱包、关弹窗、检查前置条件
}
export async function run() {
// CLI 入口：connectCDP → setup → 遍历 testCases
}
fn(page) — 单个 page 参数setup(page) — 通过 runPreconditions() 检查前置条件run() — 自动连接 CDP 并执行curl -s http://127.0.0.1:9222/json/version
pkill -f "OneKey" 2>/dev/null; sleep 2
$ONEKEY_BIN --remote-debugging-port=9222 &
sleep 5
结果写入 shared/results/<TEST-ID>.json，格式：
{
"testId": "SEARCH-001",
"status": "pass",
"duration": 12345,
"timestamp": "2026-03-18T10:30:00Z",
"error": null,
"screenshot": null
}
失败时会保存截图到 shared/results/<feature>/ 目录。
src/runner/index.mjs（已废弃）open 命令启动 OneKeypage.setViewportSize()src/tests/run.mjssrc/dashboard/server.ts (port 5050)src/dashboard/test-executor.tssrc/tests/{cosmos,perps,wallet,referral,settings}/*.test.mjssrc/tests/helpers/index.mjs (connectCDP, sleep, screenshot)shared/results/<TEST-ID>.json$ONEKEY_BIN（env 可配，默认 TF 包路径）http://127.0.0.1:9222Based on SOC occupation classification
