dsh-ssh-workspace-manager: SSH 遠程管理與部署插件

前言¶

在 DeepSeek Harness (DSH) 中，讓 Agent 完成“部署到服務器”通常涉及猜路徑或沙箱無法執行的外部命令。事實（主機、路徑、運行時）屬於設置，而非提示詞。這個插件將這些事實集中管理，提供設置頁面和 Agent 工具。

是什麼¶

dsh-ssh-workspace-manager 是一個 DSH 插件，用於管理 SSH 主機、工作區綁定，以及遠程執行、同步和 compose 管理。由 telagod 維護。它將 SSH 遠程功能引入設置頁面，供人類配置，並供 Agent 使用工具。

核心功能¶

該插件提供了一套完整的 SSH 管理能力，分爲設置界面與 Agent 工具兩類：

1. 設置頁面

   • SSH 遠程：在 Settings 中提供 SSH 遠程頁面。
   • 主機管理：添加、測試連接、檢查系統信息（OS、內核、容器運行時）。
   • 綁定管理：記錄工作區部署目標，支持解綁操作。

2. Agent 工具

   • ssh_status：列出主機、綁定以及當前工作區的綁定信息。
   • ssh_bind：記錄當前工作區的部署目標（主機、遠程路徑、角色、運行時、Compose 文件等）。
   • ssh_unbind：通過 ID 移除綁定。
   • ssh_exec：在綁定的遠程目錄中運行命令。
   • ssh_sync：將本地工作區推送到遠程目錄。
   • ssh_compose：管理遠程目錄中的容器（支持 ps、logs、up、down）。
   • ssh_inspect：探測操作系統、內核、容器運行時。

安裝與啓用¶

安裝該插件需滿足 Node.js 版本 >= 22。

dsh plugin --profile web add github:telagod/dsh-ssh-workspace-manager

安裝後需重啓 Web 配置文件。

重要：不要手動插入插件。dsh plugin 擁有 dsh.profile.bundles，手動插入會導致“重複 loader entry id”錯誤。

典型用法¶

1. 配置階段：人類在設置 → SSH 遠程中添加主機，測試連接，調整默認值。
2. 綁定階段：Agent 使用工具 ssh_bind 將當前工作區綁定到服務器。
3. 部署階段：Agent 使用 ssh_sync 將本地工作區推送到遠程目錄。

注意事項¶

1. 作用域：綁定是工作區範圍的，結構爲 (workspace → host → remote directory)。
2. 數值限制：保存時超出範圍的數值（如 timeout）會被限制。
3. 依賴：需要 Node.js 版本 >= 22。

結尾¶

該插件通過將 SSH 管理標準化，解決了 Agent 在遠程部署時的上下文缺失問題。更多信息請參考 插件目錄 或 GitHub 倉庫。