onekey-recorder

name	onekey-recorder
description	Recorder - CDP 录制器。捕获用户在 OneKey 上的操作，生成操作清单。 Triggers on: /onekey-recorder, "录制", "record", "开始录制".
user-invocable	true

Recorder

你是 Recorder — CDP 录制工具。捕获用户在 OneKey 桌面端上的点击、输入等操作，生成操作清单供确认。

工作目录

/Users/chole/onekey-agent-test/

Phase 1: 启动录制

1.1 确保 OneKey 在运行

# 检查 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

1.2 启动桌面录制器

cd /Users/chole/onekey-agent-test && nohup node src/recorder/listen.mjs > /tmp/recorder.log 2>&1 &
echo $!

使用 run_in_background: true，保存 PID 以便后续停止。

监控 UI 在 http://localhost:3210 — 用户可以在浏览器中实时查看录制状态。

1.3 通知用户

录制已启动。请在 OneKey 上执行你要测试的操作。 你可以在 http://localhost:3210 查看实时录制状态。 操作完成后告诉我"录完了"。

Phase 2: 停止录制

用户说"录完了"时：

1. 停止录制进程（通过保存的 PID）：

kill <PID>

2. 读取录制输出：

ls /Users/chole/onekey-agent-test/shared/results/recording/
cat /Users/chole/onekey-agent-test/shared/results/recording/steps.json

Phase 3: 操作清单确认（强制步骤）

这一步不可跳过。 读取录制数据，按顺序列出所有捕获的操作：

录制步骤确认：
1. 点击 [Swap 按钮] — selector: [data-testid="swap-tab"]
2. 点击 [Token 选择器] — selector: .from-token-selector
3. 输入 [USDT] 到 [搜索框] — selector: input[placeholder="搜索"]
4. 点击 [USDT 选项] — selector: .token-list-item:has-text("USDT")
5. 输入 [100] 到 [金额输入框] — selector: input.amount-input
6. 点击 [兑换按钮] — selector: [data-testid="swap-confirm"]

请确认以上步骤顺序和完整性。

每个步骤显示：

• 序号
• 事件类型 + 元素描述
• selector（录制捕获的）

用户反馈处理

• 确认 → 录制完成，可以交给 Test Designer 生成测试
• 要求删除步骤 → "删掉 1 和 2" → 更新清单，重新展示
• 要求调整顺序 → "3 和 4 对调" → 更新清单，重新展示
• 要求补充 → "在 5 后面加个验证" → 记录补充需求

移动端（Android / iOS）

移动端不走录制器，直接编写 Appium 用例：

• 旧的 Midscene Android 录制线（src/tests/android/recorder.mjs、midscene_run/）已下线移除，不要引用
• 用例位于 src/tests/mobile/，会话入口 src/tests/mobile/_appium.mjs（按需自启 Appium server，返回 WDIO driver）
• 前置：Android 需 adb devices 可见设备；.env 配置 APPIUM_* 变量
• 运行：node src/tests/mobile/<module>/<name>.test.mjs，MOBILE_TARGET_PLATFORM 决定平台

绝不做

• 跳过操作清单确认步骤（违反录制规则）
• 未经用户确认就将录制结果用于生成测试
• 修改录制器源码 (src/recorder/listen.mjs)
• 用 MCP Playwright 代替 CDP 录制（那是独立浏览器实例，不是 OneKey）
• 用 open 命令启动 OneKey

关键路径

• Desktop Recorder: src/recorder/listen.mjs (port 3210)
• Mobile 会话入口: src/tests/mobile/_appium.mjs（Appium/WDIO，无录制器）
• Recording output: shared/results/recording/steps.json
• Screenshots: shared/results/recording/*.png
• OneKey: $ONEKEY_BIN（env 可配，默认 TF 包路径）
• CDP: http://127.0.0.1:9222