作为开发者,我们都经历过这样的时刻:辛辛苦苦写完了一天的代码,到了提交的时候,大脑却一片空白。最后只能草草写下 fix bug、update 或者 temp 这种毫无意义的提交信息。
过段时间回看 git log,完全想不起来当时改了什么。
今天向大家推荐一个开源工具 ------ AI Commit (@alekschen/ai-commit)。它能根据你的 git diff 自动生成符合 Conventional Commits 标准的提交信息,而且最重要的是:它绝对安全,隐私优先。

核心亮点:为什么选择 AI Commit?
1. 🛡️ 极致的安全与隐私保护
在引入 AI 工具辅助编程时,代码安全是所有开发者最关心的问题。AI Commit 在设计之初就将隐私放在了第一位:
- 零中间商 :你的代码变更(Diff)直接发送至你配置的 API 提供商(如 OpenAI、DeepSeek 等)。
- 无追踪:没有任何中间服务器,没有数据收集,没有用户行为追踪。
- 完全开源:代码 100% 开源,随时欢迎审计,没有任何后门。
- 本地存储:API Key 等配置信息仅存储在你本地的机器上。
2. 📏 遵循 Conventional Commits 标准
不仅是写出"人话",更是写出"标准话"。生成的提交信息自动遵循行业标准格式:
feat: 新功能fix: 修补 Bugdocs: 文档改变refactor: 代码重构 ...以及更多。
3. 🎨 深度定制与 Prompt 编排
不仅仅是工具,更是你的个性化编码助手。
- 自定义 Prompt (User-Defined Prompts) :这是 AI Commit 最强大的特性之一。你拥有对 Prompt 的完全控制权。无论是需要遵循严格的企业提交规范(如 Jira ID 关联),还是喜欢轻松的 Emoji 风格,甚至是有特殊的格式要求,你都可以通过编写自定义 Prompt 模板,让 AI 精确生成你想要的内容。
- 模型自由:不局限于 GPT-3.5,支持 GPT-4、DeepSeek、Azure OpenAI 等任何兼容 OpenAI 接口的模型。
- 多语言支持 :支持输出 中文、英语、日语、韩语等多种语言。
💡 工作原理 (How it works)
AI Commit 的工作流程简洁而高效。它充当了你的 Git 环境与大语言模型之间的本地安全桥梁。
以下是其核心处理流程图:

从图中可以看到,代码数据的流动是点对点的 (从你的电脑 -> API 提供商),ai-commit 仅仅是一个运行在本地的"搬运工"和"翻译官",确保了数据链路的最短和最安全。
🚀 快速上手
1. 安装
确保你的 Node.js 版本 >= 18.0.0:
bash
npm install -g @alekschen/ai-commit
2. 配置
设置你的 API Key(支持 OpenAI 或兼容服务商):
bash
ai-commit config
在交互式菜单中,你可以设置 API 地址、Key、模型偏好以及输出语言(记得选中文!)。
3. 使用
当你修改完代码并 git add 后,只需输入:
bash
ai-commit
工具会立即分析你的变更,并给出几个生成的提交建议。你可以:
- 回车:直接使用。
- 编辑:微调生成的信息。
- 重新生成
成本尽在掌握
担心 Token 用超了?AI Commit 内置了统计功能。
运行 ai-commit cost,你可以清晰地看到:
- 你使用了多少 Token。
- 调用了多少次 API。
- 估算的费用消耗。

结语
写代码是创造性的工作,写 Commit Message 则是重复性的劳动。把重复的工作交给 AI,把精力留给核心逻辑。
AI Commit 不仅是一个工具,更是你代码仓库的"管家",帮你维护一份清晰、规范、可追溯的历史记录。
🔗 项目地址 :github.com/alekschen/a...
🌟 如果你觉得好用,欢迎给项目点个 Star!