dsh-advisor: A DSH plugin providing passive review advice for DeepSeek Harness

dsh-advisor is an Advisor plugin (DSH plugin) for DeepSeek Harness (DSH), porting the omp advisor subsystem to provide a per-session independent reviewer model. This model passively observes the primary transcript, reviews each stepped turn with an explicitly configured model (provider and model are required), and injects severity-ranked advice (nit / concern / blocker) back into the session without polluting or recursively reviewing itself. It is advisory only: it never approves or rejects the primary agent's actions, nor issues commands as if it were the primary agent. Every delivered message is self-described advisory content, and a misbehaving reviewer is bounded end to end (emission guard, immuneTurns cooldown, failure policy) so it can never stall or pollute the primary loop. Maintained by omdsh-dev, licensed under MIT, written in TypeScript, and recently updated in 2026-08, it works in both dsh front ends: the web profile and the dsh-tui terminal profile.

What core features does the dsh-advisor DSH plugin support?

• Passive review: The second model observes the primary conversation, reviews each turn, and injects advice without interfering with the primary agent's decisions.
• Severity ranking: Advice is categorized as nit, concern, or blocker, allowing users to prioritize issues.
• Safety boundaries: The reviewer never approves or rejects the primary agent's actions, nor issues commands as the primary agent, ensuring the main loop remains unaffected.
• Dual front-end support: Usable in the web configuration interface (Settings → Plugin Configuration → Advisor card) and the dsh-tui terminal (/advisor and /advisor config commands).
• Flexible configuration: Supports configuration via the global settings file or the web interface, including enable toggle, provider, model, system prompt, cooldown turns, and delta window.

How to install dsh-advisor?

Use the following install command, choosing the profile based on your front end:

dsh plugin --profile web add github:btspoony/dsh-advisor

For the dsh-tui terminal, use:

dsh plugin --profile dsh-tui add dsh-advisor

After installation, the plugin fetches the published tarball from the registry, which ships built artifacts (lib/ and cordis.patch.yml) — nothing builds on the target machine, and runtime dependencies resolve through the dsh installation's flat profile module fallback, with no extra install step.

How to configure dsh-advisor?

Add an advisor: section to the global dsh settings document (default $DSH_HOME/settings.yaml), or use the Advisor card in the web Settings page. Configuration options include:

advisor:
  enabled: true                # master switch (default false)
  provider: deepseek-official  # REQUIRED when enabled
  model: deepseek-v4-flash     # REQUIRED when enabled
  systemPrompt: ""             # optional; "" = built-in reviewer prompt
  immuneTurns: 3               # int ≥ 0, default 3 — cooldown after a delivered steer
  maxDeltaMessages: 60         # int ≥ 0, default 60 — delta window; 0 = unbounded

Note: When enabled: true, provider and model are mandatory; otherwise, the advisor never starts a model call and reports a disabled-with-reason status. Unknown config keys are rejected.

Which DeepSeek Harness versions and platforms does dsh-advisor support?

The plugin is compatible with both the web and dsh-tui front ends of DeepSeek Harness, and supports Node.js ^22.19 or >=24. It depends on multiple @deepseek-ai/dsh-* packages, resolved through the dsh installation's flat profile module fallback, with no extra install step. Maintained by omdsh-dev, licensed under MIT, and recently updated in 2026-08, it currently has 11 stars, 2 forks, and 0 open issues.

View more DSH plugins at dsh-plugin.org