Huauauaa/dsh-notify
DeepSeek Harness HTTP 通知插件
项目介绍Project Overview
dsh-notify 是 DSH 的 HTTP 通知插件:根 agent 完成一轮、出错、提问或等待审批时,向你配置的 webhook POST 含 content、receiver、auth 的 JSON。适合需要在任务结束或需交互时接收外部提醒的场景;url、headers 等在“设置→通知”配置,会话开关可覆盖全局。注意:完成状态靠轮询 agents.list() 的 phase 判断,非全局 turn/end 事件;请求失败仅记日志。
dsh-notify is a DSH plugin that sends HTTP webhook notifications when the root agent finishes a turn, errors, asks a question, or requests approval. It POSTs JSON with content, receiver, and auth to a user-configured URL, useful for external alerts on task completion or required interaction. Configure URL, method, and headers under Settings → Notifications; per-conversation toggles override the global default. Note: completion is detected by polling agents.list() phase, not a global turn/end event; failed requests only log.
请帮我了解并安装插件:【dsh-notify】【https://github.com/Huauauaa/dsh-notify】
把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.
或使用命令行安装(适合开发者)Or use CLI install (for developers)
命令行安装CLI Install
dsh plugin --profile web add github:OWNER/dsh-notify
把 Huauauaa/dsh-notify 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-notify
简体中文 | English
DeepSeek Harness HTTP 通知插件:根 agent 做完一轮 或 需要你交互(提问 / 审批)时,按配置的接口 POST:
{ "content": "任务完成:…", "receiver": "", "auth": "" }
content 由插件填写;url / method / headers / receiver / auth 在 设置 → 通知 里配。每个会话的 通知 开关在侧栏三点菜单(Rename / Fork / Archive 下方),优先于全局默认。
和 aokamoaki/dsh-notify(Windows toast)不是同一个插件:本仓库发的是你自己的 HTTP webhook。
安装
dsh plugin --profile web add link:/ABS/PATH/dsh-notify
发布到 GitHub 并加上 dsh-plugin topic 之后:
dsh plugin --profile web add github:OWNER/dsh-notify
然后重启 dsh web。
使用
- 打开 设置,在侧栏 Agent presets 下方进入 通知,填 url / method / headers / receiver / auth,可选打开「全局默认开启」,保存。点 测试 可立刻打一发
通知测试:连通性检查,确认接口是否畅通。 - 每个会话的三点菜单底部有 通知 开关:开了只通知这个会话;关了这个会话不通知。没拨过开关则用全局默认。
配置文件:$DSH_HOME/dsh-notify.json(默认 ~/.dsh/dsh-notify.json)。
触发
| 时机 | content |
|---|---|
根 agent running → idle |
任务完成:… |
agent/error |
任务出错:… |
ask_user_question |
需要回答:… |
approval/asked |
等待审批:… |
子 agent 与 5 秒内同会话重复事件不通知。请求失败只打日志,不影响 agent。
完成检测跟当前 DSH 一致:没有全局 turn/end,用 agents.list() 的 phase 轮询(与社区通知插件相同)。
开发
npm test
npm run check
收录到 awesome-dsh-plugin 时分类用 notify(Notifications & Integrations)。仓库需声明 dsh.bundle、带 dsh-plugin topic,且满 1 天 / 10 次提交。条目草稿见 data/awesome-dsh-plugin.yml。
nexu-io/open-design
freestylefly/awesome-gpt-image-2
anywhere-labs/dsh-desktop
walkinglabs/learn-harness-engineering
awesome-dsh-plugin/awesome-dsh-plugin
MemTensor/MemOS