Discord 通知 mrbeandev/dsh-discord-notify

dsh-discord-notify

为 DeepSeek Harness (DSH) 提供单向 Discord webhook 通知。

npm version
license

该插件可以在以下情况下通知 Discord 频道：

- 智能体回合开始；
- 智能体回合结束；
- 调用了选定的工具；或
- bash 工具命令匹配某个 JavaScript 正则表达式。

它仅向 Discord 发送消息。它不读取 Discord 消息、不暴露命令，也不允许 Discord 用户与 DSH 交互。

安全与隐私

- webhook URL 注册为 DSH 的 role('secret') 设置。它会从远程设置读取中移除，保存后绝不会返回给浏览器。
- 通过 allowed_mentions.parse: [] 禁用 Discord 提及。
- 默认排除工具参数，因为它们可能包含提示词、文件路径、令牌或其他敏感数据。
- 正则匹配的 bash 警报按设计会包含匹配到的命令文本。
- 投递失败会被记录，但不会打印 webhook URL 或请求正文。

请像对待密码一样对待 Discord webhook URL。如果它被泄露，请在 Discord 中将其撤销。

安装

dsh plugin --profile web add dsh-discord-notify

重启正在运行的 DSH web profile，然后打开：

Settings → Plugins → Plugin configuration → Discord notifications

用于本地开发：

dsh plugin --profile web add ./dsh-discord-notify

发布测试建议安装打包后的 tarball：

npm pack
dsh plugin --profile web add ./dsh-discord-notify-0.1.1.tgz

配置

设置折叠面板提供以下选项：

| 设置 | 默认值 | 行为 |
| Discord notification URL | 空 | 只写频道密钥；在配置之前不会发送任何通知 |
| Notification display name | DeepSeek Harness | 在 Discord 中显示的发送者名称 |
| Agent turn started | 关闭 | 为每个持久化的 turn/start 事件发送一条消息 |
| Agent turn ended | 开启 | 为每个持久化的 turn/end 事件发送一条消息，并包含其原因 |
| Selected tool calls | 关闭 | 当 tool/call 事件匹配所选工具过滤器时发送 |
| Tools to notify | 空 | 由每个健康智能体预设所暴露的工具构建的可搜索清单；为空表示所有工具 |
| Include tool arguments | 关闭 | 在所选工具警报中包含原始工具参数 |
| Regex-matched bash commands | 关闭 | 为 bash 工具启用命令特定匹配 |
| Bash command regular expression | 空 | 不带 / 分隔符的 JavaScript 正则语法 |
| Send test notification | — | 通过已保存的仅 Host 可用的 webhook 排队发送测试；未保存的编辑必须先保存或丢弃 |
| Advanced templates | 内置消息 | 按警报设置消息模板，具有严格允许且必需的变量 |

bash 模式示例：

^(npm test|pnpm run build)$

(deploy|publish|terraform apply)
无效、超大或可能造成灾难性后果的正则表达式以及非 Discord webhook URL 会在设置保存前被拒绝。正则匹配仅限于 bash 命令的前 16 KiB，以保护共享的 Host 事件循环。

模板变量

每种告警类型都有其各自允许的变量集。模板使用 {{variableName}} 占位符。Host 会拒绝未知变量、格式错误的占位符、空模板以及缺少必需变量的模板。

| 模板 | 可用变量 | 必需变量 |
| Agent 轮次开始 | sessionId、sessionName、workspaceName、turn | sessionId、turn |
| Agent 轮次结束 | sessionId、sessionName、workspaceName、turn、reason | sessionId、turn、reason |
| 选定的工具调用 | sessionId、sessionName、workspaceName、turn、step、toolName、arguments | sessionId、toolName |
| 匹配的 bash 命令 | sessionId、sessionName、workspaceName、turn、step、command | sessionId、command |
| 测试通知 | sentAt | sentAt |

动态值在插值前会被转义。sessionName 来自 DSH 的规范已记录会话标题，若不可用则回退到会话 ID。workspaceName 来自规范 Workspace 注册表成员关系，若不可用则回退到会话工作目录。arguments 和 command 已被格式化为有界的 Discord 代码块。

组合配置

该包通过 cordis.patch.yml 自行安装。手动等效配置为：

- insert:
- id: discord-notify
name: dsh-discord-notify
config:
notifyTurnEnd: true
notifyTurnStart: false
notifyToolCalls: false
toolNames: []
notifyBashMatches: false
bashRegex: ''
includeToolArguments: false
username: DeepSeek Harness

避免将 webhookUrl 放入已提交的组合配置中。请通过设置手风琴或私有本地配置文件进行配置。

事件语义

Host 插件观察 DSH 的规范提交后 session/event 事件流。这可在活动会话中提供精确、持久的 turn/start、turn/end 和 tool/call 事件。通知按事件顺序排队，并在不阻塞 agent 循环的情况下发送。

Host 解析每个健康 agent 预设的常驻作用域，并读取 ctx.tools.schemas(scope)。这些确切可调用名称的并集成为设置中可搜索的工具清单，并在 DSH tools/change 事件时刷新。之后消失的已选工具仍会显示为 Unavailable，以便将其移除。

bash 匹配是针对 bash 工具 JSON 参数中的 arguments.command 进行求值的。Bash 告警独立于通用工具调用过滤器，因此可以启用匹配命令的告警，而无需为每次 bash 调用启用通知。
测试按钮会递增一个经过验证的设置 nonce。其 Host watcher 渲染测试模板，并使用存储的 webhook secret 发送它；Client 永远不会收到该 URL。

开发

需要 Node.js ^22.19.0 或 >=24.0.0。初始兼容目标是 DSH 0.1.5-rc.2；该插件使用该版本的实时设置作用域和 session/event 契约。

npm install
npm run check

npm run check 会验证语法、运行测试，并检查 npm 包载荷。

发布

维护者应在运行本地发布门禁后，从干净的 main 分支手动发布：

npm ci
npm run check
npm audit --omit=dev
npm publish --dry-run --json
npm whoami
npm publish

最后一条命令会公开发布，因为 package.json 将 publishConfig.access 设置为 public。dry run 不会进行身份验证或发布。

发布后，将 dsh-discord-notify 从 npm 安装到干净的 DSH web 配置文件中，重启 DSH，并执行一次针对性的设置和 webhook 冒烟测试。

许可证

MIT