前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」。在智能體開發或日常使用中，一個常見的問題是：當一輪對話結束，或者 AI 主動向你提問、請求審批時，如果你切換到了其他標籤頁，很容易錯過這些狀態。dsh-session-notify 解決了這個問題，它讓完成狀態主動找你，而不是你盯着屏幕等待。

插件介紹¶

dsh-session-notify 是 DSH 的一個客戶端插件，由開發者 TelosmaYLX 維護。其核心價值在於：在每一輪會話結束時，主動將完成狀態、用時及消耗等信息通知給你；同時，在 AI 提問或請求審批時提供即時提醒。

核心功能¶

該插件包含以下已覈實功能：

1. 三通道提醒

   • 會話內系統消息：將結束原因、用時、消耗寫入會話日誌，隨 JSONL 落盤。
   • 瀏覽器系統通知：原生彈窗，每次完成事件使用獨立 tag。
   • 頁內 Toast：右下角浮動彈窗，作爲系統通知被靜默或環境不支持時的保底通道。

2. 後臺會話全覆蓋

   • 宿主維護所有會話（含後臺、未打開窗口的）的投影單元。
   • 客戶端從會話列表快照觀測 running 位的變化，觸發推送，不依賴你恰好開着窗口。

3. 提問與審批即時提醒

   • 提問提醒：AI 調用 ask_user_question 時立即彈窗，支持自定義標題和正文，包含 {question} 等佔位符。
   • 審批提醒：會話請求權限審批時立即提醒，標題與正文包含工具名與可選原因，不含敏感參數。

4. 高度可定製

   • 語言支持：支持簡中、繁中、英文、日文、韓文 5 種語言。
   • 模板編輯器：提供可視化文案模板編輯器（Chip 膠囊編輯器），支持實時預覽。
   • 預設系統：內置 4 套風格預設（默認 + 3 套風格），支持自定義和持久化保存。

5. 數據與工程質量

   • 官方口徑：緩存命中率與生成速度取自官方投影，與狀態欄同口徑。
   • 零外部依賴：宿主平面零裸 import，安裝即掛載（聲明官方 dsh.bundle manifest）。
   • 自檢腳本：提供 npm run selftest 進行工程自檢。

安裝與啓用¶

安裝推薦使用 DSH 官方的插件管理命令，而非直接安裝 npm 包。

dsh plugin --profile web add @telosmaylx/dsh-session-notify

安裝完成後，必須刷新瀏覽器頁面以加載客戶端 bundle。首次收到通知事件時，需要允許瀏覽器通知權限。

注意：npm install 僅添加依賴，不會自動註冊插件，必須使用 dsh plugin add。

典型用法¶

安裝並刷新頁面後，該插件會自動運行。你可以通過設置面板進行配置：

1. 查看通知：發起任意一輪對話，等待結束。你會看到右下角的 Toast 彈窗、瀏覽器系統通知，以及會話日誌中新增的提示行。
2. 切換語言：在設置面板中切換語言，通知文案和界面會即時重渲染。
3. 編輯模板：通過可視化編輯器自定義通知文案，插入佔位符（如 {title}, {cache}）。
4. 管理預設：內置 4 套風格預設，支持另存爲自定義預設。

注意事項¶

• 環境要求：需要 Node.js >= 22 和 DSH Web profile 部署。
• 瀏覽器支持：需要瀏覽器支持 Web Notification 權限。
• 許可證：MIT。
• 卸載行爲：卸載後，設置配置和自定義預設會保留在 localStorage 中，重裝後可恢復。

短結尾¶

dsh-session-notify 通過三通道提醒和後臺覆蓋機制，解決了會話狀態遺漏的問題。它不僅提供了即時反饋，還通過可視化編輯器和預設系統提供了良好的定製體驗，適合需要在多任務環境中使用 DSH 的用戶。

相關鏈接：
* GitHub 倉庫
* 社區目錄