前言¶
在 DeepSeek Harness（DSH）的对话窗口里写代码，很容易忽略提交、切换分支、审查差异这些 Git 操作。AI 编程不止是生成代码，还需要审查差异、挑选提交、切换分支，以及用独立工作树并行探索。DSH Git Workbench 把这些操作放回当前会话，让你少切窗口，也更清楚每一次 Git 操作会影响什么。
这是什么¶
这是面向 DSH Web GUI / Desktop 的社区开源插件，不是 DeepSeek 官方项目。插件依赖 DSH 宿主接口，不能作为独立网页运行。它把 Git 工作台集成到 DSH 的界面中，提供分支管理、变更审查、提交历史、储藏管理、多工作树和 AI 草稿协作能力。
插件由 Yaronluo 维护，采用 MIT 许可证，当前版本 1.1.1。
核心能力¶
分支与同步¶
自动识别 Git 仓库，支持搜索和切换分支、创建分支、fetch / pull / push，以及查看上游与 ahead / behind 信息。在输入框上方有一个分支胶囊，可以快速访问这些操作。
变更审查¶
按冲突、已暂存、未暂存、未跟踪分组，提供行号、词级高亮、并排差异、上下文与忽略空白选项。
精细提交¶
支持文件或 hunk 级暂存 / 取消暂存，可以提交草稿、amend、添加 Signed-off-by、撤销上次提交。编写提交信息时会读取暂存区补丁。
历史追溯¶
浏览提交图谱、提交详情、逐文件 diff、reflog、文件历史与 blame。
储藏与工作树¶
储藏补丁预览与恢复；支持工作树创建、打开会话、锁定 / 解锁、清理预演。
冲突处理¶
冲突分组、选用当前 / 传入版本，以及进行中 Git 操作的继续 / 中止 / 跳过。
本机工具¶
在编辑器或文件管理器中打开文件、复制路径 / 补丁、仓库内图片预览。
会话协作¶
按会话与仓库保留选择、草稿和滚动位置；提供 8 个 agent Git 工具。
AI 草稿协作¶
「AI 写信息」「AI 审查改动」「注入 Git 上下文」「解释这个文件」只准备提示词草稿，不自动发送、不自动提交、不自动调用模型。编写提交信息读取暂存区补丁，审查改动使用当前比较范围。
供 agent 使用的工具包括：git_status、git_diff、git_log、git_stage、git_unstage、git_commit、git_stash、git_branch。所有工具都需要明确的 cwd。
安装与启用¶
环境要求¶
- 已安装并能运行的 DSH Web GUI / Desktop。插件清单声明
dsh >=0.2.0-rc.2。 - 本机安装 Git，并确保
git在 DSH 进程的PATH中可用。 - 从源码构建 / 运行测试：建议 Node.js 24.2+、pnpm 11。
npm 安装（推荐）¶
npm 包名是 dsh-plugin-git-workbench，已包含构建产物，无需在本地编译。注意：npm 上的 dsh-plugin-git 是其他作者的包，并非本项目。
dsh plugin --profile desktop add dsh-plugin-git-workbench
GitHub Release 安装¶
也可直接安装 GitHub Release 提供的预构建包。
dsh plugin --profile desktop add https://github.com/Yaronluo/dsh-plugin-git-workbench/releases/latest/download/dsh-plugin-git-workbench.tgz
其它 profile 请将 desktop 替换为实际名称。按宿主提示重启应用后使用。
从源码安装¶
开发和本地调试可使用以下方式：
git clone https://github.com/Yaronluo/dsh-plugin-git-workbench.git
cd dsh-plugin-git-workbench
pnpm install --frozen-lockfile --ignore-scripts
pnpm build
然后将构建后的项目以本地 link 插件加入 DSH Desktop profile。将下面路径替换成你本机克隆目录的绝对路径：
dsh plugin --profile desktop add "link:D:\path\to\dsh-plugin-git-workbench"
其它 profile 请将 desktop 替换为实际名称。安装后按 DSH 提示重启应用，再打开 Git 仓库中的会话，查看 Git 页签与输入框上方的分支入口。
Host 代码变更需要重新加载插件或完整重启 DSH，单纯刷新网页不会替换正在运行的 Host 服务。客户端修改后也建议构建并刷新；不要假设所有安装方式都支持热更新。
典型用法¶
在 DSH 中打开一个 Git 仓库的会话，左侧会出现「对话 / 轨迹 / 上下文 / 编队」同排的 Git 页签。点击 Git 页签进入变更工作台，可以查看当前仓库的文件列表与差异。
在输入框上方有一个分支胶囊，点击可以搜索和切换分支、拉取和推送。切换分支后，Git 工作台会显示新分支的提交历史和变更状态。
对于未提交的改动，可以在变更工作台中按冲突、已暂存、未暂存、未跟踪分组查看。右键文件可以暂存 / 取消暂存，或选择在编辑器中打开。
点击「提交记录」页签可以浏览提交图谱、作者与引用，点开提交查看逐文件差异。点击「储藏管理」可以保存未提交改动，查看补丁，再选择应用、弹出或删除。点击「工作树管理」可以查看工作树状态、打开对应会话、在文件管理器中显示目录，以及锁定或安全移除工作树。
AI 草稿功能会在右侧对话中追加提示词草稿，而不是覆盖已有内容。缺少可用侧边对话时，会在同一项目目录新建普通对话并填入草稿。所有 AI 草稿都需要先检查再手动发送。
适用场景与注意¶
适合在 DSH 中进行 Git 操作的开发者，尤其是需要频繁切换分支、审查差异、管理储藏或使用多工作树并行探索的场景。
插件以当前 dsh 进程的权限运行，可以修改本地仓库。提交、恢复文件、软重置、储藏删除等操作前，请确认目标仓库与影响范围，重要工作先备份。包含引用 / 路径校验、字面路径处理、冲突守卫与危险操作确认，但这些保护不能替代代码审查，也不构成安全保证。
AI 草稿可能包含代码、路径和差异。发送前请移除密钥和不应交给所选模型服务的内容。凭据由本机 Git 配置及凭据管理器处理，不要把 token 放入仓库或问题反馈中。
短结尾¶
DSH Git Workbench 把 Git 工作流带进 DeepSeek Harness，让你在对话窗口里完成分支切换、变更审查、提交记录、储藏管理与多工作树操作，同时提供 AI 草稿协作能力。安装后打开 Git 仓库中的会话，即可使用 Git 页签与输入框上方的分支入口。
