Preface

In DSH (DeepSeek Harness), a common requirement for local coding assistance is: after modifying code, you only want the agent to clean up the recently changed parts, rather than rewriting unrelated files on a whim.

dsh-simplify is a plugin built around this scenario. It first locates recently changed files and line ranges via git diff, then asks the agent to propose improvements regarding clarity, consistency, and maintainability within this range.

The DSH plugin ecosystem emphasizes “everything is a plugin,” and the community directory is an independent site with no official affiliation with DeepSeek or Fanghuang. Below is an introduction to the positioning, installation, and usage of dsh-simplify.

What is this

dsh-simplify is a DeepSeek Harness plugin maintained by GongYuanCaiJi with an MIT license.

It is ported from pi-simplify. The upstream prompts and git diff parsing logic are preserved word-for-word, with only the adaptation to DeepSeek Harness’s API differences.

The core problem it solves is: after code changes, let the agent review only the recently changed code and perform simplification or cleanup within the changed lines, without extending to unrelated code.

Core Features

The following capabilities determine its usage boundaries.

  1. Only review changed lines. Locate changed files and line ranges via git diff; the agent can read surrounding code for context, but editing is strictly limited to the changed lines.
  2. Support four scopes. Uncommitted changes, staged, comparison with any ref, or specified files.
  3. Post-change verification. Existing tests will run before the review ends to confirm nothing was broken.
  4. Follow project conventions. Automatically follows CLAUDE.md / AGENTS.md in the project.
  5. Path parameter safety. Parameters are individually escaped with POSIX single quotes, ensuring filenames are safe for whitespace and quotes.

Installation and Enablement

First, confirm the DSH profile you want to install to. The installation command is as follows:

dsh plugin --profile <your profile> add github:GongYuanCaiJi/dsh-simplify

During installation, dist/ is automatically built via the prepare script. If pnpm blocks the build step in your environment, you need to add this package to allowBuilds in the profile’s pnpm-workspace.yaml.

Runtime environment requirements:

  • engines requires node >=20
  • peerDependencies requires @deepseek-ai/cordis ^4.0.1
  • peerDependencies requires @deepseek-ai/dsh-llm ^0.1.0-rc.6

If installing from a local directory, you need to build it yourself first, then add that directory according to the DSH plugin installation process.

Typical Usage

The plugin provides the /simplify command. Below are the usages by scope:

/simplify                      # Review all uncommitted changes
/simplify --staged             # Review only staged changes
/simplify --ref=<ref>          # Compare with a specific ref, e.g., --ref=main, --ref=HEAD~3
/simplify <file...>            # Review only specified files

For example, when reviewing differences with main, you can use:

/simplify --ref=main

Applicable Scenarios and Notes

It is quite suitable for performing a restricted review after local code changes: only looking at this change, only modifying lines within this change, and running existing tests before the review ends.

Note the following limitations:

  • The prompt received by the agent is in English, as it is the original upstream text, preserved word-for-word without modification.
  • The plugin runs with the current dsh process permissions; check the source code and license before installing.
  • Existing tests will run before the review ends to confirm nothing was broken.

The upstream pi-simplify copyright is Copyright (c) 2026 Matt Devy, and the copyright for this port is Copyright (c) 2026 GongYuanCaiJi.

Links

  • GitHub: https://github.com/GongYuanCaiJi/dsh-simplify
  • Community Directory Page: https://www.skillhub.cn/plugins/GongYuanCaiJi/dsh-simplify

With the above installation and configuration, dsh-simplify can serve as a local, verifiable post-change review entry point, used in daily development workflows where you need to control the scope of agent modifications.