Introduction

In DeepSeek Harness (DSH), subagents can take on delegated tasks, but different tasks do not necessarily suit the same model. For example, simple retrieval, code editing, deep reasoning, and critical review have different requirements for model capabilities, latency, and cost. If there is no unified configuration, model selection, routing instructions, and backend result convergence are prone to being scattered.

dsh-subagent-model-router puts model aliases, routing instructions, subagent delegation, backend result waiting, and settings pages in the same DSH plugin. Below, we introduce what problem it solves, what capabilities it provides, and how to install and configure it.

What is this

dsh-subagent-model-router is a DSH plugin maintained by CypherNaught-0x, licensed under MIT. The package.json version in verified materials is 0.7.0, requiring DeepSeek Harness 0.1.0-rc.6 or a compatible version.

It targets the DSH Web profile and the built-in subagent conversation UI, used to configure “which subagent route uses which model,” “what tasks suit a certain model,” and after delegating background subagents, wait for terminal state results before entering aggregation or final answers.

Core Features

The plugin provides the following verified capabilities:

  • subagent_model: Delegation tool, model parameter limited to aliases configured by the user.
  • wait-for-subagents: Convergence tool, waits for unfinished sustainable background subagents for this agent, and returns terminal state results.
  • Model Routing Information: Embeds each model’s tags and routing instructions into the tool schema and system prompt for the orchestrator to select models.
  • model_subagent_catalog: Read-only view displaying models provided by registered LLM providers.
  • configure_subagent_models: Namespace-scoped model-side tool, can read or update plugin settings without needing filesystem access.
  • model-subagent-setup: Guiding skill used to select routes, generate routing instructions, confirm, and save via restricted configuration tools.
  • Web Settings Page: Settings → Subagent Models, allows manual addition, editing, and deletion of routes.
  • Configuration Namespace: Provides a hot-reloadable subagent-model-router namespace in ~/.dsh/settings.yaml.
  • Execution Forms: Supports foreground execution and sustainable background subagents.
  • UI Indicators: Displays active-model chip in the opened subagent header; displays active-model chips in the parent session subagent catalog health row; optionally displays inline model chip inside Better Sidebar’s Tasks row.
  • Better Sidebar Integration: No need to modify Better Sidebar source code; the extension remains lazy when not installed.

Boundary Behaviors:

  • When the models list is empty, the catalog, configuration, wait tools, and settings page/settings skills are still available, but subagent_model is not registered.
  • When other plugins already own or scope-shadow the wait-for-subagents name, the plugin retains that name and suppresses the wait-specific guidance and tracking for affected agents.

Installation and Enablement

First, confirm the environment meets the following conditions:

  • DeepSeek Harness 0.1.0-rc.6 or compatible version.
  • Web profile and built-in subagent conversation UI.
  • Preset exposing a normal skill loader/tool.
  • Host spawn subagent provider, included in standard DSH profiles.
  • Optional: Compatible dsh-better-sidebar release; verified materials explicitly mention 0.15.2 and 0.16.x support.

The installation command given in the README is as follows:

dsh plugin --profile web add dsh-subagent-model-router

Note: The README marks the npm installation as “once published,” and the publication status is not confirmed in verified materials. If installing from the current checkout, you can use:

dsh plugin --profile web add .

After installation, restart dsh web, then refresh the page.

Configuration Methods

There are two common paths for configuration: the Web settings page and the guiding skill.

  1. Open Settings → Subagent Models, or call:
/model-subagent-setup
  1. In the Subagent Models settings page, configure the following items:
  • model alias
  • display name
  • LLM provider route
  • exact model id
  • comma-separated routing tags
  • when to use description
  • optional per-model output-token caps
  • subagent backend
  • delegation depth
  • background execution
  1. You can also directly edit the subagent-model-router namespace in ~/.dsh/settings.yaml; materials state that this namespace supports hot reloading.

Regarding the settings interface for DSH rc.6: The built-in Web settings API only exposes a fixed namespace allowlist; therefore, the plugin uses a package-owned, same-origin Host endpoint. This endpoint defaults to rejecting non-loopback transmissions and cross-origin changes.

If accessing via a trusted loopback reverse proxy, you can use an environment variable to allow specific browser origins:

DSH_SUBAGENT_MODEL_ROUTER_TRUSTED_ORIGINS

Even if this environment variable is configured, requests must still reach via loopback, and each changed Origin must precisely match both the request Host and the allowlist source.

Typical Workflow

After the above installation and configuration, you can use it following the steps below:

  1. After installation, restart dsh web and refresh the page.
  2. Go to Settings → Subagent Models, or call /model-subagent-setup to complete model routing configuration.
  3. Initiate delegation in a session. If delegation is initiated via subagent_model, the model parameter can only select configured aliases.
  4. After completing the expected background delegation, the orchestrator must call wait-for-subagents before synthesizing sub-results or giving a final answer.
  5. View model identifiers in the UI: subagent header, parent session subagent catalog health row, and optionally the inline model chip inside Better Sidebar’s Tasks row.

Applicable Scenarios and Notes

This plugin is suitable for DSH Web plugin users who need unified management of DSH subagent model routing, settings page, configuration tools, and backend convergence behavior. It fits scenarios where users want model aliases, tags, usage descriptions, and delegation result waiting in the same set of configurations.

Do not treat unconfirmed information as fact: current materials do not explicitly state the starred count, nor the “model inference” category; the npm installation command in the README includes the phrase “once published,” and the publication status is unconfirmed.

The plugin will run with the current dsh process permissions; source code, license, and dependencies should be checked before installation. Current materials confirm the license is MIT, requiring DSH 0.1.0-rc.6 or compatible version, and using the Web profile, built-in subagent conversation UI, preset exposing a normal skill loader/tool, and Host spawn subagent provider. Better Sidebar is an optional integration; the relevant extension remains lazy when not installed.

Links

  • Community Directory: https://www.skillhub.cn/plugins/CypherNaught-0x/DSH-Subagent-Model-Router
  • GitHub: https://github.com/CypherNaught-0x/DSH-Subagent-Model-Router

The Community Directory is an independent site and should not be interpreted as an official app store; DeepSeek and Magic Unicorn have no official affiliation with this Community Directory.