yjh051108/dsh-router-standard

dsh‑router‑standard

What it is – A research‑grade router preset for the DeepSeek Harness (DSH) agent framework. It inspects the very first real user message in a session, classifies the task, and automatically injects the appropriate persona and tool set (spec, react or weak) for the DeepSeek V4 model. The router lives as a Cord‑is plugin (zero external dependencies) and works together with the companion packages dsh‑routing‑suite and dsh‑super‑injector.

Why it exists – Experiments on DeepSeek V4 Pro/Flash show that the model’s behaviour along the persona axis collapses into three stable “bands” (spec, mixed, react). The model cannot switch modes itself after the first request, so an external router must decide the band up‑front. This preset encodes that decision logic, letting the model stay in the region where it performs best for the given task.

Key capabilities

• First‑turn classification – reads the agent/inbox/claimed event, runs classifyTask, and selects the correct band (spec / react / weak). No fallback to weak any more.
• Band‑specific tool surface – each band gets a curated set of core tools (read/write/edit, grep, shell, etc.) and a near‑field guidance message injected in the same request as the user message for weak sessions.
• Strict workflow – a staged development workflow (0→1→2→3) that forces explicit handling of ambiguous or complex tasks (ask_user_question, todo_write).
• Zero‑dependency runtime – the router core (router-core.mjs) is pure ESM JavaScript; the bootstrap plugin (router-bootstrap.mjs) adds no external Node modules.
• Hot‑reload support – with dsh‑super‑injector you can update the preset without restarting the DSH runtime (dev_reload_preset router‑standard).
• Built‑in validation – dev_page_check runs screenshot, DOM smoke, console‑/error‑/title checks automatically.
• Developer diagnostics – commands such as dev_router_status, dev_router_mode, and dev_mode_subagent expose the current band, persona, and allow spawning isolated sub‑agents in a different reasoning mode.

Current status – Development branch, version v1.19.1 (2026‑08‑24). The code is in a “strict workflow” stage, with full unit‑test coverage (router.test.mjs), documentation of the evolution, and a changelog. Not yet released as a stable package.

How to use

1. Copy the desired preset folder (router‑standard or router‑spec) into ~/.dsh/.agent-presets/.
2. Install the dsh‑super‑injector suite (see its repo) to enable hot‑reloading.
3. Start a new DSH session, select the preset (e.g., Router Standard (experimental)) and run the session.
4. Optional CLI helpers:

   dev_router_status                     # shows current band/persona
   dev_router_mode spec|react|weak ...   # force a mode
   dev_mode_subagent spec|react task      # run a single task in an isolated mode
   

5. Run the test suite to verify the installation:

   node --test router.test.mjs
   

Documentation – The repo includes:

• docs/statement.md and docs/apology.md (research‑artifact notices)
• docs/STANDARD-PLAN.md (road‑map of the router development)
• docs/paper.md and docs/experiments.md (theoretical background and raw data)
• A changelog and a detailed usage guide in the README.

License – MIT (with attribution to the DeepSeek Harness Standard preset).

---

All information above is taken directly from the repository’s README; no external assumptions have been added.