dsh-plugin-notify

DeepSeek Harness 插件：通知出口——让 agent 主动联系你。桌面通知 / 中文语音播报 / 提示音，Windows 本机零依赖。

功能

• 系统提示词注入：自动往所有 agent 的系统提示词注入主动通知规则（长任务完成 / 出错 / 需要你注意时用 notify_user），不用每次教；DSH_NOTIFY_INJECT_PROMPT=0 可禁用

• 自动通知兜底（不依赖模型自觉）：

  • 会话回合出错 → 自动语音 + 桌面通知
  • 回合结束 → 立即桌面通知，进入 60 秒确认窗口：期间你在 dsh 发了消息（=看到了）则取消；没发 → 中文语音呼叫你（无论你在不在电脑前——用电脑没发现任务完成更需要语音打断提醒）；DSH_NOTIFY_ON_TURN_END=0 关闭全部

• agent 工具 notify_user：模型想说啥说啥——把想说的话写进 message 自由发挥（如搞定了，报告放桌面了）；不写则按 scene 用默认文案

• 命令 /notify：/notify [--speak|--sound|--toast] 手动发通知

• 设置入口（dsh 原生设置界面）：dsh 左下角设置 → 「通知」分区——所有行为偏好直接嵌在 dsh 设置里（默认通知方式 / 确认窗口秒数 / 自动通知开关 / 语音呼叫开关 / 音量增强 / 文案模板），保存即生效；另有 /notify 页面可测试通知

• 音量增强：可选——通知时自动把系统音量调到最大，播报完恢复原音量（适合怕错过呼叫的场景，不是每个人都喜欢所以默认关闭）

• 炸裂音效：4 种合成音效（炸裂 / 胜利 / 警报 / 清脆，Python 标准库实时合成），通知时可配；默认「炸裂」

• 音量增强默认开启：通知时自动把系统音量调到最大，播完恢复原音量

• 三种通道（可组合）：

  • toast 桌面通知（NotifyIcon 气泡，无额外模块）
  • speak 中文语音播报（PowerShell SAPI 离线 TTS，优先中文语音）
  • sound 系统提示音
  • both 语音 + 桌面通知

安装

npm i dsh-plugin-notify

在 dsh 的 profile patch（~/.dsh/profiles/ /cordis.patch.yml）中挂载：

- insert:
    - id: notify
      name: 'dsh-plugin-notify'

重启 dsh 即生效。要求 Windows + PowerShell 5.1+（系统自带）。

使用

模型主动通知（核心场景）：直接跟 agent 说"做完这个任务通知我""出错时叫我"，它会调用 notify_user 工具。语音播报会念出内容（自动截断 300 字），适合你离开电脑时的场景：

"查一下今天的项目状态，完成后用语音叫我"

手动通知：

/notify 任务完成了
/notify --speak 快回来看看结果
/notify --sound 提醒

测试页：浏览器打开 /notify，选模式点发送；"演示：任务完成叫你"一键体验完整场景。

环境变量

变量