DeepSeek Harness 是由 DeepSeek AI 开发的开源 agent harness（智能体框架），采用“一切皆插件”的架构设计，由 Cordis 微内核驱动。该框架解决了传统 AI 应用开发中工具调用硬编码、平台适配成本高等痛点，通过插件化架构实现模型、工具、技能的自由组合，大幅降低 Agent 开发门槛。
传统部署需要手动配置 Node、环境、进程守护、安全组，对新手不够友好。为此，阿里云推出了 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 请使用您在百炼控制台申请的密钥，不要将密钥写入对话或公开文件。
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 会保存在服务实例本地持久化目录中，请妥善管理实例访问权限。
