dsh-diff-approval

English | 中文

一个 DeepSeek Harness（DSH）待处理改动审核插件：自动跟踪每次成功的 edit / write / 编辑器（str_replace_editor）改动，在侧边栏整合为一个待处理列表，可逐个文件查看完整差异并保留 / 回退，也可以把工作区里版本控制仓库的本地改动一键导入（Git / SVN / Perforce）。

面板还可把文件列表折叠成浮动卡片；浮窗形态下可以逐边选择覆盖左侧边栏、上方标题栏、右侧边栏与下方输入框（四边全开就是原来的全屏，全关则是一张普通浮窗卡片），也可以停靠到右侧边栏、成为其中一个标签页：

打开它的入口有两个：左侧边栏底部那一行，以及会话标题行右侧的按钮簇——也就是 App 放自己会话级操作的地方（「下载 Session 日志」就在那里），所以左侧边栏折叠或隐藏时也能一键叫出审核面板。

| 折叠的文件列表 | 覆盖全部 | | --- | --- | | | |

对 Markdown 文件，还可把源码行差异切换为渲染后的「改前 / 改后」预览：

✨ 功能

• 差异视图：语法高亮整文件差异与 +/− 统计，滚动条上有概览标尺标示改动位置，支持文件内搜索（Ctrl+F，用 F3 / Shift+F3 步进，并高亮匹配词）。列表按视口虚拟化渲染，大文件也能保持流畅。
• 差异块导航与操作：用 Ctrl+↑/↓（或上一处 / 下一处按钮）在差异块间跳转，当前块会高亮闪烁，导航以当前滚动位置为锚点并在首尾循环。悬停某一块可从小操作框单独保留 / 回退该块，并显示其位置（如「2/5」）；处理完一块后会自动跳到下一块。跳转目标上方保留的行数可在设置中配置。
• 选区操作框：拖动选中一段行，会浮现保留 / 回退该段行的操作框。
• 整文件与批量操作：文件列表里的文件可逐个保留 / 回退，也可在列表底部全部保留 / 全部回退。
• 已处理文件保留在列表：某文件的改动全部处理完后，条目仍保留在列表中，面板会询问是移除还是继续保留。
• 撤销 / 重做：每次保留、回退、导入都可以用 Ctrl+Z / Ctrl+Shift+Z 撤销 / 重做（可在「快捷键」中重绑，Ctrl+Y 仍作为别名），面板打开期间全局生效，输入框保留各自的编辑行为。
• 快速呼出与文件切换：Ctrl+D（可在设置中修改）在任意位置开关面板，Esc 关闭；左侧栏底部那行、以及会话标题行里 App 自身操作旁的按钮，也都是一键入口；Ctrl+Tab / Ctrl+Shift+Tab 在待处理文件间切换。
• 行引用：选中 diff 文本后，底部状态栏显示其 (文件:行号) / (文件:起-止) 引用——点击（或按 Ctrl+L）即可复制，开启设置后还会自动粘贴到消息输入框并获得焦点。消息输入框和排队消息里的引用会随文件改动自动对齐：存活的行映射到新行号，整段被删的行变成 (文件:LINE_MISSING)。
• 高亮语言：默认按扩展名自动检测，也可通过下拉列表手动切换。
• 自动换行：语言下拉旁有个「Wrap lines / 自动换行」开关，按语言记住；CJK 逐字断行、拉丁词保持完整。
• 双栏对比：可选的双栏视图（左「改前」｜右「当前」），逐行对齐，两侧各自横向滚动、共享纵向滚动条。可在工具栏或设置中切换，默认是单栏（合并）视图。双栏视图按内容相似度对齐改动块，并对改动行做词级差异高亮——拉丁文字按整词、CJK 逐字。
• Markdown 预览：对 Markdown 文件可在「源码」行差异与渲染后的「改前 / 改后」预览之间切换。预览内容最大宽度可配置。
• 外观自定义：在「差异视图」设置组里可调整差异代码字号（%）、行高（px）以及新增 / 删除行颜色，并带实时预览。
• 外部改动：已纳入列表的文件若之后被外部修改（其它工具 / 编辑器），面板会跟进最新内容并标记分歧。
• 打开 / 定位：查看某个文件的差异时，可一键在默认应用中打开它，或在系统文件管理器中定位它。
• 导入工作区改动：列表为空时，点击按钮即可导入工作区里 Git / SVN / Perforce 的本地改动——已修改、已删除，以及（可选开启的）未跟踪文件。通过从工作区目录逐级向上查找 VCS 根目录，工作区在子目录里也能识别。
• 设置：在 DeepSeek Harness 设置里新增「改动审批」页，分为「差异视图」（代码字号、行高、新增 / 删除颜色）、「快捷键」（重绑面板各类按键组合）与「浮窗覆盖」（面板自身弹出菜单里的那四个边的开关）三组，另有复制后自动粘贴、导入时是否包含未跟踪文件、diff 的 Tab 宽度（2 / 4 / 8 空格）、双栏对比开关、差异跳转行距、Markdown 预览默认与宽度，以及快速呼出快捷键。
• 持久化：待处理状态按 workspace 落盘至 <dshHome>/diff-approval/workspaces/<workspaceId>.json，跨重启保留——回来时未处理的改动仍在，即便换了新会话。

📦 安装

若 dsh 已在 PATH 中：

dsh plugin --profile web add dsh-diff-approval

若通过 npx 启动 harness（如 npx @deepseek-ai/dsh web）：

npx @deepseek-ai/dsh plugin --profile web add dsh-diff-approval

或手动：把本包加入 profile 的 package.json 依赖，并在该 profile 的 cordis.patch.yml 中加入：

- insert:
    - id: diff-approval
      name: dsh-diff-approval
      # 可选：把落盘位置迁到别处（默认是
      # <dshHome>/diff-approval/workspaces）。
      # config:
      #   storageDir: ~/dsh-pending

然后重启 dsh web。

🚀 用法

1. 照常和智能体对话——成功的 edit / write / 编辑器（str_replace_editor）调用会自动记录。
2. 点击侧边栏底部的 待处理改动 入口，逐文件查看差异并 保留 / 回退。
3. 列表为空时，点 导入工作区改动，把工作区的 Git / SVN / Perforce 本地改动拉入。

📝 注意事项

• 只自动记录被跟踪的改动（edit、write 与编辑器 str_replace_editor 调用）。通过以上工具以外的删除（如 shell rm）只能对已跟踪的文件感知：条目显示"文件已不存在"，回退即恢复。
• VCS 导入通过部署环境的 shell 执行器运行只读的 Git / SVN / Perforce 命令，需要对应 CLI 在 PATH 中。导入未跟踪文件（默认关闭）会扫描整个工作区，目录很大时可能较慢。
• 新建文件的整文件回退操作显示为删除并移除该文件。
• 回退文件时会保留其当前换行符（LF / CRLF）。
• 没有 workspace 的会话条目仅存内存；损坏的落盘文件会被拒绝，删除即可重置。
• 侧边栏底部入口会与其他插件的入口纵向排列，并在存在专门的 dsh-footer-order 插件时交由它统一管理。

🛠 开发

corepack pnpm install
pnpm run typecheck   # 两个编译面的 tsc
pnpm run build       # 产出 lib/index.js 与 lib/client.js
pnpm test
pnpm run fonts:check # 内置代码字体：138 个切片，每个码位恰好被覆盖一次
pnpm run fonts:plan  # 页面上出现多少汉字时实际会下载多少

内置字体是 JetBrains Maple Mono（SIL OFL 1.1），由 scripts/fonts 子集化并切片——流水线、许可证与各切片的体积见 assets/fonts/README.md。

file: 方式安装的 profile 只复制安装当时 files 列出的文件，所以本地 checkout 后来新增的文件（如 assets/fonts）必须先刷新安装，宿主才拿得到：

npx @deepseek-ai/dsh plugin --profile web install   # 然后重启 `dsh web`

客户端那半会自己热更新（它的 bundle 被监听），所以客户端改动刷新页面即可；宿主那半的改动（例如提供字体的这条路由）要等重启才生效。