leeyoung1/dsh-advisor-plugin

dsh-advisor-plugin is a Cordis plugin built specifically for DeepSeek Harness (DSH), targeting the web profile. It implements the "advisor strategy pattern": a cheap execution model drives the main loop while a stronger reviewer model is consulted at critical junctures, returning plan, correction, or stop signals that the executor must respect. The plugin ships two complementary channels — an explicit zero-argument advisor() tool that forwards the full session and tool inventory, plus an automatic patrol mode throttled by step count and a 90-second wall clock — both designed to mitigate self-verification blind spots, long-horizon drift, and premature completion claims in long-running coding-agent sessions. Installation runs through the official registry via dsh plugin --profile web add dsh-advisor-plugin, or directly from GitHub with dsh plugin add github:leeyoung1/dsh-advisor-plugin; local development uses ./scripts/link-deps.sh to symlink the host's @deepseek-ai/* packages and ./scripts/mount.sh to build and mount the bundle into the local web profile.

The typical workflow begins in the DSH Settings → Plugins panel where the user picks a reviewer provider/model stronger than the executor, optionally sets a reasoning effort, and toggles patrol on. From that moment, the execution model invokes advisor() with no arguments before substantive work, when stuck, or before claiming completion, while the patrol channel snapshots the conversation every N steps and writes session-event cards showing ON-TRACK, CORRECTION (amber), or STOP (red) verdicts that get injected into the next request via agent.inject(). The reviewer never mutates code — it only inspects via read-only search_files and read_file tools before issuing suggestions, making the architecture a clean separation of execution from judgment. Developers who worry about agents "proving themselves right" can also use the /advisor slash command inside any session to inspect the currently bound provider/model and effort tier without leaving the chat.

Dependencies are strict: Node.js ^22.19 or >=24, DSH 0.1.5-rc.1 or 0.1.5-rc.2 (peer range covers 0.1.0-rc.6, 0.1.1-rc.2, 0.1.2-rc.1, 0.1.3-alpha.1, verified on 0.1.1-rc.2); the user MUST supply a usable provider/model or the plugin stays unarmed, registering neither the tool nor the prompt segment so cost stays at zero. An executor blacklist accepts model, provider/model, or provider/model@effort syntax in settings.yaml, and on context overflow the plugin performs a paired safe truncation retry and falls back to the model's default effort when the configured tier is unsupported. Plain npm install will collide with DSH's official package peerDependencies, so users should always go through dsh plugin add. A known DSH Desktop 0.2.1 bundle patch still references the legacy name dsh-advisor; users must remove the old entry, install dsh-advisor-plugin@latest, and clean any residual - id: dsh-advisor line in the profile's cordis.patch.yml. The license is MIT, and the test suite reports 59 cases across 7 files all passing.