前言¶

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 仓库。