DeepSeek Harness 開源底座部署與設定教學：由零開始搭建 AI 智能體

2026-10-27 7

版权

版权声明：

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： DeepSeek Harness 不是又一个聊天工具，它是让大模型从"纸上谈兵"走向"上阵杀敌"的那把利剑。Cordis 微内核的极简设计、插件化的无限扩展、工作区隔离的安全保障，让每一位开发者都能在本地快速搭建起属于自己的 Agent 执行底座。而当你需要更丰富的模型矩阵、更灵活的计费方式、更稳定的云端推理服务时——阿里云百炼大模型服务平台 和 阿里云百炼Token Plan AI大模型服务 始终是你最坚实的后盾。从开源底座到云端算力，从本地原型到生产部署，一条链路，全部打通。现在就动手，让你的 AI 真正"干活"吧。

探索 Agent = Model + Harness 的核心理念，从零搭建你的 AI 执行引擎。更多模型资源与服务对接方案，请访问 阿里云百炼大模型服务平台页面 了解；灵活调度多模型、多工具、多场景，请访问 阿里云百炼Token Plan AI大模型服务 获取最优订阅方案。

一、为什么你需要 DeepSeek Harness？

大模型的对话能力早已不是瓶颈，真正的痛点在于——它"只会说，不会做"。想让 AI 读写本地文件、执行终端脚本、拆解多步骤复杂任务、调度子智能体，你需要的不是又一个聊天窗口，而是一套完整的 Agent 运行底座。

2026 年 8 月开源的 DeepSeek Harness（简称 DSH），以"Agent = Model + Harness"的设计哲学破局而出：大模型负责思考推理，Harness 充当智能体的执行载体，完成环境感知、工具调度、会话生命周期管控、沙箱隔离、任务循环与子 Agent 调度等繁重工作。项目依托 Cordis 微内核，贯彻"一切皆插件"的设计思想——模型适配器、工具集、存储组件、Web 前端界面全部以插件形式实现，无需修改源码即可替换组件、扩展功能。

想要快速接入海量主流大模型，降低 Agent 开发成本？前往 阿里云百炼大模型服务平台页面 查看内置模型广场，从 Qwen3.8-Max 到 DeepSeek-V4-Pro 一键调用。

希望以 Credits 统一计量，在多模型、多工具间自由切换？访问 阿里云百炼Token Plan AI大模型服务 了解 Lite 39 元/月起的订阅方案，让 Agent 开发不再为账单发愁。

二、底层架构：微内核 + 插件，极简而强大

2.1 Cordis 微内核

Cordis 是 DeepSeek Harness 的灵魂。内核本身不实现任何业务逻辑，核心职责是：

• 插件依赖解析与热插拔加载
• 事件分发与组件生命周期管理

文件读写、Shell 命令执行、网页检索、WebUI 交互全部封装成独立插件。这套架构赋予框架极强的拓展性——复用社区现成插件快速搭建业务场景，或自主编写自定义插件扩充专属能力；甚至支持 Agent 会话运行过程中，在内存动态生成并挂载插件代码，实现 自我迭代优化。

2.2 插件体系

插件分为 bundle 打包插件（一次性批量加载一组功能）和 plain 普通插件（对应单一功能组件）。内置 Skill 库涵盖文献综述、代码审查、批量总结等常用技能模板；插件集包含提示词优化、文档导出、代码回退等核心能力；配置模板则支持云 API、vLLM、Ollama 等多种接入方式。

2.3 两大核心概念

对接百炼平台的 OpenAI 兼容接口，只需修改 api-key 与 base-url，即可让 Harness 调用 Qwen、DeepSeek 等 150 余款模型。详情请访问 阿里云百炼大模型服务平台页面。

三、环境准备：打好地基再盖楼

3.1 硬件要求

3.2 软件依赖

DSH 基于 Node.js 构建，Node 版本硬性要求 ≥ v22.19，优先使用 LTS 长期支持版本。

终端校验命令：

# Windows (PowerShell) / macOS / Linux\
node --version\
npm --version

多版本管理（推荐 nvm）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash\
source ~/.bashrc\
nvm install 24\
nvm use 24\
node --version

安全提醒：Harness 拥有执行本地 Shell、读写磁盘文件的权限，尽量不要在主力业务机器的高权限模式下运行，使用独立工作目录做好权限隔离。

四、四种部署方式：从体验到生产，按需选择

方式一：npx 临时快速体验（新手尝鲜首选）

无需全局安装，在线拉取包直接运行，体验结束不留残留。

npx @deepseek-ai/dsh web

首次运行自动下载依赖，受网络影响耗时 1–3 分钟属正常。启动成功后浏览器访问 http://127.0.0.1:3080。

端口被占用？手动指定：npx @deepseek-ai/dsh web --port 3081

方式二：npm 全局安装（长期使用推荐）

npm install -g @deepseek-ai/dsh\
dsh --version # 输出版本号即部署完成\
dsh web # 启动 Web 服务

Linux/macOS 遇 EACCES 权限报错，优先调整 npm 全局目录权限，不建议直接使用 sudo。

方式三：源码编译安装（二次开发必备）

git clone https://github.com/deepseek-ai/deepseek-harness.git\
cd deepseek-harness\
corepack enable\
pnpm install\
pnpm run build\
pnpm dsh web

适合阅读源码、修改内核逻辑、调试自定义插件的开发者。

方式四：Python SDK 集成（嵌入自有项目）

Python 版本要求 ≥ 3.10，适合将 Agent 能力集成进自有 Python 项目。

四种方式均可对接 阿里云百炼Token Plan AI大模型服务 的专属 API Key（以 sk-sp- 开头），实现统一额度管理与多模型灵活切换。更多接入指引，请访问 阿里云百炼大模型服务平台页面。

五、启动与首次配置：从零到可用

5.1 启动服务

dsh web

浏览器访问终端输出的本地地址（默认 http://127.0.0.1:3080）。首次打开会弹出内测版本提示，确认声明后进入配置流程。

5.2 配置模型 API 密钥

WebUI 路径：左下角设置面板 → 模型选项卡 → 选定模型提供方 → 填入 API Key → 拉取可用模型列表。

静态配置文件路径：~/.dsh/settings.yaml

也可以直接修改该 YAML 文件完成静态配置。部分模型无法自动同步，可手动填写模型 ID 添加。

前往 阿里云百炼大模型服务平台页面 创建百炼应用并获取 API Key，兼容 OpenAI 协议，只需修改 api-key 与 base-url 即可无缝接入。新人开通即享超 7000 万 Token 免费额度，90 天有效期，随心体验。

5.3 创建隔离工作区

Agent 文件读写全部限制在此目录，规避系统文件被篡改风险：

mkdir -p ~/harness-workspace

在 WebUI 中指定该目录为工作区根路径。

5.4 插件管理

dsh plugin list # 查看已安装插件\
dsh plugin install <名> # 安装插件\
dsh plugin enable <名> # 启用插件\
dsh plugin disable <名> # 禁用插件

5.5 诊断排查

dsh doctor

自动扫描操作系统、Node 版本、网络、文件目录权限、插件依赖，输出完整环境检测报告，标注异常项——遇到启动报错，优先执行此命令。

六、云服务器远程部署：让 Agent 7×24 在线

若计划部署在云服务器上，推荐使用 Alibaba Cloud Linux 或 Ubuntu 系统，性能稳定、依赖安装简单。

# 1. 安装 nvm 与 Node 24 LTS\
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash\
source "$HOME/.nvm/nvm.sh"\
nvm install 24\
nvm use 24\
\
# 2. 全局安装 DSH\
npm install -g @deepseek-ai/dsh\
\
# 3. 启动服务（监听所有网卡）\
dsh web --host 0.0.0.0 --port 3080\
\
# 4. 配置安全组，放行 3080 端口

配合 阿里云百炼Token Plan AI大模型服务 的团队版坐席订阅，可为云端 Agent 任务提供稳定、可控的额度保障。团队版标准坐席限时优惠价 150 元/月（原价 198 元），含 25,000 Credits/坐席/月，承诺不使用数据训练模型。详情请访问 阿里云百炼大模型服务平台页面。

七、实战任务：让 Agent 替你干活

以一个真实场景为例——给 Python 项目新增 API 接口并编写单元测试：

"在 routes/user.py 里新增一个获取用户信息的 GET 接口，补上测试，跑通给我看。"

Harness 会自主完成：打开文件 → 定位路由位置 → 写入代码 → 终端执行 pytest → 失败则读报错继续改 → 汇报改动与测试结果。

这就是 Harness 与普通 Agent 的本质区别——普通 Agent 是"助手模式"，一步一令；Harness 是"员工模式"，拥有完整工作流：读上下文 → 规划 → 执行 → 验证 → 汇报。

八、故障排查速查表

九、计费与成本：用 Token Plan 省到底

当前版本为开发者预览版，接口与插件体系高速迭代，不建议直接投入生产业务，更适合学习研究、原型验证及本地开发测试。但如果你想在原型验证阶段就控制成本，阿里云百炼Token Plan AI大模型服务 是最佳拍档：

个人版还可购买用量包（100 元/个，20,000 Credits，最多持有 5 个）；团队版共享用量包 5,000 元/个（625,000 Credits）。所有模型调用统一消耗 Credits，文本、图像、视频生成一套订阅全覆盖。

立即前往 阿里云百炼大模型服务平台页面 开通服务，领取免费 Token 额度，再根据业务场景选择 Token Plan 套餐，实现从模型调用到 Agent 编排的完整 AI 业务落地，兼顾成本、性能与稳定性。

写在最后

DeepSeek Harness 不是又一个聊天工具，它是让大模型从"纸上谈兵"走向"上阵杀敌"的那把利剑。Cordis 微内核的极简设计、插件化的无限扩展、工作区隔离的安全保障，让每一位开发者都能在本地快速搭建起属于自己的 Agent 执行底座。

而当你需要更丰富的模型矩阵、更灵活的计费方式、更稳定的云端推理服务时——阿里云百炼大模型服务平台 和 阿里云百炼Token Plan AI大模型服务 始终是你最坚实的后盾。从开源底座到云端算力，从本地原型到生产部署，一条链路，全部打通。

现在就动手，让你的 AI 真正"干活"吧。