01
版本与环境
命令、配置项和界面可能随版本、操作系统、账号权限或服务端设置变化。正文标出版本或环境时，结论只适用于这些条件；没有标出的情况不要直接类推。
- 先确认客户端和运行时版本。
- 检查操作系统、权限和配置范围。
- 确认模型、端点或渠道当前仍然可用。
- 遇到差异时优先查看对应产品的最新说明。
02
使用前确认
涉及本地环境、账号权限或外部服务时，建议先用最小范围完成一次确认，再应用到正式项目。不要同时修改多个变量，否则出现问题后很难定位原因。
- 01核对条件确认版本、操作系统、权限和配置位置。
- 02从最小开始先使用只读任务、测试账号或单个文件。
- 03检查结果确认命令、文件或页面得到预期结果。
- 04再扩大范围最小步骤正常后，再应用到完整工作流。
03
兼容性的含义
基础协议兼容通常只说明部分请求可以正常交互，不代表模型发现、流式事件、工具调用、错误格式和客户端扩展完全一致。正文会尽量写清支持到哪一层。
教程和兼容矩阵反映发布时的情况。正式使用前，请以当前渠道、模型目录和客户端帮助信息为准。
04
示例与敏感信息
文档示例使用占位符，不应填入真实 API Key、完整认证头、私有仓库内容或用户数据。分享错误信息时，只保留排查所需的状态码、步骤、版本和脱敏后的请求标识。