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
}