定义
Changelog（变更日志）记录 OTA 固件版本的更新内容、修复项与已知问题，便于运维与客户了解版本差异，辅助升级决策。常与 CI/CD 流水线集成自动生成。
内容规范
Changelog 通常按版本号组织，每条记录包含：新增功能（Added）、修复问题（Fixed）、已知问题（Known Issues）、破坏性变更（Breaking Changes）等分类。采用语义化版本（SemVer）时，可对应 Major.Minor.Patch 的变更级别。格式可遵循 Keep a Changelog 等规范，便于机器解析与人工阅读。
自动化生成
在 CI/CD 流水线中，可从 Git 提交信息、Issue 关联、PR 描述自动生成 Changelog 条目。工具如 conventional-changelog 可根据 Conventional Commits 规范解析提交，减少人工维护成本，确保每次 OTA 发布都有可追溯的变更说明。
与 OTA 发布流程结合
设备管理平台在创建 OTA 任务时，可关联 Changelog 内容，在升级确认界面展示给运维人员或客户。对于灰度升级、分批推送场景，清晰的 Changelog 有助于评估升级风险，决定是否扩大推送范围或执行 Rollback 回滚。