dsh-plugin-discord

dsh-plugin-discord

中文 | English

DeepSeek Harness（dsh）的 Discord 桥接插件：在手机或 Mac 的 Discord 里，和 DeepSeek 客户端任意一个工作区里的会话对话、接入桌面端正在用的会话、审批工具调用、回答模型的提问、随时停止任务。

它怎么工作

插件是一个标准的 dsh bundle，装进 DeepSeek 桌面端（或 dsh web）的 profile 后，直接运行在 Harness Host 进程里，调用的是桌面端界面本身用的同一套 Host API（ctx.sessionController、ctx.workspaceRegistry）：

• 从 Discord 新建的会话就是普通会话：立刻出现在桌面端侧边栏对应工作区下，用当前默认模型、默认 agent preset 和权限设置。
• 在桌面端打开的会话也可以从 Discord 接入（/attach），两边任意一端输入，回复都会同步到 Discord。
• 工具审批同时出现在 Discord（按钮）和桌面端，谁先点算谁的；Discord 先答时桌面端的审批框会自动收起。
• 模型用 ask_user_question 提问时也一样：问题同时出现在 Discord 和桌面端，先答完的一方生效。
• 不需要额外进程、不暴露任何端口，Discord bot 只做出站连接。

Discord 侧的映射：

1. 创建 Discord Bot

1. 打开 https://discord.com/developers/applications → New Application。
2. 左侧 Bot → Reset Token，复制 token。
3. 同页打开 Privileged Gateway Intents → MESSAGE CONTENT INTENT（必须，否则读不到消息正文）。
4. 左侧 OAuth2 → URL Generator：Scopes 勾选 bot 和 applications.commands；Bot Permissions 勾选 View Channels、Send Messages、Create Public Threads、Send Messages in Threads、Manage Threads、Read Message History、Add Reactions、Attach Files。用生成的链接把 bot 邀请进你自己的服务器。
5. 获取你的用户 ID：Discord 设置 → 高级 → 打开开发者模式 → 右键自己的头像 → 复制用户 ID。

私信 bot 的前提是你和 bot 在同一个服务器里。

2. 安装插件

方式 A：桌面端界面——侧边栏「插件」页 → 安装 → 「插件包名」填 dsh-plugin-discord → 安装完成后点「立即启用」。

方式 B：命令行（dsh web 或其他 profile）：

dsh plugin --profile <profile> add dsh-plugin-discord

git clone https://github.com/tjiisztiuv/dsh-plugin-discord.git
cd dsh-plugin-discord
npm install      # 或 pnpm install
npm run build    # 生成 lib/
dsh plugin --profile <profile> add "$PWD"

3. 配置 token

token 不写进配置文件，而是通过 dsh 的凭据系统读取（默认变量名 DISCORD_BOT_TOKEN）。任选一种：

• 写到 ~/.dsh/.env：DISCORD_BOT_TOKEN=xxxxx
• 或写到 ~/.dsh/.credentials.yaml（dsh 本地凭据库）

.env 只在桌面端启动时读取一次：写入或修改后要彻底退出（Cmd+Q）再重新打开，只在插件页重新启用读不到新值。变量名要和配置里的 tokenEnv 完全一致。

4. 填写配置（必须）

插件默认 allowedUserIds 为空，此时 bot 不会上线（日志里会提示）。在 profile 自己的 cordis.patch.yml 里覆盖 discord 这一行，例如桌面端是 ~/.dsh/profiles/desktop/cordis.patch.yml：

- id: discord
  config:
    tokenEnv: DISCORD_BOT_TOKEN
    allowedUserIds: ['123456789012345678']     # 你的 Discord 用户 ID
    stateFile: !!js dshHomePath('discord', 'state.json')
    defaultWorkspace: my-project                # 可选：没选工作区时默认用哪个（标题/路径/ID）
    # allowedGuildIds: ['...']                  # 可选：只在这些服务器响应
    # allowedChannelIds: ['...']                # 可选：只在这些频道（及其线程）响应

patch 会整体替换这一行的 config，所以要把需要的键都写全。保存后启用了 HMR 的 profile 会自动重载；否则重启桌面端。

全部配置项

使用

直接发消息 = 发给这里绑定的会话；没有绑定时，会在当前默认工作区新建一个会话（文字频道里会自动开线程）。图片附件会作为图片输入发给模型，其他附件以链接形式附在消息里。

斜杠命令的 workspace / session 参数都支持自动补全。全局命令首次注册后可能要等几分钟才出现在客户端里，期间可以先用文本命令。

回答模型提问

模型调用 ask_user_question 时，绑定的频道里会逐题出现问题卡片（一次问多个问题时答完一题出下一题）：

• 单选：每个选项一个按钮，点一下即回答；计划审阅（plan mode 的 exit_plan_mode）里表示批准的选项是绿色按钮。
• 多选：从下拉菜单里选一项或多项。
• ✏️ 其他… / ✏️ 回答… 弹出输入框写文字回答；跳过 跳过这一题。
• 也可以直接发消息回答：回复选项序号（多选用逗号分隔，如 1,3）、选项原文，或任意文字。问题等待回答期间，频道里的普通消息都会被当作回答。

桌面端开着时两边同时可答，先答完的一方生效，另一边的卡片会自动收起；桌面端没开时只在 Discord 回答。限时提问（tool-ask-user 配置为 mode: timed）超时后模型会先继续工作，卡片显示「等待超时」。

一个会话同一时间只绑定一个 Discord 位置：在别处 /attach 同一个会话时，原来的位置会收到「已转到 …」的提示。

安全须知

• 这个插件让 Discord 消息直接驱动你本机的 agent 读写文件、执行命令，等同远程 shell。务必配置 allowedUserIds，只把 bot 放进你自己的私人服务器。
• 审批策略沿用会话自己的权限预设；在完全放行（full access）的预设下不会出现审批。
• token 只放在本机凭据里，不要提交到仓库。

开发

npm run typecheck          # 类型检查
npm test                   # 单元测试（vitest）
npm run typecheck:compat   # 用旁边的 deepseek-harness 源码校验 src/dsh.ts 里的 Host API 类型是否仍然匹配

插件刻意不依赖具体版本的 @deepseek-ai/dsh-* 包：用到的 Host API 在 src/dsh.ts 里以结构类型声明，typecheck:compat 负责在 Harness 升级时发现不兼容。运行时只用到 Host 提供的 @deepseek-ai/cordis、@deepseek-ai/schemastery（peer 依赖）和 discord.js。

代码结构：

已知限制

• 限时提问超时后，补答只能在桌面端进行（Discord 卡片会提示）。
• 回复在每个模型步骤结束后整段发送，不做逐字流式编辑。
• token 写在 ~/.dsh/.env 时需要彻底重启桌面端才会上线；写在 ~/.dsh/.credentials.yaml 时在插件页重新启用即可。