消息提醒插件c-ling/dsh-plugin-notify

dsh-plugin-notify

DeepSeek Harness Web GUI 的消息提醒插件：任务回合执行结束、或执行到需要用户确认时，按配置向所选渠道发送提醒，并在设置面板提供「消息提醒」菜单页。

English

dsh-plugin topic
license

渠道

| 渠道 | 位置 | 说明 |
| --- | --- | --- |
| 浏览器通知（页面内横幅）＋ 系统原生通知（可选） | 客户端 | 两个独立设置项：「浏览器通知」在页面可见时于右上角弹出文字横幅；「系统原生通知」通过浏览器 Notification API 弹出操作系统通知，标签页在后台/最小化时也能收到（需浏览器通知权限）；完全离开页面时请配合系统通知使用 |
| 系统通知 | 宿主机 | macOS osascript / Linux notify-send / Windows PowerShell 原生 toast（Windows 10/11 操作中心），浏览器关闭也能收到；可选系统提示音（macOS afplay / Windows 系统内置提示音） |
| 飞书群机器人 | 宿主机 | 文本消息，可选签名密钥（timestamp + HMAC-SHA256），可选自定义消息模板 |
| 钉钉群机器人 | 宿主机 | 文本消息，可选加签（timestamp + sign），可选自定义消息模板 |
| 企业微信群机器人 | 宿主机 | 文本消息，可选自定义消息模板 |
| 通用 Webhook | 宿主机 | 自定义 URL + headers + JSON/文本模板，占位符 {{title}} {{body}} {{kind}} {{sessionId}} {{turn}} {{toolName}} {{reason}} {{time}}，可对接 Slack / Discord / ntfy / Bark / Server酱 / PushPlus 等 |

消息格式

所有 Webhook 渠道共用同一套占位符：{{title}} {{body}} {{kind}} {{sessionId}} {{turn}} {{toolName}} {{reason}} {{time}}。

- 飞书/钉钉/企业微信默认使用统一格式（标题 + 详情 + 会话 + 本地时间），在设置页的「消息模板」留空即用默认；填写后按你的模板渲染。
- 通用 Webhook 的模板留空时发送纯文本消息正文。

触发

- turn/end：回合结束，按 triggers.turnEndKinds 过滤（completed/blocked/aborted/error，默认 completed+blocked）。
- approval/asked：工具调用等待用户审批（宿主机渠道）。
- tool/call（name 为 ask_user_question）：模型通过提问工具向用户提问，等待用户回答（宿主机渠道）。
- 浏览器渠道额外覆盖等待用户确认的交互（审批/提问，来自会话快照的 pending 列表）。

宿主机的系统/Webhook 渠道覆盖所有会话；浏览器渠道跟随当前打开的会话。

安装

从 GitHub 安装到 web profile（需要 pnpm 在 PATH 上；没有则用下面的 corepack 方式）：

npx @deepseek-ai/dsh plugin --profile web add "github:c-ling/dsh-plugin-notify#v1.3.0"

或使用已有的 dsh 命令：

dsh plugin --profile web add "github:c-ling/dsh-plugin-notify#v1.3.0"

pnpm 不在 PATH 上时：

cd ~/.dsh/profiles/web
corepack pnpm add "github:c-ling/dsh-plugin-notify#v1.3.0"

dsh plugin 把参数原样转发给 pnpm，直接从本仓库拉取包（pnpm 9+，本机需装有 git）。
安装时若看到 declares no dsh.bundle — installed as a plain dependency 的提示属正常现象：
本插件不是 profile bundle 层，而是通过下面的 loader 行激活。

然后在 ~/.dsh/profiles/web/cordis.patch.yml 增加一行插入：

- insert:
- id: notify
name: 'dsh-plugin-notify'

重启 dsh web（client-modules 按进程缓存包裁决，新包必须重启宿主），然后硬刷新页面。
设置页位于「设置 → 消息提醒」。

验证

curl -s http://127.0.0.1:3080/plugins/dsh-plugin-notify/client.js | head -c 60

应输出 window.__ModuleLoader__.load({ 开头的 factory bundle；设置页「设置 → 消息提醒」可配置并逐渠道发送测试消息。

更新

dsh plugin --profile web add "github:c-ling/dsh-plugin-notify#v1.3.0"
或：npx @deepseek-ai/dsh plugin --profile web add "github:c-ling/dsh-plugin-notify#v1.3.0"
或：cd ~/.dsh/profiles/web && corepack pnpm add "github:c-ling/dsh-plugin-notify#v1.3.0"

用新的 #v1.3.0 重新执行安装命令即可升级依赖；cordis.patch.yml 中的 loader 行保持不变。
重启 dsh web，然后硬刷新页面。

卸载

cd ~/.dsh/profiles/websh
corepack pnpm remove dsh-plugin-notify   # 或 dsh plugin --profile web remove dsh-plugin-notify

同时删除 cordis.patch.yml 中对应的 insert 行，然后重启 dsh web。
配置数据保存在 Harness 设置文档 $DSH_HOME/settings.yaml 的 dsh-plugin-notify: 段（回退存储在 $DSH_HOME/storages/dsh-plugin-notify/），删除该段与目录即可彻底清除。

配置存储

自 v1.3.0 起配置优先存入 Harness 官方设置服务：挂载了 settings provider 的环境里，配置写入 $DSH_HOME/settings.yaml 的 dsh-plugin-notify: 命名空间（宿主端经 installSettingsSection 注册，浏览器端通过 settingsScope 镜像响应式读取）；没有 settings provider 时自动回退到经典存储 $DSH_HOME/storages/dsh-plugin-notify/config.json（可通过插件行的 config.directory 覆盖）。升级后首次启动会把既有 config.json 作为 base 一次性迁移，无需手动操作。

飞书/钉钉签名密钥按 schema 声明为 role('secret') 只写字段：设置文档与所有 wire 面都看不到明文，只暴露「是否已配置」标记；接口读回空串并用 secretSet 标记，写入时空串表示保持不变，clearSecrets 列出要清除的路径。Webhook 地址与通用请求头以明文保存，请勿在其中放置敏感凭据（除飞书/钉钉签名密钥外）。

开发
sh
node --check lib/index.js lib/client.js
node --test

客户端为手写 factory-CJS bundle（window.__ModuleLoader__.load({ id: "dsh-plugin-notify", factory })），无构建步骤；UI 通过 settings.section 与 shell.overlay 插槽注册。宿主端对 @deepseek-ai/dsh-settings / @deepseek-ai/schemastery 做惰性可选导入（包不可解析或无 settings provider 时自动回退 config.json），通过 webServer 服务注册三条路由并订阅 session/event 事件流。

接口：

- GET  /dsh-plugin-notify/config — 脱敏后的当前配置 + secretSet
- POST /dsh-plugin-notify/config — { config, clearSecrets? } 整体替换用户可编辑配置
- POST /dsh-plugin-notify/test — { channel: "system" | "feishu" | "dingtalk" | "wecom" | "generic", genericId? } 发送测试消息

更新日志

- v1.3.0 — 适配 DeepSeek Harness 0.1.1（迁移 A）：配置优先存入官方设置文档 $DSH_HOME/settings.yaml（installSettingsSection + settingsScope 响应式读取），旧 config.json 自动作为 base 迁移、无 settings provider 时仍回退经典存储；飞书/钉钉签名密钥改为 schema role('secret') 只写字段，设置文档与 wire 面均不可见明文；浏览器端外部配置变更（其他标签页/手改 YAML）现在实时生效，无需刷新。
- v1.2.0 — 宿主机渠道支持 ask_user_question 提问通知：模型调用 ask_user_question 时，系统通知与飞书/钉钉/企业微信/通用 Webhook 会发送「等待回答」提醒；修复浏览器原生通知因固定 tag 导致连续审批/提问只显示首条的问题。
- v1.1.3 — README 结构规范化：默认 README.md 改为中文，英文文档移至 README-en.md（删除 README-ZH.md），安装命令统一固定到 #v1.1.3。
- v1.1.2 — README 拆分为默认英文 README.md + 中文 README-ZH.md（顶部互相切换），补充 npx @deepseek-ai/dsh plugin ... 安装方式与「更新」章节，安装命令统一固定到 #v1.1.2。
- v1.1.1 — 修复「设置 → 消息提醒」页在黑夜模式下的样式：保存按钮、开关、卡片/输入框边框、状态文字等统一改用 --dsw-alias-* 设计变量，跟随明暗主题。
- v1.1.0 — 新增浏览器系统原生通知、Windows 系统通知与提示音，浏览器与原生通知拆分为独立设置项。
- v1.0.0 — 首个 GitHub 版本：浏览器横幅、系统通知、飞书/钉钉/企业微信/通用 Webhook 渠道与设置页。

已知限制

- 浏览器渠道默认是页面内文字横幅；开启「系统原生通知」后，标签页在后台或窗口最小化时也会通过浏览器 Notification API 弹出系统通知（需要浏览器通知权限，且浏览器必须保持运行）。浏览器完全关闭时请使用宿主机系统通知渠道。
- 飞书/钉钉签名密钥仅做「只写 + 读回脱敏」，保存在本地 settings.yaml（或回退 config.json）中但未加密；请勿在通用 Webhook 的地址或请求头中放置其他敏感凭据。

License

MIT