joao-paulo-santos/dsh-approval-diff

dsh-approval-diff

一个 DeepSeek Harness（DSH）
插件：将它与你自己的插件一起安装到某个 profile 中。

看清你所批准的内容。 当模型请求修改文件的权限时，
原生卡片会显示工具参数：old_string 和 new_string 以原始
文本呈现，没有文件上下文，没有行号。本插件将这一询问替换为
真正的 diff 审查：红绿两色行并排显示，变更行内提供词级高亮，
周围文件内容带有真实行号，并且只有两个按钮。

插件价值主张

| 替代方案 | 不足之处 |
|---|---|
| 原生批准卡片 | 原始工具参数；每次询问你都要在脑中重建 diff |
| 自己阅读文件 | 你成了 diff 引擎，而模型已经读过一次了 |
| 自动批准并祈祷 | 完全没有审查 |

你将获得

- 待处理的 edit 在原生批准卡片内部渲染为真正的 diff，
通过卡片自身的 conversation.approval.detail 席位实现：以磁盘为
锚点的行号、变更周围的上下文窗口，以及词级
高亮（通过 dsh-diff-view）
- 拆分或统一视图（GitHub 风格切换，选择会被记住）；拆分
视图将删除项配对在左、新增项配对在右，统一视图将每个变更块
分组为先是所有删除行、然后是所有新增行
- write 将新内容显示为新增，若当前文件存在则与之合并；
删除命令（rm 及类似命令）渲染一条审查提示，
以便在允许之前阅读命令文本
- diff 锚定到询问时从本包宿主路由获取的磁盘真实内容；
当文件无法读取时，操作数仍会渲染为对齐的 diff，行号留空，
绝不显示虚假行号
- 陈旧操作数警告：当编辑的旧文本已不在文件中时，
卡片会明确说明，而不是显示一个无法应用的 diff
- 武装（ARMING）：“自动允许对此文件的编辑”会应答当前请求以及
本会话中之后所有针对同一文件的请求（仅允许一次，绝不扩大范围），
并带有可见的已武装状态和一键解除武装
- 排队的同文件编辑合并为一次审查：模型已发出的、针对同一文件的
每个待处理（未结算）编辑都会加入一次合并审查。
卡片显示“已合并 N 处编辑”，网格将所有变更与磁盘副本合并渲染
（顺序锚点），原生卡片的应答适用于整个组。之后针对同一文件的
询问会自动以用户已经看到的结果应答
- 决策本身仍由原生卡片自己的按钮完成（组决策自动化的是
那个确切的应答，绝不扩大范围）

如何安装

需要一个 DeepSeek Harness 检出目录和一个 profile，这里以 web 为例。
将插件克隆到某个 plugins 文件夹中：

mkdir -p ~/dsh-plugins && cd ~/dsh-plugins
git clone https://github.com/joao-paulo-santos/dsh-approval-diff.git

从 harness 检出目录
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-approval-diff

验证 profile 仍能正常组合
pnpm dsh --profile web --dump-config

安装后重启 harness：宿主部分在启动时加载。客户端部分安装后会热重载。

限制

- 仅限更改文件的审批（edit、write、仅删除的 bash）。
其他所有内容不渲染任何细节，并保持完全原生。
- 删除审查显示命令文本，而非被删除的内容。
- 需要 dsh 0.1.2+（待处理交互审批模型）。v0.20 的
composer 接管及其每卡片按钮已弃用：原生卡片拥有外壳和按钮。审批一次到达一个（会话在内部将它们排队）；arming 取代了旧的批量决策
工作流，用于对同一文件的重复编辑。

依赖

- dsh-diff-view 拥有此插件用于渲染其审查卡片的 diff 引擎和样式表（必需；没有它插件不会激活）

依赖此插件的插件

（暂无）