dsh-review-loop
Incremental diff reviewer for DeepSeek Harness.
中文说明 · MIT License
dsh-review-loop turns code review of agent work into an incremental, closed-loop process: after you approve a batch of changes, a checkpoint is recorded and the next review shows only the changes made afterward — never a re-review of what you already saw. Review feedback is injected back to the agent through the harness's normal message channel, without interrupting its work.
What it solves
An agent task commonly touches a dozen or more files. Reviewing the full diff every time is slow, and re-reviewing unchanged work wastes attention. This plugin makes review follow the agent's progress:
agent works (modifies files)
-> open the review panel: only changes since the last review checkpoint
-> inspect each file's diff, add feedback
-> approve: a new checkpoint is recorded, feedback is injected to the agent
-> the agent responds and keeps working; new changes become the next batch
Features
- Incremental review (since-review): approving snapshots the working tree into a checkpoint; the next review diffs
checkpoint -> current, so reviewed files disappear from the queue unless they change again.
- Two entry points: a Web UI review panel docked above the conversation composer (2s polling), and a
/review command for keyboard-first use. The same core logic backs both.
- Feedback closed loop: approvals may carry a comment, delivered to the agent as a user message via
agent.inject().
- No tool-call parsing: any on-disk change — by the agent, by you, or by another process — is reflected; the plugin reads git, not the agent loop.
- Checkpoint persistence:
$DSH_HOME/review-loop/<workspace-hash>.json, written atomically, never polluting the workspace's own git status.
- Zero core modifications: a pure bundle plugin (
dsh.bundle patch layer); the agent-loop skeleton is untouched.
Installation
# one line, from a git source
dsh plugin --profile web add github:wuxiangru915/dsh-review-loop
# restart the web server, then hard-refresh the page
Local development:
# Development requires a sibling checkout of the DeepSeek Harness source
# repository at ../deepseek-harness: the @deepseek-ai/dsh-* packages are not
# fully published to npm (dsh-type-meta is missing), so devDependencies link
# to the workspace instead. Adjust the link paths in package.json if your
# checkout lives elsewhere.
pnpm install && pnpm build
dsh plugin --profile web add /path/to/dsh-review-loop
The repository ships prebuilt lib/ artifacts, so git-source installs work without a build step on the user's machine.
Usage
Web UI
Review panel (English)
In any session whose workspace is a git repository, a review panel appears above the composer:
- A status line —
N file(s) to review — with an Open review button.
- The expanded panel lists the pending files with toggleable, colorized diffs (added lines use the success token, removed lines the error token; the sign is always visible).
- An optional feedback input and an Approve & checkpoint button.
- After approval the panel shows the reviewed state; later edits re-surface the file.
Command line
| Command | Behavior |
|---|
/review | Incremental: changes since the last checkpoint (or the full change set vs HEAD when none exists) |
/review all | The complete working-tree change set vs HEAD, ignoring the checkpoint |
/review approve | Record a checkpoint |
/review approve <comment> | Record a checkpoint and inject the comment into the agent |
Architecture
src/
├── review.ts Pure core (collectState / approve / renderState) — shared by command and HTTP paths
├── git.ts git helpers (status / diff / hash-object; zero-dependency spawnSync)
├── checkpoint.ts checkpoint persistence ($DSH_HOME/review-loop/<ws-hash>.json, atomic write)
├── http.ts Web routes: GET /plugins/dsh-review-loop/state · POST /plugins/dsh-review-loop/approve
└── client/
└── review-panel.tsx Browser panel (conversation.input.dock slot, polling refresh)
command: /review ------> renderState() ----+
+--> src/review.ts (pure, shared)
web UI: GET /state ----> collectState() --+
POST /approve --> approve() + agent.inject()
The client bundle is a CJS __ModuleLoader__ artifact served at /plugins/@dsh-plugin/dsh-review-loop/client.js; routes and command share one checkpoint store, so approving from the UI advances the same queue the /review command reads.
Incremental algorithm
for each working-tree change vs HEAD:
compare its content hash with the checkpoint's recorded hash
same -> reviewed (hidden)
changed / new / HEAD moved -> pending (the incremental queue)
approve re-snapshots the tree -> the checkpoint advances
Testing
pnpm test # 7 integration tests: real cordis + real git repositories
pnpm typecheck
pnpm build # dual-half build: host ESM + client bundle
Roadmap
Requirements
- DeepSeek Harness >= 0.1.0-rc.5 (Cordis 4.x)
- A git repository (hard prerequisite)
- Node.js >= 22
License
MIT
