dsh-notify: DeepSeek Harness HTTP 通知插件

前言¶

在使用 DeepSeek Harness (DSH) 进行智能体开发时，开发者通常需要在外部系统或终端中获知根 agent 的运行状态，例如任务完成、出现错误或等待人工交互。dsh-notify 插件通过 HTTP 请求将上述状态推送到配置的接口，方便集成到现有的工作流或监控系统中。

插件简介¶

dsh-notify 是一个由 Huauauaa 维护的通知类插件。它允许用户配置一个 HTTP 接口，当根 agent 完成一轮交互或需要人工介入时，插件会向该接口发送 POST 请求。

核心功能¶

插件主要提供以下能力：

1. 触发时机：支持任务完成、任务出错、需要回答、等待审批四种触发时机。
2. 请求配置：支持自定义 URL、请求方法、Headers、接收者 以及认证信息。
3. 开关控制：支持全局默认开启，同时支持在每个会话中独立开启或关闭通知。
4. 去重机制：子 agent 与 5 秒内同会话的重复事件不会重复触发通知。

安装¶

安装前请确保本地已安装 DeepSeek Harness，并重启 dsh web。

本地安装：

dsh plugin --profile web add link:/ABS/PATH/dsh-notify

发布到 GitHub 并加上 dsh-plugin topic 后：

dsh plugin --profile web add github:OWNER/dsh-notify

配置与使用¶

1. 打开 设置，在侧栏 Agent presets 下方进入 通知 页面。
2. 填写接口参数（URL、Method、Headers、Receiver、Auth），并选择是否开启 全局默认开启。
3. 点击 测试，接口会收到一条 通知测试：连通性检查 的请求，用于确认连通性。
4. 在侧栏三点菜单（Rename / Fork / Archive 下方）开启每个会话的通知开关。会话开关优先于全局默认设置。

配置文件默认位于 $DSH_HOME/dsh-notify.json（即 ~/.dsh/dsh-notify.json）。

技术细节与注意事项¶

• 请求失败处理：请求失败仅会在日志中记录，不会影响 agent 的正常运行。
• 完成检测逻辑：完成检测逻辑与当前 DSH 一致。如果没有全局 turn/end，会使用 agents.list() 进行轮询。
• 功能区分：本插件与 aokamoaki/dsh-notify（Windows toast）不是同一个插件，前者提供自定义的 HTTP webhook，后者仅用于 Windows 弹窗通知。

结语¶

该插件通过标准 HTTP 接口将 DSH 的运行状态暴露给外部，适合需要将 DSH 集成到现有自动化流程或监控系统的场景。更多详情可查阅 GitHub 仓库。