dsh-delegate-router

dsh-delegate-router

English · 中文

Automatic Flash/Pro routing for DeepSeek Harness subagent calls.

Your main conversation keeps running on a strong model (e.g. V4 Pro). When the
agent delegates a task to a subagent, this plugin classifies the task and sends
light tasks to a cheap model (e.g. V4 Flash) while heavy tasks stay on the
strong model — deterministically, without relying on the model's cooperation.
Every decision is recorded in a ledger you can inspect from the sidebar
(⚡ 分派记录).

• Auto routing — light tasks run on Flash, heavy tasks stay on Pro.
• DIY rules — all rules live in ~/.dsh/dsh-delegate-router.json:
  keyword lists, the short-task threshold, the budget cap, and the Beijing
  peak-hour demotion.
• Manual overrides — per-call provider/model parameters on the
  subagent / subagent_fork tools.
• /delegate command — per-session mode: /delegate auto | off | flash-all.
• Decision ledger — the ⚡ 分派记录 panel lists every routed delegation
  (task, route, trigger) for the active session.

Why

DeepSeek V4 Flash costs exactly one third of V4 Pro on every line (official
pricing, effective 2026-08-17; peak/off-peak only scales both). Stock DSH runs
every subagent on the parent's model — a search task delegated from a Pro
session costs the full Pro rate. Measured on real sessions: 4 routed runs,
~156K tokens, ¥0.32 actual (Flash) vs ¥0.96 hypothetical (Pro) — 66.7%
saved on every routed task. Run node scripts/measure-savings.mjs against
your own ~/.dsh/sessions to reproduce.

Rules (in order)

1. explicit per-call provider/model → used as-is (manual)
2. /delegate off → inherit; /delegate flash-all → all Flash
3. session tokens over budgetCapTokens → Flash (budget)
4. keyword dominance scoring: heavy wins ties, but a strictly-light task
   beats one incidental heavy word (auto-heavy / auto-light)
5. task text ≤ shortTaskMaxChars → Flash (auto-short)
6. unmatched + Beijing peak hours (default 9–12, 14–18) → Flash (peak)
7. unmatched + unknownToFlash: true (opt-in, aggressive) → Flash (auto-unknown)
8. otherwise → inherit the parent model

Task text = the subagent call's description + prompt. Matching is precise:
pure-ASCII keywords use word boundaries (list never matches specialist,
design never matches designer); CJK keywords shorter than two characters
are ignored.

Works great with dsh-routing-suite

dsh-routing-suite owns the
thinking-mode / persona layer; this plugin owns the child-model cost
layer. They stack: light subagent tasks get routed to Flash by this plugin,
then run under the router preset's flash-optimized persona. The routing suite's
own experiments (P11/P24) found the optimal weak persona is flash-specific
and that spec-style personas actively hurt Flash — so Flash + that router
preset is the best-matched combination for cheap delegation, and this plugin
supplies the automatic Flash routing for it.

Honest measurement

Relative prices are guaranteed by the official price table (Flash = 1/3 of Pro
on every line, 2026-08-17 peak/off-peak pricing). Absolute numbers depend on
how much work a run does — LLM runs are nondeterministic, so compare per
token (or same-task), never raw totals. scripts/measure-savings.mjs prices
your real session logs with the official table; read it before quoting numbers.

Install

dsh plugin --profile web add dsh-delegate-router

Configure

All knobs are optional and live in ~/.dsh/dsh-delegate-router.json:

{
  "flashProvider": "opencode-go",
  "flashModel": "deepseek-v4-flash",
  "proProvider": "opencode-go",
  "proModel": "deepseek-v4-pro",
  "mode": "auto",
  "lightKeywords": ["search", "搜索", "查找", "总结", "summarize", "list", "列出"],
  "heavyKeywords": ["refactor", "重构", "implement", "实现", "debug", "调试"],
  "shortTaskMaxChars": 120,
  "peakDemoteUnknown": true,
  "unknownToFlash": false,
  "peakHours": [[9, 12], [14, 18]],
  "budgetCapTokens": 0
}

• shortTaskMaxChars: 0 disables the short-task rule; peakDemoteUnknown: false disables peak-hour demotion; unknownToFlash: true sends ANY
  unmatched task to Flash (aggressive — leave false unless you are sure);
  budgetCapTokens: 0 disables the cap.
• Providers can also come from DSH_DELEGATE_ROUTER_FLASH_PROVIDER /
  DSH_DELEGATE_ROUTER_FLASH_MODEL / DSH_DELEGATE_ROUTER_PRO_PROVIDER /
  DSH_DELEGATE_ROUTER_PRO_MODEL env vars.
• Restart DSH after editing the file. Switch mode at runtime with
  /delegate <mode>.

Development

npm install
npm run smoke              # manifest sanity
node scripts/test-routing.mjs   # deterministic rule checks
node scripts/measure-savings.mjs # real savings over ~/.dsh/sessions
node scripts/e2e-panel-loop.mjs  # browser E2E against a test instance

License

MIT

Acknowledgements

Built for the DeepSeek Harness plugin ecosystem — thanks to the community on
LINUX DO for feedback and testing.