菜单
启动、验证和排查 qq-codex-bridge 运行时。适用于检查 QQ gateway WebSocket、Codex Desktop 远程调试端口、SQLite 会话绑定、真实消息收发链路等场景。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | qq-codex-runtime |
| description | 启动、验证和排查 qq-codex-bridge 运行时。适用于检查 QQ gateway WebSocket、Codex Desktop 远程调试端口、SQLite 会话绑定、真实消息收发链路等场景。 |
| metadata | {"codex":{"emoji":"🛠️","repo":"qq-codex-bridge"}} |
当用户提到以下问题时使用本技能：
pnpm dev 启不来cd /path/to/qq-codex-bridge
pnpm dev
预期日志：
[qq-codex-bridge] codex desktop ready { launched: true|false, remoteDebuggingPort: 9229 }
[qq-codex-bridge] ready { transport: 'qq-gateway-websocket', accountKey: 'qqbot:default' }
curl http://127.0.0.1:9229/json/version
curl http://127.0.0.1:9229/json/list
如果没有响应：
--remote-debugging-port=9229cat ./runtime/qq-gateway-session.json
预期：
sessionIdlastSeqsqlite3 ./runtime/qq-codex-bridge.sqlite \
"select session_key, codex_thread_ref, status, last_error from bridge_sessions;"
sqlite3 ./runtime/qq-codex-bridge.sqlite \
"select session_key, message_id, received_at from message_ledger order by received_at desc limit 20;"
优先检查：
msg_id 是否为真实入站消息 ID优先检查：
codex-thread: 开头/thread current 返回是否符合预期优先检查：
page targetpnpm dev/thread currentapps/bridge-daemon/src/main.tsapps/bridge-daemon/src/thread-command-handler.tspackages/adapters/qq/src/qq-gateway-client.tspackages/adapters/qq/src/qq-api-client.tspackages/adapters/codex-desktop/src/codex-desktop-driver.ts