前言¶
在 DeepSeek Harness(DSH)裏做智能體開發時,常見情況是同一臺機器上要切換 Claude Code、Codex、OpenCode OMP 等多套 CLI 會話,遠程環境還要走 SSH。原生 DSH 會話各自獨立,側邊欄和對話界面也不一致,查歷史工具調用、審批與導出往往要分開操作。
下面介紹社區插件 dsh-remote-agents(維護者 FrankieeW,分類爲客戶端)。它把上述代理的本地與 SSH 對話放進統一工作區,保留 DSH 原生的側邊欄與對話界面,並支持工具審批與持久化歷史。本文爲非官方社區插件說明,與 DeepSeek 無從屬關係;安裝前請自行查看源碼與 MIT 許可證,插件以當前 DSH 進程權限運行。
這是什麼¶
dsh-remote-agents 的定位是:面向 DSH 的「本地與 SSH 智能體艦隊工作臺」。官方 README 概括爲:爲 Claude Code、Codex 和 OMP 提供統一的 DSH 工作區,支持本地與 SSH 對話、工具審批和持久化歷史;原生 DSH 會話仍共用同一側邊欄並保留原有對話界面。
項目聲明爲獨立開發與維護的非官方社區插件,用戶消息與模型輸出不會被翻譯或改寫。當前 npm 包版本爲 0.5.0;0.5.0 將後端遷至 Rust 側車(sidecar),DSH 界面與狀態文件格式保持不變。
核心功能¶
統一工作區與會話¶
可在同一側邊欄中瀏覽 Claude Code、Codex、OMP 的會話,包括嵌套的本地工作區以及獨立的 SSH 工作區。各代理的對話頁籤按產品定製,例如:
- Claude:Chat / Tools / To-dos
- Codex:Chat / Plan / Changes
- OMP:Chat / Tasks / Tools / Models(0.5.0 起增加按會話的 Models 頁籤)
OMP 的 Models 頁籤用於該會話所在機器與工作區範圍內的內置/自定義角色、項目覆蓋、預設、提供商連接與自定義模型定義;配置管理需要 OMP 18.18.x(見倉庫文檔 docs/omp-model-configuration.md)。
對話內 / 命令(Rust 後端執行)¶
在 Claude Code、Codex、OMP 對話中可使用由後端處理的 / 命令,支持鍵盤補全與狀態/幫助,且失敗時保留草稿、不會作爲模型提示發送。0.5.0 列出的命令包括:/help、/status、/model、/effort、/permissions、/rename、/pin、/archive、/new、/stop、/export。詳見 docs/unified-chat.md#conversation-commands。
工具調用歸檔與導出¶
新的本地與 SSH 輪次提供完整工具歸檔:按 16 次調用分頁瀏覽、搜索完整輸入/結果、以 UTF-8 安全頁面閱讀長值,並可將單輪全部工具導出爲 JSONL。較舊的本地 OMP 輪次可從原始會話文件恢復。詳見 docs/tool-history.md。
標題、差異與界面細節¶
- 根據首條提示自動生成標題,支持手動重命名保護,並提供顯式 Use automatic title 操作。
- 結構化文件差異、工具篩選、OMP 任務階段與各代理設置標籤;Composer、草稿、審批與中斷在各視圖間可用。
- OMP 工具、階段、Markdown 與思考層級採用與 DSH 明暗主題一致的語義色。行爲與限制見
docs/agent-ui.md。
SSH 目的地¶
SSH 目標支持 alias、user@host、host:port、ssh://… 等形式;保存前會測試連接,並按機器記錄連接結果,支持安全重命名與移除。
版本線說明¶
| 版本 | 說明 |
|---|---|
0.5.0(latest) |
Rust 側車負責會話與艦隊存儲、CLI 發現、SSH/tmux、審批、導入、搜索/導出等;Host shim 與 Claude SDK 輔助仍爲 JavaScript。包內提供 macOS/Linux arm64 與 x64 可執行文件。 |
| 0.4.1 | 凍結的 JavaScript 實現,源碼在 legacy-js 分支,不再加新功能;與 0.5.0 狀態格式兼容,可降級後仍可讀會話。 |
安裝與啓用¶
在當前運行的 DSH 配置中,通過插件管理器安裝 dsh-remote-agents@latest,或固定爲 dsh-remote-agents@0.5.0。
若顯式使用 web 配置,可在終端執行:
dsh plugin --profile web add dsh-remote-agents@latest
桌面應用應在應用內插件管理器安裝到其已有配置;上述命令不會更新桌面應用的配置。
package.json 要求 Node.js >= 22,DSH >= 0.2.2-rc.1 且 < 0.3.0。從 0.4.1 升級至 0.5.0 時,現有狀態文件格式不變,會話、工作區與機器登記應可保留。
典型用法¶
安裝並啓用後,工作區側欄會出現統一的本地與 SSH 會話列表。可按代理類型打開對應對話頁籤,在 Composer 中發起本地或遠程輪次;需改模型、權限或 Effort 時,在輸入框使用 /model、/permissions、/effort 等命令(由後端處理,不進入模型上下文)。
OMP 會話可在 Models 頁籤中爲當前機器/工作區配置角色與提供商;在 Tools 或歸檔視圖中分頁查看工具調用,必要時將單輪工具導出爲 JSONL。外部會話支持重命名、固定、歸檔/恢復、保留消息全文搜索以及 Markdown/JSON 導出(0.4.0 起的能力在 README 變更日誌中有說明)。
SSH 工作區配置遠程主機後,界面會顯示主機標識與遠程項目目錄,便於確認對話實際運行位置(README 截圖使用演示夾具,不代表真實生產環境)。
適用場景與注意¶
適合:需要在單一 DSH 界面中並聯管理 Claude Code、Codex、OMP 的本地與 SSH 對話,並依賴持久歷史、工具審批、完整工具歸檔與會話級 OMP 模型配置的用戶。
注意:
- 社區插件,非 DeepSeek 官方出品;目錄站點 skillhub.cn 與 GitHub 爲公開信息來源,使用前請審閱代碼與 MIT 許可證。
- 插件權限等同安裝它的 DSH 進程,涉及 SSH 與本地 CLI 時發現與調用,請僅在信任的環境中啓用。
- 需要 OMP 按會話模型管理時,確認 OMP 版本滿足 18.18.x 要求。
- 若需繼續使用純 JavaScript 後端,可安裝
dsh-remote-agents@0.4.1,勿與 0.5.0 混用時期望新特性。
結尾¶
dsh-remote-agents 把多代理、多環境的對話收斂到 DSH 統一工作區,並在 0.5.0 用 Rust 側車承載重負載後端邏輯,同時保持狀態與界面兼容。進一步瞭解功能與截圖見倉庫 README 與 docs/。