前言¶
在 DSH 插件生态中，插件可以补齐 DeepSeek Harness 客户端的具体使用体验。一个比较直接的场景是：Harness 需要你审批某个操作，或需要你选择方案、回答 ask_user_question、进行方案审阅时，如果浏览器不在前台，窗口内的提示就容易错过。
已有做法通常是留在浏览器里等待审批卡片出现；dsh-plugin-approval-alert 提供另一种方式：当 Harness 需要你审批或选择方案时，弹出系统级通知，并提示对应工作区。
下面介绍这个插件的能力、安装方式和典型用法。
这是什么¶
dsh-plugin-approval-alert 是 DeepSeek Harness 审批提醒插件，由 doncelee229-cmyk 维护，许可证为 MIT。
它是一个纯浏览器端插件，注册在 shell.overlay 插槽，不触碰审批流水线。当 Harness 需要你审批或选择方案时，它会显示系统级通知，通知内容会包含需要审批或选择方案的工作区名称，并在到达时播放提示音。
核心功能¶
系统级通知¶
- 通知显示在屏幕右下角、浏览器窗口之外。
- 通知按操作系统默认停留时长显示，并自动收起。
- 通知外观与动画由操作系统决定。
审批和选择方案提醒¶
以下场景都会触发通知：
- 需要审批。
- 需要选择方案。
ask_user_question。- 方案审阅。
通知会直接显示需要审批或选择方案的工作区名称，不做冗余说明。
多语言通知¶
通知语言跟随系统语言切换：
- 简体中文。
- 繁体中文。
- 英文。
其他语言回退为英文。
点击跳转¶
点击通知后会拉回浏览器，并跳转到对应工作区或会话。
如果点击通知导致浏览器新开窗口或标签页，新页面加载后也会自动打开目标会话。
提示音¶
通知到达时会播放双音上行提示音。
插件会在首次用户交互时解锁音频，以适配浏览器自动播放限制。
其他会话提醒¶
其他会话需要审批或选择方案时，也会弹出通知，并支持点击跳转。例如子代理会话触发审批时，同样会提醒。
兼容性与实现¶
- 基于
Web Notifications API与Web Audio API。 - 兼容 Windows 10、Windows 11、Linux、macOS。
- Linux 下依赖桌面环境的通知服务。
- 通知外观、动画和停留时长由操作系统决定。
安装与启用¶
先确认浏览器支持 Web Notifications API 与 Web Audio API，并允许浏览器站点中的通知权限。
执行下面的命令安装插件：
dsh plugin --profile web add dsh-plugin-approval-alert
这条命令会把插件安装到 web profile。
安装完成后，首次使用时请点击页面任意位置一次。插件会在这次交互中请求浏览器通知权限，并解锁音频。
经过上面的步骤后，再触发需要审批或选择方案的操作，插件就会弹出系统级通知并播放提示音。
如果没有弹出通知，先检查浏览器站点权限中的“通知”是否已允许。
国内网络环境下，可以先配置 npmmirror 镜像：
npm config set registry https://registry.npmmirror.com
然后再执行前面的安装命令。
典型用法¶
1、安装插件，并在首次使用时点击页面任意位置一次，完成通知权限请求和音频解锁。
2、在 DeepSeek Harness 中触发需要审批、选择方案、ask_user_question 或方案审阅的操作。
3、桌面右下角弹出通知，通知中显示对应工作区名称，并播放提示音。
4、点击通知，拉回浏览器并跳转到对应工作区或会话。
5、在浏览器内的审批卡片上完成真正的决策，例如“允许一次”或“拒绝”。
这里需要注意：插件负责提醒和跳转，不执行审批决策。
适用场景与注意¶
这个插件适合使用 Web 版 DeepSeek Harness，并且经常切换窗口、但仍希望不错过审批或方案选择的人。
使用前注意以下几点：
- 插件不执行审批决策，真正的“允许一次”或“拒绝”仍在浏览器内的审批卡片上完成。
- 需要浏览器支持
Web Notifications与Web Audio API。 - 需要允许浏览器站点的通知权限。
- 首次使用需通过一次点击请求通知权限并解锁音频。
- 兼容 Windows 10、Windows 11、Linux、macOS；Linux 下取决于桌面环境的通知服务。
- 通知按操作系统默认停留时长显示并自动收起，外观与动画由操作系统决定。
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。该插件许可证为 MIT。
相关链接¶
GitHub：
https://github.com/doncelee229-cmyk/dsh-plugin-approval-alert
