dsh-review-checkout

DeepSeek Harness（DSH）的会话文件修改审查插件：把每一轮 write / edit 的结果变成一张像官方卡片一样的「已编辑」卡片，配一个能定位到行、能按轮撤回的审查视图。

起点是 cirelir/dsh-change-review，本仓库是其加固 + 与官方 UI 对齐后的重构版，Web（dsh web）与 Desktop 均可用。

亮点

• 每轮一张「已编辑」卡片 —— 与官方 dsh-client-ui-deliverables 的卡片同款皮肤（同 token、同 16px 圆角、同图标块、同折叠行），但自带 撤销 / 审核 两个官方没有的动作；默认接管官方那张卡片，避免一轮出现两张。
• 审查 tab —— 按轮查看：左文件列表 + 右 diff（分割线可拖动改宽度，双击复位），或「列表」模式每文件一张可展开卡片；语法高亮、真实行号、每文件 +N −M、单文件 还原。
• 三级打开链 —— ① 你选的编辑器（定位到行）→ ② 系统默认应用（与官方卡片同一条路）→ ③ 右侧内置预览；每一级失败都会说明原因，不会静默。
• 运行中小胶囊 —— 输入框上方 N 个文件已更改 ＋X −X，与卡片同一套主题样式。
• 主题跟随 —— 卡片、胶囊、图标全部使用 DSH 主题 token，深浅自动切换；只有 diff 配色保留插件自己的两套预设。

安装

dsh plugin add dsh-review-checkout          # 或从 DSH 插件市场安装

确认 profile 注册了 bundle patch（~/.dsh/profiles/<profile>/cordis.patch.yml）：

- insert:
    - id: diff-review
      name: 'dsh-review-checkout'

Host 端（lib/index.js）改动需重启 dsh web / Desktop；纯客户端（lib/client.js）改动刷新页面即可。

功能

每轮卡片（对话流）

审查 tab（会话视图）

• 范围：任意一轮 / 「全部修改」（会话累计）。
• 双视图：左侧文件列表 + 右侧该文件 diff；中间分割线可左右拖动调整比例，双击恢复响应式默认宽度（左栏最小 140px、diff 至少 260px），宽度写入 localStorage；面板过窄（<520px）时自动只留 diff。
• 列表模式：每文件一张可展开卡片，同时只展开一个，文件标题吸顶。
• diff：按扩展名高亮 JS/TS/JSON/CSS/C++/C#/Java/Go/Rust/Python/YAML/Shell/CMake 等；行号是从改动前的快照恢复出来的真实文件行号（无法恢复时标注为相对行号），每行左侧有「在编辑器中打开该行」按钮。
• 工具条：轮次选择、双视图/列表切换、＋N －M · N 文件、编辑器选择器（原「刷新 / 清空」位置：刷新已由 5s 轮询承担，清空移到设置页）。
• 文件类型图标：直接复用官方 @deepseek-ai/dsh-client-ui-primitives 的 FileTypeIcon（代码文件是彩色品牌图标，其它按分类着色）；该模块缺失时回退为字母角标。

打开文件：三级链路

• 编辑器选择器的图标取自宿主图标路由 /open-in-app/icon/<id>，与官方「打开方式」菜单用的是同一枚真实应用图标（未收录的编辑器回退字母块）。
• 检测范围（Windows）：VS Code / VS Code Insiders / Cursor / Windsurf / VSCodium / Sublime Text / Notepad++ / IntelliJ IDEA / PyCharm / WebStorm；判据是 PATH 上的命令或已知安装路径存在。
• 探测只跑一次：结果按会话缓存 10 分钟，进入审查 tab 不会重复探测；装了新编辑器可在下拉里点「重新检测编辑器」。

运行中小胶囊

会话进行中显示在输入框上方（conversation.composer.dock）：N 个文件已更改 ＋X −X，与每轮卡片同一套 token；空闲自动隐藏；窄行下不会把自己压成竖排（flex:none + nowrap）。

设置 → 修改审查

• diff 与角标颜色：深浅两套预设（各 8 色）+ 一键预设，localStorage 持久化。
• 「隐藏官方『已编辑 N 个文件』卡片」开关（默认开）。
• 「清空本会话的修改记录」按钮（原来在审查工具条上的 ✕）。

工作原理

tools/result 事件 ──► lib/index.js（Host）
      │                  记录 write/edit 的 op（含改动前后快照，单条上限 120k 字符、每文件 100 条）
      │                  按 root session 聚合（子代理的改动折进父会话）
      │                  原子写 ~/.dsh/profiles/<profile>/diff-review-state.json
      ▼
session/follow + session/page（官方 RPC；Desktop 走 IPC 桥）
      ▼
lib/client.js（客户端）──► 每 5s 轮询重建 ──► 卡片 / 审查 tab / 小胶囊
                            本地转录解析作为兜底（宿主无数据或旧宿主）

• 不建自建 HTTP 路由，不做跨 fiber RPC 拦截：只用官方 slot 注册 + 官方历史通道。
• 路径围栏：open-with-editor / reveal 只接受本会话记录过的文件树内的绝对路径。
• 诊断日志：~/.dsh/profiles/<profile>/diff-review-debug.log（记录打开动作的 editor spawned pid=… / editor exited code=…、路径围栏拒绝、revert 调用等）。

撤回

• 工具 diff_review_revert(path, op?) 注册在官方基础层工具注册表（@deepseek-ai/dsh-tools），Web 与 Desktop 都能用；op 省略时撤回该文件的全部记录。
• 卡片上的 撤销 会按轮生成倒序的调用序列（最后一个操作先撤），填进输入框由你确认发送——插件不替模型执行工具调用。
• 审查视图详情头部还有一个单文件 还原 按钮。

兼容性

开发

npm test                 # 78 条测试（node:test，含 host 与客户端冒烟）
npm run sync             # 把 lib/*.js 与 package.json 复制进实际被加载的 profile 副本

npm run sync 存在的理由：仓库里的改动不会自动生效——dsh web 加载的是 ~/.dsh/profiles/<profile>/node_modules/dsh-review-checkout 下的副本，忘了同步就会得到"改了但没变"的假象。同步后：host 改动重启、客户端改动刷新。

目录：

lib/index.js            Host 插件（记录、持久化、RPC 端点、revert 工具）
lib/client.js           客户端 bundle（单文件，DSH client-modules 加载）
scripts/sync-profile.mjs  同步到 profile 副本
test/smoke.test.js      测试

已知限制

• 交付文件（present）不在本插件范围内：官方 deliverables 的交付卡片保留原样，本插件只统计 write / edit 的 op。
• 官方右侧栏的「第 N 轮改动」审查视图与本插件的审查 tab 并存，两者入口与定位不同（右侧栏便于边看边改，插件的 tab 是全宽专注视图）。
• 撤销 依赖宿主能启动编辑器/填写输入框；宿主不支持 inputActions.setDraft 时会退化为写入剪贴板。

致谢

灵感与早期实现来自 cirelir/dsh-change-review；文件类型图标与「打开方式」图标分别复用了 DSH 官方 ui-primitives 与 host-open-in-app 的资源。

License

MIT