前言¶
在 DeepSeek Harness（DSH）里用 AI 改代码时，常见打断来自 Git：切到终端做 pull、stage、写提交信息，再切回会话，上下文容易断掉。终端或独立 Git 客户端能完成这些事，但按钮多、步骤散，和「边聊边改」的节奏不对齐。下面介绍客户端插件 WDX Git（dsh-wdx-git），它把 Git 面板放在 DSH 右侧栏，用一个同步按钮处理 fetch / pull / push，默认打开提交页并全选改动，还可让 AI 根据本次 diff 写提交信息。
这是什么¶
WDX Git 是 DSH 右侧栏里的 Git 面板，维护者为 wdxtub，在插件目录中归类为客户端。README 将其定位为：AI 改完代码后不必切终端，也不必在一排 Pull / Push / Fetch 里做选择；交互思路参考 GitHub Desktop 里顺手的一部分，但为 DSH 会话重新设计，不是完整的 GitHub Desktop 替代品。
- 仓库：wdxtub/dsh-wdx-git
- 目录页：SkillHub 插件页
- 许可：MIT（资料注明适用于 DSH 0.2.x，支持 macOS / Windows / Linux）
- npm 包当前版本（
package.json）：0.1.4；运行要求 Node>=22，DSH>=0.2.0 <0.3.0
插件在本机执行 Git 操作；私有仓库依赖你机器上已有的 git 凭据。安装前建议自行查看源码与许可证——插件以当前 DSH 进程权限运行。
一个同步按钮¶
顶栏保留仓库名、分支名和一个同步按钮。按钮文案随仓库状态变化，点一次由插件按顺序完成所需步骤（fetch → 补 upstream → 快进或合并 → 需要时推送）。
| 状态 | 按钮显示 |
|---|---|
| 已与远端同步 | Fetch origin |
| 只落后远端 | Pull origin |
| 只有本地提交 | Push origin |
| 本地与远端都有新提交 | Sync |
| 尚无 upstream | Publish branch |
落后或领先远端时，按钮内会出现带方向箭头的计数：↓ 表示待拉取的远端提交，↑ 表示待推送的本地提交。工作区有未提交改动时，同步前会自动 stash，合并后恢复；push 被拒时会自动重试一次（fetch + merge + 再 push）。不 force push，不自动 rebase，不改写已有历史；遇冲突才停下来，由你在面板里处理。
提交页默认在前，改动默认全选¶
打开面板先看到提交表单：Summary 一行、Description 单独一行，AI 区域与提交按钮依次排开。所有改动默认勾选；取消某个文件则只留在工作区，不会进入本次提交。提交时仅暂存选中的路径。
AI 可生成提交信息，分两种风格：
- 快速：一句话 Conventional Commit，适合日常小改；
- 详细：补充原因、行为变化、限制与验证信息。
默认跟随当前会话模型；也可在设置里换更便宜的模型。AI 只读本次会提交的 diff 及相关上下文，不替你做提交或推送，最后一步仍由你确认。
变更、历史、分支与冲突¶
除提交与同步外，README 还说明面板支持：
- 变更 / 差异：逐文件查看，词级高亮 diff；
- 历史：SVG 提交车道图、提交搜索；
- 分支与 Stash：分支切换等；
- 冲突：查看 ours / theirs，AI 生成合并建议（仅预览，确认后写入）、取某一侧或手工修改后「标记为已解决」；支持中止或继续 merge / rebase / cherry-pick / revert。
界面颜色来自 DSH 主题 token，深浅主题自动适配。macOS 可自动读取系统 HTTP/HTTPS 代理；其他平台尊重 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY 或 git 的 http.proxy。Git 数据留在本机，README 写明插件不保存 token、不做遥测。
插件刻意不做的事项包括：hunk / 行级 partial staging（仅到文件级）、远端选择 UI（多远端时优先 origin）、绕过 hooks、commit signing、后台自动提交等。
安装与启用¶
从插件页安装（推荐）¶
在 DSH 侧栏打开 插件 → 添加插件，输入包名：
dsh-wdx-git
安装源选 npm 官方源，装好后点 立即启用。若镜像未同步，可切换安装源再试。npm 包主页：https://www.npmjs.com/package/dsh-wdx-git。
从源码安装¶
若你从 GitHub 拉取源码本地安装，README 给出的命令为：
git clone https://github.com/wdxtub/dsh-wdx-git.git
dsh plugin --profile desktop add ./dsh-wdx-git
安装后刷新页面。若更新了 Host 代码（index.js / src/），需重开 DSH 让 Host 重新加载；仅刷新页面只更新客户端部分。
启用后入口有两处：
- 会话头部工具栏的 Git 分支图标；
- 右栏 + → 开始 →「WDX Git」。
典型用法¶
按 README「上手」步骤，可这样走一遍：
- 打开任意会话的 Git 面板；默认在「提交」页。
- 看顶栏按钮是 Fetch origin / Pull origin / Push origin / Sync 中的哪一种，点一下完成与远端的同步；需要时会自动合并、推送。
- 填写 Summary，或点 AI 生成。
- 点「提交 N 个文件到 main」；勾选「提交后推送」可在提交后继续同步。
适合谁、要注意什么¶
README 归纳的适用人群包括：在 DSH 里高频提交的人、不想为 pull / push / stage 反复切终端的人、希望提交信息规范但不想每次手写的人，以及喜欢 GitHub Desktop 式交互但希望面板长在 AI 会话旁的人。
使用前请确认 DSH 版本在 0.2.0 至 0.3.0 之间，且本机 Node 满足 >=22（Host 侧要求）。AI 生成提交信息会把 diff 等内容发到你设置里的模型服务商；若仓库敏感，请在设置中选用合适的模型与模式。
DSH 生态是「一切皆插件」；社区目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系。本文事实来自插件 README 与 package.json，星标等动态信息以各站点当时展示为准。
结尾¶
WDX Git 把 Git 留在会话旁边：一个同步按钮、默认提交页与全选改动、可选的 AI 提交信息，并在冲突时留在面板内处理。若要安装或读完整 FAQ，见 SkillHub 目录页 与 GitHub 仓库。
