用途:根据 git 历史快速生成可读的变更日志条目,适合发布前准备、补齐遗漏的 changelog、为 GitHub Release 生成发布说明,以及统一多次发布的格式。
主要能力:读取任意两个 ref(标签、分支、提交)之间的 git log;把提交归类为 Added、Changed、Fixed、Removed;把杂乱的提交信息整理成可读条目;输出 Keep a Changelog 风格的 Markdown,可直接写入 CHANGELOG.md。
使用方式:无需安装,用 npx 运行,需设置 OPENAI_API_KEY,建议 Node.js 18 以上。常用命令:npx ai-changelog --from v1.0.0 --to v2.0.0;npx ai-changelog --from v1.0.0 --to HEAD;npx ai-changelog --from v1.0.0 --to v2.0.0 -o CHANGELOG.md;npx ai-changelog --from abc123 --to def456。帮助命令:npx ai-changelog --help。
工作原理:在指定 ref 之间运行 git log,收集提交信息并发送给 GPT-4o-mini,由 AI 解析每条改动并格式化归类。
限制与注意:结果依赖提交信息质量,建议写规范的提交;AI 可能对部分改动分类有误,需人工复核;需自行提供 OPENAI_API_KEY;文档未说明离线可用或替代模型。工具标注为 MIT 许可、免费,属于 LXGIC Dev Toolkit 系列。具体费用、网络要求等细节暂未提供。