dsh-plugin-model-dispatch
DSH 插件：为主代理、子代理和计划模式按会话切换模型与思考强度
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:kolawong/dsh-plugin-model-dispatch#7f9d671e9da05486e62eabef640d3a2f2a0f7c00Plugin Model Dispatch 以 dsh-plugin-model-dispatch 发布，当前版本为 1.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
Give the main model, your subagents, and plan mode their own model and reasoning effort — from the chat bar, in one menu.
DeepSeek Harness ships a model picker for the main model. This plugin keeps that control and adds the two routes it does not cover — the model that delegated subagents run on, and the model plan mode thinks with — then puts all three in one menu that behaves like a native control.
| Route | Set it from | Applies to |
|---|---|---|
| Main model | chat-bar main chip · settings row 1 | the current session, through the native DSH switching API |
| Subagent model | chat-bar subagent chip · settings row 2 | subagents started later in this session |
| Planning model | settings row 3 | plan mode only; the pre-plan main model is restored afterwards |
Two composer chips, wearing the host's own material. The input bar carries a main chip (the host's model glyph) and a subagent chip (a branch glyph); the icon alone tells them apart, while the tooltip and accessible name keep the full Main · model · effort label. Both are borderless 28px chips that only show a surface on hover, exactly like the neighbouring native controls. While the subagent route inherits, its chip reads Follows main instead of repeating the main model name.
One menu for every route. Search across models and providers, provider groups, favorites, recents, and reasoning effort — the same menu is used by the chat bar and the settings rows. It is built from the host menu's material (translucent blurred card, elevation shadow, 4px padding, 34px rows, 13px type, l2 hairlines), so it reads as a first-party control rather than a plugin overlay.
Reasoning effort as a discrete slider. One stop per level, plus a leading provider default stop so "don't specify an effort" is a visible state instead of hidden behaviour. The scale is drawn under the rail (so it never seams the filled run), the current level is named in the header row, and the control is draggable and keyboard-operable.
Live apply — no confirm row. A model pick, a slider move, or a restore writes through immediately. A slider drag coalesces into a single write when it settles, writes are serialized, and a failed write rolls the row back and shows the real error. The menu stays open, so picking a model can be followed straight by an effort change; Esc or a click outside only closes the menu and never undoes a live choice.
Plan-mode auto switching. Entering plan mode switches to the planning model; approving the plan or /plan off restores the pre-plan main model and effort before the first execution request. The review panel shows which model will be restored.
Per-session subagent overrides. A chat-bar subagent pick is stored as a durable override for that session and never touches the settings default; one click restores the settings default.
Requires DeepSeek Harness 0.2.0-rc.2 (other 0.2.x versions need a compatibility check — see Compatibility).
dsh plugin --profile web add git@github.com:kolawong/dsh-plugin-model-dispatch.git
Replace web with the profile you actually use (desktop, …). Then fully quit and reopen DSH: the host half needs a recomposition, and refreshing the page only reloads the client half.
lib/ in this repository holds the prebuilt host and client bundles, so installing needs no local build step.
// <DSH_HOME>/profiles/<profile>/package.json
{
"dependencies": { "dsh-plugin-model-dispatch": "link:/path/to/dsh-plugin-model-dispatch" },
"dsh": { "profile": { "bundles": ["…", "dsh-plugin-model-dispatch"] } }
}
Create the matching node_modules link (the profile directory is the resolution anchor), then restart DSH.
Two chips sit at the right of the composer, next to the permission and preset controls:
| Chip | What it does |
|---|---|
| Main (model glyph) | Switches the current session's model through the native API. The chip shows the effective route and its effort in the tooltip. |
| Subagent (branch glyph) | Picks the model for subagents started later in this session, stored as a session override. Reads Follows main while nothing is overridden. |
Opening either chip gives the same menu: search, provider groups, favorites (★, hover-revealed, remembered per browser), recents, the effort slider, and — for the subagent route — a restore to settings default row.
Web settings → 模型切换 / Model switch holds three rows, each with a one-line scope hint:
| Row | Meaning |
|---|---|
| New-session default model | Written to the native agent-default-model entry. Changing the model inside a chat does not change it. |
| Subagent default model | Used by subagents of any session that has no override. |
| Planning model | Used while plan mode is active. |
provider / model / reasoningEffort atomically and switches to the planning model./plan off) restores that saved route before the first execution request is assembled.| Decision | Precedence (highest first) |
|---|---|
| Subagent model | session override → settings default → native parent-model inheritance → explicit start options in the tool call |
| Plan model | planning model while plan mode is active → restored session route afterwards |
| Main model | session selection (native API) → new-session default from settings |
Defaults and sessions stay independent: the settings rows store new-session defaults, while chat picks and plan switches only affect the current session. The host adapter isolates the native selectModel "save as deployment default" side effect with AsyncLocalStorage, so only that call chain is intercepted.
| Data | Location |
|---|---|
| Settings defaults (subagent default, planning model) | DSH profile config (volatile fields — editable from the settings page or the config file) |
| New-session main-model default | The native agent-default-model entry |
| Session subagent overrides | $DSH_HOME/storages/model-switch/session-overrides.json |
| Pre-plan main model (cleared after a successful restore) | $DSH_HOME/storages/model-switch/plan-main-models.json |
| Menu favorites / recents | Browser localStorage (per browser, not synced) |
0.2.0-rc.2. The plugin follows the 0.2.x extension surfaces (volatile Config + configForms, session projections, the session model-selection API, planMode) and patches nothing in the DSH core, so one-click upstream upgrades stay painless.start / startContinuable (rc.2) and startActivation (newer hosts). On a host that only exposes startActivation, 1.0.x is silently bypassed into plain parent-model inheritance.lib/client.js) and needs the host half loaded; a page refresh alone is not enough after a first install.pnpm install
pnpm test # vitest — 69 tests
pnpm build # tsc (host + client projects) + tsdown client bundle
Iterating on the UI only:
./node_modules/.bin/tsc -p tsconfig.client.json && ./node_modules/.bin/tsdown
Test coverage: route-merge precedence, session-override storage and concurrent writes, plan-boundary enter / restore / restart / reject paths, session-versus-default selection isolation, route validation rejections, client save races, stale-catalog adaptation, and concurrent delegation isolation.
tsc -p tsconfig.json(the host project) type-checks against the@deepseek-ai/*peers that the profile resolves. If this package's ownnode_moduleshappens to hold a second copy of those packages, branded types differ between the copies and the host project reports mismatches; the client project, the bundle build, and the test suite are unaffected.
| Symptom | Cause / fix |
|---|---|
| Chips or settings rows missing after install | The host half was not recomposed — fully quit and reopen DSH (a page refresh only reloads the client half). |
| Subagents always use the parent model | On hosts newer than rc.2 this needs ≥1.1.0 (see Compatibility); also check that no stale start-only host is in use. |
| A model is missing from the menu | The provider failed to load its catalog — the menu header shows a partial-catalog warning and the model appears once the provider responds. |
| Saving reports an invalid route | The combination is not in the provider's live catalog; pick the model from its own provider group and retry. |
| Settings changed but a chat did not | Expected: chat picks and plan switches are per-session, settings rows are new-session defaults. |
configForms, session projections, session controller, plan mode) — re-run the suite after a DSH upgrade.exit_plan_mode result wording; a DSH wording change delays the restore (the plan/mode event is the fallback).localStorage); they are not part of the session or the profile.Every catalog model is delegatable. Subagent routing reads the host's live model catalog, so an explicit child selection and list_subagent_models keep working in existing sessions even when rc.2 captured an older allowlist. Models added later are available on the next delegation; removed routes and unsupported efforts are rejected up front.
Route validation before saving. Overrides and child creation validate the exact provider/model/effort through the host's resolveCallConfig; an invalid combination fails immediately with the real reason instead of failing inside a run.