Git 集成
LoongCode 将常用的 Git 工作流直接集成到界面中：统一的分支与 worktree 切换器、可视化的代码审查面板、AI 一键生成提交消息，以及简洁的提交与推送入口。即使不熟悉 Git 命令行，也可以通过界面完成完整的版本管理流程。
相关基础：界面导览
不熟悉 Git？
没关系——本页的操作都可以照步骤点击完成，不需要记任何命令。Git 是记录代码每次修改的版本管理工具：「提交」相当于存一次档，「分支」相当于平行的存档线，「推送」则是把存档同步到云端仓库。先照着做，细节可以以后再深入。
分支与 Worktree 切换器
顶部标题栏显示当前任务所在的分支名称，点击它即可打开统一切换器。
Worktree（Git 工作树）可以这样理解：同一份代码库在多个文件夹中以不同分支状态同时打开——每个文件夹各自停留在自己的分支上，互不干扰，适合多条任务并行开发。切换器将普通分支和 worktree 统一列出，一个入口管理全部。
搜索与切换
切换器顶部有搜索分支 / worktree输入框，直接输入关键词过滤列表。列表分为分支和远程跟踪两个分组（「远程跟踪」指与远程仓库同步的分支引用，形如 origin/main，代表远程仓库上对应分支的最新状态）：
- 选择普通分支 → 对主仓库执行
git checkout（若当前在 worktree 跟随状态则先脱离）。 - 选择 worktree 占用的分支 → 切换到该 worktree 环境（不执行 checkout，改变的是 UI 面板根目录）。
- 底部列出未提交的更改文件数，切换前可确认当前工作区状态。
新建分支
在切换器底部点击创建并检出新分支…，打开「创建并检出新分支」对话框：
- 在分支名输入框填写新分支名称（例如
feature/my-feature）。 - 点击创建并切换，基于当前 HEAD 创建新分支并立即切换过去。
TIP
目前仅支持基于当前 HEAD 创建新分支。
新建 Worktree
在切换器底部点击新建 worktree…，打开「新建 worktree」对话框：
- 填写新分支名和worktree 目录（相对仓库的路径；默认会在仓库的上一级目录创建一个「仓库名-分支名」的文件夹，可手动修改）。
- 点击创建并跟随，创建新 worktree 并让当前任务自动跟随过去。
Agent 自动跟随 Worktree（v0.2.0 起）
当 AI（Agent）在对话中自动执行 git worktree add 创建 worktree 时，LoongCode 会侦测到这一操作并让当前任务自动跟随——文件树、终端、审查面板整体切换到新 worktree 目录，你无需手动操作。界面会弹出一条可撤销的提示，点击撤销仅停止跟随，不删除 worktree。
worktree 被删除时（无论是应用内操作还是命令行外部操作），绑定它的任务会自动脱离回主仓库，面板恢复到主树目录。
移除 Worktree
在切换器中将鼠标悬浮到 worktree 分支行，出现移除 worktree 入口（垃圾桶图标），点击后立即执行移除——移除前应用会先结束该 worktree 目录下运行的所有终端进程，再删除该 worktree 文件夹。
若该 worktree 中存在未提交的改动（或目录被占用），普通移除会失败：此时会弹出确认对话框，显示 Git 的原始错误信息，并询问「仍要强制移除吗？」。
强制移除会丢失未提交的改动
普通移除在 worktree 有未提交改动时会被 Git 拒绝，改动不会丢失；但确认强制移除后，整个 worktree 文件夹连同其中未提交的改动会被一并删除，无法恢复。移除前请确认改动已提交，或已另行备份。
另外，在 worktree 环境下，顶部提交菜单中的创建分支功能不可用——界面会提示：请先移除当前 worktree（任务会退回主仓库分支），再创建分支。
审查面板
审查标签页在右侧面板中展示工作区的代码 Diff，帮你在提交前确认所有改动。
查看模式
审查面板顶部有四个视图模式切换：
| 模式 | 显示内容 |
|---|---|
| 未暂存 | 尚未 git add 的工作区改动 |
| 已暂存 | 已 git add 但未提交的改动 |
| 全部分支更改 | 当前分支与基干分支（main/master）的所有差异 |
| 上一轮更改 | 上一次提交的改动（类似 git show HEAD） |
TIP
若仓库没有 main/master 或 origin/HEAD，「全部分支更改」模式会显示提示「未找到基干分支（main/master 或 origin/HEAD），无法比较全部分支更改」。
文件列表与 Diff
每个改动文件显示文件名与文件名右侧的目录段（灰色小字，过长时自动中段省略），方便在多个同名文件之间快速定位。每行还显示变更类型标记：增（新增文件）、删（删除文件）、改（修改文件）。
点击文件行即可展开内联 Diff，以行级红绿高亮呈现新旧内容对比。点击展开全部内容可查看未截断的完整 Diff。
提交代码
打开提交对话框
点击顶部标题栏的提交按钮（或在更多 Git 操作菜单中选择提交），打开「提交更改」对话框。
对话框显示：
- 当前分支：本次提交将写入哪条分支
- 更改：将被提交的文件数
- 提交消息输入框：填写本次提交的说明文字，占位提示为「留空以自动生成提交消息」
AI 生成提交消息（v0.5.0 起）
不想自己写提交消息？有两种自动方式，效果和成本不同：
- 点 ✨ 按钮（AI 生成，可预览）：点击提交消息输入框右侧的 ✨ 按钮，AI 根据当前工作区的实际改动生成一条规范的提交消息并填入输入框；你可以在此基础上继续编辑，满意后再点击提交。AI 生成会消耗额外 token（走一次与当前任务隔离的一次性会话，不会出现在任务列表中）；生成失败时会显示具体的错误信息，便于排查。
- 直接留空提交（本地摘要，不耗 token）：不填提交消息直接点击提交，会自动用改动文件名与增删行数拼出一条简单的摘要消息（形如
update src/foo.ts (+12 -3)）。这一条在本地生成，不调用 AI、不消耗 token。
推送与更多 Git 操作
点击提交按钮旁的更多 Git 操作按钮，展开操作菜单，包含：
- 提交：等同于点击提交按钮
- 推送：将当前分支推送到
origin，推送期间界面显示「推送中…」提示，完成后显示「已推送到 origin/<分支名>」 - 创建分支：基于当前 HEAD 新建并切换分支（worktree 环境下不可用）
未推送计数
当本地有尚未推送的提交时，推送菜单项右侧会显示 ↑N 徽标——N 表示本地领先远程的提交数，也就是已提交但还没推送到远程仓库的提交数量。推送成功后徽标消失。看到徽标就说明还有工作没同步到远程，记得及时推送。
回滚变更
代码回滚不是 Git 面板里的独立操作，而是「编辑历史消息」的一个附加选项：在编辑某条历史用户消息时勾选同时回滚代码，LoongCode 才会把工作区文件回滚到该消息发送前的状态，并显示本次回滚变更预览面板，展示将被回滚的文件列表与 Diff。
回滚会连带改变对话历史
回滚依附于「编辑历史消息」，触发时会从该条消息处截断当前会话（其后的对话不再保留在当前任务中），再以修改后的内容重新运行——文件与对话历史会一起变化，不存在「只回滚文件、对话历史不变」的情况。该消息之后的文件改动（含你手动改的）也会被丢弃；回滚前 LoongCode 会自动存一份代码安全快照，但当前版本未提供一键撤销入口，请务必在确认 Diff 预览后再操作。
完整操作步骤与可用条件，见对话面板 → 编辑历史消息重跑与代码检查点。
下一步
完成 Git 工作流的学习后，接下来了解如何使用斜杠命令快速调用内置功能——前往斜杠命令继续学习。