前言¶
在 DSH 会话里，智能体会持续编辑、写入或删除文件。对开发者来说，关键不只是“有没有生成结果”，而是要看到这一轮到底改了哪些文件、行级差异是什么，以及是否能快速撤销或重新应用。
dsh-file-review-tab 解决的是这个环节：它把 left0ver/dsh-file-review 的改动审查能力接入 dsh-better-sidebar 侧边栏，同时保留对话尾部的审查行。
这是什么¶
Lzh3070/dsh-file-review-tab 是一个 DSH web 插件，许可证为 MIT。
它提供两个入口：
- 对话尾部审查行：在回合结束后快速查看本轮文件改动。
dsh-better-sidebar侧边栏「文件审查」Tab：按轮次展开文件改动、行级 diff 和撤销操作。
核心功能¶
对话尾部审查行¶
回合结束后，对话尾部会出现“已编辑 N 个文件 +M −K / 撤销 / 审查”的审查行。
点击「审查」或单个文件名，可以深链打开侧边栏「文件审查」Tab，并自动展开对应文件的 diff、定位到该轮分组顶部。
侧边栏「文件审查」Tab¶
侧边栏 Tab 按轮次分组列出本会话改动文件。
点击条目后，可以展开行级红绿 diff。插件支持：
- 撤销本轮
- 单文件撤销
- 重新应用
Tab 角标会实时显示改动文件数。
删除文件可见¶
插件会解析 rm、rmdir、unlink、Remove-Item、del、rd 等命令的字面路径参数。
被删除的文件会以「已删除」标记显示。这类文件没有行级 diff，也不提供撤销。
带通配符或命令替换的删除不会被识别。
自动归档¶
主列表只保留最近 5 轮。
更早的已完成轮次会沉入「已归档 N 轮」折叠区。展开后每页加载 10 轮。深链可以自动展开并定位到目标轮次。
PTC / Code Mode 支持¶
插件会捕获 run_code 内部的 edit / write 子调用。
Host 端会保存 before/after 快照，浏览器端会重建带行号的行级 hunks，用于该轮审查。标准模式行为不变；对话尾部审查行仍只覆盖标准模式轮次。
会话隔离与界面适配¶
每个会话只查看自己的改动。Tab 不可见时暂停状态巡检。
在工作台分屏半宽或浮动窗口下，轮次头部会自动换行，次要信息让位，保留撤销操作和文件名。
样式使用 CSS Module 和宿主 --dsw-alias-* 主题令牌。
安装与启用¶
前置依赖：
- DeepSeek Harness web
≥ 0.1.0-rc.5，兼容0.1.2-alpha系列。 dsh-better-sidebar≥ 0.12.0。
执行安装命令：
dsh plugin --profile web add dsh-file-review-tab
安装后重启 dsh web，然后在 dsh-better-sidebar 侧边栏的「+」菜单中打开「文件审查」。
典型用法¶
1、对话结束时，在尾部审查行点击「审查」或某个文件名。侧边栏 Tab 打开后，会展开对应文件的 diff，并定位到该轮分组顶部。
2、在 Tab 中按轮次展开文件 diff，检查改动。需要回退时，可以执行撤销本轮、单文件撤销或重新应用。
3、如果文件被删除，条目会显示「已删除」标记。这里只能确认哪些文件被删除，不提供行级 diff 或撤销。
4、长会话中，较早已完成的轮次会进入「已归档 N 轮」折叠区。展开后每页加载 10 轮，也可以通过深链自动打开并定位目标轮次。
适用场景与注意¶
适合在 DSH web 工作流中频繁审查智能体文件改动的开发者，尤其是已经使用 dsh-better-sidebar 的项目。它把查看 diff、撤销、定位轮次等操作集中到侧边栏，并与对话尾部入口配合使用。
使用前需要注意：
- 插件会以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 许可证为 MIT。核心 diff 渲染器与撤销服务移植自
left0ver/dsh-file-review（MIT License, © ZhangWenChao）。 - 侧边栏集成基于
dsh-better-sidebar开放的ctx.betterSidebar注册 API。 - 带通配符或命令替换的删除不会被识别。
package.json的peerDependencies内容在资料中被截断，无法完整确认；依赖解析以实际安装环境为准。
结尾¶
dsh-file-review-tab 的价值在于把文件改动审查从分散的对话反馈中收拢到一个可展开、可撤销、可定位的侧边栏视图中，同时保留对话尾部的快捷入口。
可在 DSH 插件目录中查找 dsh-file-review-tab 页面；GitHub 仓库为：
https://github.com/Lzh3070/dsh-file-review-tab
