Preface¶
If you wish to operate DeepSeek Harness sessions in Discord DMs, guild text channels, or threads, you need a controller capable of bi-directionally connecting Discord with DSH.
dsh-discord is a plugin designed for this scenario: it provides bi-directional Discord bridging for DeepSeek Harness and maps Discord conversations to persistent DSH Sessions.
What is it¶
dsh-discord is maintained by suuuuuu-1, is released under the MIT license, and is version 0.1.0.
It provides Discord bridging and remote control capabilities for DeepSeek Harness: the Discord side can send natural text, slash commands, as well as images and text/code attachments; the DSH side can return status, progress, approvals, and structured questions.
The DSH ecosystem emphasizes “everything is a plugin”. The activation scope of dsh-discord is also limited: it only activates on a dedicated discord profile and binds to a single project chosen during setup; it does not activate automatically in every directory or the web profile.
Sessions and Triggers¶
dsh-discord uses a dedicated discord profile, supports one owner and one project, covering DMs, guild text channels, and threads.
The triggering rules are as follows:
- Owner DMs can trigger directly.
- Ordinary guild channel messages require an explicit bot mention.
- Bound threads can continue without repeating the mention.
- Slash commands do not require a mention.
Each Discord conversation has its own persistent DSH Session.
Control and Operational Capabilities¶
dsh-discord supports natural text control and also supports the following slash commands:
/dsh help/dsh status/dsh new/dsh stop/dsh steer
Operational capabilities include:
- coalesced progress
- approvals
- structured questions
- image and text/code attachment input
- durable event deduplication
- Gateway reconnect
- managed daemon operation
In terms of security, the plugin maintains a single-owner setup and is fail-closed. The Bot Token is stored only via DSH Credentials. dsh-discord doctor checks for the same permission set required for the Bot invite.
Installation and Enablement¶
First, ensure your local Node meets the engine requirements:
^22.19.0 || >=24.0.0
The installation instructions given in the README are: install the CLI from GitHub before the npm release is available. Below, we install the CLI first, then execute setup and doctor:
npm install --global github:suuuuuu-1/dsh-discord
dsh-discord setup --package-spec github:suuuuuu-1/dsh-discord
dsh-discord doctor
dsh-discord setup is used to establish Discord-side configuration and select the bound single project; dsh-discord doctor checks for the same permission set.
After the above steps, you can start in the foreground or use the managed daemon mode:
dsh-discord start
Or:
dsh-discord start --daemon
dsh-discord status
dsh-discord stop
The global CLI is just a launcher. The plugin itself only activates on a dedicated discord profile and binds to the single project chosen during setup.
The Bot page in the Discord Developer Portal needs Message Content Intent enabled for natural guild-channel messages. The Bot invite requires the following permissions:
- View Channel
- Send Messages
- Send Messages in Threads
- Read Message History
- Embed Links
- Attach Files
Typical Usage¶
After installation and enablement, common operations are as follows:
-
Send a message directly in an Owner DM to trigger DSH control.
-
In a normal guild text channel, send a message using an explicit bot mention.
-
Continue the conversation in a bound thread without repeating the mention.
-
Use slash commands to view help, status, new, stop, or steer:
/dsh help
/dsh status
/dsh new
/dsh stop
/dsh steer
- Continue processing approvals and structured questions returned by DSH within Discord; images and text/code attachments can be used as input.
Ordinary guild-channel messages require an explicit bot mention; slash commands do not require a mention.
Applicable Scenarios and Notes¶
dsh-discord is suitable for developers who need to remotely operate DeepSeek Harness in Discord, especially scenarios where they want to manage DSH Sessions in DMs, guild text channels, and threads.
Before using it, please note:
- The plugin runs with the permissions of the current DSH process; you should check the source code and license before installation.
- It maintains a single-owner setup and is fail-closed, requiring explicit mentions for ordinary guild channels.
- Natural guild-channel messages depend on Message Content Intent.
- The Bot Token is stored only via DSH Credentials.
- The current version is
0.1.0, and the Node engine requires^22.19.0 || >=24.0.0. - The README states that the CLI should be installed from GitHub before the npm release is available.
Links¶
- GitHub: https://github.com/suuuuuu-1/dsh-discord
- DSH Marketplace directory page: https://dshmarketplace.dev/plugins?q=dsh-discord
The DSH Marketplace is an independent community directory with no official affiliation to DeepSeek / Fangfang; it is not an official app store.