rab-rn-debug

rab-rn-debug 调试指南（React Native）

本 skill 告知 Agent 如何通过 rab-rn-debug 本地服务（默认 localhost:9229）向集成 @rabjs/rn-debug 的 React Native 应用发送 HTTP 指令，对 Service 层进行功能验证与状态检查。请求会同步挂起直到设备执行完毕返回结果。

前置条件

1. 电脑上启动调试服务（bin 名 rab-rn-debug，来自 @rabjs/rn-debug-server）：

npx rab-rn-debug            # 默认端口 9229，启动时会打印局域网 IP（setupRNDebug 的 host）

1. RN 应用已集成 SDK（App 入口，仅 __DEV__ 生效）：

import { setupRNDebug } from '@rabjs/rn-debug';

setupRNDebug({ host: '<电脑局域网IP>', port: 9229, appName: 'MyApp' });

1. 确认设备在线：

curl -s http://localhost:9229/api/devices
# 期望: [{"deviceId":"rn-ios-xxxx","appName":"MyApp","platform":"ios","osVersion":"18.0","sdkVersion":"0.1.0","connectedAt":...,"lastSeen":...}]

如果目标 App 尚未接入，先引导用户完成上述步骤再调试。多设备在线时，请求需带 deviceId（见下）。

指令调用方式

curl -X POST http://localhost:9229/api/commands \
  -H 'Content-Type: application/json' \
  -d '{"type":"<指令type>","payload":{...},"timeout":30000}'

• 唯一设备在线时自动路由；多设备返回 409（body 为 {"error":"multiple devices, specify deviceId","devices":["rn-ios-xxx","rn-android-yyy"]}），改用 POST /api/devices/<deviceId>/commands；无设备返回 404；指定的 deviceId 不存在同样返回 404。
• 响应：{"id","status":"ok"|"error"|"timeout","result","durationMs"}；失败时另有 error:{"message","stack?"}。
• 事后可用 GET /api/commands/<id> 查询单条指令记录（含 status:"pending" 的进行中状态）。
• 同一设备指令严格串行；默认超时 30s（上限 120s，超出按 120s 计），异步方法耗时长时可加大 timeout。

常用调试操作

1. 连通性检查

curl -X POST localhost:9229/api/commands -H 'Content-Type: application/json' \
  -d '{"type":"ping"}'
# 期望 status ok, result: { "pong": true, "time": 1723766400000 }

2. 枚举所有已实例化的 Service

curl -X POST localhost:9229/api/commands -H 'Content-Type: application/json' \
  -d '{"type":"rab.listServices"}'

返回示例：

{
  "status": "ok",
  "result": [
    {
      "instanceId": "CartService#1",
      "containerName": "ProductPage_2",
      "identifierLabel": "CartService"
    }
  ]
}

• instanceId 格式为 类名#序号（如 CartService#1），identifierLabel 为 Service 类名。
• 仅枚举 Singleton 作用域且已实例化的 Service（Transient 不缓存实例，不会出现在列表中）。