OPaimon/dsh-model-gate

dsh-model-gate

English | 中文

Single-model disable gate for DSH. Deny whole provider routes or exact provider/model pairs - denied models disappear from every discovery path and any dispatch that still reaches them terminates with an in-protocol MODEL_DISABLED error chunk.

Non-destructive by design: nothing in your provider configuration or credentials is touched. The denylist is an independent overlay; removing an entry (or the plugin) restores everything exactly as it was.

Screenshots

Settings panel — the「模型门禁」section reads the UNFILTERED catalog through the plugin's own typert service: one collapsible group per provider, one switch per model row, enabled-count badge on the group header.

Discovery hiding — deny a model and it disappears from the web selector and every other discovery path; the current selection clears with it.

Dispatch backstop — a turn that still reaches a denied model (subagents, session titles, stale references) ends with the in-protocol MODEL_DISABLED error chunk; no network request is issued.

Install

From npm - one command:

dsh plugin --profile web add dsh-model-gate

Or from a Release tarball - download dsh-model-gate-<version>.tgz, unpack it, and point the official installer at the unpacked directory (the tgz ships prebuilt lib/, so no build step and no pnpm allowBuilds prompt):

tar -xzf dsh-model-gate-0.1.2.tgz    # -> ./package/
dsh plugin --profile web add ./package

Then restart DSH once so the bundle layer picks up the new entry. Every denylist edit afterwards hot-applies through settings - no further restarts. Verified against DSH 0.1.x-rc.

Usage

Edit the denylist section in ~/.dsh/settings.yaml - changes hot-apply, no restart:

llm-model-gate:
  disabledProviders:
    - openrouter
  disabledModels:
    - "*/kimi-k2.7-code"        # deny this model id on every provider
    - "token-rhythm/glm-5"      # deny one exact provider/model pair

Matching is exact and case-sensitive. A disabled provider route hides all of its models. Model ids listed with a * + slash prefix are denied on every provider, including dedicated routes (e.g. DeepSeek direct) that accept explicit directory-external ids.

Settings UI

The web settings page has a dedicated「模型门禁」section (one collapsible group per provider, one switch per model row). The panel reads the UNFILTERED catalog through the plugin's own typert service, so currently denied models render as off and can be turned back on; toggling writes the denylist through the same hot-apply settings chain as manual YAML editing.

Row-state notes:

• A row is off when its exact pair, a */model star rule, or the whole provider route denies it; the reason is tagged on the row.
• Turning a star-denied row back on removes the covering star rule for every provider (the denylist has no per-provider exceptions); the panel re-renders from the returned state, so affected rows visibly flip together.
• Provider headers show an enabled-count badge; row switches are authoritative.

Semantics

• Discovery (primary): the web selector, session.models / llm.models catalogs, task_models, and API request validation all read the filtered view - a disabled model behaves as if it had never been configured. Re-enable and it reappears on the next refresh.
• Dispatch (backstop): any path that still dispatches a denied model - subagents, session-title, custom routing, explicit ids - is stopped at the public llm/stream waterfall with a single terminal finish{kind:"error", code:"MODEL_DISABLED"} chunk. The turn ends with a normal model error; no network request is issued.
• If the disabled model is the current session or default model, the next request on it fails; nothing switches automatically. Failover-style plugins listening on agent/request-error compose naturally.

Boundaries

• Vision-router clones are separate route keys: disabling openrouter does not disable openrouter-vision - list both if you want both.
• Providers stay installed; only their public listing is filtered. Provider configuration surfaces (adding/editing providers) are unaffected.
• Bypassing the DSH LLM service entirely (direct HTTP) is outside DSH.
• Uninstalling removes the bundle entry; the plugin restores the native listProviders/listModels methods on unload with zero residue. A leftover denylist section in settings.yaml is harmless.

License

MIT. An independently distributed plugin: DSH itself is untouched and keeps its own license.

Development

bash scripts/build.sh     # requires DSH_CHECKOUT or ~/dsh-harness; also shims node_modules/.bin/tsdown
npm run build:client      # bundle src/client/main.tsx -> lib/client.js (ModuleLoader wrapper)
npm test                  # unit tests (node:test) against lib/ - run the build first on a fresh clone

Tests import the compiled lib/ outputs (relative ESM imports in source need tsc's .js rewriting, which node's type stripping does not perform), which resolves the host packages through the symlinks that scripts/build.sh creates - run the build first on a fresh clone.

Inside a super-injector environment: dev_inject_plugin <this dir> then dev_reload_package to iterate without restarting.