前言¶
在 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
