LLM 提交信息

May 25, 2026 · View on GitHub

AI 自动分析你的代码改动,生成高质量的 git 提交信息。支持通过 OpenRouter 使用 GPT、Claude、Gemini 等各种大语言模型。

✨ 核心功能

🎯 一键生成提交信息

在源代码管理面板点击星星(✨)按钮,几秒钟就能得到符合 Conventional Commit 规范的完美提交信息。

🧠 丰富的上下文收集

不只是看代码改动,还会分析整个项目环境:

暂存区差异 - 详细分析实际代码变更和补丁细节
项目树 - 了解工作区的文件结构和修改状态
最近提交记录 - 每个修改文件最多包含10条历史提交,保持风格一致
打开的标签页 - 当前编辑器中正在处理的文件
终端日志 - 最近执行的命令输出
大量差异处理 - 对于变更较多的文件(3个以上代码块),会包含完整文件快照

🌐 通过 OpenRouter 支持多种 AI 模型

自由选择最新的 AI 模型:

OpenAI: GPT-4、GPT-4 Turbo、GPT-3.5
Anthropic: Claude 3.5 Sonnet、Claude 3 Opus
Google: Gemini 2.5 Flash、Gemini Pro
Meta: Llama 3
Mistral: Mixtral 8x7B
还有更多模型可供选择...

默认模型: google/gemini-2.5-flash-lite (速度快,成本低)

📝 自动生成 Conventional Commits 格式

生成的信息自动遵循 Conventional Commits 标准:

<type>(<scope>): <subject>

<body>

类型: feat、fix、docs、style、refactor、perf、test、chore、ci、build

🌍 多语言提交信息

可以用你习惯的语言编写提交信息:

将 kargnas.aiCommit.commitLanguage 设为 "ko" 生成韩语,"ja" 生成日语,"auto" 则使用英语

🔍 调试与透明度

完整请求日志 - 所有 API 请求都会记录到输出面板
"查看最后的载荷" - 查看发送给 AI 的确切提示词和上下文
原始响应日志 - 可以查看解析前模型返回的原始内容

🏢 多仓库工作区支持

在多个 git 仓库中工作?没问题:

自动检测当前工作的仓库
不确定时会提示你选择
为每个仓库维护独立的上下文

📦 安装

从 VS Code 市场安装
在 OpenRouter 获取 API 密钥
打开 VS Code 设置 (⌘+, 或 Ctrl+,)
搜索 "kargnas commit"
将 API 密钥粘贴到 Kargnas Commit AI: API Key 中

🚀 使用方法

在源代码管理面板中暂存你的更改
点击提交信息输入框旁边的星星按钮(✨)
等待几秒让 AI 分析你的改动
检查生成的信息 - 需要的话可以修改
提交!

没有暂存的更改?

如果你在没有暂存任何内容的情况下点击按钮,插件会询问是否要自动暂存所有更改。

⚙️ 配置

设置	默认值	说明
`kargnas.aiCommit.apiKey`	`""`	OpenRouter API 密钥 (必需)
`kargnas.aiCommit.model`	`"google/gemini-2.5-flash-lite"`	OpenRouter 模型 ID
`kargnas.aiCommit.endpoint`	OpenRouter API	自定义 API 端点 (高级)
`kargnas.aiCommit.commitLanguage`	`"auto"`	提交信息语言 (如 `"ko"`、`"ja"`)
`kargnas.aiCommit.transport`	`"fetch"`	HTTP 传输方式 (`"fetch"` 或 `"curl"`)
`kargnas.aiCommit.requestTimeoutMs`	`25000`	API 请求超时时间(毫秒)
`kargnas.aiCommit.logRawResponse`	`true`	将原始 API 响应记录到输出面板
`kargnas.aiCommit.contextIncludeGlobs`	`["*/"]`	包含在上下文中的文件模式
`kargnas.aiCommit.contextIgnoreGlobs`	`["*/.lock", "dist/**", ...]`	从上下文中排除的文件模式
`kargnas.aiCommit.maxFilePatchBytes`	`12000`	单个文件差异的最大字节数
`kargnas.aiCommit.maxPatchBytes`	`50000`	总差异的最大字节数
`kargnas.aiCommit.previousCommitLimit`	`10`	包含的最近提交数量
`kargnas.aiCommit.openTabsLimit`	`10`	包含的打开标签页数量
`kargnas.aiCommit.terminalLogLines`	`20`	包含的终端日志行数
`kargnas.aiCommit.projectTreeMaxEntries`	`400`	项目树的最大条目数
`kargnas.aiCommit.logPromptMaxChars`	`0`	提示词日志截断长度(0 = 无限制)

配置示例

{
  "kargnas.aiCommit.apiKey": "sk-or-v1-...",
  "kargnas.aiCommit.model": "anthropic/claude-3.5-sonnet",
  "kargnas.aiCommit.commitLanguage": "ko",
  "kargnas.aiCommit.logPromptMaxChars": 0
}