返回目录

dsh-edit-diff

精选清单收录维护状态: 活跃

better-er/dsh-edit-diff

「DSH·质量 diff」:接管 edit/write 及 extraTools 配置的其他工具卡片,行级去重与行内高亮,消除相同内容在删除与新增两区的重复;兼容 PTC 模式。

前往 GitHub
$ dsh plugin --profile web add github:better-er/dsh-edit-diff

14

星标

0

Fork

TypeScript

语言

MIT

许可证

2026-08-28

创建于

2026-11-14

最近推送

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/`。

安装步骤

  1. 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

  2. 02

    从 npm 装:执行 `dsh plugin --profile web add dsh-edit-diff`,包内已含 `lib/index.js` 与 `lib/client.js`,安装时不再构建。

    $ dsh plugin --profile web add dsh-edit-diff

  3. 03

    重启 DSH web:两种方式装完都会自动挂载,无需手工编辑任何文件。

验证接入成功

作者未说明

回滚

  • 执行 `dsh plugin --profile web remove dsh-edit-diff` 并重启 DSH web——README 说这样是彻底移除,重启后不再加载。

03DSH 适配与能力边界

DSH 适配原生运行时

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`

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`,否则读不到内容。
2026-08-282026-11-03v0.4.5

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 行还要再点一次才全量展开。

08数据与来源

  • 作者声明github.com96a431e6adf0…

    - 是**标准形态的 dsh client 插件**,声明 `dsh.client`,导出 `./client`。

  • 作者声明github.com96a431e6adf0…

    - **UI 挂载点**:接管 keyed 槽位 `tool.call.toolview` 的 `edit` 与 `write` 两个 key,以及 `extraTools` 里声明的每个工具名。

  • 作者声明github.com96a431e6adf0…

    接管 DSH 浏览器的 `edit` / `write` 工具卡片,用近线性行级 diff 做真正的差异展示,消除内置 DiffBlock 把「未变化的相同行」在删除区红 `-` 行和新增区绿 `+` 行各渲染一遍的重复。

  • 作者声明github.com96a431e6adf0…

    dsh plugin --profile web add github:better-er/dsh-edit-diff

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-16。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。