DeepSeek Harness（DSH）采用插件架构，Agent 的运行状态通常需要在 Web 界面查看。如果需要在系统层面快速掌握当前活跃的 Agent 数量及待处理事件，需要一个可视化的反馈。下面介绍 dsh-notify，这是一个为 DeepSeek Harness 提供的 macOS 菜单栏状态项插件，由用户 linbin-mk 维护。
核心功能¶
该插件在 macOS 菜单栏添加一个状态项，包含鲸鱼图标与当前状态。
- 实时会话计数：状态项显示状态为
running的 Agent 数量。当数量为零时，菜单栏仅显示鲸鱼图标。 - 待处理事件标记：当有已订阅事件等待处理时，数字切换为这些事件的总数。字母用于标识事件类型：
Q表示提问，S表示审批。例如2-QS表示各有一个提问和审批等待处理。 - 扫光强化提示：有已订阅事件等待处理时，一道扫光会掠过鲸鱼图标和旁边的数字。高光只落在图标与字形上，不会铺满整个状态项。
- 点击聚焦：点击状态项会将已打开此 Harness 进程的 Google Chrome 标签页切换到前台，绝不会新建标签页。
- 免重启改设置：状态项、两类订阅和扫光都可在 Harness 的内置设置面板中实时开关，无需重启 Harness。
安装¶
安装前请确保环境满足以下要求：
* macOS 13 或更高版本
* Node.js ^22.19 或 >=24
* DeepSeek Harness 0.2.1-alpha.2 或兼容版本
使用官方包安装：
dsh plugin --profile web-notify add @linbin-mk/dsh-notify
若需安装本地构建的 tarball，可执行：
npm test
npm pack
dsh plugin --profile web-notify add ./linbin-mk-dsh-notify-0.5.0.tgz
配置与使用¶
插件提供配置项，用于控制状态项的显示与行为。通过 Web Client 端的内置设置面板管理，修改即时生效。
enabled：是否显示菜单栏状态项。关闭后会关闭原生辅助程序。questionMarkers：是否统计待处理提问，每个提问对应一个Q。approvalMarkers：是否统计待处理审批，每个审批对应一个S。sweep：是否在有待处理事件时播放扫光效果。
只要标记字母显示，数字就表示已订阅的待处理事件数；关闭两类订阅后，数字恢复为会话数。
隐私与限制¶
插件只监听特定系统事件：agent/status、agent/disposed、user-questions/request 和 approval/request。它只通过标准输入向原生辅助程序发送非负汇总会话数、已订阅事件数、标记字母和扫光设置，不会发送会话 ID、提示词、模型输出、凭据或文件路径。
插件依赖 DeepSeek Harness 提供的 ctx.agents、ctx.webServer 和设置服务。计数逻辑统计 Agent 的完整活动区间，包括连续排队的轮次和最终检查点。
总结¶
dsh-notify 为 DeepSeek Harness 用户在 macOS 系统栏提供了一个轻量级的运行状态反馈入口。它通过直观的数字与扫光提示，帮助开发者快速定位活跃 Agent 与待处理任务，同时保持了对敏感数据的隐私保护。
项目源码与更新请查看 GitHub。
