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

# 生成提交消息

Cline 的 Git 集成将 AI 辅助功能直接带入您的版本控制工作流程。无需离开编辑器即可生成提交消息。

## 生成提交消息

最有用的 Git 集成之一是自动生成有意义的提交消息的能力：

![使用 Cline 生成提交消息](https://storage.googleapis.com/cline_public_images/docs/assets/generate-commit-message-with-cline.png)

1. 进行更改并在 Git 中暂存它们
2. 在源代码控制视图中点击机器人图标或运行 "使用 Cline 生成提交消息" 命令
3. Cline 分析您的更改并生成描述性的提交消息
4. 消息自动插入到提交消息输入框中

生成的提交消息：

* 以简洁的摘要开始（50-72 个字符）
* 使用命令式语气（例如，"Add feature" 而不是 "Added feature"）
* 描述更改了什么以及为什么
* 遵循 Git 最佳实践

此功能节省时间并确保您的提交历史一致且信息丰富。

> [!TIP]
>
> 有关在聊天消息中使用 `@git-changes` 和 `@[commit-hash]` 提及的信息，请参阅 [Git
> 提及](https://cat.mintlify.site/features/at-mentions/git-mentions.md) 文档。

## 工作原理

当您使用 Cline 的提交消息生成功能时，幕后发生的事情如下：

1. Cline 使用 `getWorkingState()` 检索当前的 Git 差异
2. 它将此差异格式化为 AI 的专用提示
3. AI 分析更改并生成适当的提交消息
4. 消息被提取并插入到 Git 提交消息输入框中

此过程使用您当前的 Cline API 配置，因此生成消息的质量与您选择的 AI 模型相匹配。

## 有效使用技巧

* **为复杂更改生成提交消息**：AI 擅长将多个相关更改总结为连贯的消息。

* **审查和编辑生成的消息**：虽然 AI 生成高质量的消息，但总是审查并根据需要调整它们是个好习惯。

* **将相关更改一起暂存**：为了获得最佳结果，将相关更改一起暂存，以便 AI 可以生成连贯的消息。

* **用于一致的提交历史**：使用生成提交消息功能有助于在您的提交历史中保持一致的风格。

## 底层工作原理

提交消息生成利用 VSCode 的 Git 扩展 API 来访问仓库信息：

1. 当您触发命令时：
   * Cline 获取当前差异
   * 它将其发送给 AI，并附带提交消息格式化的特定指令
   * 它解析 AI 的响应
   * 它访问 Git 扩展 API 来设置提交消息

与 Git 的这种集成使得在不中断工作流程的情况下轻松生成高质量的提交消息。

下次您为写好提交消息而苦恼时，尝试使用 Cline 的提交消息生成功能。您将节省时间并通过 AI 辅助改进您的版本控制工作流程，恰好在您需要的地方。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.