DeepSeek Harness部署指南：5分钟快速上手AI Agent工作台

时间：2026-08-20 18:13

上一篇我们已经介绍了 DeepSeek Harness 是什么，以及它为什么不是另一个 Codex。那么这篇文章就直接进入实操环节：把 DeepSeek Harness 跑起来。你不用先啃完那 230 多个包的源码，也不需要先理解 Cordis 的微内核机制。按照下面的教程操作，只要一条命令，就能

上一篇我们已经介绍了 DeepSeek Harness 是什么，以及它为什么不是另一个 Codex。那么这篇文章就直接进入实操环节：把 DeepSeek Harness 跑起来。 你不用先啃完那 230 多个包的源码，也不需要先理解 Cordis 的微内核机制。按照下面的教程操作，只要一条命令，就能在本地启动 Web 工作台；再花 5 分钟配置 API Key、工作区和运行模式，就可以让 Agent 开始读取文件、执行命令、规划任务。

本地启动后看到的 DeepSeek Harness Web 工作台

一、前置条件：Node.js 版本

DeepSeek Harness 是一个基于 Node.js 的 AI Agent 运行时。官方要求的 Node.js 版本为 22.19.0 或更高（22.x 分支），以及 24.x 及以上。开始安装前，先检查本地 Node 版本：

node -v

如果输出类似 v22.23.1 或 v24.x.x，说明运行环境没有问题。如果版本过低，建议先到 nodejs.org 安装 LTS 版本，或者使用 nvm 进行切换。

小提示：DeepSeek Harness 目前仍处于开发者预览阶段，兼容性和界面细节后续都可能继续调整。建议先在本地目录或虚拟机中体验，不要直接连接生产代码仓库。

二、最快上手：npx 一条命令启动

官方最推荐的快速体验方式就是使用 npx。它会临时下载并运行最新版本的 DSH CLI，不需要提前 clone 仓库，也不用全局安装，适合新手快速启动 DeepSeek Harness。

npx @deepseek-ai/dsh web

执行完成后，终端会提示服务已经启动，默认监听地址为：

https://127.0.0.1:3080

把这个地址复制到浏览器中打开即可。首次运行时会先显示开发者预览声明，点击「继续」就能进入主界面。整个本地部署过程通常只需 30 秒到 1 分钟，具体时间取决于网络下载速度。

如果命令执行时卡住，通常是因为网络下载较慢。你可以尝试切换 npm 镜像源，或者直接使用下一节介绍的源码编译方式，通过 clone 仓库并使用 pnpm 安装依赖。

三、首次配置：API Key + 工作区

1）填入 API Key

进入首页后，第一步通常会提示你添加 API Key。点击左下角「设置 → 模型」，填入 DeepSeek 官方 API Key。如果你还没有 Key，可以前往 DeepSeek 官网申请并完成充值。

首次启动后的 API Key 配置弹窗

export DEEPSEEK_API_KEY="sk-xxxxxxxx"
npx @deepseek-ai/dsh web

Web UI 会把密钥保存到 $DSH_HOME/.credentials.yaml，不会直接写入会话日志。如果你更倾向于使用环境变量，也可以不在弹窗里填写，留空后系统会自动回退读取环境变量或 .env 文件。

2）选择工作区

工作区就是 Agent 可以读取和写入的项目目录。为了更安全，建议先新建一个空目录做测试，避免误操作影响正式代码：

mkdir code

然后回到 Harness 首页，点击顶部的工作区名称，选择「添加工作区」，把刚创建的目录加入进去。之后 Agent 的文件读写、Shell 命令执行都会以该目录作为边界。

在工作区下拉菜单中添加本地项目目录

四、选模型、选模式

1）模型选择：Flash vs Pro

在输入框右下角可以快速切换模型。目前官方默认提供 DeepSeek-V4-Flash 和 DeepSeek-V4-Pro 两个档位：

右下角下拉可切换 Flash / Pro，以及思考强度

Flash：响应速度更快、成本更低，适合简单任务、批量脚本处理和初步探索；
Pro：模型能力更强，更适合复杂规划、长上下文处理，以及需要多步工具调用的任务。

需要注意的是：从 8 月 17 日起，DeepSeek-V4 Pro API 已涨价，高峰时段输出价格达到 27 元/百万 token。首次体验建议优先使用 Flash，熟悉 DeepSeek Harness 的使用流程后，再根据任务复杂度切换到 Pro。

2）四种运行模式怎么选

点击顶部「标准模式」下拉菜单，可以看到四种预设模式。它们并不是四套完全独立的 Agent，而是同一个 Harness 宿主在加载不同插件后形成的不同「运行时形态」。

标准、PTC、极简、创造四种模式

模式	适合谁	特点
标准模式	新手 / 日常开发	文件编辑、Shell、检索、Skills、子 Agent、工作流全部预装，开箱即用
PTC 模式	想节省 Token 的进阶用户	让模型通过编写 TypeScript 程序，一次性组合多步工具调用，减少反复对话
极简模式	做模型评测	仅保留持久 Bash 和文件编辑器，适合基准测试，不建议日常使用
创造模式	插件/Agent 开发者	Agent 可以检查 Cordis 运行时、临时挂载插件、创建新的 Agent 预设

第一次使用，直接选择「标准模式」即可。 等你发现任务中经常重复出现「搜索 → 编辑 → 测试」这类固定循环，再尝试 PTC 模式会更合适。

五、源码编译方式（适合开发者）

如果你想修改源码、开发插件，或者需要固定某个版本，建议直接 clone 仓库并在本地构建：

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

源码仓库的 packages/ 目录，每个能力都是一个可替换的插件包

源码方式的优势很明显：版本可控，可以修改配置文件 cordis.yml，也能加载自己编写的本地插件。缺点同样明显：仓库体积较大、依赖较多、构建时间更长，因此对普通用户来说，用 npx 启动已经足够。

六、Headless 与自动化

如果你想把 DeepSeek Harness 接入脚本、CI 或批处理任务，可以使用 Headless 模式。它接收一个任务，在 Agent 完整执行结束后，把最后一条有效回复输出到终端：

dsh --profile headless "run the tests and summarize failures"

如果你需要更结构化的事件流和持续控制能力，官方还提供 ACP 服务、JSON-RPC 入口以及 Python SDK。这些场景更偏向自动化开发，建议先在 Web UI 中把流程跑顺，再进一步深入。

七、接入其他模型

DeepSeek Harness 并不会把你绑定在自家模型上。在设置 → 模型中，你可以选择「添加提供方」，目前支持 Anthropic、OpenAI、Azure、Bedrock、Vertex 等模型目录，也支持自定义 OpenAI 兼容端点。

设置页支持自定义提供方、Base URL 和模型列表

可配置项包括：提供方名称、Base URL、协议类型以及可用模型列表。保存后，回到输入框右下角即可切换模型。这意味着你也可以把 GLM、Qwen 或其他 OpenAI 兼容服务接入 DeepSeek Harness，借助它的插件能力来运行这些模型。

八、安全与权限

一旦 Agent 拥有运行 Shell 和修改文件的能力，就天然具备一定破坏性。DeepSeek Harness 默认采用 workspace-write 模式：命令执行和文件修改会被限制在当前工作区及允许的临时目录中。如果需要扩展权限，系统会通过弹窗询问，也就是 ask 审批策略。