前言¶

在使用 DeepSeek Harness（DSH）与智能体协作时，Agent 每一轮输出往往包含多个文件的修改。当前 DSH 的内置 ui-deliverables 只提供改动卡片概览，缺少行级差异对比和撤销能力。dsh-file-review-tab 将 left0ver/dsh-file-review 的「改动审查」能力移植到 dsh-better-sidebar 的侧边栏 Tab，并在对话尾部复刻内置卡片的外观，提供行级红绿 diff、撤销/重新应用、深链跳转等能力。

插件定位¶

whybebabo/dsh-file-review-tab 是一个客户端插件，将文件改动审查能力扩展为两个入口：

• 对话尾部审查行：与 DSH 内置 ui-deliverables 同款外观，带撤销与审查按钮
• 侧边栏 Tab「文件审查」：按轮次分组展示改动文件，展开查看行级 diff

本仓库是 Lzh3070/dsh-file-review-tab 的 fork 镜像，针对 DSH 0.2.0-rc.2 进行了适配与增强。

核心功能¶

对话尾部审查行¶

每轮对话结束后，会在对话尾部出现「已编辑 N 个文件 +M −K」卡片。卡片外观与 DSH 内置 ui-deliverables 改动卡片逐像素对齐，包括 60px 头部、40px 文件类型图标块、13px 标题、等宽字体文件行、超过 4 行折叠为「全部 N 个文件」等细节。内置卡片标题栏没有插槽，本插件自渲染同款卡片以容纳两个按钮：

• 撤销：撤销本轮改动（撤销后可点「重新应用」）
• 审查：在侧边栏 Tab 中展开对应文件的 diff 并定位到该轮分组顶部

鼠标悬停 500ms 后弹出该文件的 diff 预览；点击「审查」或单个文件名，会深链打开侧边栏 Tab。

侧边栏 Tab「文件审查」¶

在 dsh-better-sidebar 的侧边栏「+」菜单中打开「文件审查」Tab，按轮次分组列出本会话改动文件。点击展开行级红绿 diff，支持撤销本轮 / 单文件撤销 / 重新应用。Tab 角标实时显示改动文件数。表头是与原生同款的 38px 对照条（文件选择器 + 统计），工具行提供「分栏 / 换行 / 刷新」三个可切换/可用的控件，每个都带 500ms 提示气泡。

删除文件可见¶

DSH 没有删除文件的工具，删除通常发生在终端命令中。本插件解析 rm 族命令的字面路径参数（rm / rmdir / unlink / shred / trash / Remove-Item / del / rd / erase 等），将被删文件以「已删除」标记出现在两个入口（内容已不存在，故无行级 diff、不可撤销）。带通配符或命令替换的删除命令不识别。

自动归档¶

主列表只保留最近 5 轮（进行中的轮次永不归档），更早的已完成轮次沉入底部「已归档 N 轮」折叠区。折叠时归档内容零渲染，展开后每页加载 10 轮（「加载更多」续页），diff 行另有懒挂载——长会话不再一次性挂载几十个 diff 组。深链跳到已归档轮次会自动展开并定位；展开状态按会话记忆；角标只统计主列表。

PTC / Code Mode 支持¶

run_code 程序内部的 edit/write 子调用也会被捕获——Host 端快照完整 before/after，浏览器端重建带行号的行级 hunks 并入所属轮次；diff 查看、状态检查、撤销/重做均可用。标准模式行为不变（对话尾部审查行仍只覆盖标准模式轮次）。

安装与启用¶

前置依赖：
- DeepSeek Harness web（0.2.0-rc.2+，已在 0.2.0-rc.2 上验证）
- dsh-better-sidebar（≥ 0.19.1，已在 0.24.1 上验证）

安装本仓库的发布版：

dsh plugin --profile web add @whybebabo/dsh-file-review-tab

或直接从本仓库的 GitHub 源安装：

dsh plugin --profile web add github:whybebabo/dsh-file-review-tab

上游版本（DSH 0.1.5）：

dsh plugin --profile web add dsh-file-review-tab@0.5.0

装好后重启 dsh web，在 better-sidebar 侧边栏「+」菜单打开「文件审查」即可。dsh-better-sidebar 需另行安装。

注意：裸名 dsh-file-review-tab 在 npm 上由上游作者持有，dsh plugin --profile web add dsh-file-review-tab 装到的是上游版本，不是本仓库的 0.7.1。要装本 fork 的版本必须使用 scoped 包名或 GitHub 源。

版本对应¶

• @whybebabo/dsh-file-review-tab@0.7.x：面向 DSH 0.2.0-rc.2，使用严格 TypertCodec.create() 工厂、turnTail 加法列表槽、原生 ui-deliverables 同款外观
• 上游 dsh-file-review-tab@0.5.x：面向 DSH 0.1.5
• 上游 0.4.1：面向 DSH 0.1.2 / 0.1.1

注意事项¶

• 不要同时安装本仓库与上游版本：两者注册同一个 turnTail 槽位与同一个 ui-deliverables 补丁，共装会出现重复卡片
• 安装前应检查源码与许可证（MIT）
• 刚发布的版本可能被 pnpm 的 minimumReleaseAge 挡下，可使用精确版本绕过

总结¶

dsh-file-review-tab 将文件改动审查能力扩展为对话尾部审查行与侧边栏 Tab 两个入口，提供行级 diff、撤销/重新应用、深链跳转、删除文件可见、自动归档、PTC 支持、会话隔离等能力，适合需要在 DSH 中审查和回滚 Agent 生成的文件改动的开发者。

• 目录页：https://www.skillhub.cn/plugins/whybebabo/dsh-file-review-tab
• GitHub：https://github.com/whybebabo/dsh-file-review-tab