English | 简体中文
WTF Commit 是一款简约的 VS Code 扩展，利用 AI 根据您暂存的更改（或工作区更改）生成简洁且有意义的 Git 提交信息。
- 零配置意图提示: 如果你在源码管理输入框里先写下几个关键词，WTF Commit 会自动把它当作本次生成的意图提示，让结果更贴近你真正想提交的内容。
- AI 一键修正: 当生成结果的标题看起来不符合 Conventional Commits 时，插件会提供一个
AI Repair按钮，允许你在不离开当前流程的情况下快速修正格式。 - 更干净的 Diff 上下文: 现在会更早过滤 lockfile、资源文件、构建产物和超大噪声补丁，在保持极简体验的同时提升生成质量。
- 多语言支持：预设支持 英文、简体中文、繁体中文、日语、文言文，并支持自定义语言。
- 约定式提交：自动遵循约定式提交标准（feat, fix, docs 等）。
- 智能差异化：优先处理暂存的更改，若无则回退到工作区更改，并在生成前过滤更多低价值 diff 噪声。
- 意图感知生成：会复用你已经写在 SCM 输入框中的文本，作为零配置提示词参与生成。
- 自动提交与推送：支持一键完成 生成 + 提交 + 推送 (Auto Commit & Push)。
- 实时调优：Auto-commit 流程现已支持直接进入 Input Box 框二次编辑，避免阻断生成快感。
- 轻量纠偏：当标题格式不够规范时，支持直接点击
AI Repair做一次快速修正。 - 请求稳定性增强：新增针对 Reasoner（推理型）大模型的自动长超时匹配机制，附带分类错误反馈。
- 快捷键支持: 默认绑定
Cmd+Alt+G(Mac) /Ctrl+Alt+G(Windows/Linux)。 - 高度可定制：可完全自定义系统提示词（Prompt）和自定义 LLM 端点的 Base URL。
只需要 3 步，即可开启 AI 自动提交之旅：
- 下载安装：在 Open VSX 插件市场搜索
WTF Commit并安装。 - 输入 API Key：按下
Cmd+Shift+P(Mac) 或Ctrl+Shift+P(Windows)，输入WTF Commit: Set API Key，选择服务商并粘贴您的 Key。 - 一键生成：按下
Cmd+Alt+G(Mac) 或Ctrl+Alt+G(Windows)，插件将自动根据代码变动生成提交信息并填入输入框。
您可以进入 VS Code 设置 (Cmd+,)，搜索 WTF Commit 来深度定制：
| 设置项目 | 描述 |
|---|---|
| Auto Commit | 生成信息后自动提交。 |
| Auto Push | 提交后自动推送（需要开启 Auto Commit）。 |
| Confirm Before Commit | 自动提交前显示确认对话框，防止误操作。 |
| Smart Stage | 当暂存区为空时，自动将工作区所有变更加入暂存区（默认：true）。 |
| Prompt | 自定义 AI 的角色和生成规则。 |
除了内置的服务商，您还可以通过 Provider: Custom 或直接修改 Model / Base URL 来使用任何 OpenAI 兼容的模型（如本地 Ollama 运行的模型）：
- 在设置中将 Provider 设为
Custom。 - 填写 Base URL (例如
http://localhost:11434/v1)。 - 填写 Model (例如
llama3)。
如果您想让 AI 使用特定的语言（如粤语、法语或仅使用 Emoji）生成提交信息：
- 在设置中将 Language 改为
Custom。 - 在 Custom Language 中输入您想要的语言名称或规则（例如
Emoji only）。
若 Base URL 和 Model 留空，插件将根据所选 Provider 自动使用以下默认值：
| 服务商 (Provider) | 默认模型 (Model) | 默认 Base URL |
|---|---|---|
| OpenAI | gpt-5-nano |
https://api.openai.com/v1 |
| DeepSeek | deepseek-chat |
https://api.deepseek.com |
| MiniMax | MiniMax-M2.5 |
https://api.minimaxi.com/v1 |
| Moonshot | kimi-k2-turbo-preview |
https://api.moonshot.cn/v1 |
| GLM | glm-5 |
https://open.bigmodel.cn/api/paas/v4 |
| Gemini | gemini-3.1-flash-lite-preview |
https://generativelanguage.googleapis.com/v1beta/openai |
| OpenRouter | openrouter/free |
https://openrouter.ai/api/v1 |
| Custom | - | - |
OpenRouter 默认使用免费路由模型：
openrouter/free。
Important
关于 Claude: 目前暂不支持 Claude 原生格式。请使用支持 OpenAI 兼容端点的中转服务。
- 源代码管理图标：点击 Git 面板顶部的 ✨ 图标。
- 命令面板：运行
WTF Commit: Generate。 - 命令面板：运行
WTF Commit: Set API Key来设置或更新密钥。 - 连击快捷键 (Chord)：您可以自行绑定双击
Cmd+G触发，设置方法见💡 进阶技巧。
如何设置连击快捷键？
- 打开键盘快捷键设置 (
Cmd+K Cmd+S)。 - 搜索
WTF Commit: Generate。 - 双击并连续按下两次
Cmd+G。
MIT License.