MIT 许可的 TypeScript DSH 客户端插件:把 `edit` / `write` 的内置卡片换成只显示真实变化行的行级 diff,带行内字符高亮、长 diff 二次折叠,并通过 `extraTools` 接管远程 edit/write 工具。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-16
许可证
MIT
01它能帮你完成什么?
在 DSH 会话里看 `edit` / `write` 的结果时,只看到真正改掉的行,而不是永远对不上的红区和绿区
完全相同的行一律不渲染:改一行就只有一行红 `-` 加一行绿 `+`,被改的字符在行内加下划线标出
在浏览器里逐条复查 DSH 文件改动的人,尤其是被内置 DiffBlock 在删除区和新增区各画一遍上下文行拖慢的人
PTC 模式下 `edit` / `write` 作为 `run_code` 子调用跑时,同样能看到改了什么
子调用里渲染同一套优化 diff,靠 `callId` 中的 `:code:` 标记识别
把文件改动放进 `run_code` 子调用执行的人——默认卡片只报调用成功与否
让远程 edit/write 工具也用上同一套显示,不必再写第二个插件
`edit_remote` 与 `write_remote` 在插件自带的 `cordis.patch.yml` 里默认已接管,其他工具写进 `extraTools` 即可
通过 dsh-remote-file-system 而不是内置工具写文件的场景
02如何接入 DeepSeek Harness?
前置条件
- 安装命令按 `web` profile 书写(`--profile web`);插件同时声明了 `dsh.bundle`,装到哪个 profile 就会被自动识别为 profile layer 并挂载,无需手写组合 entry。
- 装完需要重启 DSH web——README 说两种方式都自动挂载,重启后启用,不用手工编辑任何文件。
- 从 GitHub 安装时 npm 需要跑 `prepare` 脚本现场构建,因为仓库里不含 `lib/`。
安装步骤
- 01
从 GitHub 装:执行 `dsh plugin --profile web add github:better-er/dsh-edit-diff`,安装时 npm 会触发 `prepare` 脚本现场构建 `lib/`。
$ dsh plugin --profile web add github:better-er/dsh-edit-diff
- 02
从 npm 装:执行 `dsh plugin --profile web add dsh-edit-diff`,包内已含 `lib/index.js` 与 `lib/client.js`,安装时不再构建。
$ dsh plugin --profile web add dsh-edit-diff
- 03
重启 DSH web:两种方式装完都会自动挂载,无需手工编辑任何文件。
验证接入成功
作者未说明
回滚
- 执行 `dsh plugin --profile web remove dsh-edit-diff` 并重启 DSH web——README 说这样是彻底移除,重启后不再加载。
03DSH 适配与能力边界
DSH 客户端插件 —— 声明 `dsh.client` 并导出 `./client`,在 keyed 槽位 `tool.call.toolview` 上注册 `edit` / `write` 两个 key 以及 `extraTools` 里声明的每个工具名,以 `priority: -1` 遮蔽内置的 `file-mutation-toolview`;安装命令为 `dsh plugin --profile web add github:better-er/dsh-edit-diff`
只渲染变化的行,行内标出改动的字符
近线性 diff 算法
超大文件的差异会退化成粗粒度的整块显示,不再是精细 diff默认收起、长 diff 二次折叠、复制与统计
卡片默认只有一行摘要,点开才显示 diff 体差异行超过 14 行时,中间部分要先再点一次才全量展开复制出来的内容只含差异行,每行带 `- ` 或 `+ ` 前缀对齐原生观感,单文件与多文件都覆盖
接管 `edit` / `write` 之外的写工具
按 `write` 型渲染的工具调用只能显示全新增行,因为整文件覆写没有旧内容可比以更低优先级遮蔽内置渲染,配置实时下发
settings 变化会让浏览器端重建这批 key 的注册
04适合谁?何时不该用?
适合
- 在浏览器里逐条复查 DSH 文件改动的人,尤其是被内置 DiffBlock 在删除区和新增区各画一遍上下文行拖慢的人
- 把文件改动放进 `run_code` 子调用执行的人——默认卡片只报调用成功与否
- 通过 dsh-remote-file-system 而不是内置工具写文件的场景
不适合
- `write` 是全文件覆写、没有旧内容,卡片只能显示全新增的绿行;需要精确到字符的 diff 应该用 `edit`。
05兼容性、维护与安全提示
- 渲染全在浏览器端:主机端半身只把配置转成 `dsh-edit-diff` settings 命名空间,插件以更低优先级遮蔽内置渲染,不改动 DSH 源码。
- `write` 是全文件覆写、没有旧内容,卡片只能显示全新增的绿行;需要精确到字符的 diff 应该用 `edit`。
- 有两道明确的渲染上限:一行的改动区超过 512 字符时不再逐字符对齐,行级差异超过 600 行时退化为整块删除加新增。
- `extraTools` 里的参数名省略时按 `file_path` / `old_string` / `new_string` / `content` 取值;参数名不同的工具必须逐项补 `pathKey` / `oldKey` / `newKey` / `contentKey`,否则读不到内容。
MIT · 最新版本 v0.4.5(2026-11-14T11:26:34Z)· DSH web 客户端插件,不改 DSH 源码
06常见问题
怎么把 dsh-edit-diff 装进 DeepSeek Harness?
在 DSH 里执行 `dsh plugin --profile web add github:better-er/dsh-edit-diff` 从 GitHub 安装,npm 会跑 `prepare` 脚本现场构建 `lib/`;也可以执行 `dsh plugin --profile web add dsh-edit-diff` 装 npm 包,包内已含构建产物 `lib/index.js` 与 `lib/client.js`。两种方式装完都会自动挂载,重启 DSH web 后启用。
它会改动 DSH 源码或内置渲染器吗?
不会。它是标准形态的 DSH 客户端插件,声明 `dsh.client` 并导出 `./client`,在 keyed 槽位 `tool.call.toolview` 上以 `priority: -1` 注册,用更低优先级遮蔽内置的 `file-mutation-toolview`,而不是在同一优先级上冲突。渲染全在浏览器端,主机端半身只把配置转成 `dsh-edit-diff` settings 命名空间。
自己的远程 edit/write 工具也能用这套显示吗?
可以,把它们写进 `extraTools`:给工具名,参数名不同再补 `pathKey` / `oldKey` / `newKey` / `contentKey`,省略时按 `file_path`、`old_string`、`new_string`、`content` 取值。插件自带的 `cordis.patch.yml` 已经默认接管 dsh-remote-file-system 的 `edit_remote` 与 `write_remote`,要改这份默认就在 profile 的 `cordis.patch.yml` 里按 id 覆盖。
为什么 `write` 的卡片只有绿色新增行?
`write` 是全文件覆写,没有旧内容可比对,只能把新文件整体显示成新增行;想要精确 diff 请用 `edit`。PTC 模式下通过 `callId` 中的 `:code:` 标记识别 `run_code` 子调用,子调用里的 `edit` / `write` 也会走这套优化显示。
多大的 diff 还能正常渲染?
算法先做公共前缀/后缀收缩,只对中间的小差异带跑 Myers diff,复杂度与差异量成正比。超过阈值就换成粗粒度显示:单行改动区超过 512 字符不再逐字符对齐,行级差异超过 600 行退化为整块删除加新增。卡片默认收起,差异行超过 14 行还要再点一次才全量展开。
07相关的 DSH 工作流
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 插件,高性能低占用,可爱像素鲸鱼,流畅鼠标交互,npm 一键安装
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座,支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒体工作台插件:一句话记灵感,一键生成脚本、封面、配图和分镜
dsh-drawai
作者 fourzkw
DSH 右侧栏里的可编辑画布 —— 加上让模型直接改图的两个工具
08数据与来源
- 是**标准形态的 dsh client 插件**,声明 `dsh.client`,导出 `./client`。
- **UI 挂载点**:接管 keyed 槽位 `tool.call.toolview` 的 `edit` 与 `write` 两个 key,以及 `extraTools` 里声明的每个工具名。
接管 DSH 浏览器的 `edit` / `write` 工具卡片,用近线性行级 diff 做真正的差异展示,消除内置 DiffBlock 把「未变化的相同行」在删除区红 `-` 行和新增区绿 `+` 行各渲染一遍的重复。
dsh plugin --profile web add github:better-er/dsh-edit-diff
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-16。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
