前言¶
在使用 DeepSeek Harness (DSH) 進行智能體開發時，審批請求、提問確認、目標受阻等需要人工干預的事件往往容易被忽略。dsh-session-notify 插件將這類事件接入瀏覽器系統通知與應用內提示，通過點擊直接跳轉到對應會話，解決漏看問題。
插件介紹¶
本插件爲 DSH 動態 Cordis 插件，由 Lwc-LiuWenCheng 維護，採用 MIT 許可證。
核心功能¶
- 雙半體架構：Host 與 Client 分離，無需修改 DSH 部署源碼即可加載。
- 全面覆蓋：覆蓋全部人工干預事件，共 7 個分類、11 個事件源。
- 雙通道提醒：同時提供瀏覽器 Notification API 系統通知與右上角 toast 棧。
- 交互跳轉：點擊通知直接聚焦窗口並跳轉到對應會話。
- 精細配置：支持在設置頁爲每個分類配置通知級別（關閉 / 應用內提示 / 系統通知）。
- 低負載設計：採用 Client→Host 長輪詢（空隊列掛起 15s）與 Host 側源頭過濾，避免輪詢風暴，關閉分類零負載。
安裝與啓用¶
有兩種方式啓用該插件：
- 方式 A：作爲動態插件加載
- 運行構建命令生成文件：
npm run build:dynamic
- 在 DSH 會話中，將生成的
dynamic/host.body.js內容作爲code.host，dynamic/client.body.js內容作爲code.client調用cordis_define，隨後執行cordis_run激活。 - 首次使用需在 DSH 設置頁請求通知權限。
- 方式 B：作爲靜態插件安裝
- 運行構建與打包命令：
npm run build:static
npm pack
- 執行本地安裝腳本：
powershell -ExecutionPolicy Bypass -File scripts\install-local.ps1
- 重新啓動 DSH 進程即可生效。
注意事項¶
- 會話級作用域：動態插件僅接收當前會話作用域內的事件，無法接收跨會話事件。
- 瀏覽器通知依賴：系統通知依賴 Notification API 與用戶授權，不支持時自動降級爲應用內提示。
- 標題降級處理：通知正文中的會話標題來自
sessionQuery.readTitle，取不到時使用通用文案。 - 生命週期：動態插件是會話級、進程內的，停止或更新即移除全部副作用。
