前言¶
DeepSeek Harness 的插件化架構允許開發者擴展環境交互能力。dsh-plugin-ssh 補充了 SSH/SFTP 能力，使 Agent 能夠直接在宿主環境中執行命令、傳輸文件，並利用宿主的 AI 模型輔助排查問題。它無需獨立的 SSH 客戶端，直接集成在 Harness 的工作流中。
插件定位¶
這是 DeepSeek Harness 的 SSH/SFTP 工作區插件，提供多主機終端、文件傳輸與 AI 命令助手。由 techflag 維護，開源協議爲 MIT。
安裝與啓用¶
安裝前需確保已安裝 DeepSeek Harness Web，且版本不低於 0.1.2-rc.1。在下載目錄執行以下命令安裝插件：
npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add ./dsh-plugin-ssh.tgz --ignore-scripts
安裝完成後刷新瀏覽器，在側欄即可看到 SSH 入口，點擊打開工作區。
核心功能¶
主機管理¶
支持添加、編輯和刪除服務器主機。連接前需覈對服務器的 SHA256 指紋以確保安全。可選擇“記住密碼”，密碼會以 AES-256-GCM 加密存儲在宿主本地；私鑰和私鑰口令不保存。刪除主機會同時清除對應的保存密碼。
SSH 終端¶
提供交互式 PTY 終端，支持多會話標籤頁。關閉標籤頁會斷開對應的 SSH 連接。終端尺寸與本地同步。
SFTP 文件¶
支持瀏覽遠程目錄，利用顏色區分文件類型。支持拖放或選擇多文件上傳到當前遠程目錄。選中文件可進行 UTF-8 文本編輯或下載。
工作區佈局¶
文件區與終端區默認上下排列，可通過拖動分隔線調整比例。文件預覽與終端也可上下拖動。
AI 助手與傳輸管理¶
- AI 助手：選中終端內容可點擊“用 AI 解決選中內容”進行分析。
- 傳輸管理：手動上傳及 AI 直傳均顯示字節進度、百分比和速度，支持取消與清理記錄。
典型用法¶
對話中調用¶
在宿主輸入框輸入 @服務器，從候選菜單選擇目標，直接描述任務。例如：“檢查 Java 環境並部署這個 jar”。提交時，任務會被序列化爲模型可見的 SSH 上下文。
完整工作區¶
輸入 /ssh 可打開完整的 SSH 工作區。在此界面中，文件與終端的佈局更加靈活，支持拖動調整。
AI 命令操作¶
AI 在回答中生成的單行 Shell 代碼塊，可點擊 填入終端 或 執行。執行前需確認目標主機，且終端應處於空命令提示符。多行代碼僅用於閱讀。
注意事項與限制¶
網絡與路由¶
SSH 路由僅接受本機地址 http://127.0.0.1:<端口>。遠程訪問 Harness 或使用 localhost 地址暫不支持。
文件與性能¶
- 單文件下載上限 32 MB。
- 64 KB 以內的 UTF-8 文本可編輯；超過 64 KB 時只讀預覽；超過 512 KB 時顯示文件末尾約 512 KB。
- 最多支持 12 個併發 SSH 會話。
功能邊界¶
暫不支持跳板機、目錄遞歸傳輸、斷點續傳、自動重連、終端分屏、主機分組、語法高亮。
數據安全¶
- 密碼存儲在本地文件系統，以當前用戶權限保護，不依賴系統鑰匙串。
- 刪除傳輸記錄不會刪除遠程文件。
- 默認命令超時 60 秒，輸出上限 128 KB。
