Plugin directory / Desktop / dsh-notify
dsh-notify
Unverified haytham818
What it does
DSH system notification plugin: desktop notifications when an agent finishes a task, errors, asks a question, or waits for approval (dsh 系统通知插件)
No short evidence report
There is no checkable per-level test record on this page. Stars, the catalog test field, a web-only flag, and whether the plugin needs an external account or service are not shown here as a pass or a failure. The catalog badge stays as published.
“Unverified” means our automated CI has not yet installed this plugin. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-notify
DeepSeek Harness 任务完成通知插件：turn 结束后把结果摘要推送到 Server酱 / 钉钉 / 飞书 / 通用 Webhook。 长任务（几十分钟到几小时）跑完不用一直盯着终端，手机收通知即可。 - 监听session/event 事件流，turn/end 后防抖 debounceMs 推送
- 通知内容：模型、耗时、工具调用数、token 消耗（含缓存读写）、最后一条助手消息摘要、回合结果（完成/出错/被中断…）
- 支持 4 种渠道：Server酱（form 表单）、钉钉（含加签模式）、飞书、通用 Webhook（JSON）
- 进程退出时 flush 待发送通知（headless 一次性任务也能送达）
安装
``sh
本地 checkout 安装
dsh plugin --profile <web|tui|headless> add file:/path/to/dsh-notify
或从 Git 仓库安装
dsh plugin --profile <web|tui|headless> add https://gitcode.com/qq8864/dsh-notify.git
`
配置
通过 profile 的 cordis.patch.yml 或 --patch overlay 配置渠道：
`yaml
- id: notify
config:
enabled: true
debounceMs: 10000 # turn/end 后的静默等待
summaryMaxChars: 500 # 助手消息摘要截断
titlePrefix: '' # 通知标题前缀
notifyOnCompleted: true # 正常完成时通知
notifyOnError: true # 出错/达到上限时通知
channels:
- type: serverchan # Server酱（方糖）
url: https://sctapi.ftqq.com/<SENDKEY>.send
- type: dingtalk # 钉钉机器人
url: https://oapi.dingtalk.com/robot/send?access_token=<TOKEN>
secret: <加签模式的 secret，可选>
- type: feishu # 飞书机器人
url: https://open.feishu.cn/open-apis/bot/v2/hook/<TOKEN>
- type: generic # 通用 Webhook（JSON: title/content/timestamp）
url: https://example.com/hook
`
channels 为空数组时不发送任何通知（插件只订阅不动作）。
通知样例（generic 渠道）
`json
{
"title": "[dsh] 任务完成",
"content": "模型：deepseek-official/deepseek-v4-flash\n耗时：4s\ntokens：8247 in / 122 out（缓存读 0 / 写 0）\n---\ndef fibonacci(n): ...",
"timestamp": "2026-08-14T09:22:36.409Z"
}
`
开发
`sh
pnpm install
pnpm run build # tsc -> lib/
`
端到端验证（本地 webhook）：
`sh
node test/hook-server.mjs & # 监听 127.0.0.1:9999，落盘 test/hook-received.jsonl
dsh --profile headless --patch ./test/notify-patch.yml "一句话介绍你自己"
cat test/hook-received.jsonl
``
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-notify for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:haytham818/dsh-notifyHeadless (CLI) profile:
dsh plugin --profile headless add github:haytham818/dsh-notifyTest report
No short evidence report
There is no checkable per-level test record on this page. Stars, the catalog test field, a web-only flag, and whether the plugin needs an external account or service are not shown here as a pass or a failure. The catalog badge stays as published.
When to use it
Get task-completion notifications via ServerChan, DingTalk, Feishu, or generic webhooks when a job finishes.
Who it's for
Users running batch or long tasks who want completion pings on channels they already monitor.
For developers — extending it
Add webhook channels and payload templating — the notifier's channel list is meant to grow.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-notify/)<a href="https://dshbase.com/plugins/dsh-notify/"><img src="https://dshbase.com/badges/dsh-notify.svg" alt="dshbase listed"></a>