dsh-review
English | 简体中文
> 已废弃。 DSH 0.2.2 起,右侧栏自带代码审查和变更标签页
> (@deepseek-ai/dsh-experimental-client-ui-forge):本会话的代码变更、逐文件对比、
> 行级评论和变更请求。已经覆盖本面板的功能,因此这个插件不再需要,也不再维护。
> 仓库保留作参考;只有停留在 DSH 0.2.1 及更早版本时才值得安装。
给 DSH Web GUI 用的审查型 Git 面板。它在右侧栏加一个标签页,专门回答代码审查真正要问的几件事:
我的工作区改了什么、这个 commit 改了什么、我这个分支和另一个分支差多少、我现在在哪个分支上——
不用开终端,也不碰历史。
- 工作区:已暂存 / 未暂存 / 未跟踪,每个文件带
+/-行数 - 提交:当前分支的提交历史,分页加载,每行直接标出指向它的引用(
main、origin/main、tag);点开看提交信息、作者和改动文件,再点文件看差异 - 分支:本地与远程分支分区显示、各自标注,带最后一次提交;本地分支显示还有多少个提交没推送,一键切换,
对比把本地分支与它的 upstream 比较(没有 upstream 时与HEAD比) - 子项目:工作目录只是个容器、自己不是仓库时,面板会列出它下面的 git 工作区,并按会话记住选择
- 差异是真正的
git diff输出——rename、二进制、mode 变化都在——逐行渲染,并复用宿主自带的语法高亮 - 设计上只读:不提交、不推送、不 stage、不 reset。唯一的写操作是
git checkout,且工作区脏时直接拒绝,不 stash 也不强切
截图
安装
1. 让宿主自己装(installBundle,装上即启用)
在对话里跟 agent 说:
> 安装插件 github:miiy/dsh-review
或者把同一个 spec 贴到 设置 → 插件 的安装框里。
两条路都走宿主的 installBundle:装包、写入 dsh.profile.bundles、热加载,一步到位。
2. 用 CLI(dsh plugin,只装不启用)
dsh plugin --profile add github:miiy/dsh-review
dsh plugin 把参数转给 profile 目录里的 pnpm,所以这一步只装包、不组装。装完
设置 → 插件 里会出现一行“已安装、开关关闭”,打开开关才进 dsh.profile.bundles;
开关没热生效就重启 dsh web。纯 JS bundle 没有构建脚本,从 git 装不需要
allowBuilds 审批。本地目录也行:dsh plugin --profile add /path/to/dsh-review。
3. 启动宿主
照常启动 dsh web 即可,不需要任何启动参数:bundle 挂载时就把路由注册到宿主的
webServer 上,标签页出现在右侧栏的标签向导里。
使用
打开右侧栏,从标签页向导(+)里选 Git 审查。面板跟随当前会话的工作目录,
所以每个对话审查的是它自己的仓库。
| 标签 | 内容 |
|---|---|
| 工作区 | 已暂存、未暂存、未跟踪文件;点文件看差异 |
| 提交 | 已检出分支的历史;点提交看改动文件,再点文件看差异 |
| 分支 | 本地分支带 ↑ 未推送数与 ↓ 落后数,其后是远程分支;切换需要行内确认,对比对本地分支用其 upstream(无 upstream 或远程分支则与 HEAD 比),结果是一份文件清单,逐个展开看差异 |
刷新 重新读取当前视图;切走再切回来也会刷新,后台不做任何轮询。
点标题栏的仓库名可以切换当前会话能访问的 git 工作区:包含工作目录的那个,以及下面四层内的嵌套工作区。
工作目录本身不是仓库时,只有一个候选就自动选它,有多个才让你挑。
安全
- 所有 git 命令都通过
spawn('git', [...])以参数数组执行,从不拼 shell 字符串。 - 引用先过
rev-parse --verify;路径必须是仓库相对路径(不许..、不许以-开头)。 - 命令带
GIT_TERMINAL_PROMPT=0和GIT_OPTIONAL_LOCKS=0;diff 使用--no-color --no-ext-diff --no-textconv。 checkout遇到任何已暂存或未暂存的已跟踪改动就拒绝,并返回受影响文件;仅未跟踪文件不阻塞切换。- 路由用宿主连接的
requestRejection做围栏:非回环且非同源/未配对来源的请求会被拒绝。 - 客户端指定的仓库必须是会话工作目录所在的工作区或它下面的工作区,否则返回
forbidden-root。
要求
- DeepSeek Harness
>= 0.2.1-rc.1 < 0.3.0的 Web profile - 宿主机有
git,且会话工作目录位于一个 git 工作区内
已知限制
- 一次只认一个仓库:包含工作目录的那个,或面板列出的嵌套工作区。
- 不做提交、推送、stage/unstage、stash 或改写历史。
- 宿主没有导出
useCodeHighlighter时不做语法高亮,差异仍按纯文本渲染。 - 工作目录不在仓库内、或宿主没有
git时返回not-a-repository,面板会明确提示。
开发
node --test # 解析器、路由面、客户端模块契约
test/ 不需要额外依赖;路由测试用到的 node_modules/@deepseek-ai/schemastery
链接只是镜像 profile 在运行期提供的那份。
| 文件 | 职责 |
|---|---|
git.js |
git 执行、输出解析、引用与路径围栏 |
index.js |
宿主插件:/dsh-review/api/ 路由 |
client.js |
客户端 bundle:右侧栏标签类型与标签体 |
MAINTENANCE.md |
本插件依赖的全部上游名字 |
许可证
MIT,见 LICENSE。