在 DeepSeek Harness (dsh) 的生態中,智能體對遠程主機的操作是一個常見需求。傳統方式往往需要在目標機器上部署額外的 Agent 組件,增加了維護成本。dsh-tool-ssh 插件通過調用本地 OpenSSH 客戶端,解決了這一問題,允許 dsh Agent 在不安裝目標端 Agent 的情況下執行命令或傳輸文件。
插件定位¶
dsh-tool-ssh 是一個針對 DeepSeek Harness (dsh) 的 SSH 工具插件,由開發者 hcyinnn 維護,屬於聯網工具類別。它通過 OpenSSH 協議實現遠程交互,核心價值在於零 Agent 部署——只要目標機器支持 SSH 登錄,即可進行操作。該插件採用 MIT 許可證。
核心功能¶
該插件提供三個主要能力:
ssh_run:在遠程主機上執行一條 shell 命令,返回標準輸出、標準錯誤和退出碼。ssh_upload:使用scp將本地文件或目錄上傳到遠程主機。ssh_download:使用scp將遠程文件或目錄下載到本地。
安裝¶
安裝前需確保本地已安裝 DeepSeek Harness (dsh) 以及 OpenSSH 客戶端(macOS / Linux 自帶,Windows 可使用 OpenSSH for Windows 或 Git Bash)。
使用官方安裝命令:
dsh plugin add github:<你的用戶名>/dsh-tool-ssh
典型用法¶
Agent 可以通過自然語言直接觸發以下操作:
- 在生產服務器
10.0.0.5上執行systemctl status nginx。 - 將本地的
dist/目錄上傳到10.0.0.5:/var/www/app。 - 從遠程主機
web-1下載/var/log/app.log到本地。
適用場景與注意事項¶
該插件適合需要在遠程服務器上進行運維操作、文件傳輸的場景。使用時需注意以下幾點:
- 目標機器要求:目標機器無需安裝 Agent 組件,只要能用
ssh登錄即可。 - 安全與認證:默認啓用
BatchMode=yes,避免交互式提示。建議使用密鑰認證,不要在配置中寫死密碼。 - 輸出限制:爲防止內存溢出,輸出流設置了上限(默認 2 MiB),超出部分會返回
truncated標記。 - 權限風險:插件以當前 dsh 進程的權限運行,安裝前應檢查源碼與許可證。
總結¶
dsh-tool-ssh 通過標準 SSH 協議爲 DeepSeek Harness 提供了遠程操作能力,簡化了運維流程。更多詳情可查閱 GitHub 倉庫 或 社區目錄。