随着 AI Agent 技术快速落地,单纯的大模型对话能力已经难以满足复杂任务自动化需求。传统 Agent 开发普遍存在工具调用硬编码、模型适配成本高、能力难以复用的痛点。DeepSeek Harness(简称 DSH)是 DeepSeek 推出的开源智能体框架,基于 Cordis 微内核,采用一切皆插件的架构,模型适配器、工具集、会话存储、沙箱、调度循环、Web 界面全部以插件形式实现,可自由替换、组合,遵循 MIT 协议开源,开发者无需修改内核源码,就能快速搭建具备工具调用、任务拆解、子 Agent 调度能力的智能体应用。

本地运行 DSH 存在明显短板:仅本机可访问,外出、团队协作时无法共享环境,会话和配置不能云端持久化。将 DSH 部署在阿里云 ECS 上,可以实现 7×24 小时持续运行,电脑、平板、手机多设备远程访问,团队共用一套 Agent 工作空间,非常适合开发者、小团队持续调试、运行自动化智能体任务。本文带来完整实操教程,从 ECS 准备、环境安装、DSH 部署、模型接入、安全配置到故障排查,全程可直接复制命令落地。
一、DeepSeek Harness 介绍说明
DeepSeek Harness 核心设计理念:Agent = 大模型 + Harness执行底座阿里云开发...。大模型负责思考、规划;Harness 底座负责任务调度、工具调用、沙箱隔离、会话追踪、插件管理。
- 插件化架构:所有能力都是插件,支持网页搜索、Shell 执行、文件读写、代码审查、子 Agent 等插件,还支持对话内创建自定义插件;
- 完整轨迹记录:全链路事件流日志,支持查看推理过程、工具调用记录、任务回放、任务分叉续跑;
- 多部署形态:支持桌面客户端、npx 一键拉起 WebUI、源码部署三种方式;
- 模型兼容:兼容 DeepSeek 系列模型、阿里云百炼等 OpenAI 兼容接口,切换模型只需要修改配置,不用改动 Agent 逻辑;
- 开源协议:MIT 协议,商用友好,适合二次开发。
二、DeepSeek Harness 部署步骤
1、打开计算巢服务实例创建页面,选择部署地域并填写实例规格、实例密码和网络参数。
DeepSeek Harness 一键部署专题:https://computenest.console.aliyun.com/service/instance/create/cn-hangzhou?type=user&ServiceId=service-252a17b1e4cc425ca5f0
2、确认询价明细后点击 下一步:确认订单,同意服务协议并点击 立即创建。
3、等待服务实例部署完成。部署完成后,在服务实例详情页的 输出 区域查看 WebUIAddress。
4、点击输出中的安全代理访问地址打开 Web UI。页面应展示 DeepSeek Harness 的新会话、设置和选择工作区入口。

首次使用配置
Deepseek Harness Web UI 打开后还不能直接发起会话,必须先完成模型和工作区配置。
1、配置大模型
首次打开会弹出开始使用引导,点击 添加 API Key 可直接进入模型配置;也可以点击左下角 更多 → 设置 → 模型。

①在模型页签中,页面会列出 DeepSeek 提供方(deepseek‑official)与「添加模型提供商」入口。
②任选一种方式完成模型接入:
- a、填写 DeepSeek API Key,使用 DeepSeek 官方模型。
- b、点击
添加模型提供商 → 第三方模型提供商,从内置目录(OpenAI、Anthropic、Kimi、Qwen 等)中选择并填写 API Key。 - c、点击
添加模型提供商 → 自定义模型 API,填写 Base URL、API Key 与模型 ID。
③新增提供商时点击 创建,编辑已有提供商时点击 保存 完成配置。
未配置模型 API Key 时,Web UI 可以打开,但无法正常发起模型请求。
示例:接入阿里云百炼 qwen‑plus
1、在 设置 → 模型 中点击 添加模型提供商 → 自定义模型 API。
2、填写以下配置。API Key 请使用您在百炼控制台申请的密钥,不要将密钥写入对话或公开文件。
| 字段 | 值 |
|---|---|
| Provider ID | bailian |
| 显示名称 | 阿里云百炼 |
| API 地址 | https://dashscope.aliyuncs.com/compatible‑mode/v1 |
| API 协议 | OpenAI Chat Completions |
| API 密钥 | 您自己的百炼 API Key |
| 模型 ID | qwen‑plus |
| 模型显示名称 | Qwen Plus |
3、添加上述模型后点击 创建;修改已有提供商时点击 保存。
4、完成工作区选择后,在会话输入框的模型选择器中选择 Qwen Plus。
该示例使用百炼中国内地兼容接口,请使用对应地域的 API Key。其他地域或网关请以提供商文档中的 API 地址和协议为准。保存配置或检测到凭据不代表模型调用已成功,需通过实际对话确认。
2、选择工作区
①返回主页面,点击 选择工作区。
②在目录选择器中进入 workspace,点击 打开。

③工作区选择完成后,新会话输入框才可正常使用。

服务实例已在 ECS 上准备
/opt/deepseek‑harness/workspace作为默认工作目录,并在主目录下提供同名入口供目录选择器直接选取;DeepSeek Harness 的会话、凭据、存储和附件数据保存在/opt/deepseek‑harness/dsh‑home下。
3、开始会话
①确认工作区已选择,并在模型选择器中选择已配置的模型。
②输入任务并发送,例如:请概述当前工作区的目录结构,不要修改文件。
③等待模型回复。只有收到实际回复,才说明模型鉴权和调用成功;若请求失败,请核对 API Key、API 地址、协议、模型 ID 及实例出网连接。
长对话需要压缩上下文时,可在输入框使用 /compact 指令。
运维说明
如需登录 ECS 排查服务状态,可使用实例密码远程连接 ECS 后执行:
sudo systemctl status deepseek-harness.service
sudo systemctl status nginx.service
sudo journalctl -u deepseek-harness.service -n 100 --no-pager
服务启动脚本位于 /opt/deepseek‑harness/bin/start‑dsh‑web,应用日志位于 /opt/deepseek‑harness/logs/service.log。
注意事项
1、DeepSeek Harness 当前为 developer preview,上游未来版本可能存在破坏性变更。
2、用户在 Web UI 中配置的模型 API Key 会保存在服务实例本地持久化目录中,请妥善管理实例访问权限。