> ## 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](/jetbrains/providers/claude) 或 [Codex](/jetbrains/providers/codex) |
| 按钮看不见     | 确认当前是 Git 仓库，且总开关已打开                                                            |