前言¶
在 DeepSeek Harness (DSH) 中,智能体对工作区文件进行修改后,查看变更并直接执行 git 操作通常需要切换到外部终端。dsh-git-review 作为一个客户端插件,在会话视图中注册了一个 Review tab,提供了一个 fenced git workbench。它将文件树、差异视图和提交图与受保护的 git 操作整合在同一界面中,方便查看决策依据并进行操作。
核心功能¶
Review tab 与差异查看¶
插件注册了 Review tab,用于显示工作区仓库与 HEAD 的对比。支持可过滤的文件树,并在文件和状态上显示徽章。差异视图支持并排、统一和全文件模式,提供代码折叠、单词级高亮和语法高亮。支持在文件名、差异文本和文件内容中进行搜索。支持基于键盘的操作:使用 j/k 在文件间移动,/ 聚焦搜索。
提交图视图¶
提供提交图视图,可以查看按提交的文件和差异,显示错行 gutter,并支持按文件历史查看。允许从历史记录中读取任何文件版本。
受保护的 Git 操作¶
针对危险操作提供保护机制。支持暂存、取消暂存和丢弃文件/块,提交、提交并推送、推送。支持分支管理操作:创建、切换、重命名、删除、合并、跟踪远程,以及 fetch/pull。支持历史操作:重置、变基、变更为、cherry-pick。支持轻量级标签(创建、删除、推送)和 stash。支持合并冲突解决。
注释与预览¶
支持在 diff 的任意行添加注释,并将其放入编辑器草稿中。支持文件预览,包括 Markdown、HTML、PDF。支持图片差异查看,提供 2-up、onion skin 和 difference blend 模式。
设置与同步¶
插件支持设置同步。
安装与启用¶
安装插件:
dsh plugin --profile web add dsh-git-review
安装后需要重启或刷新 DSH 进程以生效。
使用场景与限制¶
适用环境¶
需要 DeepSeek Harness 版本在 0.1.2-rc.1 到 0.2.0-rc.1 之间。需要在主机 PATH 环境中安装 git。如果在非 git 仓库目录下打开,插件会提供文件浏览功能,并支持一键 git init。
安全与锁定¶
危险操作需要显式确认,破坏性操作需要双重确认。代理运行时会对操作进行锁定。
性能限制¶
插件在客户端运行,存在以下限制:
* 单文件差异行数限制为 20k 行。
* 单文件差异大小限制为 2MB。
* 提交图页面加载限制为 500 次。
* 流式字节传输限制为 8MB。
总结¶
dsh-git-review 为 DSH 提供了一个集成的代码审查和 Git 工作台。它通过 Review tab 将变更展示、提交图和历史查看与受保护的 Git 操作结合,适合需要在 DSH 界面内直接管理 Git 状态和审查代码变更的场景。
- 插件目录:https://www.skillhub.cn/plugins/HaoyueQin/dsh-git-review
- GitHub 仓库:https://github.com/HaoyueQin/dsh-git-review