前言¶
DeepSeek Harness (DSH) 采用插件化架构。在开发或运行智能体任务时，开发者需要及时获知会话创建、任务完成、任务中断或待审批状态。dsh-notify 旨在解决这一状态感知问题，提供从应用内弹窗到系统原生通知的分层通知方案。
插件定位¶
这是一个由 having5548 维护的客户端插件，开源协议为 MIT。
核心功能¶
- 应用内通知：聚焦在 DSH 界面时，右上角弹出 Telegram 风格的 Toast 并播放提示音。
- 系统原生通知：聚焦在应用外时，Windows 10/11 或 macOS 弹出系统通知中心消息。
- Web UI 设置面板：支持管理总开关、通知通道开关、场景开关以及查看最近 100 条通知日志。
- 应用内一键审批：针对待审批场景，应用内通知直接提供「批准」或「拒绝」按钮，无需打开会话即可处理。
- 零额外依赖：不依赖第三方库，利用系统自带 API 实现。
安装与启用¶
- 确保安装包已下载（版本 0.3.1）。
- 执行安装命令：
dsh plugin --profile web add dsh-notify-0.3.1.tgz
- 安装完成后重启 DSH Web GUI，设置才会生效。
典型用法¶
- 进入 设置 → 通知 面板，管理开关或测试通知功能。
- 应用内：焦点在 DSH 时，系统会在界面右上角弹出通知并播放提示音。
- 应用外：焦点离开 DSH 时，系统会触发原生通知。
- 待审批：当有待办事项时，回到 DSH 界面，应用内通知会显示批准/拒绝按钮；如果在应用外，则会收到系统提醒。
适用场景与注意事项¶
- 平台支持：仅支持 Windows 10/11 和 macOS。
- 原生通知限制：原生通知仅作提醒，点击无回调或激活功能（避免被安全软件误报）。
- 处理流程：待审批请务必回到 DSH 界面处理，不要依赖原生通知的点击激活。
- 持久化：设置通过 DSH 官方设置系统持久化，无需额外配置。
资源链接¶
- 项目目录：dsh-notify
- 源代码：GitHub
