前言¶
在 DeepSeek Harness (DSH) 的使用場景中，本地多項目並行開發或遠程集羣管理往往伴隨着標籤頁混亂與狀態盲區。手動頻繁切換網頁不僅影響效率，也難以實時掌握各實例 Agent 的運行進度。
dsh-server-hub 是一個爲 DSH Web 設計的持久化多實例切換插件。它通過零配置的本地端口掃描自動發現實例，將所有本地及通過 SSH 隧道映射的 DSH 端點聚合進同一個工作臺，支持後臺熱切、全矩陣狀態雷達與全局桌面通知。
核心能力¶
Zero-Config Auto Discovery (智能本地掃描)
插件原生探測本機 TCP 監聽端口，自動識別本地啓動的其他 DSH 實例，或通過 SSH 隧道映射到本機的遠程實例，無需繁瑣配置。
Seamless Hot Switching (常駐 Iframe 後臺熱載)
所有實例在後臺保持掛載，切換標籤時不會重新加載頁面，保留上下文、聊天記錄與輸入框草稿。
Status Radar (全矩陣 Agent 狀態雷達)
提供全局 Agent 狀態視圖，直觀展示各實例的工作進度、等待確認及完成狀態。
Smart Browser Tab (瀏覽器標籤頁智能同步)
瀏覽器標籤頁標題會根據 Agent 狀態動態變化（如顯示旋轉字符或等待標記），無需切回頁面即可感知後臺狀態。
Desktop Notifications (全局桌面被動喚醒)
在需要人工授權或任務完成時，向系統推送通知，減少手動巡檢頻率。
Remote Agents (遠程 Agent 跨實例協作)
主控與遠程均安裝插件後，選擇允許執行的工作區並連接，即可在主控聊天中向其他實例派出任務，接收結果回傳。
安裝與使用¶
安裝插件
在主控或被監控實例上執行以下命令：
dsh plugin --profile web add github:ginkgonine/dsh-server-hub
安裝後重啓 dsh web。
啓用 Hub 面板
在主控 DSH 實例上安裝插件以啓用 Hub 面板與智能發現。插件會自動掃描本地端口。
配置遠程實例
若需管理遠程服務器，通過 SSH 隧道將遠程 DSH 端口映射到本地（例如 ssh -N -L 3101:127.0.0.1:3080 user@server），Hub 即可自動發現並聚合該遠程實例。
命名與授權
在 Hub 標籤中爲實例命名（如 本地-電商重構、A100-訓練機），並在工具欄授權桌面通知權限。
注意事項¶
隱私
狀態總覽 API 僅返回輕量聚合數據（如工作任務數、等待確認數等），不傳輸聊天記錄、提示詞或輸出日誌。
安全
狀態總覽 API 僅接受 Loopback GET/HEAD 請求。
兼容性
需要 DSH 0.2.x+ 和 Node.js ^22.19.0 || >=24.0.0。
反向代理
不要將狀態橋接端點放在會將外部請求轉換成 Loopback 的代理後面。
