lsq-dsh-plugins/dsh-windows-notifications

DSH Windows 通知

简体中文 | English

为 DeepSeek Harness Web 提供 Windows 系统通知、可选提示音和 DSH 风格页面通知卡片。只要 DSH 标签页保持打开，即使正在使用其他软件，也能收到任务结果或待处理事项提醒。

通知规则

默认情况下，同一个事件只会显示 Windows 通知或页面通知，不会两者同时出现。提示音独立于显示方式，可以与其中任意一种通知同时播放。

判断依据是浏览器可见性和焦点，而不是显示器数量。如果关闭“仅在 DSH 不活跃时弹系统通知”，DSH 获得焦点时也可能显示 Windows 通知；只要 Windows 通知投递成功，同一事件的页面通知仍会被抑制。

通知事件

• 任务正常完成。
• 任务报错、中止、阻塞、异常中断或达到输出上限。
• DSH 正在等待审批、计划确认或问题回答。
• 可选的子智能体完成与失败事件。

点击 Windows 通知会聚焦 DSH 并打开对应会话。插件读取 Harness 持久化的 turn/end 结果，不会从短暂的运行状态猜测任务是否完成。首次加载、刷新和重连只建立静默基线，不会把旧事件重新当作新通知。

设置

在 DSH Web 中打开设置 → 通知。

Windows 通知、页面通知和声音分别提供独立测试按钮。连续触发 Windows 或页面测试时，新测试会覆盖尚未结束的同类测试，不会不断排队；真实任务通知仍按到达顺序展示。

安装

将公开包安装到 DSH Web 配置：

dsh plugin --profile web add @lsq64737/dsh-windows-notifications

如果 DSH Web 正在运行，请在安装后重启。再次执行相同的 add 命令即可更新。

卸载命令：

dsh plugin --profile web remove @lsq64737/dsh-windows-notifications

首次启用

1. 打开 DSH Web，进入设置 → 通知。
2. 点击授权通知。
3. 在浏览器权限提示中选择允许。
4. 分别运行测试 Windows 通知、测试页面通知和测试声音。

浏览器要求通过用户手势申请通知权限，因此插件不会在页面加载时自动弹出权限框。如果此前选择了拒绝，请先在浏览器的站点权限中恢复通知权限，再重新测试。

浏览器与 Windows 要求

• DSH 标签页必须保持打开；关闭标签页或浏览器后，通知处理会停止。
• Windows 通知要求浏览器和页面来源能够在受允许的安全上下文中使用 Notification API。
• Chrome 或 Edge 的站点权限以及 Windows“勿扰”设置具有最终控制权，插件无法绕过。
• Windows 决定系统通知的外框、位置和持续时间；插件只提供 DSH 图标、标题、正文和点击操作。
• 浏览器可能限制或冻结长时间未使用的后台标签页，即使 DSH 连接看似仍然活跃，通知也可能延迟。

隐私与可靠性

• 插件不使用第三方通知服务。事件只在 DSH Web、浏览器 Notification API、Web Audio 和 Windows 之间处理。
• 通知正文可能包含 DSH 会话标题，因此会按照 Windows 通知设置显示在系统界面或锁屏上。
• 提示音由 Web Audio 合成，不下载音频文件。
• 桌面通知投递失败时，如果页面通知已启用，会回退为页面错误提示或任务卡片。
• 关键路径和异常使用 windows-notifications: 前缀写入 Harness 日志或浏览器控制台，包括权限、投递、设置和音频失败，不记录凭据。

开发

需要 Node.js 24 或更高版本，以及兼容的 DSH 开发工作区。

npm ci
npm run typecheck
npm test
npm run build

许可证

MIT