Introduction

In DSH, agents often modify multiple files within a git workspace consecutively. If you review the full diff every time, it is easy to re-confirm changes that have already been seen and distracts attention from changes that have not yet occurred. DSH’s extensibility approach emphasizes “everything is a plugin,” where third-party plugins can provide incremental enhancement around host capabilities; the community directory is an independent site with no official affiliation with DeepSeek or Futurna.

Below is an introduction to wuxiangru915/dsh-review-loop. It is an incremental diff reviewer for DeepSeek Harness designed to turn “reviewing agent changes” into a small loop: approve the current batch of changes and record a checkpoint; the next review only shows changes after the checkpoint.

Plugin Positioning

wuxiangru915/dsh-review-loop is a pure bundle plugin, integrated using the dsh.bundle patch layer, and does not modify the DeepSeek Harness core code. It provides two entry points: the Web UI review panel and the /review command, sharing the same checkpoint logic.

This plugin uses the MIT license and is maintained by wuxiangru915.

Core Capabilities

  1. Incremental Review: When approved, it snapshots the current working tree as a checkpoint; the next review only diffs checkpoint -> current.
  2. Two Entry Points: Web UI review panel (2-second polling) and /review command.
  3. Feedback Loop: You can carry a comment when approving and inject it to the agent as a user message via agent.inject().
  4. Direct Git Reading: It does not parse tool calls, so it can reflect any on-disk change.
  5. Checkpoint Persistence: Writes to $DSH_HOME/review-loop/<workspace-hash>.json using atomic writes, thus not polluting the workspace’s git status.
  6. Zero Core Modification: Runs as a bundle plugin without modifying the host core.

Installation and Enablement

The runtime environment requires:

  • DeepSeek Harness >= 0.1.0-rc.5 (Cordis 4.x)
  • A git repository (hard requirement)
  • Node.js >= 22

git-source installation:

dsh plugin --profile web add github:wuxiangru915/dsh-review-loop

This step installs the plugin from the git repository. The repository ships with pre-built lib/ artifacts, so this installation method does not require the user’s machine to perform a build.

After installation, perform the following once:

  1. Restart the web server.
  2. Hard refresh the page.

Local development installation:

pnpm install && pnpm build
dsh plugin --profile web add /path/to/dsh-review-loop

Local development requires ../deepseek-harness to be checked out at the same level. Some @deepseek-ai/dsh-* packages are not fully published to npm, and devDependencies will link to the workspace; if the checkout path is different, you need to adjust the link paths in package.json.

Typical Usage

Web UI

In a DSH session where the workspace is a git repository, a review panel appears above the composer. Here you can open the review, view the diff, fill in feedback, and click Approve & checkpoint.

The panel provides a file list, toggleable diff display, and feedback input. After approval, a checkpoint is recorded; if files are modified again later, they re-enter the review list.

Commands

/review

Displays incremental changes since the last checkpoint; if no checkpoint exists, it shows full changes vs HEAD.

/review all

Displays full working tree changes relative to HEAD, ignoring the checkpoint.

/review approve

Records a checkpoint.

/review approve <comment>

Records a checkpoint and injects the comment to the agent.

Applicable Scenarios and Notes

Suitable for scenarios where DSH Web sessions are used within a git repository and you want to review agent changes in batches. It is suitable for breaking long tasks into small loops of “review, feedback, and continue execution.”

Notes:

  • The plugin depends on a git repository; it cannot serve as a review target without one.
  • Checkpoint files are written to $DSH_HOME/review-loop/<workspace-hash>.json and do not enter the workspace’s git status.
  • NPM publication (@dsh-plugin/dsh-review-loop) is not yet completed in the Roadmap; currently, installation is primarily done via the git-source and local path methods provided in the documentation.
  • The plugin runs with the permissions of the current dsh process. Before installing, you should check the source code and license to confirm that its behavior of reading git, writing checkpoints, and injecting messages meets your environment requirements.

References

  • Directory page: https://www.skillhub.cn/plugins/wuxiangru915/dsh-review-loop
  • GitHub: https://github.com/wuxiangru915/dsh-review-loop