前言¶

在 DeepSeek Harness (DSH) 的插件生態中，開發者常遇到”問完就切走、後臺等結果”的場景。dsh-pharos（法羅斯燈塔）旨在解決這一問題，作爲桌面守望提醒插件，它提供多路狀態通知與系統交互能力，確保不會遺漏關鍵的任務完成、錯誤或需要人工介入的信號。

功能概覽¶

該插件由 Leo Chen (Leo-Cjw) 維護，遵循 MIT 許可證。核心能力包括：

• 多路提醒：支持操作（審批/確認）、完成、錯誤、中斷、上限、後臺任務及工作流進展等多種事件類型。
• 系統交互：提供系統原生通知、分音型提示音及標題標記（如 🔔 需要你），點擊通知可直接跳轉至對應會話（v0.6.3 起由宿主 uiWorkspace.openSession 實現）。
• Webhook 推送：支持向企微、飛書、釘釘及通用渠道推送消息，並包含當輪統計（Token/緩存/TPS）。
• 自動化控制：內置免打擾時段、子代理過濾、SSE 橋接與遠程觸發功能。

安裝與配置¶

通過 DSH 插件目錄安裝：

# 通過目錄鏈接安裝（需 DSH 環境支持）
https://www.skillhub.cn/plugins/Leo-Cjw/dsh-pharos

或通過 GitHub 倉庫安裝：

https://github.com/Leo-Cjw/dsh-pharos

配置入口位於 DSH 的 設置 → 消息通知。設置修改後約 0.8 秒自動保存。

使用說明¶

調整提醒時機¶

默認情況下，”回覆完成”僅在頁面隱藏或後臺時提醒。在設置頁可調整至三檔：關閉 / 僅頁面隱藏時提醒 / 始終提醒。對於”需要你操作”的請求，默認全時提醒，但在當前會話頁面在前臺時會靜默只保留標題標記。

配置 Webhook¶

在設置頁的 Webhook 渠道管理中，可配置企微、飛書、釘釘（支持加簽）及通用透傳。消息格式支持簡潔、詳細或自定義三檔，自定義檔允許使用 {title}{note}{kind}{summary} 等變量進行排版。

腳本調用¶

插件暴露了全局對象 window.__dshPharos，可通過 JS 腳本控制：

window.__dshPharos.setConfig({
  enabled: true,               // 主開關
  sound: true,                 // 提示音
  doneHiddenOnly: true,        // 完成提醒時機
  quietHours: { enabled: false, start: "23:00", end: "08:00" }, // 免打擾
  workflowEvents: false,       // 工作流提醒
  webhooks: []                 // Webhook 配置
})

注意事項¶

• Windows 平臺限制：Windows 原生通知 tag 長度受系統限制（約 64 字符），v0.6.4 版本修復了該問題。此外，Windows 原生通知依賴 DSH host 在線運行。
• 去重機制：爲防止重複通知，插件採用 SSE 幀級 2s 窗口去重、雙源 done 去重以及同會話節流（默認 6s）。
• 瀏覽器兼容：瀏覽器通知功能零依賴，但點擊跳轉功能（v0.6.3）需宿主提供 uiWorkspace.openSession 接口。
• 權限要求：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。