前言¶

在 DeepSeek Harness (DSH) 的使用中，智能體常在後臺運行。當任務需要用戶介入（如模型提問、授權請求或方案審查）時，若用戶處於頁面失焦或隱藏狀態，容易錯過處理時機。dsh-tab-alert 插件旨在解決這一可見性問題，同時爲外部工具提供統一的事件數據流。

功能¶

該插件提供兩項核心能力：

任務欄提醒
當 dsh 需要用戶操作時，插件通過 Web Notification 觸發系統通知，並在操作系統任務欄上閃爍圖標（Windows 下爲橙色閃爍，Linux 下爲通知與 Dock 脈衝）。僅對以下場景觸發：
1. 模型提問
2. 授權請求
3. 方案審查
4. 目標完成/失敗
5. 後臺任務完成/失敗
6. 會話在別處完成
7. dsh 完成當前回合

實時事件源
插件維護各會話的實時狀態機，並將歸一化的狀態數據通過 WebSocket 端點對外提供，供外部消費方使用。
- 端點地址：ws://127.0.0.1:<port>/tab-alert/stream
- 典型應用場景：dsh-pet 桌面寵物插件、狀態面板或自定義監控工具。

安裝¶

安裝前請確保 dsh CLI 可用，且目標 profile（如 web）已初始化。

1. 執行安裝腳本：

powershell -ExecutionPolicy Bypass -File .\install.ps1

2. 卸載插件：

dsh plugin --profile web remove dsh-tab-alert

配置¶

可通過 dsh 行級 config 覆蓋默認值。以下配置項可用於控制通知行爲：

- id: dsh-tab-alert
  config:
    enabled: true
    kinds:
      question: true
      approval: true
      planReview: true
      goalComplete: true
      goalBlocked: true
      jobCompleted: true
      jobFailed: true
      sessionCompleted: true
    silent: true              # 靜音模式：只閃爍不響鈴
    requireInteraction: false # 通知常駐直到手動關閉
    debug: true               # 控制台調試日誌

注意事項¶

• 僅對需要用戶介入的場景（提問、授權等）觸發提醒，普通回覆不觸發。
• 首次使用需請求通知權限，用戶拒絕後插件保持靜默，不做頁內降級。
• 插件依賴以下 peerDependencies：
• @deepseek-ai/cordis (^4.0.1)
• @deepseek-ai/dsh-client-runtime (^0.1.0-rc.6)
• 卸載插件後，相關的訂閱快照與通知配置將自動清理。

結語¶

dsh-tab-alert 通過系統通知與任務欄閃爍解決了後臺任務可見性問題，同時通過 WebSocket 爲外部工具提供了統一的事件流接口。該項目遵循 MIT 許可證，源碼與文檔可在其 GitHub 倉庫查閱。