DeepSeek Harness (DSH) 旨在通過插件系統擴展能力。在運維場景中,智能體或開發者往往需要在對話中直接操作服務器,而不僅僅是處理文本。dsh-withSsh 插件將 AI 協作、真實的 SSH 終端操作記錄和操作痕跡整合在同一頁面,提供一種可視化的控制台。
這是一個由 lhwu1 維護的客戶端插件,採用 MIT 許可證。它不是獨立的 SSH 客戶端,而是作爲 DeepSeek Harness 的插件存在,用於在對話中連接服務器,讓人工和 AI 共享終端進行操作和復盤。
核心功能¶
該插件主要提供以下能力:
- 服務器狀態監控:提供 CPU、負載、內存、交換區等關鍵指標的查看入口。
- 日誌排查與服務檢查:支持在終端直接輸入命令,也支持讓 AI 執行命令並返回結果。
- 算力與進程檢查:用於確認 GPU 或 NPU 佔用情況。
- 目錄瀏覽:提供只讀的文件樹視圖,顯示目錄和文件元數據。
- 人機協同:人工和 AI 可以在同一對話中執行命令,且操作來源在終端中有明確區分。
安裝與啓用¶
安裝插件需要已安裝 DeepSeek Harness 並能在命令行使用 dsh。通過以下命令將插件添加到 Harness 的 web 配置檔:
dsh plugin --profile web add github:lhwu1/dsh-withSsh
安裝完成後,需要檢查配置是否加載。確認輸出中包含 dsh-withssh 和 dsh-withssh-web。隨後啓動 Web 表層:
dsh --profile web --port 3080
在瀏覽器訪問對應地址,在對話中選擇 SSH 控制台 標籤頁即可使用。
典型用法¶
- 建立連接:在對話的 SSH 控制台輸入主機、端口、賬號和密碼建立連接。插件會返回 SHA-256 主機密鑰指紋,必須由用戶手動覈對確認。
- 人工操作:連接成功後,在右上角的終端直接輸入命令(如
top、systemctl),查看服務狀態或日誌。 - AI 協作:在對話中告知 AI 需要檢查服務。AI 會通過
ssh_exec執行命令。終端中 AI 的命令會顯示爲黃色,點擊?可查看中文說明。 - 結果交互:終端顯示遠端回顯,AI 對話中也會收到標準輸出、錯誤輸出和退出碼。用戶根據真實日誌決定下一步。
適用場景與注意事項¶
- 適用人羣:運維人員、SRE、平臺工程師以及需要與 AI 協作進行服務器巡檢和故障排查的開發者。
- 安全與限制:
- 密碼僅短暫經過連接請求和插件進程內存,不會寫入持久化文件。
- 首次連接必須手動確認主機密鑰指紋。
- 遠端輸出限制爲 256 KiB,且移除了 ANSI/OSC 控制序列。
- 文件瀏覽器爲只讀模式,不支持上傳或刪除。
- 高風險操作(如遞歸刪除)會請求 Harness 審批。
- 插件依賴 Harness Web 表層的同源訪問模型,重啓 Harness 會清理內存中的 SSH 連接。
該插件通過整合 AI 對話與真實終端,解決了在單一界面中完成服務器操作與復盤的需求。更多細節可查閱 插件目錄 或 源碼倉庫。