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。
