回到首页

输入关键词,多个关键词用空格分隔。

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

约 10 分钟

摘要

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

本页目录

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

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

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

WDX Git 提交页

省流版

  • 顶栏只有一个同步按钮,按仓库状态显示 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
没有 upstreamPublish branch

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

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

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

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

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

提交历史

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

AI 写提交信息,但不替你提交

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

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

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

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

冲突不硬来

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

解决冲突

为什么是一个 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,npm 包是 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 提交信息改用默认模型——全局页离会话太远,就不硬凑会话模型了。

全局仓库页

概览每 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,不改写提交历史。

本文 Markdown 版本机器可读站点索引:llms.txt

相关文章