前言¶
在 DeepSeek Harness(DSH)里让 Agent 改代码之后,你需要确认「这一轮到底动了哪些文件、每一行怎么变的」。DSH 自带的审查能力以 hunk 片段为主,适合快速扫一眼,但当你要对着完整文件逐行核对、在多个改动文件之间跳转时,体验会偏碎。
社区插件 dsh-review-panel(维护者 sadgsk,分类:客户端)把 Cursor 式的只读代码审查放进 DSH 官方右侧栏:完整源码、行级内联 diff、文件树与编辑器标签页,并复用常见的 VS Code 快捷键。下面介绍它解决什么问题、能做什么,以及如何安装启用。
这是什么¶
dsh-review-panel 是 DSH 的客户端插件(dsh.client.platform: web,注入会话 UI 与右侧栏)。它在右侧栏增加一个只读的「代码审查」页,用 Monaco 展示 Agent 本轮修改:新增行整行着色,删除行按原行号内联显示;配合文件树、多标签页和键盘导航,像在编辑器里 review,而不是只看零散 diff 块。
插件不写文件、不提交 Git、不静默安装依赖;需要改代码或执行操作时仍交给 DSH Agent。许可为 MIT。
与 DSH 自带审查的差异¶
| 维度 | DSH 自带审查 | dsh-review-panel |
|---|---|---|
| 展示粒度 | 以 hunk 片段为主 | 整个文件的完整源码 + 行级内联 diff |
| 工作区 | 相对轻量 | 文件树、标签页、Quick Open、工作区搜索等 |
| 导航 | 基础 | F12 定义跳转、Shift+F12 引用、悬停、大纲、只读诊断(依赖语言服务,缺失时降级) |
| 对比基线 | — | 三种:Agent 本轮 / Git 未提交 / 仅代码,可一键切换 |
Git 与语言服务器均为可选项;环境中没有时会自动降级,不阻塞打开审查面板。
核心功能¶
完整源码与行级内联 diff¶
在审查页查看整文件内容:新增行整行高亮,删除行内联保留原行号,便于对照上下文而不是只看 patch 摘要。
三种对比基线¶
可在界面中切换:
- Agent 本轮:相对 Agent 本轮开始前的基线
- Git 未提交:相对当前 Git 工作区未提交状态(需本机有 Git)
- 仅代码:不叠 diff,只看当前内容
VS Code 式工作区¶
- 文件树、编辑器标签页
- Quick Open(
Ctrl+P,被占用时Ctrl+Alt+P) - 命令面板(
Ctrl+Shift+P) - 工作区搜索(
Ctrl+Shift+F) - 自动跟随 DSH 明暗主题
语言服务导航(可选)¶
在只读前提下支持:跳转定义(F12 / Ctrl+单击)、查找引用(Shift+F12)、悬停提示、文档大纲(Ctrl+Shift+O)、只读诊断。具体能力取决于工作区语言服务器是否可用。
只读与安全边界¶
审查面板为只读;不修改磁盘文件、不执行 Git 提交、不后台安装组件。有写操作需求时应在 Agent 对话中完成。
环境与依赖¶
- DSH:需要 0.2.1-rc.2 或更高版本(README 徽章写 0.2.1+;Desktop 与 Web 均可)。
- Git:可选,用于「Git 未提交」基线。
- 语言服务器:可选,用于定义/引用/悬停等;缺失时相关能力降级。
插件当前包版本为 0.2.0(见仓库 package.json)。
安装与启用¶
安装方式来自官方 README:在 DSH 插件 UI 里粘贴仓库地址,不要自行拼接 CLI 安装命令。
- 在 DSH 左侧栏打开 插件,点右上角 添加插件。
- 在输入框粘贴仓库地址并点 安装:
https://github.com/sadgsk/dsh-review-panel
- 按提示重启 DSH。
- 在右侧栏点 +,选择 代码审查。
若「+」菜单里尚未出现入口,也可点击聊天输入框上方的 本轮修改 打开同一面板。
默认快捷键打开代码审查:Ctrl+Alt+D(macOS:Cmd+Option+D)。所有命令注册在 DSH 设置 → 通用 → 键盘快捷键,可按需改绑。
典型用法¶
- 让 Agent 完成一轮代码修改后,用
Ctrl+Alt+D或右侧栏 + → 代码审查 打开面板。 - 在文件树或
Ctrl+P中打开关心的文件,用F7/Shift+F7在改动处之间跳转。 - 需要对照未提交工作区时,将基线切到 Git 未提交;只想读当前文件内容时切到 仅代码。
- 确认无误后关闭面板,继续在对话里让 Agent 提交或做后续修改。
审查过程中可用 Ctrl+Tab 切换标签、Ctrl+Shift+E 显隐文件树、Ctrl+F 在编辑器内查找,习惯与 VS Code 相近(macOS 将 Ctrl 换为 Cmd)。
适用场景与注意¶
适合:
- 经常在 DSH 里跑 Agent 改多文件,需要整文件 + 行级 diff 做人工把关;
- 希望审查时保留文件树、多标签、快捷键导航,减少在 IDE 与 DSH 之间来回切换;
- 需要临时对比 Agent 本轮 与 Git 未提交 两种视角。
注意:
- 插件以当前 DSH 进程权限运行,安装前建议阅读 源码 与 MIT 许可,第三方组件见 THIRD_PARTY_NOTICES。
- 社区目录 skillhub.cn 为独立生态站点,与 DeepSeek / 幻方无官方从属关系;插件列表与星标等信息以各站点实时数据为准(GitHub 当前约 1 star)。
- 部分快捷键若与系统或其他应用冲突,会在设置中显示为未绑定,需自行改键。
问题与建议可通过 GitHub Issues 反馈。
结尾¶
dsh-review-panel 把 Cursor 式的只读审查搬进 DSH 右侧栏:完整源码、行级内联 diff、三种对比基线与 VS Code 式工作区,补足了「只看 hunk」之外的整文件 review 场景。安装只需在插件页粘贴仓库地址并重启,即可从右侧栏或「本轮修改」入口使用。