前言¶
DeepSeek Harness (DSH) 採用“一切皆插件”的架構，允許開發者通過插件擴展功能。lemoncat7/dsh-ssh 是此類插件之一，旨在解決 AI 代理在遠程服務器上的操作需求。它將 SSH 會話管理、SFTP/FTP 文件傳輸、瀏覽器交互終端、代理和端口轉發功能集成到 DSH 工作區中，無需依賴本機的 ssh 或 sftp 命令即可完成連接。
核心能力¶
該插件提供以下核心功能：
- 認證方式：支持 SSH 密碼、私鑰和 SSH Agent 認證。
- 代理與跳板：支持 HTTP CONNECT、SOCKS5 和 SSH 跳板代理。
- 端口轉發：支持本地轉發（-L）、遠程轉發（-R）和動態 SOCKS5 轉發（-D）。
- 交互終端：提供瀏覽器交互終端，支持輸入、增量輸出、窗口尺寸同步。
- 文件管理：支持 SFTP 和 FTP/FTPS 文件瀏覽、預覽（文本/圖片/PDF）、流式下載以及拖放上傳。
- Markdown 編輯：支持 Markdown 手動/自動刷新模式下的編輯與保存。
- Agent 工具：提供
ssh_list、ssh_set_cwd、ssh_exec、ssh_terminal_open、ssh_terminal_send和ssh_terminal_read等工具接口。
安裝¶
使用官方命令安裝該插件：
dsh plugin --profile web add @lemoncat7/dsh-ssh@latest
安裝或升級後，需重啓對應的 DSH Profile。
典型用法¶
根據使用場景，該插件支持以下操作：
- 執行一次性命令：使用
ssh_exec工具在遠端執行單次命令。 - 打開交互終端：使用
ssh_terminal_open打開當前 Agent 獨佔的 SSH 終端。 - 終端交互：使用
ssh_terminal_send向終端發送文本並等待輸出穩定，或使用ssh_terminal_read分頁讀取終端回滾緩衝區。 - 工作目錄管理：使用
ssh_set_cwd設置並驗證當前會話在指定主機上的工作目錄。 - Markdown 編輯：在 Markdown 手動模式下直接編輯正文並保存，或利用自動刷新模式只讀查看。
- HTML 預覽：在禁用腳本、導航和表單能力的沙箱中顯示 HTML/HTM 靜態頁面。
- 文件下載：使用 SFTP 進行流式文件下載，無需暫存到 DSH 磁盤。
注意事項¶
在使用過程中，請注意以下事實與限制：
- 環境依賴：不依賴本機
ssh或sftp命令。 - 預覽限制：文件預覽最大 1 MB；Markdown 編輯限完整 UTF-8 文件，最大 256 KB。
- 本地目錄：本地目錄支持取決於運行環境（桌面端）。
- 文件保存：保存文件需服務器支持 OpenSSH 原子替換擴展。
- 沙箱顯示：HTML/HTM 在禁用腳本、導航和表單能力的沙箱中顯示。
- 連接安全：首次連接主機需確認指紋。
生態背景¶
DeepSeek Harness (DSH) 是一個基於插件的智能體開發環境。插件目錄（如 skillhub.cn）與 DeepSeek / 幻方無官方從屬關係，是社區驅動的生態補充。本插件由社區開發者 lemoncat7 維護，遵循 MIT 許可證。
