| 结构 | 版本/日期 + 分组（新增/变更/修复/废弃） |
|---|---|
| 读者 | 用户与依赖方：说影响而非实现细节 |
| 维护 | 随发布更新，历史条目不可篡改 |
条目示例
条目示例
2026-10-12 平台 v3.2
新增：支持按服务配置告警静默
变更：API 分页默认上限调整为 200（影响导入脚本）
修复：修复导出文件名乱码变更日志 Changelog
变更日志按时间记录系统或产品的显著变化：新增、修改、修复与废弃，写用户可理解的影响描述并标注日期与版本；比代码提交历史更适合对外沟通。
易错点
- 日志写成代码提交复制：用户看不懂影响
- 发布后补记：遗漏变更，依赖方升级踩坑
数据来源与参考
- Keep a Changelog 公开规范
- 开源项目变更日志实践