Huauauaa/dsh-notify

插件Plugin 原生Native ⭐ 2 MIT

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.

或使用命令行安装(适合开发者)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

Awesome DSH Plugin

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

使用

  1. 打开 设置,在侧栏 Agent presets 下方进入 通知,填 url / method / headers / receiver / auth,可选打开「全局默认开启」,保存。点 测试 可立刻打一发 通知测试:连通性检查,确认接口是否畅通。
  2. 每个会话的三点菜单底部有 通知 开关:开了只通知这个会话;关了这个会话不通知。没拨过开关则用全局默认。

配置文件:$DSH_HOME/dsh-notify.json(默认 ~/.dsh/dsh-notify.json)。

触发

时机 content
根 agent runningidle 任务完成:…
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

许可

MIT

上一个 Prev canon-deepseek-harness-plugin 下一个 Next dsh-file-resource