前言¶
DeepSeek Harness（DSH）可以在本機桌面或 dsh web 裏管理智能體工作區與會話。若你在局域網或雲上還有幾臺正在跑的 dsh，常見做法是每臺單獨開瀏覽器標籤，或在 SSH 隧道里切地址。切換成本高，側欄也無法一眼看到「哪臺機器上還有哪些會話」。dsh-peerbar 由社區維護者 observer130 發佈，目標是把本機與各遠端的 dsh 收進同一個官方前端：工作區與會話混排在官方側欄，點哪條就在官方中欄跟哪臺交互，實際執行仍發生在對應遠端進程上。
這是什麼¶
dsh-peerbar 是 DSH 社區插件（倉庫 observer130/dsh-peerbar），當前 package 版本爲 1.2.0，許可證 MIT。它通過 HTTP/TLS 直連各遠端 dsh，不需要 SSH 隧道；遠端實例不必安裝本插件，只要地址可直達且持有訪問令牌即可。
核心功能¶
下面介紹 README 中已說明、且與實現描述一致的能力。
統一側欄與按主機分組¶
本機與各遠端的工作區、會話出現在官方側欄同一列表裏。側欄頂層是多行可摺疊分組（本機用顯示器圖標、遠端用雲圖標），展開後是該主機下的工作區條目。選中遠端會話時，由官方中欄渲染界面，消息下發、停止、改名等寫操作在遠端 dsh 上執行。
「遠程主機」設置¶
在設置裏提供「遠程工作區 / 遠程主機」相關界面：每臺主機一張卡片，展示在線狀態、延遲、憑據是否有效，並支持刷新、更新令牌、刪除；卡片下方有「添加」，彈窗填寫名稱、地址與令牌。
狀態與緩存¶
設置頁可集中查看各 Host 的在線、延遲與憑據狀態。遠端工作區信息讀取失敗時，側欄仍可能保留此前緩存的標題，避免列表瞬間空白。
適配版本¶
| 項 | 要求 |
|---|---|
| DeepSeek Harness | 桌面 0.2.2-alpha.2（README 實測）；遠端 0.2.1-rc.2 / rc.3（README 實測） |
| 宿主形態 | DSH Desktop 與 dsh web |
| 插件 engines（package.json） | dsh >=0.2.1-rc.1 且 <0.3.0 |
| 遠端 | 正在運行的 dsh，地址可直連（同網段或可達即可） |
安裝與啓用¶
安裝方式以倉庫 README 爲準，不要憑插件名自行拼接 CLI 安裝命令。
從 GitHub 安裝（推薦）¶
- 打開 DSH Desktop → 側欄 插件 → 右上 添加插件
- 輸入倉庫地址，點 安裝：
https://github.com/observer130/dsh-peerbar
- 安裝完成後點 立即啓用（或打開插件卡片上的開關）。側欄出現「本機 / 遠端主機」一類分組即表示已生效。
從本地目錄安裝（開發用）¶
- 側欄 插件 → 右上 添加插件
- 填寫本倉庫在本地的絕對路徑
- 安裝後同樣 立即啓用
倉庫根目錄即爲安裝器使用的組合包，按 commit 打包；發佈說明見 README「發佈說明」一節。
典型用法¶
經過上面的安裝與啓用，按下面步驟添加第一臺遠端 Host。
- 打開 設置 → 遠程工作區（或 README 中的等價入口），添加 Host：名稱、地址（示例格式如
https://10.0.0.10:3080）、訪問令牌。 - 令牌即遠端 dsh 啓動後瀏覽器 URL 裏
?token=後面的字符串。 - 若遠端使用自簽證書，可在該 Host 上勾選「跳過證書校驗」——README 明確建議僅在內網使用；更穩妥的做法是給系統信任根證書，或在配置中使用
caFile指定 CA（詳見 README「注意事項」）。
憑據與換來的 cookie 保存在本機 ~/.dsh/dsh-peerbar.json（權限 0600），不會向界面回傳明文令牌。
適用場景與注意事項¶
適合誰：需要在同一 DSH 桌面或 Web 前端裏切換多臺 dsh（本機 + 局域網/可達雲主機），且各遠端已獨立運行、網絡可直連的場景。
權限與安全：插件隨當前 DSH 進程運行，對遠端發起的操作具備該令牌對應權限；安裝前請自行審閱源碼與 MIT 許可證。README 強調：會在遠端執行寫操作（發消息、停止、改名、歸檔/置頂、分叉、新建/刪除工作區等）。
能力與邊界（均來自 README）：
- 不搬運文件內容：遠端會話裏的文件引用只做提示，不會在本機打開同名文件；查看內容請用右側「文件」面板（只讀，直接讀遠端）。
- 不做中轉與 NAT 穿透：只支持可直達地址。
- 遠端 localhost 鏈接：從聊天區經「側邊欄打開」時會被攔截並複製地址，避免誤開本機同名端口；本機瀏覽器仍無法直接打開遠端服務，端口轉發不在本項目範圍內。
社區插件目錄頁：skillhub.cn/plugins/observer130/dsh-peerbar。該站點爲社區生態索引，與 DeepSeek / 幻方無官方從屬關係；問題與更新以 GitHub 倉庫爲準：https://github.com/observer130/dsh-peerbar。
