前言¶
在 DeepSeek Harness(DSH)裏跑智能體任務時,常見情況是:你切到別的窗口寫代碼、查文檔,DSH 在後臺繼續跑;任務結束時沒有明顯信號,需要你點「批准」工具調用時也不會主動找你。Codex、WorkBuddy 一類產品會在系統層彈出提醒,把注意力拉回會話。DSH 本身不自帶這類跨窗口通知,社區插件 dsh-reminder(維護者 Aisland-SJL)補的就是這一塊:任務完成或等待審批時,在任意窗口彈出提醒,點擊即可回到對應會話。
這是什麼¶
dsh-reminder 是面向 DSH Web 端的跨窗口提醒插件,分類爲「工作流」。它在任務輪次結束或出現待審批工具調用時,通過瀏覽器 Notification API 彈出右下角卡片,並播放短促提示音;只提醒、不代你批准。插件以 MIT 許可證發佈,當前版本 0.1.0,GitHub 倉庫約 12 stars(截至資料抓取時)。
架構上,一個 npm 包同時包含 host(Cordis 插件,註冊設置命名空間與 Typert Remote)和 client(訂閱會話列表與對話快照,監聽 turn/end、approval/requested 等 mux 流事件)。插件爲只讀設計,不修改 DSH 核心行爲。
核心功能¶
下面按事件類型說明已覈實的能力。
任務完成提醒¶
每輪對話結束時彈出綠色「Task completed」通知,展示會話信息與耗時,帶綠色勾選圖標。
審批等待提醒¶
出現待審批工具調用時彈出琥珀色「Waiting for your approval」通知,展示工具名稱與警示圖標。
跨窗口與交互¶
- 在其他應用窗口工作時也會彈出,不侷限於 DSH 標籤頁在前臺。
- 點擊通知會聚焦 DSH 窗口並打開對應會話。
- 通知 3–5 秒後自動消失(時長可調)。
- 播放 D4→A4 兩音柔和提示音;同一事件去重,不會重複彈出。
- 插件不會代替用戶點擊批准。
設置項¶
在 DSH 設置 → Reminders 中可配置:
| 設置項 | 默認值 | 說明 |
|---|---|---|
| Notification permission | 未設置 | 一鍵授權併發送測試彈窗 |
| Approval reminders | 開啓 | 關閉後不彈審批提醒 |
| Completion reminders | 開啓 | 關閉後不彈完成提醒 |
| Duration | 3–5 s | 自動消失前的秒數 |
| Failure alerts | 關閉(預留) | 計劃在 v0.3 提供 |
安裝與啓用¶
先做插件安裝,再在 Web 配置裏註冊並重啓進程。
1. 安裝插件¶
通過 DSH CLI 安裝(Web profile):
dsh plugin --profile web add <dsh-reminder>
也可使用 npm:
npm i dsh-reminder
2. 註冊並重啓¶
在 profile 的 bundle 列表中註冊 dsh-reminder,然後重啓 DSH Web 進程,使 host 與 client 生效。
典型用法¶
安裝並重啓後,按下面步驟完成授權與驗證。
- 打開 DSH 設置 → Reminders。
- 點擊 Enable & test notifications,在瀏覽器權限對話框中選擇允許;應立即收到一條測試彈窗。
- 切到其他窗口繼續工作。當智能體完成一輪或等待你批准工具調用時,右下角會彈出對應通知;點擊即可回到會話。
提示音受瀏覽器自動播放策略限制,首次需在頁面內有一次點擊後纔會解鎖。
適用場景與注意¶
適合誰: 長時間讓 DSH 在後臺跑任務、經常切窗口的開發者;需要及時響應工具審批、又不想反覆手動切回 DSH 標籤頁的用戶。
使用注意:
- 通知權限必須由用戶手勢觸發(瀏覽器策略),設置頁的測試按鈕即爲此設計。
- Chrome 頁面通知不支持
actions按鈕,只能通過自動關閉或懸停關閉;持久化帶 actions 的通知需 Service Worker,本插件未採用該路徑。 - Failure alerts 當前爲預留項,默認關閉。
- 插件隨當前 DSH 進程權限運行。安裝前請閱讀 GitHub 源碼 與 MIT 許可證,確認符合你的安全與合規要求。
社區目錄 SkillHub 爲獨立站點,與 DeepSeek / 幻方無官方從屬關係;插件信息以倉庫 README 爲準。
結尾¶
dsh-reminder 把「任務完成」和「等待審批」兩類事件做成跨窗口提醒,點擊即可回到會話,改動範圍限於通知層,不碰 DSH 核心邏輯。若你已在用 DSH Web 端並希望減少「切回去看一眼」的頻率,可以按上文步驟安裝試用。