chat-plus-adapter-debugger

Chat Plus Adapter Debugger

目标

产出或修复一段可直接粘贴到 Chat Plus 的站点适配脚本，并满足新框架硬规则：

1. 最外层必须 return { ... }
2. 必须包含 meta
3. 必须包含四个 hook：
   • transformRequest
   • extractResponse
   • decorateBubbles
   • continueConversation
4. decorateBubbles 必须使用 ctx.helpers.ui.decorateProtocolBubbles(...)
5. continueConversation 必须使用 ctx.helpers.plans.dom(...)
6. continueConversation 必须使用 ctx.continuationText
7. extractResponse 必须返回 responseContentPreview
8. transformRequest 要么使用 ctx.helpers.buildInjectedText(...) 改写请求，要么明确 return null
9. 输出抓取必须基于真实协议 / 真实响应，不接受用消息 DOM 反向抄正文代替 extractResponse
10. 输入实现允许两条路：

• 优先请求层协议注入
• 协议层因加密、签名、opaque body 或其他原因无法稳定改写时，退回 DOM 发送

1. 生成脚本时必须使用平台 helpers：JSON 解析、文本转换、协议注入、气泡装饰、续写 DOM plan 都不要手写替代实现

使用 chrome-cdp

准备页面调试前，先确认工具列表存在 chrome-cdp，并读取 builtin://chrome-cdp/SKILL.md。本 skill 的执行入口可直接代理常用 CDP 调试命令，也可用更贴近 Chat Plus 工作流的别名。

只有用户明确允许启动浏览器调试会话后，才使用浏览器调试命令。MCP Gateway 内置 chrome-cdp 默认通过原生 Chrome DevTools Protocol 启动或复用独立的持久 profile Chrome，不连接用户已经打开的 Chrome 调试端口。

常用别名：

capture start
capture clear
network search <filter>
network get <request-id>
network perf

等价 CDP 命令：

netclear
net <filter>
netget <request-id>
perfnet
html [target] [selector]
snap [target]
evalraw <target> <method> [json]

如果 chrome-cdp 启动或浏览器连接失败：

1. 运行 stop
2. 再运行 open <url> 或 launch <url>
3. 不要要求用户关闭已有 Chrome 或已有 DevTools 调试端口，除非用户明确要求连接既有浏览器

抓样本流程

按这个顺序抓样本。不要把 URL、Performance index 或页面 DOM 文本当作稳定 request id。

1. 打开 / 选中目标页面，并确认处于用户真实登录态和真实使用模式
2. 执行 capture start 或 netclear，让 CDP Network 从用户操作前开始记录
3. 告诉用户现在只需要在页面里手动发送一条唯一探针文本，例如 CHATPLUS_ADAPTER_PROBE_YYYYMMDD_001
4. 用户回页面手动发送这条探针文本
5. 等用户明确回复：发好了
6. 执行 network search <关键词> 或 net <关键词> 搜索 CDP Network 记录
7. 按 URL / method / status / MIME / timing / body 线索找真实发送请求
8. 复制 net 输出里的 CDP request id
9. 执行 network get <request-id> 查看请求体、响应体、状态码、content-type 和传输类型
10. 根据 network get 输出总结协议结构，不复述敏感 headers
11. 只有当 body 太长、输出被截断、需要离线解码二进制/长流式内容时，才追加 --request-file / --response-file 保存到临时文件后再读取
12. 如果首条消息创建了新会话或跳转，必须在新会话页重新执行 capture start，让用户发第二条 follow-up 样本