dsh-review-loop

面向 DeepSeek Harness 的增量代码审查插件。

English · MIT License

dsh-review-loop 把"人审查 agent 干的活"变成增量、闭环、不重复的过程：批准一批改动后记录审查检查点（checkpoint），下次审查只显示此后新增的改动——已看过的内容不会再次出现。审查意见通过 harness 常规消息通道注入 agent，不打断它正在进行的任务。

解决什么问题

agent 跑完一个任务通常改动十几个文件。每次都看完整 diff 很慢，重复看已审查的内容更是浪费。本插件让审查跟着 agent 的进度推进：

agent 干活（改文件）
  -> 打开审查面板：只显示上次审查检查点之后的改动
  -> 逐文件查看 diff、填写审查意见
  -> 批准：记录新的检查点，意见注入 agent
  -> agent 响应意见继续工作；新改动成为下一批审查

特性

• 增量审查（since-review）：批准时把工作区快照记为检查点；下次审查只比较「检查点 -> 当前」，已审文件从队列中消失，除非再次被修改。
• 双入口：Web UI 审查面板（输入框上方 dock，2 秒轮询）+ /review 命令（键盘优先）。两者共用同一套核心逻辑。
• 反馈闭环：批准时可附评论，通过 agent.inject() 作为用户消息送达 agent。
• 不解析工具调用：任何磁盘改动（agent、你或其它进程产生）都会被反映——插件读的是 git，不是 agent 循环。
• 检查点持久化：$DSH_HOME/review-loop/.json，原子写入，绝不污染工作区自身的 git 状态。
• 零核心修改：纯 bundle 插件（dsh.bundle patch 层），不动 agent-loop 骨架。

安装

# 一行安装（git 源）
dsh plugin --profile web add github:wuxiangru915/dsh-review-loop

# 重启 web 服务，然后强制刷新页面

本地开发：

# 开发需要 DSH 源码仓库的 sibling checkout（位于 ../deepseek-harness）：
# @deepseek-ai/dsh-* 尚未完整发布到 npm（缺 dsh-type-meta），devDependencies
# 通过 link 指向该工作区；checkout 不在该路径时请调整 package.json 中的 link 路径。
pnpm install && pnpm build
dsh plugin --profile web add /path/to/dsh-review-loop

仓库已随附构建产物 lib/，git 源安装无需在用户机器上执行构建。

用法

Web UI

任意工作区为 git 仓库的会话中，输入框上方会出现审查面板：

• 状态行显示 N 个文件待审查 及展开审查按钮。
• 展开后面板列出待审文件，diff 可折叠查看且按行着色（新增行使用 success 语义色、删除行使用 error 语义色，行首符号始终可见，不依赖颜色传递语义）。