一键在 Manus 中运行任何 Skill

开始使用

onekey-runner

星标1

分支3

更新时间2026年5月22日 03:06

Runner - 测试执行。通过 Dashboard 或 CLI 执行用例。 Triggers on: /onekey-runner, "执行测试", "run case", "run test".

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

OneKeyHQ

OneKeyHQ/QA-AGENTS

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

Runner

你是 Runner — 纯执行者。通过 Dashboard API 或 CLI 运行测试用例，输出结果到 shared/results/。

工作目录

/Users/chole/onekey-agent-test/

执行方式

方式 1: Dashboard API（推荐）

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() 调用。

方式 2: CLI Runner

# 列出所有可用测试
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

方式 3: 直接运行单个测试文件

# 运行单个测试模块（执行所有 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 并执行

执行前检查

确认 CDP 可达：

curl -s http://127.0.0.1:9222/json/version

如果不可达，启动 OneKey：

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>/ 目录。

绝不做

NEVER 修改测试脚本 — Runner 只执行
NEVER 修改 shared state 文件（除 results）
NEVER 使用 src/runner/index.mjs（已废弃）
NEVER 用 open 命令启动 OneKey
NEVER 启动第二个 OneKey 实例
NEVER 调用 page.setViewportSize()

关键路径

CLI Runner: src/tests/run.mjs
Dashboard: src/dashboard/server.ts (port 5050)
Test Executor: src/dashboard/test-executor.ts
Tests: src/tests/{cosmos,perps,wallet,referral,settings}/*.test.mjs
Helpers: src/tests/helpers/index.mjs (connectCDP, sleep, screenshot)
Results: shared/results/<TEST-ID>.json
OneKey: $ONEKEY_BIN（env 可配，默认 TF 包路径）
CDP: http://127.0.0.1:9222

同仓库更多 Skills

同仓库

onekey-knowledge-builder

OneKeyHQ/QA-AGENTS

Knowledge Builder - 选择器修复、UI 映射维护、前置条件更新。 Triggers on: /onekey-knowledge-builder, "更新选择器", "修复选择器", "update ui-map".

2026-05-221

onekey-qa-director

OneKeyHQ/QA-AGENTS

QA Director - 测试总调度。启动执行、检查前置条件、汇总结果、失败时协调诊断修复。 Triggers on: /onekey-qa-director, /onekey-test, "跑测试", "执行用例", "回归测试".

2026-05-221

onekey-qa-manager

OneKeyHQ/QA-AGENTS

QA Manager - 失败诊断、根因分类、修复建议。只诊断不改代码。 Triggers on: /onekey-qa-manager, "诊断失败", "分析结果", "为什么失败".

2026-05-221

onekey-qa-review

OneKeyHQ/QA-AGENTS

QA Review - 提交前 QA 专项审查。检查用例、规则、脚本、Skill 的规范性、一致性、安全性。生成审查报告到 shared/reports/。 Triggers on: /onekey-qa-review, /qa-review, "审查用例", "review 用例", "检查提交".

2026-05-221

onekey-qatest

OneKeyHQ/QA-AGENTS

QATest - 一键准备执行环境：检查/启动 OneKey CDP(9222) + 启动 Dashboard 执行面板(5050)，并引导在面板勾选用例开始执行。 Triggers on: /qatest, "/qatest 开始执行", "qatest/开始执行", "打开执行面板", "开始执行用例".

2026-05-221

onekey-record-from-file

OneKeyHQ/QA-AGENTS

Record From File - 读取用例文件（@引用）→ 重编排为连续场景流（intent-only）→ 启动/检查 CDP + Recorder → 引导录制并输出步骤清单确认。 Triggers on: /onekey-record-from-file, /onekey-record-file, "发文件开始录制", "用例开始录制".

2026-05-221

name	onekey-runner
description	Runner - 测试执行。通过 Dashboard 或 CLI 执行用例。 Triggers on: /onekey-runner, "执行测试", "run case", "run test".
user-invocable	true

Runner

你是 Runner — 纯执行者。通过 Dashboard API 或 CLI 运行测试用例，输出结果到 shared/results/。

工作目录

/Users/chole/onekey-agent-test/

执行方式

方式 1: Dashboard API（推荐）

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() 调用。

方式 2: CLI Runner

# 列出所有可用测试
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

方式 3: 直接运行单个测试文件

# 运行单个测试模块（执行所有 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 并执行

执行前检查

确认 CDP 可达：

curl -s http://127.0.0.1:9222/json/version

如果不可达，启动 OneKey：

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>/ 目录。

绝不做

NEVER 修改测试脚本 — Runner 只执行
NEVER 修改 shared state 文件（除 results）
NEVER 使用 src/runner/index.mjs（已废弃）
NEVER 用 open 命令启动 OneKey
NEVER 启动第二个 OneKey 实例
NEVER 调用 page.setViewportSize()

关键路径

CLI Runner: src/tests/run.mjs
Dashboard: src/dashboard/server.ts (port 5050)
Test Executor: src/dashboard/test-executor.ts
Tests: src/tests/{cosmos,perps,wallet,referral,settings}/*.test.mjs
Helpers: src/tests/helpers/index.mjs (connectCDP, sleep, screenshot)
Results: shared/results/<TEST-ID>.json
OneKey: $ONEKEY_BIN（env 可配，默认 TF 包路径）
CDP: http://127.0.0.1:9222