🔗 项目地址：https://github.com/alekschen/ai-commit

作为开发者，我们都经历过这样的时刻：辛辛苦苦写完了一天的代码，到了提交的时候，大脑却一片空白。最后只能草草写下 fix bug、update 或者 temp 这种毫无意义的提交信息。

过段时间回看 git log，完全想不起来当时改了什么。

今天向大家推荐一款开源神器 —— AI Commit (@alekschen/ai-commit)。它能根据你的 git diff 自动生成符合 Conventional Commits 标准的提交信息，而且最重要的是：它绝对安全，隐私优先。

running.gif

核心亮点：为什么选择 AI Commit ？

1. 🛡️ 极致的安全与隐私保护

在引入 AI 工具辅助编程时，代码安全是所有开发者最关心的问题。AI Commit 在设计之初就将隐私放在了第一位：

• 零中间商：你的代码变更（ Diff ）直接发送至你配置的 API 提供商（如 OpenAI 、DeepSeek 、Azure 等）。
• 无追踪：没有任何中间服务器，没有数据收集，没有用户行为追踪。
• 完全开源：代码 100% 开源，随时欢迎审计，没有任何后门。
• 本地存储：API Key 等配置信息仅存储在你本地的机器上。

2. 📏 遵循 Conventional Commits 标准

不仅是写出“人话”，更是写出“标准话”。生成的提交信息自动遵循行业标准格式：

• feat: 新功能
• fix: 修补 Bug
• docs: 文档改变
• refactor: 代码重构 ...以及更多。

3. 🌍 全球化与高度定制

• 多语言支持：支持输出 中文、英语、日语、韩语等多种语言的提交信息。
• 模型自由：不局限于 GPT-3.5 ，你可以配置使用 GPT-4 、DeepSeek 、Azure OpenAI 等任何兼容 OpenAI 接口的模型。
• 自定义 Prompt：觉得默认风格太严肃？你可以切换成 Emoji 风格，或者编写自己的 Prompt 模板。

💡 工作原理 (How it works)

AI Commit 的工作流程简洁而高效。它充当了你的 Git 环境与大语言模型之间的本地安全桥梁。

以下是其核心处理流程图：

zh_uml.png

从图中可以看到，代码数据的流动是点对点的（从你的电脑 -> API 提供商），ai-commit 仅仅是一个运行在本地的“搬运工”和“翻译官”，确保了数据链路的最短和最安全。

🚀 快速上手

1. 安装

确保你的 Node.js 版本 >= 18.0.0：

npm install -g @alekschen/ai-commit

2. 配置

设置你的 API Key （支持 OpenAI 或兼容服务商）：

ai-commit config

在交互式菜单中，你可以设置 API 地址、Key 、模型偏好以及输出语言（记得选中文！）。

3. 使用

当你修改完代码并 git add 后，只需输入：

ai-commit

工具会立即分析你的变更，并给出几个生成的提交建议。你可以：

• 回车：直接使用。
• 编辑：微调生成的信息。
• 重新生成：换个说法。

成本尽在掌握

担心 Token 用超了？ AI Commit 内置了统计功能。

运行 ai-commit cost，你可以清晰地看到：

• 你使用了多少 Token 。
• 调用了多少次 API 。
• 估算的费用消耗。

结语

写代码是创造性的工作，写 Commit Message 则是重复性的劳动。把重复的工作交给 AI ，把精力留给核心逻辑。

AI Commit 不仅是一个工具，更是你代码仓库的“管家”，帮你维护一份清晰、规范、可追溯的历史记录。

🔗 项目地址：https://github.com/alekschen/ai-commit
🌟 如果你觉得好用，欢迎给项目点个 Star ！