前言¶
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 倉庫
