Preface¶

The extension philosophy of DSH can be understood as “everything is a plugin”: the host provides the runtime, while plugins extend session, model, sub-agent, tool, and panel capabilities. The community directory is an independent site with no official affiliation to DeepSeek / High-Flyer.

As the number of plugins grows, common issues go beyond just “can it be installed” — they also include scattered installation formats, whether dynamic plugins are restored after restart, how model routing and sub-agent delegation are centrally managed, and whether there is a unified entry point for sessions, skills, and plugin states. dsh-forge is a DSH runtime extension suite built around these challenges.

What This Is¶

dsh-forge is a set of DSH extensions maintained by alex04130, positioned as a runtime extension suite for DeepSeek Harness: much like Forge for Minecraft, it forges, installs, routes, and orchestrates plugins for DSH.

Its capabilities include:

• Plugin marketplace and installer
• Task-aware thinking-mode routing
• Skill manager
• Plugin management panel
• Session management
• Collaborative orchestration
• Model delegation and routing
• Runtime injection and dynamic plugins
• Archive, plasmid, and verification

Basic information:

• License: MIT
• Runtime requirements: Node >=22
• GitHub: https://github.com/alex04130/dsh-forge

Core Features¶

Plugin Marketplace and Installer¶

This part addresses where to find plugins, how to install them, and how they are loaded after installation.

Confirmed capabilities include:

• Browse community plugins under the GitHub dsh-plugin topic
• One-click installation of four forms: npm package / dynamic manifest / preset / bundle
• Hot-reload via injector
• Persistent registry

Task-Aware Thinking-Mode Routing¶

This part is provided by the router-standard preset.

Its flow is:

1. Classify the first message into categories including spec / react / weak.

2. Perform minimal anchoring in the first round.

3. Release the full tool set after the first tool/call.

Note: First-round anchoring only takes effect for deepseek series models.

Skill Manager¶

The Skill Manager is used for unified skill management.

Confirmed capabilities include:

• Persistent add, remove, enable, and disable
• Content preview
• Settings page panel
• Dual channel of model and tools

Plugin Management Panel¶

The Plugin Management Panel is used to view and manage currently discoverable plugin entries.

Confirmed capabilities include:

• Real-time discovery of host / injected / official loader entries
• Dynamic plugin run, stop, and delete
• Search
• Partition navigation

Session Management¶

Session management is provided by mailbridge.

Confirmed capabilities include:

• Session list
• Search
• Archiving
• Retrieval
• Export
• mailbox inspection

Collaborative Orchestration¶

Collaborative orchestration is provided by teamhub.

Confirmed capabilities include:

• captain + member sub-agents
• Dependency-ordered task board
• Direct messaging between members

Known limitations:

• Tasks claimed on behalf of members by the captain cannot be updated by the members themselves
• Approval waits for team_create / team_add_member will serially block other team_* calls

Model Delegation and Routing¶

This part is handled by components such as llmrouter / modelroute / modsub.

Confirmed capabilities include:

• Multi-vendor model_list / model_call
• Model family taxonomy
• Sub-agent model inheritance policy
• spawn sub-agents with specific models

Runtime Injection and Dynamic Plugins¶

Runtime injection and dynamic plugins extend DSH’s loading mechanisms.

Confirmed capabilities include:

• injector runtime injection
• dynboot / dynrestore restart recovery
• Dynamic panels
• Patch-type plugins

Archive, Plasmid, and Verification¶

This part provides evidence, retrieval, and verification capabilities.

Confirmed capabilities include:

• archive evidence handle
• plasmid self-recommended retrieval suitability
• verify_claim verification for git-commit / file / text-in-file

Installation and Activation¶

npm Package Installation¶

Use the following commands for npm package installation:

dsh plugin --profile web add @dsh-forge/bundle
dsh web

The first step installs @dsh-forge/bundle, and the second step restarts DSH.

Version requirements:

• @dsh-forge/bundle requires 0.1.4+
• 0.1.3 and earlier versions fail to boot under the npm path — this is a known historical bug

Enabling the Routing Preset¶

If you want to enable the task-aware routing preset, first copy the preset:

cp -r presets/router-standard $DSH_HOME/.agent-presets/

Then create a new session and select the “Router Standard (Experimental)” preset.

Note: The npm bundle does not include presets or dynamic panels; copy them from the source repository when needed.

Installing from Source¶

Source installation is suitable for scenarios requiring presets or dynamic panels:

git clone https://github.com/alex04130/dsh-forge.git
cd dsh-forge
node scripts/install.mjs
dsh web

Restart DSH after installation is complete.

Self-Check and Runtime Verification¶

First, run the code self-check:

npm run check

For runtime verification, check:

• dev_plugin_status
• skill_list
• model_taxonomy
• dev_router_status

Uninstallation¶

To uninstall the npm package:

dsh plugin --profile web remove @dsh-forge/bundle
dsh web

Typical Usage¶

Here is a common activation sequence:

1. Install the base suite via the npm package:

dsh plugin --profile web add @dsh-forge/bundle
dsh web

2. If task-aware routing is needed, copy the preset and create a new session selecting that preset:

cp -r presets/router-standard $DSH_HOME/.agent-presets/

3. If dynamic panels are also needed, copy them from the source repository:

git clone https://github.com/alex04130/dsh-forge.git
cd dsh-forge
node scripts/install.mjs
dsh web

4. Verify status:

npm run check

At runtime, continue checking dev_plugin_status, skill_list, model_taxonomy, and dev_router_status.

Applicable Scenarios and Notes¶

Suitable users:

• Developers who need to install and manage community plugins in DSH
• DSH users who need unified management of sessions, skills, model routing, and sub-agents
• Maintainers who need to inspect plugin runtime status

Notes before use:

• Plugins installed from the marketplace execute with host process privileges, with no sandbox isolation
• Only install repositories whose sources have been reviewed
• The dynamic client half disables fetch
• The panel data plane must go through host.call / harness.handle for private RPC wrapping
• npm 0.1.4’s insert does not include archive / verify / plasmid; these three require injector or will be automatically attached once written into insert in a future release
• The first-round anchoring of task-aware routing only applies to deepseek series models
• The GitHub MCP tool is not integrated by default; manual opt-in configuration is available and requires your own token
• teamhub has known limitations such as captain-claimed task update restrictions and serial blocking of approvals

Links¶

• Directory page: https://www.skillhub.cn/plugins/alex04130/dsh-forge
• GitHub: https://github.com/alex04130/dsh-forge