前言¶

在使用 DeepSeek Harness (dsh) web 進行開發或調試時，Agent 在運行過程中可能會遇到需要用戶介入的節點，例如輪次結束等待輸入、工具審批請求或模型提問。如果此時頁面處於後臺或未及時查看，這些狀態很容易被遺漏。dsh-turn-reminder 插件旨在解決這一問題，通過監聽 Agent 狀態並在需要時觸發通知，確保用戶不會錯過任何阻塞點。

插件簡介¶

這是一個用於 DeepSeek Harness web 的用戶注意力通知插件。當會話等待用戶操作時，該插件會提供頁面內 Toast 提示或系統級瀏覽器通知。該插件由 SipengXie2024 維護，開源協議爲 MIT。

核心功能¶

插件通過監聽特定事件來識別需要用戶注意的場景：

1. turnEnd：監聽 agent/status 事件。當 Agent 從運行狀態轉爲空閒狀態時觸發。這涵蓋了已結束的目標和出錯的輪次。
2. approval：監聽 approval/request 事件。用於處理工具審批、沙箱升級等需要中斷當前流程的操作。這些操作通常發生在輪次中間。
3. question：監聽 tools/pre-execute 事件中的 ask_user_question。當模型向用戶提問時觸發。
4. plan：監聽 tools/pre-execute 事件中的 exit_plan_mode。當模型展示計劃供審覈時觸發。

通知機制分爲兩種：
* 頁面可見時：顯示頁面內 Toast 提示。
* 頁面隱藏時：顯示操作系統級別的瀏覽器通知。

安裝與啓用¶

使用官方提供的安裝命令添加插件：

dsh plugin --profile web add dsh-turn-reminder-0.1.0.tgz

安裝完成後，需要重啓 dsh web 進程。插件會在啓動時加載並自動爲所有會話提供提醒服務。

使用說明¶

1. 在 DSH web 的 Composer 工具欄右側找到 🔔 按鈕。
2. 點擊該按鈕以授予瀏覽器通知權限（瀏覽器要求必須通過用戶手勢觸發權限請求）。
3. 之後，每當出現上述四種情況之一，系統會彈出通知。Toast 提示會在 8 秒後自動消失，也可以手動點擊關閉。

注意事項¶

• 計數器邏輯：插件僅在加載後開始記錄事件，進程重啓後計數器會重置。第一次輪詢僅記錄基線數據，不會針對歷史事件發送提醒。
• 版本兼容性：該插件在 dsh 0.1.0-rc.6 版本下測試通過。
• 本地重新安裝：如果通過本地 tarball 文件重新安裝，需要手動 bump 版本號。這是因爲 pnpm 會保留同名同版本的舊構建文件，導致新安裝的插件未生效。

生態與鏈接¶

DeepSeek Harness 的設計理念是“一切皆插件”。該插件屬於社區目錄中的項目，與 DeepSeek 官方應用無關。如需查看源碼或反饋問題，可訪問其 GitHub 倉庫：https://github.com/SipengXie2024/dsh-turn-reminder