c-ling/dsh-plugin-notify
DeepSeek Harness 消息提醒插件：回合结束或等待确认时向浏览器、系统、飞书/钉钉/企业微信/通用 Webhook 发送通知
安装Install
npx @deepseek-ai/dsh plugin --profile web add "github:c-ling/dsh-plugin-notify#v1.3.0"把 c-ling/dsh-plugin-notify 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-plugin-notify
DeepSeek Harness Web GUI 的消息提醒插件：任务回合执行结束、或执行到需要用户确认时，按配置向所选渠道发送提醒，并在设置面板提供「消息提醒」菜单页。
渠道
| 渠道 | 位置 | 说明 |
|---|---|---|
| 浏览器通知（页面内横幅）＋ 系统原生通知（可选） | 客户端 | 两个独立设置项：「浏览器通知」在页面可见时于右上角弹出文字横幅；「系统原生通知」通过浏览器 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/web
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 地址与通用请求头以明文保存，请勿在其中放置敏感凭据（除飞书/钉钉签名密钥外）。
开发
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— 脱敏后的当前配置 + secretSetPOST /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 时仍回退经典存储；飞书/钉钉签名密钥改为 schemarole('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
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…