前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在本地編寫代碼並管理遠程服務器之間建立連接，是常見的開發場景。dsh-ssh-files-sidebar 插件爲 DSH 提供了完整的 Remote SSH 工作區，整合了文件管理、終端操作、遠程編輯以及從零到一的部署閉環能力。
核心功能¶
該插件由 qigelunbiya 維護，屬於“工作流”類別。它是一個 Remote SSH workspace & deployment Agent，支持 SSH Files、Terminal、遠程編輯，以及基於 DEPLOYMENT.md 的自動化部署與回滾。
-
Remote SSH Workspace
插件內部整合了文件側欄、終端與遠程編輯功能。SSH 主機與憑據只維護一份，存儲在~/.dsh/dsh-ssh.json中。一個 Conversation 僅綁定一個 SSH 目標，防止 Agent 枚舉或切換主機。 -
SSH Files / SFTP / Terminal
支持遠程目錄樹瀏覽、編輯（基於 CodeMirror）、上傳下載、多選、歸檔查看（TAR/TGZ/ZIP 等）、圖片預覽（PNG/JPG/GIF 等）以及遠程 Terminal 操作。 -
本地源碼 + Linked SSH
推薦的日常開發模式爲：本地 Workspace 寫代碼，會話綁定唯一 SSH 目標，用於服務啓動、日誌查看和端口檢查。 -
Remote Vision / OCR
Agent 可以直接讀取當前 SSH 上的圖片進行視覺分析，或調用系統 OCR，無需先將截圖複製到本地 Workspace。 -
Zero-to-One Bootstrap
對於陌生的項目，插件不會盲目生成DEPLOYMENT.md。它會先只讀檢查本地項目（技術棧、運行時、入口）和遠程服務器（OS、架構、權限、端口），生成 Bootstrap Plan 並逐步驗證。只有在第一次真正穩定後，纔會將實際成功路徑沉澱爲DEPLOYMENT.md。 -
Runbook 與自動化邊界
插件將部署流程沉澱爲DEPLOYMENT.md。在生成腳本前，會通過標記（AUTOMATE / KEEP MANUAL 等）與用戶確認真實使用習慣。最終腳本僅自動化用戶真正希望交給機器的部分。 -
Agent 自主發佈與閉環
驗證通過後，Agent 的角色從“給命令”升級爲“執行發佈”。它可以自主執行已驗證的自動化、自檢進程/端口/日誌、總結變更集，並在用戶驗收後進行診斷、修復或回滾。
安裝與啓用¶
推薦使用預構建的 GitHub Release 包，無需自行構建。
dsh plugin --profile web add https://github.com/qigelunbiya/dsh-ssh-files-sidebar/releases/latest/download/dsh-ssh-files-sidebar.tgz
安裝後啓動 Web Profile：
dsh web
典型用法¶
- 連接與文件操作: 連接 Linux 服務器，通過側欄瀏覽、編輯、上傳或下載遠程文件。
- 本地開發 + 遠程服務: 在本地 Workspace 編寫代碼，通過 Linked SSH 在服務器上啓動服務、查看日誌或檢查端口。
- 陌生項目部署: 接手僅有源碼和目標服務器的項目，Agent 可通過 Zero-to-One Bootstrap 分析環境，嘗試部署並生成 Runbook。
- 流程沉澱: 將跑通的部署步驟寫入
DEPLOYMENT.md，經用戶確認後轉化爲自動化腳本。
注意事項¶
- 會話鎖定: 一個 Conversation 只操作一個 SSH 目標。
- 權限控制: 高風險動作仍走 Harness 原生審批。陌生項目 Bootstrap 期間，不會爲了“讓它跑起來”默認修改全局 Runtime、防火牆、反向代理或數據庫。
- 回滾策略: 除非用戶已經明確批准自動回滾條件，否則生產異常不會靜默自動回滾。
總結¶
該插件通過將 SSH 工作區與部署 Agent 融合，幫助開發者從手動操作走向自動化閉環。如需更多信息或源碼，可訪問其 GitHub 倉庫。
