在使用 DeepSeek Harness (DSH) 開發智能體時,切換標籤頁或離開電腦後,無法實時感知 Agent 是否已完成回覆,或是否需要人工介入。dsh-task-feedback 插件通過 Favicon 小圓點提供這種狀態反饋,並輔以音效提示,降低對人工查看的依賴。
插件定位¶
這是一個爲 DeepSeek Harness 打造的會話狀態反饋插件。由 Pudge1996 維護,採用 MIT 許可證。
核心功能¶
1. Favicon 小圓點實時回顯
插件會監聽會話狀態,並在頁面不可見時通過瀏覽器標籤頁的 Favicon 圖標進行視覺提示。顏色與形狀均可配置:
- 顏色狀態:
- 綠色:當前任務已完成
- 藍色:當前任務進行中或子代理正在運行
- 橙色:需要人工介入(等待審批、計劃確認或回答問題等)
- 形狀支持:小圓點 | 圓形 | 圓角矩形
- 觸發邏輯:利用原生 Page Visibility API,僅在頁面不可見時觸發 Favicon 變更。若會話本身已處於空閒/完成狀態,Favicon 保持默認小鯨魚圖標。
2. 音效提示
內置 12 個合成音效,通過 Web Audio API 實現,無外部依賴。支持以下配置:
- 音效區分:可分別爲“任務已完成”和“需要你介入”選擇不同音效。
- 播放時機:
- 始終播放:無論頁面是否可見,只要狀態變更即播放。
- 僅頁面不可見時播放:僅在頁面最小化或切走標籤頁時播放。
3. 技術實現
- 純前端實現。
- 無自定義協議、無 host 命令、無 LLM 調用、不進會話日誌。
- 接入 DSH 的 sessions 與 uiSession 標準服務獲取任務運行狀態。
安裝與啓用¶
使用官方插件安裝命令:
dsh plugin --profile web add dsh-task-feedback
配置與使用¶
- 進入設置:在 DSH 界面中找到設置選項。
- 配置反饋:進入反饋設置頁面。
- 調整參數:
- Favicon 形狀:選擇小圓點、圓形或圓角矩形。
- 音效作用域:選擇“始終播放”或“僅頁面不可見時播放”。
- 音效選擇:爲“任務已完成”和“需要你介入”分別挑選音效。
配置會持久化保存在 localStorage 中。
適用場景與注意¶
- 版本要求:從 DSH v0.1.2-alpha.1 開始適配。
- 模式限制:暫不支持
/goal模式。 - 權限提示:插件以當前 DSH 進程權限運行,安裝前建議檢查源碼與許可證。
總結¶
dsh-task-feedback 通過 Favicon 和音效,解決了開發者在使用 DSH 時“人不在電腦旁如何感知狀態”的問題。所有功能均在前端完成,不會干擾後臺任務邏輯。