前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在智能體開發場景中，讓 Agent 能夠安全地管理遠程服務器（如阿里雲 ECS）是核心需求之一。傳統的 SSH 方案往往需要維護複雜的代理配置，或者直接暴露公網 IP，存在安全隱患。dsh-workbench-ecs 插件通過驅動本地的 Workbench CLI，讓 Agent 能夠在無需公網 IP 的情況下，通過 Workbench 後端通道安全地操作實例。

這是什麼¶

這是一個 DeepSeek Harness (Cordis) 插件，由 nishuoyang 維護。它的核心作用是提供一套 Agent 原生的工具集，讓智能體能夠通過本地 Workbench 後端通道控制阿里雲 ECS 實例。插件採用 MIT 許可證，支持在 Web 和桌面端運行。

核心功能¶

該插件提供以下能力：

1. 跨平臺支持：支持 Web (dsh web) 和 DeepSeek Harness 桌面應用 (dsh-desktop-host)，版本要求 v0.9.0+。
2. 11 個 Agent 原生工具：覆蓋從發現到驗證的全流程。
   • ecs_find：跨區域搜索實例。
   • ecs_list：列出實例。
   • ecs_exec：執行遠程命令。
   • ecs_log：讀取遠程日誌。
   • ecs_upload / ecs_download：文件傳輸。
   • ecs_diagnose：診斷實例。
   • ecs_deploy：部署操作。
   • ecs_runbook：運行編排。
   • ecs_snapshot：生成快照。
   • ecs_session：會話管理。
3. 安全機制：所有破壞性命令（如重啓、刪除）都經過 Harness 審批，除非明確允許，否則拒絕執行（Fail Closed）。
4. 無公網 IP 依賴：通過 Workbench 後端通道訪問實例，無需配置公網 IP。
5. 快照管理 (ecs_snapshot)：支持創建只讀收集，生成可比較的快照清單（寫入 .dsh/workbench-ecs/snapshots/ 目錄），用於回滾和差異檢查。
6. 高級特性：支持參數契約校驗、上傳重試、長任務分離、日誌游標讀取、跨區域搜索、項目級實例錨點等。

安裝與啓用¶

插件需要通過包管理器或源碼安裝。安裝完成後，插件會自動註冊上述 11 個工具。在桌面端或 Web 界面的設置面板中，可以查看工具狀態、管理實例錨點並進行驗證。

典型用法¶

• 實例發現：使用 ecs_find 搜索特定名稱或標籤的實例，無需預先知道實例所在的具體區域。
• 快照創建：在執行破壞性操作前，使用 ecs_snapshot create 生成當前狀態的只讀快照清單。
• 安全執行：執行破壞性命令時，插件會觸發 Harness 審批流程，未獲批准的命令會被拒絕。

適用場景與注意¶

• 適用場景：需要通過 Agent 自動化管理阿里雲 ECS 的開發者，特別是需要跨區域搜索或嚴格審批流程的場景。
• 系統要求：需要 Node.js >= 18。
• 注意：
  • 插件通過本地 Workbench 後端通道連接實例，因此必須確保 Workbench 服務正常運行。
  • 破壞性命令的執行受到嚴格限制，必須通過 Harness 的審批機制。
  • 代碼託管在 GitHub，使用前請檢查源碼與許可證。

短結尾¶

dsh-workbench-ecs 插件通過本地 CLI 抽象，解決了 Agent 管理 ECS 的網絡和安全問題。更多細節請參考 GitHub 倉庫。