← 云枢 AI 导航 · 工具库
更新日志生成:把一堆提交记录变成能发出去的更新日志
发版前最费时的一步,是把 commit 整理成人话。贴进 git log、选一个格式,按类型分组后的 Markdown 直接复制走。
立即使用 →
English
git log 是写给写代码的人看的,更新日志是写给用的人看的。差别不只是措辞:前者按时间倒序混着 feat、fix、chore,后者要按「新增 / 修复 / 变更」分组,而且「升级依赖」不该和「新增导出功能」并列。手工整理一次十分钟,一年要整理几十次。
这个工具把这一步拆成两个动作:贴进去、选格式。它会剥掉短哈希与列表符号,按 Conventional Commits 的前缀归到 Added / Fixed / Changed / Documentation / Testing / Maintenance 分组,认不出前缀的行放进「其他」而不是丢掉。三种输出对应三种真实场景:Keep a Changelog 用于对外发版说明,按日期分组用于按天记录的运营日志,纯列表用于发在群里的简版。
它会检查什么
- 识别 feat / fix / docs / style / refactor / perf / test / chore / build / ci 前缀
- 剥掉 git 短哈希、长哈希与 - * + 列表符号
- 带括号的作用域(如 feat(core))转成「core: 说明」
- 半角冒号与全角冒号都认
- 三种输出:Keep a Changelog / 按日期分组 / 纯列表
- 一条都没认出来时给明确提示,而不是输出空白
常见问题
- 会帮我编版本号吗?
- 不会。Keep 格式统一输出到「[未发布]」段——版本号和发布日期是人的决定,工具只负责把条目摆整齐。按日期分组时会沿用你输入里出现的版本/日期标题。
- 没按 Conventional Commits 写也能用吗?
- 能。看不懂前缀的行会原样进入「其他」分组,不会被丢掉;也可以选纯列表格式,只做去哈希与去符号。
- 提交记录会被保存吗?
- 不会。全部在内存里计算,不写数据库、不落盘,日志里也不记录内容。
- 和 release-please / semantic-release 有什么区别?
- 那些工具跑在 CI 里,会真的改版本号与打 tag;这里是手工贴一次、拿结果就走。适合还没上自动化、或者想人工润色一遍的项目。
相关工具