前言¶
在使用 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
