AI 工具变化太快,一篇没有日期和版本的“最佳实践”可能在几周后就无法复现。版本化不是形式主义,而是在告诉读者:这条结论在哪个时间窗口和环境里成立。
标题下方建议固定写六项
最后验证:YYYY-MM-DD,时区
工具或模型:准确名称与版本
客户端或 SDK:版本号
运行环境:操作系统、运行时、关键依赖
账号或能力范围:只写必要的套餐/权限,不泄露身份和密钥
结论状态:已复现 / 部分复现 / 已失效 / 待更多样本
正文要区分三类信息
事实:官方文档、返回字段、日志、测试结果。
观察:在多少样本、什么条件下出现的表现。
推断:对原因的解释,尚未被直接证明。
如果工具是在线服务,还应记录地区、请求时间、重试策略和速率限制,因为这些因素会改变延迟与成功率。价格类内容要写币种、计价单位和查询日期,不把历史价格说成当前价格。
更新而不是悄悄覆盖
结论变化时,在顶部增加更新记录:改了什么、为什么改、旧结论哪里失效。读者看到的不是一篇永远正确的文章,而是一段可以追踪的知识维护历史。
编辑说明:2026-08-15,COHAO 编辑部基于 AI 工具文档与生产核验经验整理;AI 协助起草,项目负责人复核。