前言¶
DeepSeek Harness 运行时，开发者常需在后台处理审批请求、回答模型提问或处理计划待审。如果只依赖终端或浏览器标签页，很容易遗漏关键事件。dsh-notifications 作为一个纯第三方插件，在 macOS 菜单栏添加一个状态项，提供实时会话/事件计数、扫光视觉提示以及系统级通知，确保你在处理其他任务时也能及时响应 Harness 的请求。
插件概览¶
- 定位: 客户端插件，提供菜单栏状态指示与系统级提醒。
- 维护者: haotian-lu-prog
- 协议: MIT
核心功能¶
- 实时会话计数: 状态项显示当前
running的 Agent 数量。无活动时仅显示鲸鱼图标。 - 待处理事件标记: 当有待处理事件时，数字切换为总数。Q 代表提问，S 代表审批（如
2-QS表示各有一个待处理）。 - 扫光强化提示: 有待处理事件时，图标上会有扫光掠过。
- 点击聚焦: 点击菜单栏状态项，将已打开此 Harness 进程的 Chrome 标签页切至前台，绝不新建标签。
- 免重启改设置: 状态项、两类订阅和扫光效果均可在 Web Client 内置设置面板中实时开关。
- 即时提醒: 当工具提权、沙箱放行、模型提问或计划待审时，弹出系统通知，并让状态项出声、变红并闪烁，直到事件被处理。
- 关键词规则: 支持按会话标题、工具名与回复文本做包含/排除过滤，支持正则与大小写敏感。
安装与配置¶
使用官方安装命令将插件添加到指定的 Web profile：
dsh plugin --profile web-notifications add dsh-notifications
环境要求¶
- macOS 13 或更高版本。
- Node.js
^22.19或>=24。 - DeepSeek Harness
0.1.7-rc.2或0.2.0-rc.1。 - Xcode Command Line Tools（用于本地构建；若使用预构建 tarball 则无需安装）。
权限要求¶
安装后需在 macOS 系统设置中授予插件：
1. 通知权限: 用于弹出系统提醒。
2. 自动化权限: 用于通过菜单项控制 Chrome 标签页切换。
使用说明¶
- 菜单栏交互: 点击菜单栏的鲸鱼图标，浏览器会自动跳转到已打开 Harness 的 Chrome 标签页。如果当前没有匹配的标签页，操作静默无效。
- 内置设置: 在 Harness Web Client 的内置设置页中找到“通知”页面，可管理所有订阅开关、关键词规则及提示音。
技术细节与隐私¶
- 监听范围: 插件仅监听
agent/status、agent/disposed、user-questions/request和approval/request四类事件。 - 隐私保护: 插件不发送会话 ID、提示词、模型输出、凭据或文件路径给原生辅助程序，仅传输计数与标记字母。
结语¶
dsh-notifications 通过菜单栏与系统通知，解决了 Harness 后台运行时信息反馈不及时的问题。你可以通过以下链接查看插件详情或源码：
* 插件目录
* GitHub 仓库
