DeepSeek Harness是什么？2026最新安装与配置指南-驱动人生

DeepSeek Harness是DeepSeek开源的Agent运行框架，安装只需三步：装 Node.js → 执行 npx @deepseek-ai/dsh web → 浏览器打开 http://127.0.0.1:3080 配置 API Key。启动后选择工作区目录和运行模式，即可向Agent下达任务。若不想折腾命令行，也可通过OpenClaw部署助手一键配置DeepSeek模型。

一、DeepSeek Harness是什么？

用一个公式就能理解：Agent = Model + Harness。

大模型本身只会生成文字，它不会读文件、不会运行命令、也记不住上一轮对话。真正让模型“动起来”的那一层——文件系统接入、工具调用、沙箱权限、会话记忆、任务循环——就是 Harness（执行脚手架）。DeepSeek Harness于2026年8月13日以MIT协议开源，采用“一切皆插件”的架构，模型、工具、UI、甚至 Agent 主循环本身都是可替换的插件。

DeepSeek Harness是什么

你可以把它理解为对标Claude Code和OpenAI Codex的底层运行框架，但DeepSeek把它完全开源了，开发者可以自由组装、二次开发。

二、安装前的环境准备

环境项	要求	说明
Node.js	已安装（建议 LTS 版本）	Harness 基于 Node.js 运行
npm	随 Node.js 自带	用于安装 dsh 包
API Key	DeepSeek 开放平台获取	以 sk- 开头，用于模型调用
浏览器	任意现代浏览器	访问 Web UI 界面

安装 Node.js 后，在终端输入 node -v 和 npm -v，能正常输出版本号即说明环境就绪。

三、三种安装方式

方式一：npx快速体验

无需全局安装，一条命令直接启动：

npx @deepseek-ai/dsh web

首次运行会自动下载依赖包，稍等片刻后终端会输出本地地址，默认是 http://127.0.0.1:3080，用浏览器打开即可。

npx快速体验

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

npm install -g @deepseek-ai/dsh

dsh web

全局安装后，后续直接输入 dsh web 即可启动，更加顺手。

方式三：从源码安装（二次开发）

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
适合需要修改源码或开发插件的进阶用户。

四、首次配置：API Key 与工作区

打开 Web UI 后，首次使用需要完成两项核心配置：

1、配置 API Key：点击设置进入模型配置页，填入从 DeepSeek 开放平台创建的 API Key

2、Harness 默认支持 DeepSeek 模型，也可接入 OpenAI、Anthropic 等第三方模型。

3、选择工作区：点击“Choose workspace”，选择一个本地项目目录作为 Agent 的操作空间。

首次配置：API Key 与工作区

Agent 将在这个目录下读写文件、执行命令。

五、四种运行模式速览

模式	特点	适用场景
标准模式	文件编辑 + Shell + 搜索 + 子 Agent，开箱即用	日常编程、项目管理
PTC 模式	模型生成代码批量编排工具调用，省 Token	批量爬虫、多文件处理
极简模式	仅保留 Shell 和文件编辑器	模型基准测试、裸能力评估
创造模式	可探查运行时、在线调试插件、创建新 Agent	插件开发、架构实验