用途：当代码涉及自身无法控制的外部黑盒系统（浏览器、编辑器、CDN/WAF、IM 平台、操作系统剪贴板、第三方 API/SaaS）时，用于编码与调试。核心原则是“代码没说谎，但黑盒系统的行为不在代码里”，必须先抓真实环境数据再做推理。
触发场景：输出被第三方平台消费（HTML 推送到 CSDN/微信/Notion/钉钉/飞书）；集成浏览器或操作系统 API（Clipboard、Drag-Drop、File System）；调用经 CDN/WAF/反代的第三方 HTTP API；在 IM 或富文本编辑器渲染内容。调试侧包括跨浏览器/设备/终端表现不一致、粘贴复制异常、第三方 API 返回怪结果、本地复现失败但线上有问题，以及连续 2 轮凭代码推理的修复都无效。
黑盒判定：控制权在第三方、文档不全或有未文档化行为、只能从外部观察输入输出、同一输入在不同环境表现不同，满足任意 2 项即适用。
数据采集：浏览器粘贴复制抓实际剪贴板 HTML（navigator.clipboard.read() 列出所有 mime 并打印 outerHTML）；编辑器渲染对比粘贴前后 DOM；跨浏览器用真机截图加 DOM；HTTP API 用 curl -v / Charles / mitmproxy 抓完整请求响应；CDN/WAF 用 curl -I 看 Server / Via 头；IM 平台需真机截图发送与接收两端；操作系统剪贴板列出所有 mime type（如 macOS pbpaste -Prefer html）；移动端 webview 用 Chrome DevTools 远程调试。抓取须保留原始格式：HTML 用 outerHTML、JSON 用原始字节、二进制用 hexdump。
决策流：Bug 现象 → 是否涉及外部黑盒 → 是则按模板采集数据 → 基于数据做假设 → 单变量验证 → 修复 → 追加案例到 references/。反模式包括凭“我以为”推断、连续推理无效仍继续、用 try-catch 或 polyfill 掩盖未理解行为、多变量同时改、修好不沉淀、凭“主流都支持”下结论。修复后按 case-{system}-{symptom}.md 命名沉淀，template- 文件填完后改名 case-。
限制：资料未提供具体安装命令、收费、平台支持范围与效果数据。