> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 生成 Commit

> 根據當前 Git 變更，用 CC GUI 生成提交說明並填回提交介面。

CC GUI 可以讀取當前專案的 Git diff，生成提交說明，並儘量寫進 JetBrains 的 Commit 訊息框。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/jetbrains/scm-commit.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=59b614063470faa77591b9f4e6573362" alt="提交介面裡的生成按鈕" width="100%" data-path="images/jetbrains/scm-commit.png" />

## 開啟前先確認

1. 專案是 Git 倉庫，並且有未提交變更
2. **設定 → 基礎配置 → 行為 → AI 生成提交資訊** 為開啟
3. **設定 → Commit AI** 裡已選可用的供應商和模型
4. IDE 已啟用 Git 支援（Git4Idea）

關閉總開關後，動作會提示該功能已禁用。

## 生成一次提交說明

<Steps>
  <Step title="開啟 Commit 工具視窗">
    確認變更列表裡有檔案。沒有 diff 時，動作會提示沒有變更。
  </Step>

  <Step title="點生成按鈕">
    在 VCS Message 工具欄點 CC GUI 的生成按鈕，或透過 **Find Action** 執行 Generate Commit Message。
  </Step>

  <Step title="等結果寫回">
    生成過程在後臺執行緒執行，避免卡住 EDT。成功後訊息框裡是清理過的提交說明。
  </Step>
</Steps>

生成失敗時，外掛會把完整提示詞塞進對話，並說明原因。

## 配置 Commit AI

開啟 **設定 → Commit AI**：

* 選擇供應商和模型（Claude / Codex / 各 CLI）
* 編輯全域性提示詞
* 按專案覆蓋提示詞

提示詞裡可以固定語言、約定標題格式，或要求必須寫正文。

<Note>
  Commit AI 會把 diff 發給所選模型。過大的 diff 會被截斷。敏感倉庫先檢查提示詞和供應商。
</Note>

## 常見問題

| 現象        | 原因                                                                                              |
| --------- | ----------------------------------------------------------------------------------------------- |
| 提示沒有專案    | 先開啟專案                                                                                           |
| 提示沒有變更    | 先留下未提交 diff                                                                                     |
| 提示沒有可用供應商 | 先配好 [Claude](/zh-Hant/jetbrains/providers/claude) 或 [Codex](/zh-Hant/jetbrains/providers/codex) |
| 按鈕看不見     | 確認當前是 Git 倉庫，且總開關已開啟                                                                            |