前言¶
做智能體或日常運維時，常見做法是：終端在一個窗口、傳文件用 SFTP 客戶端、看指標再開監控面板，對話裏的 Agent 還要單獨配 SSH 密鑰或臨時粘貼命令。上下文在工具之間切換，連接信息也不一定能被 Agent 安全複用。
DeepSeek Harness（DSH）把能力拆成插件。下面介紹社區維護的 foryourever/ssh-plugin-dsh：在 Harness 側欄打開 SSH 工作臺，把交互終端、SFTP、服務器監控和 Agent 工具放在同一界面，並複用已保存的連接。
這是什麼¶
foryourever/ssh-plugin-dsh 是面向 DeepSeek Harness 的客戶端類插件，維護者爲 foryourever。簡介爲：SSH terminal, SFTP and server monitoring plugin for DeepSeek Harness（SSH 終端、文件傳輸與服務器監控）。
項目基於 jinpy666/dbx-plugin-ssh 適配，複用其 Rust 後端與 Vue 終端工作臺，接入 Harness 側欄、連接管理與 Agent 工具服務。當前 package 版本爲 1.0.8，許可爲 MIT；上游後端鎖定 0.7.13-beta.1。插件目錄頁：skillhub.cn/plugins/foryourever/ssh-plugin-dsh，源碼：github.com/foryourever/ssh-plugin-dsh。
核心功能¶
README 中歸納的能力如下，安裝前可按需對照 驗證記錄 瞭解尚未驗收的上游能力（如 Telnet、串口、VNC、實驗性 RDP 等）。
終端工作臺：PTY 交互終端、窗口調整、批量輸入、快速命令、終端錄製與遠程目錄跟隨。
SFTP：瀏覽、排序、預覽、上傳下載、重命名與目錄管理；傳輸進度與取消；文件選擇器與拖放上傳。系統剪貼板文件粘貼取決於宿主是否提供原生 paste 文件事件。
服務器監控：CPU、內存、磁盤、網絡趨勢，以及進程、磁盤和容器相關面板。
連接與認證：密碼、私鑰、SSH Agent 與自動認證；最多三跳 ProxyJump、連接保活、Known Hosts 校驗；只讀模式、sudo 配置、命令白名單與操作審計等沿用上游能力。創建連接的表單與說明已中文化，私鑰可通過「選擇文件…」導入；界面跟隨 Harness 亮暗主題。
多會話：可同時連接不同服務器，或對同一服務器「新建會話」；標籤切換保留各自終端與文件面板；關閉標籤或「斷開連接」只結束當前會話。返回列表或切換側欄會保留會話；刷新頁面或退出 Harness 會結束當前客戶端會話。
Agent：與界面共享已保存連接；固定後端版本註冊 16 個 SSH/SFTP 工具（數量以運行時清單爲準），並支持在可見終端中執行 AI/MCP 命令以便觀察過程。
| 類別 | 工具 |
|---|---|
| 命令與終端 | ssh_exec、ssh_exec_sudo、ssh_multi_exec、ssh_terminal_input |
| 後臺任務與連接 | ssh_run_bg、ssh_task_status、ssh_close、ssh_list_connections |
| 主機指紋 | ssh_list_known_hosts、ssh_remove_known_host |
| SFTP | sftp_list_dir、sftp_stat、sftp_upload、sftp_download、sftp_read_file、sftp_write_file |
安裝與啓用¶
前提：本機已安裝 DeepSeek Harness。倉庫自帶構建好的客戶端與 macOS ARM64 後端；其他平臺需 Node.js 22+ 與 Python 3，在插件目錄執行 npm run setup:backend，腳本會按平臺下載鎖定版本官方後端並校驗 SHA-256。發佈資產覆蓋 macOS ARM64/x64、Linux x64/ARM64、Windows x64；README 寫明當前運行驗收環境爲 macOS ARM64。
安裝步驟以倉庫 README 爲準：先取得插件的本地目錄並完成上述後端準備，再在可調用 plugin_manager 的 Harness 會話中安裝本地 bundle。將 target 換成本地目錄的絕對路徑：
{
"action": "install_bundle",
"target": "/absolute/path/to/ssh-plugin-dsh"
}
也可在對話中讓 Agent 執行同等操作，例如說明：使用 plugin_manager 安裝本地 bundle，目錄是 /absolute/path/to/ssh-plugin-dsh。
檢查安裝結果裏的 application 與 warnings：applied 表示已應用，restart-required 表示需要重啓對應 Harness 實例。
打開工作臺：
- 點擊 Harness 左側 SSH。
- 點擊「添加服務器」，填寫地址、端口、用戶名與認證方式；私鑰可「選擇文件…」導入。
- 保存並連接，使用終端、SFTP、監控與端口映射等。
- 在對話中讓 Agent 引用已保存連接執行任務。
插件啓用後由 Harness 管理後端，無需每次手動啓動。編輯連接時，留空已有密碼可保留原值，勾選清除選項纔會清空。
側欄沒有 SSH 入口時（README 常見問題）：在 DeepSeek Harness Desktop 0.2.1-rc.5 中，新插件可能已在後端運行，但前端仍用啓動時的清單。需 ⌘Q 完整退出 Harness 再打開；僅關窗口或刷新頁面可能無法更新清單。
本地目錄更新插件時：在倉庫中同步最新代碼後，按安裝結果處理重新加載或重啓；已打開頁面需刷新才能用新客戶端，刷新會結束當前連接。
典型用法¶
界面運維：日常巡檢與排障用終端、命令歷史、快速命令與指標/進程查看；改配置或傳包用 SFTP；內網訪問可配置 ProxyJump 與保活。
Agent 對話示例（README 原文風格，連接名需換成你保存的名稱）：
列出 SSH 服務器，連接“測試服務器”，查看磁盤使用情況和最近的錯誤日誌。
將本地配置上傳到測試服務器，讀取上傳後的文件並覈對內容。
在測試服務器執行一個後臺任務，然後查詢任務狀態。
建議在服務器表單中保存憑據，讓 Agent 通過連接名稱或 ID 引用，避免在對話中粘貼密碼或私鑰。上游只讀限制、危險命令檢查、連接範圍與 sudo 白名單繼續生效。
數據、安全與適用注意¶
連接數據默認在 ~/.dsh-ssh/default；不同 DSH_PROFILE 使用不同子目錄，也可通過 DSH_SSH_DATA_DIR 或插件 dataDir 指定。內容以 AES-256-GCM 加密存於本機數據目錄，密鑰與密文應一併備份；這不能隔離同一系統賬戶下的其他進程。插件不自動導入既有 DBX 應用中的連接。取消、超時或刪除服務器可能重啓整個後端並關閉其他活動會話；已被遠端接受的命令可能仍在運行。細節見倉庫 ADAPTATION.md。
適合誰：需要在 Harness 內完成 SSH/SFTP 運維，並希望 Agent 與人工共用同一套連接與審計策略的開發者或運維人員。
使用前請知悉：
- 插件在當前 DSH 進程權限下運行；安裝前應自行審閱源碼與 MIT 許可及 NOTICE 中的第三方歸屬。
- 瀏覽器宿主下的上傳/下載與私鑰導入行爲與 DBX 原生桌面不同，不能假定任意本機路徑或流式落盤能力（README「常見問題」有說明）。
- SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；本插件爲社區適配項目，不代表上游作者或 DeepSeek 官方發佈。
結尾¶
經過上面的步驟，你可以在 Harness 側欄集中使用 SSH 終端、SFTP 與監控，並讓 Agent 通過 16 個工具複用已保存連接做自動化。進一步瞭解安裝細節、Agent 工具與開發構建，見 GitHub 倉庫 README 與 docs/ADAPTATION.md。
- 目錄頁：https://www.skillhub.cn/plugins/foryourever/ssh-plugin-dsh
- GitHub：https://github.com/foryourever/ssh-plugin-dsh
