# 【AI Work】02 把 Git 留在会话旁边：WDX Git

> AI 改完代码，最烦的是切到终端处理 Git。WDX Git 把提交、同步、历史和冲突做进 DSH 右栏：一个按钮完成 fetch/merge/push，改动默认全选，提交信息由 AI 起草，但最后一步永远由你确认。

- 作者：[小土刀](https://wdxtub.com/about)
- 发布日期：2026-11-09
- 更新日期：2026-11-17
- 原文（引用请使用此链接）：https://wdxtub.com/blog/aiwork/aiwork-02
- 所属系列：aiwork AI Work
- 标签：AI、Work、Harness、Git、插件
- 许可：CC BY-NC-SA 4.0（https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh）
- 正文中的站内图片路径以 https://wdxtub.com 为根目录。

---

用 DSH 写代码的人大概都有过这个瞬间：AI 说「改好了」，你看了一眼 diff，觉得没问题，然后切到终端——`git status`、`git add`、`git commit`、`git pull`、`git push`。每一步都不难，但每切一次窗口，刚才脑子里的上下文就掉一截。等提交完回来，已经想不起下一步要让它改什么了。

AI 把写代码这件事变快了，但「改完到提交」这段路还是老样子。我也试过 GitHub Desktop，它确实比命令行顺手，但它是一个独立 App：你还是要在两个窗口之间来回看，还是得自己判断 AI 到底改了哪几个文件，提交信息也还是得自己写。

所以我把这段路搬进了 DSH 的右栏，做了 WDX Git。

![WDX Git 提交页](/static/images/aiwork/aw02/commit.webp)

## 省流版

+ 顶栏只有一个同步按钮，按仓库状态显示 Fetch origin / Pull origin / Push origin / Sync / Publish branch
+ 打开面板先看到提交页，改动默认全选
+ AI 读本次要提交的 diff 写提交信息，快速和详细两档
+ 变更、diff、历史、分支、stash、冲突都在面板里解决
+ 不 force push，不自动 rebase，不改写历史

## 一个按钮，但不是一把梭

Git 的日常操作其实只有几种状态：本地和远端一样、只落后、只领先、两边都有新提交、还没有 upstream。以前这些状态要靠 `git status` 和 `git log` 自己拼出来，再决定先 pull 还是先 push。现在顶栏按钮直接显示「点下去主要会发生什么」：

| 仓库状态 | 按钮 |
| --- | --- |
| 已同步 | Fetch origin |
| 只落后远端 | Pull origin |
| 只有本地提交 | Push origin |
| 两边都有新提交 | Sync |
| 没有 upstream | Publish branch |

点下去之后，面板内部会依次做：fetch --prune、补 upstream、快进或合并、需要时推送。需要合并时，工作区有改动会先自动 stash，合并完再恢复；push 被远端拒绝时，fetch + merge + 重试一次，再失败就把 git 的错误原样告诉你。冲突一定停下来，不会偷偷提交。

这也是我理解的「自动化」边界：可以替你跑流程，但不能替你承担改写历史的后果。

## 提交页先出现，改动默认全选

很多 Git 工具打开时落在「变更」页，你得先 review 一遍再切到提交页。我的习惯正好相反：AI 改完，我通常已经看过 diff 了，打开面板就是来提交的。所以 WDX Git 默认打开提交页，Summary、Description、AI 区和提交按钮一次排开。

改动默认全选。这一点和大多数工具不一样，但符合 AI 协作的实际情况：一次会话改五六个文件是常态，逐个勾选纯属浪费。不想提交的文件，去「变更」里取消勾选就行；提交时只暂存选中的路径，取消的文件留在工作区。

![提交历史](/static/images/aiwork/aw02/history.webp)

提交页左侧的提交者图标，用的是 wdxtub-blog 的 W 标记，不读 DSH 账户头像，也不读 GitHub 头像。倒不是洁癖，只是提交面板离「身份」太近，展示头像容易让人误会你在拿账号做什么。

## AI 写提交信息，但不替你提交

提交信息是我最不想手写的部分，尤其是改了十几个文件之后。WDX Git 的 AI 只做一件事：读本次待提交的 diff、文件列表、最近几条提交标题和当前分支，按仓库已有的风格写一条消息。

+ 快速：一句话 Conventional Commit，适合日常小改动
+ 详细：补充原因、行为变化、限制和验证信息，适合需要留痕的提交

默认跟随当前会话的模型，思考等级自动压低；嫌贵可以在设置里换成更便宜的模型。它只看本次会提交的内容：取消勾选的文件不会出现在 diff 里，未跟踪的文本文件也只在详细模式下按需读取。

AI 只生成文字。commit、push、解决冲突，最后一步都由你点。这个边界是故意的：提交信息写错了可以改，历史写错了就麻烦了。

## 冲突不硬来

同步遇到冲突会停下来，面板里可以看 ours 和 theirs 的差异，也可以直接取当前分支或对方分支。AI 生成合并建议时只预览，确认后才写入文件；手工改完点「标记为已解决」继续。中止、继续 merge、rebase、cherry-pick、revert 也都在面板里。

![解决冲突](/static/images/aiwork/aw02/conflict.webp)

## 为什么是一个 DSH 插件

DSH 的插件分 Host 和 Client 两半。Host 跑在 Node 里，负责 git 子进程、同步状态机和模型调用；Client 是浏览器 bundle，只画界面。两边通过 `POST /api/wdx-git` 走一套很小的 RPC，错误码和数据结构都写在 `PROTOCOL.md` 里。

这样做的好处很实际：不用另起进程，不用打包 Electron，颜色直接复用 DSH 的主题 token，深浅色自动适配；git 凭据、代理、hooks 都还是你本机那一套。macOS 上还会自动读取系统代理，Finder 启动的 DSH 也能正常 fetch / push——这个点看起来小，但 GUI 进程拿不到 shell 里的代理变量时，真的很烦。

代价也有：DSH 改版时客户端注入点可能变，Host 代码更新要重开 DSH 才会重新加载。这是插件形态的固有成本，只能认。

## 刻意不做的事

+ 不 force push，不自动 rebase，不改写提交历史
+ 不绕过 hooks，不做 commit signing
+ 不做 hunk 级 / 行级 partial staging，只到文件级
+ 不做远端选择 UI，多远端时优先 origin
+ 不在后台自动提交，也不替你决定冲突

这些不是没做完，是想清楚之后不做。Git 面板最怕「聪明」，一次错误的历史改写，比十次多点一下的代价大得多。

## 安装

侧栏 **插件 → 添加插件**，输入 `dsh-wdx-git`，安装源选 npm 官方源，装好后点「立即启用」。插件面向 DSH 0.2.x；装完刷新页面，有两个入口：会话头部工具栏的 Git 分支图标，或者右栏的 **+ → 开始 → WDX Git**。

源码、协议和测试在 [GitHub](https://github.com/wdxtub/dsh-wdx-git)，npm 包是 [dsh-wdx-git](https://www.npmjs.com/package/dsh-wdx-git)。当前 45 个测试，覆盖同步状态机、冲突、代理和 AI 提交信息。

WDX Git 不想替代 Git，也不想变成另一个 GitHub Desktop。它只想把「改完到提交」这段路缩短到看一眼、点一下。剩下的判断，还是留给人。

## 更新（2026-11-17）：从 0.1.2 到 0.1.8

上面那版写完之后的几天里，WDX Git 发到了 0.1.8。前面讲的东西都还在，新增集中在五处：左侧栏多了一个全局仓库页，同步按钮加了方向徽标，提交信息合并成一种，冲突解决完剩下的事它自己接着做，同步可以放到后台跑。

+ 左侧栏的 **Git** 入口列出所有工作区的仓库，不建会话也能直接提交
+ 同步按钮加了方向徽标：`↓` 待拉取，`↑` 待推送；推送时顺手带上可达的 tag
+ AI 提交信息不再分快速 / 详细，一次生成标题加一段正文，格式不合格自动重试
+ 最后一条冲突解决完，自动 commit merge / continue rebase / 放回 stash / 按你原来点的意图推送
+ 提交后的推送改在 Host 里脱离请求运行，切会话、切仓库都不会打断

### 方向徽标，和顺手带上 tag

按钮上加了 GitHub Desktop 式的方向徽标：`↓` 是远端待拉取的提交数，`↑` 是本地待推送的提交数，Pull / Push 的主图标换成细箭头，仓库行不再重复显示计数。推送分支时会一并推送可达的 annotated tag（`git push --follow-tags`），tag 推失败不影响分支同步。

### 左侧栏的全局仓库页

GitHub Desktop 左边那条仓库列表是它的招牌：不用先打开哪个项目，扫一眼就知道哪个仓库落后、哪个攒了一堆没提交的改动。

现在左侧栏有个 **Git** 入口，自动列出当前 DSH 的所有工作区，按父目录分组，显示分支、ahead/behind 和改动数。点开任意仓库就能提交、同步、看历史，不必先进那个项目建会话。没有会话时，AI 提交信息改用默认模型——全局页离会话太远，就不硬凑会话模型了。

![全局仓库页](/static/images/aiwork/aw02/global.webp)

概览每 30 秒自己刷一次。手动刷新时按钮至少转 650ms，转完短暂变绿色对勾，状态行写「正在刷新 N 个仓库 / 已更新 N 个 / 已是最新」，这一轮状态变了的行高亮约 1.6 秒。批量读状态走新增的 `overview`，并发 4，某个路径不是仓库或者打不开，不影响整批。

### 提交信息只留一种

快速和详细两档合成了一档：一次生成标题加正文，正文按 PR 摘要的密度写——一句动机，再 2–4 条具体改动，涉及测试就说清了覆盖了什么，信息量正好落在原来两档之间。

它也会自己把关：输出被截断、标题是半句话，或者改动不小而正文只有一句话，就带上上次被拒的理由重新请求，最多 3 次，每次多给一点 token。三次还不合格，留一个能用的标题或者降级文案，提交按钮始终按得下去。上下文统一成更大的 diff（30k），选中的未跟踪文件一定会读。

### 冲突解决完，剩下的它接着做

以前解决完冲突，还得自己想下一步：merge 要不要 commit、rebase 要不要 continue、自动 stash 要不要 pop、原本点的是 Sync 还要不要 push。现在最后一条冲突一解决（手动或者 AI 都行），这些就照你最初那个按钮的意图跑完。中途又冒出新冲突会继续处理，只有解决失败才停下来写清楚。

顺带修了几件小但烦人的事：

+ 变基是否进行中不再看 `REBASE_HEAD`：`rebase --continue` 成功之后 git 还留着这个伪引用，于是面板一直挂着「正在变基」，点继续只得到 `fatal: no rebase in progress`。现在只认 `.git/rebase-merge` / `.git/rebase-apply` 这两个状态目录在不在。
+ 「继续 / 中止」改成幂等：如果你已经在终端里做完了，面板刷新成最新状态并写明「当前操作已经结束」，不把 git 的原始错误甩给你。
+ 同步前先把自动 stash 的 commit id 返回给客户端，合并冲突、pop 冲突之后都能按这个 hash 找回或删掉那一条，不用懂 `stash@{n}`；自动 stash 恢复失败也不再被误报成「冲突」。
+ 冲突没解决、或者 merge / rebase 还在进行中时，同步按钮会被拦下，提示先把当前操作做完，不再甩一串看不懂的 git 报错。
+ 同一仓库的写操作在 Host 里排队，多开面板、多开会话不会同时改 index；撞上终端里别的 git 进程占着 `index.lock`，会等一等再重试。
+ push 被拒不再只重试一次：远端在合并期间又前进的话，fetch + merge 后再推，一共最多试 4 次，仍然失败才报错。
+ `continue` 之前如果还有没暂存的改动，先用 `stash push --keep-index` 收起来，做完再放回。
+ 游离 HEAD 下顶栏不再整个禁掉：可以 Fetch，也能在分支下拉里直接切回分支继续同步；提交会被拦下并提示先切回分支，免得提交脱离分支。
+ 冲突 AI 解决单个文件失败会重试一次，还不行才留给你手动处理。

「变更」页还多了「AI 解决全部」：逐个文件生成合并结果，直接写入并暂存，某个文件失败不影响其余，结束后汇总失败原因。大文件不再一律拒绝——超过 240k 字符，或者合并结果超过 12k 字符，就按冲突块逐个请求（带上下文）再拼回完整文件。设置里有个「冲突后自动用 AI 解决」，默认关闭；开了以后 sync / pull 一出冲突就直接逐文件解决并暂存，不再问你。我的判断是这个开关默认必须关：AI 解决冲突是有依据的猜测，猜错了会静静写进提交里。

### 同步可以放到后台

最后这次更新解决一个很小的问题：提交完点了「提交后推送」，然后切去另一个会话或另一个仓库，推送就断了。

现在 sync / push / pull 可以带 `background` 参数，Host 里脱离请求运行，切会话、切仓库、关掉面板都不会取消它。顶栏显示「后台同步中 / 后台推送中」并保持旋转，结果由下一次 snapshot 补上；切走时已经完成的任务，切回来也会报。后台同步碰到冲突不会自己往下走：停在那里，切到「变更」并列出冲突文件，解决之后照旧自动收尾。同一个仓库有后台任务时，其他写操作会被拦下，提示等它跑完。`snapshot` 多了一个 `background` 字段，报告这个仓库当前或最近一次的后台任务（`running` / `done` / `conflict` / `failed`，结果留 5 分钟）。不带这个参数时，行为和原来完全一样。

### 现在

当前版本 0.1.8，67 个测试（写这篇时是 45 个），覆盖同步状态机、冲突与自动收尾、后台任务、代理和 AI 提交信息。装法没变：侧栏 **插件 → 添加插件**，输入 `dsh-wdx-git`，安装源选 npm 官方源。Host 代码更新后要重开 DSH 才会重新加载，只刷新页面只更新客户端。

上面那条边界也没变：它可以替你跑流程、替你接着跑完冲突之后的活，但不替你改写历史——不 force push，不自动 rebase，不改写提交历史。

