01
证据分四类，分开记
每个关键结论都会标明主要证据。官方文档证明维护者公开说了什么；规范证明协议要求什么；本地验证证明指定环境里发生了什么；产品行为描述页面或客户端当前能观察到的结果。
- 官方文档：确认公开的配置、命令、权限和支持边界。
- 协议规范：确认请求、响应、事件和错误的语义。
- 本地验证：固定版本、配置和最小任务后跑出来的结果。
- 产品行为：只记能观察到的现象，不反推没公开的内部实现。
02
最小验证流程
先把客户端版本、目标端点、模型标识、权限和最小输入固定下来，再分别验证配置解析、认证、普通响应、流式结束、工具调用和失败路径。写操作默认要额外授权和结果检查。
- 01固定环境记下日期、版本、操作系统、配置范围，以及不含秘密的参数。
- 02最小复现从只读或单文件任务开始，别让多个变量同时变。
- 03验证失败至少跑一个预期会失败的请求，确认客户端不会把失败包装成成功。
- 04保存边界记清哪些是已验证、哪些只有文档支持、哪些是条件支持、哪些还没验。
03
兼容 ≠ 能力一致
同样的基础协议，往往只保证文本请求能往返，不保证模型发现、流式事件、工具调用、推理字段、错误结构或客户端扩展全都一样。所以兼容性结论必须写清楚验到了哪一层。
静态教程和兼容矩阵都是某一天的快照。上线前还是要跑一个最小的只读请求，以当时的渠道、模型目录和客户端帮助输出为准。
04
安全与脱敏
验证记录里不能出现 API Key、完整认证头、私有仓库内容、用户数据或没授权的日志。示例一律用占位符；要共享错误时，只留状态码、阶段、版本和脱敏后的请求标识。