Documentation
README
外部黑盒系统调试方法论
"代码没说谎,但黑盒系统的行为不在代码里。"
涉及代码以外的环境(浏览器、编辑器、CDN、IM 平台、第三方 API),编码和调试都必须先抓真实数据,再做推理。
何时触发
写代码场景
- 输出会被第三方平台消费的内容(HTML 推送到 CSDN/微信/Notion/钉钉/飞书)
- 集成浏览器/操作系统 API(Clipboard / Drag-Drop / File System)
- 调用经过 CDN/WAF/反代的第三方 HTTP API
- 在 IM / 富文本编辑器中渲染内容
调试场景
- 跨浏览器/跨设备/跨终端表现不一致
- 粘贴/复制行为异常
- 第三方 API 返回怪结果(body 空、headers 不全、200 但 error)
- 本地复现失败但线上有问题
- 连续 2 轮"凭代码推理"的修复都 no-op(最强信号)
黑盒判定清单
| 维度 | 不是黑盒 | 是黑盒(触发本 skill) |
|---|---|---|
| 控制权 | 自己写的代码 | 第三方/平台/浏览器实现 |
| 文档完备性 | 有完整 API 文档 | 文档不全或有未文档化行为 |
| 可调试性 | 能加日志、断点 | 只能从外部观察输入输出 |
| 行为可预测 | 给定输入必然得到给定输出 | 同一输入在不同环境表现不同 |
满足任意 2 项 → 走本 skill 方法论。
数据采集模板(核心)
不同黑盒类型,第一步该让用户抓什么:
This is the opening of the README. Read the full README on GitHub.