Introduction

In the DSH pluggable workflow, many capabilities can be mounted onto dsh, but users still need a stable entry point to view current entries, track refinement history, roll back committed changes, and audit auto-gate decisions.

dsh-refine provides such an entry point: it organizes refinement-related operations into a /refine command and a settings panel. It drives the dsh-continual-harness engine; when the engine is not mounted, operations degrade into executable setup instructions rather than throwing errors directly.

What is it

dsh-refine is a refinement UX layer for DeepSeek Harness (dsh), maintained by dushaobindoudou, with an MIT license.

Based on the provided information, in package.json:

"name": "dsh-refine",
"version": "1.0.3"

And it declares:

"dsh": {
  "client": {
    "platform": "web"
  }
}

The README explains that this project is a port and practical adaptation of the /refine concept from prime-agent into the dsh ecosystem.

Core Features

The following introduces the parts that users can operate directly.

/refine Command

/refine supports status viewing, entry listing, history, rollback, and free-text refinement instructions.

Common forms include:

/refine status

View engine and rollback status.

/refine list [kind]

List current entries, filterable by prompt, memory, skill, or subagent.

/refine history [n]

View recent refinement history, defaulting to 10 entries, with a maximum of 50.

/refine rollback <id>

Roll back a committed refinement; the id comes from the history.

/refine <any text>

Trigger a refinement with free text. The command returns immediately, and results appear later in the settings panel or /refine history.

Settings Panel

After entering Refine Harness in the settings panel, you can:

  • Browse entries
  • View harness timeline
  • One-click rollback
  • Audit auto-gate decisions

Session History Compatibility

Session events for harness/refinement written by the engine are registered with the host reader, keeping the relevant session log loadable.

Engine Optional

The dsh-continual-harness engine is optional at runtime.

Without the engine, the plugin provides executable setup instructions; it does not error out and does not pollute the session.

However, to truly trigger refinements, the engine must be mounted.

Installation and Activation

First, check the environment. The data indicates the following requirements:

  • Node.js ≥ 18
  • dsh 0.1.0-rc.6+, with @deepseek-ai/dsh-home-paths and @deepseek-ai/dsh-typert-protocol

Then, mount the plugin in the plugins configuration of the dsh profile:

plugins:
  - dsh-continual-harness   # Engine, optional at runtime but required to trigger refinements
  - dsh-refine              # This UX layer, required

After the above steps, restart dsh web to apply host-side changes.

If currently running:

pnpm run dev:web

Client-side panel changes will hot reload.

Typical Usage

View Status

/refine status

Used to view the current engine and rollback status.

List Entries

/refine list prompt

Filter by prompt.

/refine list memory

Filter by memory.

/refine list skill

Filter by skill.

/refine list subagent

Filter by subagent.

You can also use directly:

/refine list [kind]

View History

/refine history

View the last 10 refinement history entries.

/refine history 20

View the last 20 entries.

The maximum number is 50:

/refine history 50

Rollback

First, obtain the id from the history:

/refine history

Then, rollback a specific entry:

/refine rollback <id>

Trigger Refinement

Input a free-text instruction:

/refine 优化当前 prompt 的边界条件说明

The command returns immediately. The results will appear later in the settings panel or:

/refine history

Using the Settings Panel

Enter:

Settings → Refine Harness

You can browse entries, view the history timeline, one-click rollback, and audit auto-gate decisions.

Use Cases and Notes

dsh-refine is suitable for scenarios where refinement capabilities need to be used within dsh, especially for those who need to view current entries, track refinement history, roll back committed changes, and audit auto-gate decisions.

Note the following points:

  1. The plugin runs with the permissions of the current dsh process. You should check the source code and license before installing.
  2. The dsh-continual-harness engine is optional at runtime, but it must be mounted to trigger refinements.
  3. Without the engine, the plugin provides executable instructions; it does not error out and does not pollute the session.
  4. dsh-refine is a plugin project in the independent community directory; it has no official affiliation with DeepSeek / Synthesia and should not be considered an official app store.
  5. The data only lists npm version, npm downloads, CI, and other badge links, without specific values; this article does not cite these values.

Related Links