前言¶
在 DeepSeek Harness 中，Agent 執行一個回合往往需要幾分鐘。這期間如果用戶切到其他窗口，任務停止的唯一信號就是側邊欄運行燈的熄滅。但這盞燈無法區分是“任務完成”、“出錯停止”還是“Agent 正在等待你的回答（審批/提問/方案）”。
dsh-task-reminder 插件將這一刻轉化爲真正的提醒：任務停止時，發送一條 Windows 系統彈窗（原生通知）和一聲提示音。點擊通知即可跳轉回會話並滾動到提問位置。
核心功能¶
該插件由 hawkongz 維護，遵循 MIT 協議，零運行時依賴。它主要解決以下問題：
-
三種通知類型
- 任務完成：任務結束。
- 等待回覆：Agent 卡住等待用戶操作。根據具體等待類型顯示不同標題（如“審批請求”、“提問”、“方案待確認”）。
- 錯誤停止：網關報錯或其他錯誤導致任務停止。
-
通知交互
- 點擊跳轉：點擊通知卡片，打開對應會話並滾動到用戶提問的位置。
- 桌面端前臺喚醒：在 DSH Desktop 中，點擊通知會將最小化或隱藏的窗口拉回前臺。
-
提示音
- 提供 4 種合成音效（兩聲·經典 / 三聲上揚 / 上升琶音 / 圓潤三角波）。
- 支持上傳本地音頻文件（如 mp3, wav, ogg, m4a）作爲自定義音效。
-
設置頁面
- 包含彈窗開關、彈窗時機（任何情況 / 僅非前臺窗口）、通知語言、子智能體提醒開關、提示音控制、自定義音效文件上傳、一鍵恢復默認設置。
安裝¶
安裝命令會通過 pnpm 將包安裝到指定的 profile 中。
# Web 端
dsh plugin --profile web add @hawkongz/dsh-task-reminder
# 桌面端
dsh plugin --profile desktop add @hawkongz/dsh-task-reminder
安裝後必須重啓宿主並硬刷新瀏覽器（Ctrl + F5）才能生效。
使用與調試¶
啓用通知¶
首次安裝後，需要在「設置 → 任務提醒」頁面允許瀏覽器通知權限。如果權限被拒絕，可以通過設置頁的“申請通知權限”按鈕重新申請。
控制台命令¶
在瀏覽器控制台中可以使用以下命令進行調試：
- 查看狀態或權限：
__dshTaskReminder.state() - 測試通知（不等待任務結束）：
__dshTaskReminder.test()：測試“任務完成”__dshTaskReminder.test('question')：測試“提問”通知__dshTaskReminder.test('plan')：測試“方案待確認”通知__dshTaskReminder.test('approval')：測試帶按鈕的“審批”通知__dshTaskReminder.test('error')：測試“錯誤停止”通知
自定義音效¶
在設置頁面中，點擊“自定義音效”選擇本地音頻文件。音頻僅保存在本地瀏覽器中，不上傳，重啓瀏覽器後仍有效。
注意事項¶
- 瀏覽器通知權限：必須允許瀏覽器通知權限才能看到系統彈窗。
- 插件互斥：同一類通知插件（使用同一機制）只應安裝一個，否則會互相頂替。
- Service Worker 限制：帶按鈕的“審批”通知需要瀏覽器的 Service Worker 支持。在
dsh-app://協議（桌面端）和局域網http下，不支持按鈕，會退回普通樣式。 - 桌面端特例：DSH Desktop 支持通過通知將窗口拉回前臺，普通瀏覽器不支持此功能。
- 全屏干擾：在 Windows 上，如果開啓了“請勿打擾”或應用全屏運行，通知橫幅可能會被隱藏，但通知中心仍然會收到。
- 更新機制：設置頁的“檢查更新”功能依賴 DSH 插件管理服務。
