在 DeepSeek Harness (DSH) 环境中，直接处理 Git 操作通常依赖外部命令或依赖复杂的上下文传递。dsh-git-plugin 插件将 Git 工作流集成到 DSH 会话中，通过 Web 面板和斜杠命令，提供查看仓库状态、分支管理、差异检查、提交以及恢复快照的能力。
核心能力¶
该插件通过 Web 面板和命令行接口，为用户和模型提供以下功能：
- Web Git 面板：在 Web 界面右侧侧边栏中，可以直接查看分支、文件状态、暂存与未暂存的差异以及提交历史。支持在面板中暂存文件、管理分支和暂存，每次写入操作都会打开预览并需要确认。
- 斜杠命令：支持通过命令行快速执行常用 Git 操作。
- 只读工具：模型可以使用
git-status、git-diff、git-log、git-show等工具来获取仓库信息。 - 暂存快照：通过
/undo命令创建、列出或恢复 stash 快照。 - 预提交检查：支持在提交前进行相关检查。
安装与启用¶
使用以下命令安装插件。请将 web 替换为你当前使用的 profile 名称。
dsh plugin --profile web add dsh-git-plugin@0.4.0
安装后，重启对应 profile 的 DSH 进程并刷新浏览器，即可在 Web 界面中使用 Git 面板。
使用方式¶
斜杠命令¶
| 命令 | 功能说明 |
|---|---|
/status |
查看当前分支和工作树状态 |
/diff |
查看暂存和未暂存的变更摘要 |
/branch [<name>] |
列出分支，或创建并切换新分支 |
/commit [<message>] |
显示提交引导或执行检查并提交 |
/undo [list\|pop] |
创建、列出或恢复暂存快照 |
模型工具¶
模型可以使用 git-status、git-diff、git-log、git-show 等只读工具来辅助决策。
操作范围与注意事项¶
- 提交范围：Web 面板中的提交操作仅使用暂存区的内容；而
/commit命令会在提交前暂存目标仓库中的所有更改。 - 撤销操作：
/undo命令会暂存工作区的更改，包括未跟踪的文件。它不会回退提交。使用pop恢复快照时可能会产生冲突。
环境要求与限制¶
- 系统依赖：需要 Node.js ≥ 20 和 Git ≥ 2.32。
- DSH 版本：已验证在 DSH 0.2.0-rc.2 上运行。
生态位置¶
该插件由社区用户 MashedPotato817 维护，遵循 MIT 许可证。DSH 生态强调“一切皆插件”，该插件旨在让智能体在会话中直接拥有对 Git 仓库的完整操作视图。
