前言¶
DSH 扩展里，agent 跑完长任务或出错后，常见问题是“人不在电脑前怎么办”。dsh-plugin-notify 解决的是通知出口：让 agent 主动通过桌面通知、中文语音播报或系统提示音联系你。它由 huguangyu666 维护，MIT 许可，面向 Windows 本机环境，要求 Windows + PowerShell 5.1+（系统自带）。
这是什么¶
dsh-plugin-notify 是一个 DeepSeek Harness（DSH）插件，核心是“通知出口”：
- agent 主动通知你
- 会话出错时自动提醒
- 回合结束后进入确认窗口，超时未互动则中文语音呼叫
核心功能¶
注入主动通知规则¶
插件会自动往所有 agent 的系统提示词注入主动通知规则。agent 在长任务完成、出错或需要你注意时，可以调用：
notify_user
notify_user 工具¶
notify_user 支持：
- 自由传入
message - 不写
message时按scene使用默认文案
自动兜底¶
这部分不依赖模型自觉：
- 会话回合出错：自动语音 + 桌面通知
- 回合结束：自动桌面通知
- 确认窗口内超时未互动：中文语音呼叫
手动通知¶
插件提供：
/notify
用于手动发送通知。
通知通道¶
支持以下通道：
toast
speak
sound
both
其中：
toast：桌面通知speak：中文语音播报sound：系统提示音both：语音 + 桌面通知
音效¶
支持 4 种合成音效：
炸裂
胜利
警报
清脆
配置¶
可通过 dsh 设置面板、环境变量或配置文件调整通知行为与文案模板。可调整的环境变量包括：
DSH_NOTIFY_DEFAULT_MODE
DSH_NOTIFY_INJECT_PROMPT
DSH_NOTIFY_ON_TURN_END
DSH_NOTIFY_CALL_DELAY_SECONDS
DSH_NOTIFY_TEMPLATE_DONE
安装与启用¶
先执行安装命令：
dsh plugin --profile web add dsh-plugin-notify
该命令把 dsh-plugin-notify 加到 web profile。插件要求 Windows + PowerShell 5.1+（系统自带）。
典型用法¶
让 agent 主动通知¶
直接跟 agent 说：
- “做完这个任务通知我”
- “出错时叫我”
它会调用 notify_user 工具。
手动通知¶
/notify 任务完成了
/notify --speak 快回来看看结果
/notify --sound 提醒
测试¶
浏览器打开：
/notify
选择模式并点发送。“演示：任务完成叫你”可用于一键体验完整场景。
适用场景与注意¶
适合在 Windows 上使用 DSH，并希望 agent 在长任务完成、出错或需要人工介入时主动提醒你的场景。
注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- 许可证：MIT。
- 运行环境：
Windows + PowerShell 5.1+（系统自带）。 - 语音播报在后台子进程执行，等待播完才返回。
- 通知串行执行，超时 120 秒。
- “音量增强”在给定资料中同时出现“默认关闭”和“默认开启”的表述，本文不把它作为确定默认值；使用前应检查本地配置或源码。
链接¶
- GitHub 仓库：
https://github.com/huguangyu666/dsh-plugin-notify - 社区列表：本文只保留已确认的分类信息：
awesome-dsh-plugin的Notifications & Integrations列表；独立目录页 URL 未确认，因此不补充未核实地址。
