dsh-edit-diff 0.2.0 → 0.3.0

package/README.md

@@ -1,4 +1,4 @@
-# dsh·去重复 diff 展示插件
+# dsh·修改显示优化插件
 
 接管 DSH 浏览器的 `edit` / `write` 工具卡片，用近线性行级 diff 做真正的差异展示，消除内置 DiffBlock 把「未变化的相同行」在删除区红 `-` 行和新增区绿 `+` 行各渲染一遍的重复。
 
@@ -6,13 +6,11 @@
 
 ## 引言
 
-DeepSeek Harness 内置的 DiffBlock 展示工具改动时有个毛病：它拿到旧文件全文和新文件全文，就把旧的全染成红色 `-` 行、新的全染成绿色 `+` 行——**完全不做行级匹配**。
+原版 diff 的显示相当离谱：一次只修改一行，它却把这行连同上下各三行一起带进 diff，共十四行，其中七行被折叠，正好红区和绿区完全不重叠。不点开二级展开根本看不出到底改了什么——点开了也照样看花眼。
 
-结果呢？一次只改了一小段的 edit，一堆根本没变的注释、空行、样板代码，在红绿两区各出现一遍，仿佛同一句话被说了两次。大文件改起来更是重复加刷屏，想扫一眼真正改了什么，得靠肉眼在一大摊重复里找不同。
+这个插件把无关的相同行全部去除。只修改一行时，就只显示一行红一行绿，真正的修改加粗划线，一眼就能看清改在哪里。
 
-这哪行。改个文件就该像看 git diff 一样：**只亮出真正的差异，相同行不该凑热闹**。
-
-于是这个插件接管了 `edit` 和 `write` 两个工具卡片，用近线性算法算出真实差异，相同行一行不渲染，替换行还把改动到的具体字符用下划线标出来。一眼就知道到底改了什么。
+另外，PTC 模式下默认只显示调用成功与否，本插件也做了适配，能正常显示修改内容。
 
 ## 功能
 
@@ -24,28 +22,38 @@ DeepSeek Harness 内置的 DiffBlock 展示工具改动时有个毛病：它拿
 - **对齐原生观感**：字号、圆角、配色复用内置 DiffBlock/ToolRow 同一批 `--dsw-*` 主题变量，视觉上就是原生卡片。
 - **复制与统计**：复制只含差异行，`- `/`+ ` 前缀；底部 `└ +A -R · N file(s)` 变更统计。
 - **单文件与多文件**：`edit` / `write` 双双接管，覆盖新建只显示绿色新增，纯删、多 hunk 等场景。
-- **PTC 模式兼容**：`run_code` 子调用中的 `edit` / `write` 同样显示去重 diff，通过 `callId` 中的 `:code:` 标记识别子调用。注意 `write` 是全文件覆写，无旧内容，只能显示全新增；想看精确 diff 应使用 `edit`。
+- **PTC 模式兼容**：`run_code` 子调用中的 `edit` / `write` 同样显示优化后的修改 diff，通过 `callId` 中的 `:code:` 标记识别子调用。注意 `write` 是全文件覆写，无旧内容，只能显示全新增；想看精确 diff 应使用 `edit`。
 
 ## 它长什么样
 
-`edit` 只改动一小段后的实际效果：
+|  | 效果图 |
+| --- | --- |
+| 原版 diff | ![原版离谱显示](docs/原版diff.webp) |
+| 本插件 | ![插件优化显示](docs/优化diff.webp) |
+
+## 演示视频
 
-![去重复 diff 效果](docs/去重复diff.webp)
+光看静态截图不过瘾？看看这个插件的实际演示效果：
 
-- **顶部行**：`✎ Edit · dsh-cache-billing\src\client.ts`，右侧 chevron 可点开收起。
-- **diff 体**：只显示真实变化的删除行红色 `-` 与新增行绿色 `+`，完全相同行不重复渲染。
-- **行内高亮**：把 `峰谷价标注` 改成 `峰谷价标注附模型名`，改动到的字符 `附模型名` 以下划线加粗标出；右下角为复制按钮。
-- **底部统计**：`└ +1 -1 · 1 file`，列明净增删行数与文件数。
+| dsh-edit-diff 插件演示 · 66 秒 |
+| :---: |
+| [![dsh-edit-diff 插件演示](https://i2.hdslb.com/bfs/archive/dd90d9de85da22eae537d53dd77a2034bf841b5e.jpg)](https://www.bilibili.com/video/BV1ect76CENM/) |
 
 ## 安装
 
+**从 GitHub 安装**：源码在 `src/`，`lib/` 不入仓库，安装时 npm 会触发 `prepare` 脚本现场构建。
+
 ```powershell
 dsh plugin --profile web add github:better-er/dsh-edit-diff
 ```
 
-或安装 npm 发布的版本：`dsh plugin --profile web add dsh-edit-diff`。
+**从 npm 安装**：包内已含构建产物 `lib/index.js` 与 `lib/client.js`，安装时不再构建。
+
+```powershell
+dsh plugin --profile web add dsh-edit-diff
+```
 
-一条命令装完即生效，自动挂载，重启 DSH web 后启用，无需手工编辑任何组合文件。
+两种方式装完都会自动挂载，重启 DSH web 后启用，无需手工编辑任何文件。
 
 ## 卸载
 
@@ -63,9 +71,19 @@ dsh plugin --profile web remove dsh-edit-diff
 - **UI 挂载点**：接管 keyed 槽位 `tool.call.toolview` 的 `edit` 与 `write` 两个 key。
 - **遮蔽而非冲突**：注册时显式传 `priority: -1`低于内置 `file-mutation-toolview` 的默认 0，用更低优先级遮蔽默认渲染，而不是在同一优先级上 clash。
 - **PTC 模式**：通过 `callId` 包含 `:code:` 判断是否为 `run_code` 子调用，从 `argsRaw` 中提取 `old_string`/`new_string` 即 edit 或 `content` 即 write 动态构建 diff。
-- **无构建**：`lib/client.js` 是按 DSH client bundle 产出的注册式模块，源码即产物，改完即用。
-- 纯 JavaScript 单文件，不引入任何额外 npm 依赖diff 算法就地内联。
+- **构建型**：TypeScript 源码位于 `src/`，`pnpm build` 通过 tsdown 生成 `lib/index.js`、`lib/index.d.ts`、`lib/client.js` 与 sourcemap，运行时只加载 `lib/` 发布产物。
+- 无运行时 npm 依赖，diff 算法就地内联；浏览器端只向宿主模块表请求 react。
+
+本地开发：
+
+```powershell
+pnpm install
+pnpm typecheck
+pnpm build
+```
+
+改完源码需重新 `pnpm build`，DSH web 的 HMR 观察到 `lib/client.js` 变化后自动重载。
 
 ## License
 
-[MIT](./LICENSE)
+[MIT](./LICENSE)