前言¶
在使用 DeepSeek Harness 进行智能体开发时，审批、提问、出错、轮次完成等事件容易在后台被忽略。手动切换窗口查看状态会打断工作流。本文介绍 dsh-notify-overlay 插件，通过浮窗与待处理小球，让提醒显式地停留在屏幕上。
插件定位¶
dsh-notify-overlay 是 RicardoYan 维护的客户端插件，为 DeepSeek Harness 提供置顶通知浮窗。当发生审批、提问、出错、轮次完成等事件时，屏幕右下角会弹出自绘卡片；待处理提醒收进一个可拖动的小球，点击任意一条可跳回对应会话并把 DSH 置顶。关掉浮窗开关则改用系统通知，macOS / Linux 靠这条路可用。
核心功能¶
浮窗通知¶
审批、提问、出错、轮次完成时，屏幕右下角弹出自绘卡片。卡片会一直保留，直到处理完成；轮次完成、子代理完成、会话结束等事件弹一下就走。
待处理列表与跳转¶
会阻塞对话的提醒收进一个可拖动的小球。点开小球显示待处理列表，点击任意一条跳回对应会话并把 DSH 提到前台。小球位置只存内存，DSH 重启后回右下角。
投递方式切换¶
浮窗是 Windows 独占的（WPF 进程），macOS / Linux 只能用系统通知。开关照字面执行——非 Windows 上把开关打开就什么都不发。
| 浮窗 | 系统通知 | |
|---|---|---|
| 看到有提醒 | ✅ | ✅ |
| 点击跳回会话 | ✅ | ❌ |
| 待处理列表 | ✅ | ❌ |
| macOS / Linux | ❌ | ✅ |
系统通知只负责提醒，点击没有反应。这是取舍：让点击有用要走渲染进程，而 DSH 窗口隐藏时会把定时器节流到约一分钟一次，正好是通知唯一有意义的场景。
安装与启用¶
dsh plugin --profile desktop add github:RicardoYan/dsh-notify-overlay#v0.1.0
装完重启 DSH。卸载把 add 换成 remove。
配置¶
设置 → 插件 → 通知浮窗。改完立即生效，不用重启。
| 项 | 默认 | 说明 |
|---|---|---|
| 用浮窗提醒 | 开 | 关掉改用系统通知 |
| 审批 / 提问 / 出错 | 开 | 会一直留着，直到你处理完 |
| 轮次完成 | 开 | 弹一下就走 |
| 子代理完成 / 会话结束 | 关 | 弹一下就走 |
| 卡片停留时长 | 6000 | 3–8 秒 |
| 界面缩放 | 1 | 0.6–1.8 倍 |
| 提示音 | 开 | 仅浮窗模式 |
| 免打扰时段 | 关 | 支持跨午夜；审批和提问不受影响 |
适用场景与注意¶
适合需要显式提醒的智能体开发者：审批、提问、出错等事件容易在后台被忽略，浮窗与待处理小球能让提醒显式地停留在屏幕上。
插件以当前 dsh 进程权限运行。安装前应检查源码与许可证。浮窗只有 Windows，需要 .NET Framework 4.8（Win10 1803+ 自带）。macOS / Linux 的系统通知未在真机验证。
结尾¶
dsh-notify-overlay 通过浮窗与待处理小球，把后台提醒变成显式可见的交互。关掉浮窗则改用系统通知，macOS 和 Linux 也能用。访问目录页或 GitHub 查看源码与更多细节。
- 目录页：https://www.skillhub.cn/plugins/RicardoYan/dsh-notify-overlay
- GitHub：https://github.com/RicardoYan/dsh-notify-overlay
