dsh-host-notify：宿主侧 macOS 通知插件

前言¶

在 DeepSeek Harness（DSH）的开发场景中，开发者常遇到离开页面后无法收到通知的问题。这是因为 Electron 应用在窗口被挂起或隐藏时，渲染进程发出的通知往往会被系统静默拦截。为了解决这一层级的丢失问题，需要利用宿主进程直接向系统投递通知。

下面介绍 dsh-host-notify。这是一个宿主侧 macOS 通知插件，通过内置签名应用投递，免疫 Electron 渲染进程隐藏丢失通知。它由 huhui-tech 维护，使用 MIT 许可证。

核心功能¶

插件运行在宿主进程，不经过渲染进程或 Service Worker，确保通知的可靠性。它主要具备以下能力：

1. 事件监听：监听 ask_user_question 事件、审批事件以及回复完成事件。
2. 应用投递：使用内置的 DSH Notifier 应用发送通知。
3. 交互增强：支持点击通知直接将 DSH 抬回前台。
4. 降级方案：提供 osascript 降级方案，确保在特定环境下仍能投递通知。
5. 去重机制：支持通知去重，避免重复打扰。

安装与启用¶

在终端执行以下命令即可安装：

dsh plugin --profile web add dsh-host-notify

插件仅限 macOS 平台（darwin），其他平台安装后插件静默不启用，不影响宿主运行。

使用方法¶

1. 离开页面提醒：离开 DSH 页面也不错过任何动静。
2. 点击唤醒：点击通知直接把 DSH 抬回前台。
3. 设置样式：在系统设置中将通知样式设为持续，确保横幅驻留屏幕。
4. 系统授权：首次使用需在系统设置中授权 DSH Notifier 发送通知。

注意事项¶

1. 首次配置：安装后首次收到通知时，系统可能会弹出授权框，需要手动点击“允许”。
2. 通知样式：建议在系统设置中将 DSH Notifier 的通知样式设为“持续”。
3. 环境依赖：依赖 Node.js >= 20。
4. 去重规则：交互级 60s 去重，完成级 5s 去重。

总结¶

dsh-host-notify 解决了在 Electron 环境下浏览器通知容易丢失的痛点，适合需要在后台保持感知的开发者。其宿主侧的运行机制保证了通知的稳定性。

• GitHub 仓库