DeepSeek Harness SSH 會話管理插件介紹

前言¶

DeepSeek Harness（DSH）採用插件化架構。在本地開發或運維場景中，連接服務器通常需要維護獨立的 SSH 配置文件，手動輸入密碼或密鑰，且命令執行結果難以直接反饋給 Agent。sycada/dsh-remote-ssh-tools 是一個爲 DSH 提供的 SSH 會話管理插件，它通過集中維護連接檔案、提供 Agent 工具接口以及內置交互式終端，解決了遠程連接與操作的安全性與效率問題。

核心功能¶

該插件提供以下主要能力：

連接檔案管理：集中維護 SSH 檔案（名稱、分組、主機、端口、用戶、認證方式、私鑰路徑、備註等），支持從界面或 Agent 調用中快速讀取。
Agent 一鍵執行（ssh_run）：支持遠程執行單條命令，可獲取退出碼、標準錯誤輸出、執行耗時，並支持輸出截斷和超時控制。
交互式終端（xterm）：在瀏覽器內提供 xterm 終端，支持窗口縮放、會話跨頁面刷新保活，關閉即結束遠端會話。
文件傳輸（SFTP）：提供上傳、下載、列表功能。下載默認開啓防覆蓋機制，上傳支持自動創建遠端目錄。
憑據安全：密碼與私鑰口令僅以引用名寫入 DSH 憑據中心（~/.dsh/.credentials.yaml），檔案 JSON 文件不包含任何明文密鑰。密碼值絕不進入進程命令行。
主機密鑰指紋緩存：支持 accept-new 和 strict 模式，首次連接自動記錄指紋，防止中間人攻擊。
Agent 工具注入：即插即用的系統提示詞，Agent 可自動識別並選用可用工具。

安裝與啓用¶

安裝需修改 DSH profile 的 package.json 文件，通過 GitHub 引入依賴。

打開 DSH profile 目錄下的 package.json。
在 dependencies 中添加 GitHub 倉庫鏈接（版本號 v0.1.2）：

    "dependencies": {
      "dsh-remote-ssh-tools": "https://github.com/Sycada/dsh-remote-ssh-tools.git#v0.1.2"
    },
    "dsh": { "profile": { "bundles": [ "dsh-remote-ssh-tools" ] } }

在 profile 目錄執行 pnpm install。
重啓 DSH。

注意：npm 上存在另一個名爲 dsh-remote-ssh 的包（Yan-Zero/dsh-remote-ssh，Apache-2.0），與本插件（MIT 協議，Sycada 維護）無關，安裝時請確認倉庫地址。

典型用法¶

安裝並重啓後，可在設置頁或對話中調用相關功能：

Agent 執行命令：
- 對話指令：“連生產服務器跑 df -h”，Agent 會自動選擇檔案執行。
- 對話指令：“用 test 檔案跑 uptime”。
打開終端：
- 在設置頁點擊“打開終端”。
- 或讓 Agent 執行 ssh_session_open 後調用 sidebar_open 將終端頁嵌入側邊欄。
文件傳輸：
- 讓 Agent 執行 ssh_sftp_upload、ssh_sftp_download 或 ssh_sftp_list。

Agent 工具清單¶

插件向 Agent 提供以下工具（共 13 個）：

ssh_profile_list / add / update / remove：檔案的增刪改查。
ssh_profile_test：連通性及認證探測。
ssh_secret_status：報告憑據引用狀態（不顯示值）。
ssh_run：遠程單條命令執行。
ssh_session_open / list / close：交互會話管理。
ssh_sftp_list / upload / download：SFTP 文件操作。

系統要求與限制¶

環境要求：依賴 DSH >= 0.1.1-rc.1，Node.js >= 20。
Agent 轉發：SSH Agent 轉發（ssh -A）在 v0.1 版本的交互引擎中暫不支持。
網絡功能：連跳板機與端口轉發功能規劃中（預計 v0.2+）。

總結¶

該插件通過將 SSH 檔案管理與 DSH 憑據中心集成，實現了遠程操作的標準化與安全化。它適用於需要在對話流中直接執行遠程命令、管理多服務器連接或進行文件傳輸的開發與運維場景。完整文檔與源碼可參考 GitHub 倉庫。