The philosophy behind DSH is “everything is a plugin.” When developing complex workflows with DeepSeek Harness, managing subagent dispatch specifications and asynchronous presets often requires manual maintenance of configuration files. The dsh-agent-instructions plugin reads $DSH_HOME/AGENTS.md and injects it as global instructions, but specification files and presets usually need to be synchronized separately.
This section introduces the sangning-h/dsh-farm-dispatch plugin. It packages the “subagent dispatch specification (Stingy Farm Owner Mode)” as a standard distribution package and, through a global synchronization mechanism, resolves the problems of fragmented presets and the difficulty of unifying specifications.
What Is This¶
The plugin is called dsh-farm-dispatch and is maintained by sangning-h. It is a global plugin designed to unify subagent dispatch behavior in DeepSeek Harness. By installing it, users can automatically obtain the full dispatch specification and asynchronous dispatch presets without manually copying files, thereby enforcing consistent dispatch discipline across all presets with agent-instructions.
Core Features¶
The plugin primarily addresses two core problems: specification synchronization and preset distribution.
- Includes the full dispatch specification: The plugin bundles
instructions/AGENTS.md, containing five sections: task assignment, the stingy principle, work step shapes, traceability and recovery, and asynchronous execution and acceptance. These contents are provided to the DSH engine via$DSH_HOME/AGENTS.mdas the single source of truth. - Automatic preset synchronization and override: On startup, the plugin automatically synchronizes
presets/cordis-async/(Creative Mode · Asynchronous Dispatch) to~/.dsh/.agent-presets/and registers the preset in the roster. - Global rules take effect: After installation, all presets with
agent-instructions, including Standard Mode (standard), PTC Mode (code), Creative Mode (cordis), and Creative Mode · Asynchronous Dispatch (cordis-async), automatically follow the global dispatch specification.
Installation and Activation¶
Installing this plugin requires specifying a profile. After installation, the plugin automatically synchronizes the presets/ directory to the local configuration directory on startup.
dsh plugin --profile <profile> add https://github.com/sangning-h/dsh-farm-dispatch.git
Replace <profile> with your profile name (the default is usually web).
After installing and restarting DSH, the cordis-async preset appears under ~/.dsh/.agent-presets/, and the “Creative Mode (Asynchronous Dispatch)” option appears in the roster.
Note: Installing the Specification File¶
The preset persona internally retains only a pointer to the global specification (“Full text in ~/.dsh/AGENTS.md”), and the plugin does not automatically overwrite an existing user AGENTS.md file. The full specification must be manually synchronized to the designated location to take effect:
# If ~/.dsh/AGENTS.md does not exist:
cp instructions/AGENTS.md ~/.dsh/AGENTS.md
# If you already have your own AGENTS.md: manually merge the contents of instructions/AGENTS.md
Typical Usage¶
After completing the installation and synchronization steps above, you can directly use the synchronized preset in conversations.
Installation:
dsh plugin --profile web add https://github.com/sangning-h/dsh-farm-dispatch.git
Synchronize specification:
cp instructions/AGENTS.md ~/.dsh/AGENTS.md
Verification:
Look for “Creative Mode (Asynchronous Dispatch)” in the DSH roster and confirm that it appears in the preset list.
Use Cases and Notes¶
- Coverage: The plugin takes effect for all presets with
agent-instructions, including Standard Mode, PTC Mode, Creative Mode, and Creative Mode · Asynchronous Dispatch. - Inapplicable scenarios:
- Minimal Mode (minimal): This mode does not naturally include subagent tools, so it is not applicable.
- Liangshen Mode (liangshen): This preset’s design logic only injects path hints and does not inject the full global specification, so it is not affected by this plugin.
- Version requirement: The plugin depends on DSH engine version
>=0.1.1-rc.2. - Permission note: The plugin runs with the permissions of the current DSH process. It is recommended to review the source code before installation.
Short Conclusion¶
dsh-farm-dispatch simplifies DSH workflow management costs by unifying the specification entry point and preset distribution path. It provides a single source of truth, $DSH_HOME/AGENTS.md, so modifying the dispatch specification only requires maintaining one file, and all related sessions automatically take effect in the next turn.
Project address: https://github.com/sangning-h/dsh-farm-dispatch