前言¶

DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在智能体开发流程中，频繁切换终端或打开外部 Git 工具会打断会话的连贯性。dsh-git 插件将 Git 的核心操作封装为侧边栏面板，让开发者无需离开当前界面即可完成版本控制。

这是什么¶

dsh-git 是由 EasyTZ 维护的一款客户端插件，为 DeepSeek Harness 提供可视化的 Git 面板。它不依赖命令行记忆，直接在界面中处理暂存、提交、推送和分支切换等操作。

安装与启用¶

安装前请确保环境满足以下依赖：
* dsh 版本 >= 0.1.1-rc.2
* 机器上已安装 git 且在系统 PATH 中
* pnpm 可用

使用命令行安装：

dsh plugin --profile <name> add @easytz/dsh-git

<name> 为必填的 profile 名称，桌面版通常为 web，TUI 版为 tui。安装完成后重启 dsh，侧边栏底部会出现 Git 按钮。

核心功能¶

该插件提供以下核心能力：
* 查看改动：展示当前仓库的变更文件列表。
* 逐文件暂存：对每个文件单独执行暂存或取消暂存操作。
* 提交与推送：在面板内直接编写提交信息并推送到远端。
* 切换分支：通过下拉菜单快速切换分支，并显示与上游的领先/落后数量。
* 浏览历史：查看最近提交记录，点击可查看详情（包括改动文件及行数统计）。
* 撤销最近一次提交：支持对最新提交进行回滚。
* 多仓库支持：支持在一个工作区下管理多个独立的 Git 仓库。

典型用法¶

1. 打开面板
   点击侧边栏底部的 Git 按钮打开面板。

2. 选择仓库
   如果当前工作区下有多个仓库，面板顶部会显示“仓库”下拉框，选择目标仓库即可。

3. 暂存文件
   在“变更”列表中，点击文件右侧的 + 暂存文件；已暂存的文件点击 − 取消。

4. 提交
   在提交框中编写信息，点击 提交 按钮。

5. 推送
   点击 推送 ↑n 按钮，其中 n 为本地领先远端的提交数。

6. 切换分支
   在分支行使用下拉菜单切换分支，旁边的数字显示相对上游的进度。

7. 查看历史
   点击“最近提交”中的任意一条，弹出详情窗口查看完整提交信息和文件变动。

8. 撤销提交
   只有最新的一条提交右侧有撤销按钮。点击后按钮变红进入二次确认，三秒内再次点击即可执行：

   • 未推送的提交执行 reset --mixed，改动退回工作区。
   • 已推送的提交执行 revert，生成反向提交。

注意事项¶

• 撤销限制：仅支持撤销最新的一条提交。
• 推送冲突：当远端拒绝推送（如冲突）时，面板会提示去终端执行 git pull，不会自动处理。
• 未跟踪文件：新文件不会被自动暂存，必须逐个点击 + 明确选择。
• 缓存机制：浏览器端插件 bundle 带一年期的 immutable 缓存，升级后需重启 dsh 才能生效。
• 多仓库扫描：插件只扫描工作区根目录下一层的子目录作为仓库，会自动跳过 node_modules、dist 等目录。

适用场景¶

适用于需要在 DSH 环境内进行高频 Git 操作的开发者，特别是习惯在侧边栏进行快速版本控制，而不愿频繁切换窗口的场景。

结尾¶

dsh-git 通过可视化的方式简化了 DSH 中的 Git 流程，让版本控制更贴近操作流。更多细节可参考 插件目录 或 GitHub 仓库。