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, plus /delegate status to print the routes in force.- 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)
- explicit per-call
provider/model → used as-is (manual)
/delegate off → inherit; /delegate flash-all → all Flash- session tokens over
budgetCapTokens → Flash (budget)
- keyword dominance scoring: heavy wins ties, but a strictly-light task
beats one incidental heavy word (
auto-heavy / auto-light)
- task text ≤
shortTaskMaxChars → Flash (auto-short)
- unmatched + Beijing peak hours (default 9–12, 14–18) → Flash (
peak)
- unmatched +
unknownToFlash: true (opt-in, aggressive) → Flash (auto-unknown)
- 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.1-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.
- Config edits apply to the next delegation — no DSH restart needed. Switch
mode at runtime with
/delegate auto | off | flash-all, and print the routes
in force with /delegate status.
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.
