前言¶
DeepSeek Harness (DSH) 的生态强调“一切皆插件”。在使用 Agent 开发或自动化任务时，往往需要即时反馈，比如构建完成、审批提醒或定时任务结果。然而，DSH 内置的机制或部分插件默认仅提供会话内的反馈，难以直接触达手机或第三方协作平台。dsh-notify 插件旨在解决这一痛点，它提供了 Agent 可直接调用的推送工具，并将官方日程模块的提醒镜像到外部渠道。
插件简介¶
dsh-notify 是由用户 Lubaoshuai 维护的一个 DSH 插件。其核心价值在于提供两方面的能力：一是允许 Agent 在运行时通过 notify_send 工具发送任意消息；二是作为 @deepseek-ai/dsh-schedule 的伴侣，将日程提醒同步到外部渠道，弥补官方 Schedule 仅在会话内生效的缺陷。
核心能力¶
- Agent 可调用工具：插件注册了
notify_send工具，Agent 可在对话中调用它，用于推送构建完成、审批请求、定时任务结果等消息。 - 日程提醒镜像：官方
dsh-schedule的设计仅限于会话内通知。dsh-notify 监听相同的schedule/change事件流，将提醒镜像分发到外部渠道。 - 多渠道支持：支持 Telegram, Slack, Discord, 飞书, 钉钉, Bark, ntfy, webhook。
- 并发与容错：消息会并发发送到所有配置的渠道。单渠道失败不会阻塞其他渠道，工具会返回各渠道的送达状态。
- 配置与设置：支持通过配置文件管理，计划在 v0.2 版本支持 Web UI 插件设置页。
安装与启用¶
使用官方 CLI 安装该插件：
# 从 npm 安装（插件发布后可用）
dsh plugin --profile web add dsh-notify
# 或直接从 GitHub 安装
dsh plugin --profile web add github:Lubaoshuai/dsh-notify
安装完成后，需要重启 dsh web 会话，Agent 才能识别并调用 notify_send 工具。
配置与用法¶
- 创建配置文件：在
DSH_HOME目录下创建~/.dsh/dsh-notify/config.文件。 - 配置渠道：在文件中定义
channels列表，指定通知目标。例如配置飞书、Telegram 或 Bark。 - 启用日程镜像：设置
"scheduleNotifications": true，以开启日程提醒的外部同步。 - 调整超时：通过
timeoutMs参数控制通知发送的超时时间。 - 重启会话：修改配置文件后，重启
dsh进程使配置生效。
Agent 可以通过对话指令调用工具，例如：“请在我测试完成后通知我”。也可以直接使用 Webhook 频道发送自定义 POST 请求。
注意事项¶
- 敏感信息保护：Bot Token 和 Webhook URL 属于敏感凭证，建议在配置文件上设置权限为
0600，避免泄露。 - 进程依赖：DSH 进程关闭时，通知不会发送。下次启动时，由 schedule 模块传递待发送的提醒。
- 网络协议：Webhook 频道应使用 HTTPS 进行出站集成。
- 未来计划：v0.2 版本计划增加 Web UI 设置卡片和 SMTP 邮件支持。
总结¶
dsh-notify 通过提供标准化的工具接口和日程同步机制，降低了 DeepSeek Harness 开发者在构建通知系统时的门槛。如果你需要将 Agent 的行为或定时任务结果实时推送到手机或协作平台，该插件提供了现成的解决方案。
