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

# Git 版本管理

> 用 Git 把项目初始化为本地仓库，在关键节点提交快照，随时回退到满意的版本

SoloEnt 支持用 Git 对整个项目（workspace）进行版本管理。你可以把打开的项目初始化为一个**本地仓库**（无需联网、无需远程托管），在写作过程中把阶段性成果提交为快照，之后如果对 AI 后续的改动不满意，就能整体回退到之前某个满意的节点。

## 初始化仓库

在左侧边栏选择第三个标签（源代码管理），点击 **初始化仓库**，即可把当前项目变成一个本地 Git 仓库。

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/git_1.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=8b18c37153ab80763e1c19d6e411af6d" alt="编辑器左侧的源代码管理标签，显示 chapter-01.md 等项目文件，以及初始化仓库后可用的自动 Commit 入口" style={{ width: '70%' }} width="590" height="646" data-path="assets/images/git_1.png" />

## 提交更改

初始化完成后，每完成一项任务，就可以在源代码管理面板把本次改动提交（Commit）到仓库。

<Steps>
  <Step title="查看改动">
    面板左侧会列出本次发生变化的文件（新增文件标记为 **U**）。
  </Step>

  <Step title="生成提交说明">
    点击面板右上角第二个图标，用 SoloEnt 的**提交内容总结**功能自动生成 Commit Message。
  </Step>

  <Step title="提交">
    确认说明后点击 **提交**，本次改动即被保存为一个版本节点。
  </Step>
</Steps>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/git_2.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=2bb4001d54e2fca84c8496bd3cc0c06e" alt="源代码管理提交界面：左侧为改动文件列表，右上角提交按钮旁的自动图标用于生成 Commit Message" style={{ width: '55%' }} width="740" height="1012" data-path="assets/images/git_2.png" />

## 什么时候该提交

如果你担心某个版本的内容之后会丢失或被改坏，建议在每个**阶段性任务**完成后都提交一次，例如：

* 完成整本书的大纲
* 完成前 10 章
* 完成一次大的设定调整

这样一来，后续如果觉得 AI 改得不满意，就可以整体撤回到之前提交过的某个节点重新开始。

<Tip>
  提交越频繁、粒度越清晰，回退时就越容易找到那个"改坏之前"的干净版本。
</Tip>

<CardGroup cols={2}>
  <Card title="上下文与 SOLOENT.md" icon="file-lines" href="/zh/tips/SoloEnt">
    配合 `SOLOENT.md` 记录项目全貌，让每个新会话都能快速恢复上下文
  </Card>

  <Card title="常见问题速查" icon="circle-question" href="/zh/faq">
    遇到提示安装 Git、checkpoints 等问题时在这里查阅
  </Card>
</CardGroup>
