前言¶
如果你希望在 Discord 的 DM、guild 文本频道或 thread 中操作 DeepSeek Harness 的会话，就需要一个能双向连接 Discord 与 DSH 的控制器。
dsh-discord 就是为这个场景准备的插件：它为 DeepSeek Harness 提供双向 Discord 桥接，并把 Discord 对话映射到持久化的 DSH Session。
这是什么¶
dsh-discord 由 suuuuuu-1 维护，采用 MIT 许可证，版本为 0.1.0。
它为 DeepSeek Harness 提供 Discord 桥接和远程控制能力：Discord 端可以发送自然文本、slash 命令以及图片和文本/代码附件；DSH 端可以返回状态、进度、审批和结构化问题。
DSH 生态强调「一切皆插件」。dsh-discord 的激活范围也有限定：它只在专用 discord profile 激活，并绑定 setup 时选择的单个 project；不会在每个目录或 web profile 自动激活。
会话与触发方式¶
dsh-discord 使用专用 discord profile，支持一个 owner 和一个 project，覆盖 DM、guild 文本频道和 thread。
触发规则如下：
- Owner DM 可以直接触发。
- 普通 guild 频道消息需要显式 bot mention。
- 已绑定的 thread 可以继续，无需重复 mention。
- Slash 命令无需 mention。
每个 Discord 对话拥有独立持久化 DSH Session。
控制与运行能力¶
dsh-discord 支持自然文本控制，也支持以下 slash 命令：
/dsh help/dsh status/dsh new/dsh stop/dsh steer
运行能力包括：
- coalesced progress
- approvals
- structured questions
- 图片和文本/代码附件输入
- durable event deduplication
- Gateway reconnect
- managed daemon operation
安全方面，插件保持 single-owner 且 fail-closed。Bot Token 仅通过 DSH Credentials 存储。dsh-discord doctor 会检查 Bot invite 所需的同一权限集。
安装与启用¶
先确认本机 Node 满足引擎要求：
^22.19.0 || >=24.0.0
README 给出的安装说明是：在 npm release 可用前，从 GitHub 安装 CLI。下面先安装 CLI，再执行 setup 和 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 用于建立 Discord 侧配置，并选择绑定的单个 project；dsh-discord doctor 检查同一权限集。
经过上面的步骤后，可以前台启动，也可以使用 managed daemon 模式：
dsh-discord start
或：
dsh-discord start --daemon
dsh-discord status
dsh-discord stop
全局 CLI 只是 launcher。插件本身只在专用 discord profile 激活，并绑定 setup 时选择的单个 project。
Discord Developer Portal 的 Bot 页面需要启用 Message Content Intent，用于自然 guild-channel 消息。Bot invite 需要以下权限：
- View Channel
- Send Messages
- Send Messages in Threads
- Read Message History
- Embed Links
- Attach Files
典型用法¶
安装并启用后，常见操作如下：
1、在 Owner DM 中直接发送消息，用于触发 DSH 控制。
2、在普通 guild 文本频道中，使用显式 bot mention 发送消息。
3、在已绑定 thread 中继续对话，不需要重复 mention。
4、使用 slash 命令查看帮助、状态、新建、停止或转向：
/dsh help
/dsh status
/dsh new
/dsh stop
/dsh steer
5、对 DSH 返回的 approvals 和 structured questions 在 Discord 中继续处理；图片与文本/代码附件可作为输入进入。
普通 guild-channel 消息需要显式 bot mention；slash 命令无需 mention。
适用场景与注意¶
dsh-discord 适合需要在 Discord 中远程操作 DeepSeek Harness 的开发者，尤其是希望在 DM、guild 文本频道和 thread 中管理 DSH Session 的场景。
使用它之前需要注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- 它保持 single-owner 且 fail-closed，普通 guild 频道需要显式 mention。
- 自然 guild-channel 消息依赖 Message Content Intent。
- Bot Token 仅通过 DSH Credentials 存储。
- 当前版本为
0.1.0，Node 引擎要求^22.19.0 || >=24.0.0。 - README 说明在 npm release 可用前，从 GitHub 安装 CLI。
链接¶
- GitHub：https://github.com/suuuuuu-1/dsh-discord
- DSH Marketplace 目录页：https://dshmarketplace.dev/plugins?q=dsh-discord
DSH Marketplace 是独立社区目录，与 DeepSeek / 幻方无官方从属关系；它不是官方应用商店。
