DeepSeek Harness 上手教程：从 API 密钥到本地 WebUI 完整部署

2026 年 8 月，DeepSeek 正式开源 Agent 运行框架 DeepSeek Harness（终端命令简写 dsh）。官方的核心理念非常好理解：大模型负责思考推理，Harness 承接任务规划、工具调用、上下文管理等工程层能力，二者组合，就能形成可自主执行任务的 AI 智能体。框架基于 Cordis 插件内核开发，遵循「万物皆插件」的设计思路，对标 Claude Code、OpenAI Codex 这类代码智能体产品。当前为 v0.1 开发者预览版本，官方提示后续版本会存在不兼容的破坏性更新，非常适合技术爱好者本地体验、动手测试。

下面提供两套完整部署方案，按需选择即可。

0. 前置准备：申请 DeepSeek API Key

Harness 本地 WebUI 启动后，必须填入有效的 API 密钥才能开启对话能力，提前申请准备。

访问 DeepSeek 开放平台完成账号注册与账户充值
进入控制台页面，新建 API Key
保存密钥（以 sk - 开头），Web 界面配置阶段需要使用。

1. 环境准备：安装 Node.js

dsh 基于 TypeScript 开发，运行依赖 Node.js 环境。下载 Node.js，推荐安装 LTS 长期支持版本；预览版环境优先选择 Node.js 22 及以上。安装完成，打开 CMD 或者 PowerShell，执行下面命令校验环境：

bash 复制代码

node --version
npm --version

终端正常输出版本号，代表环境安装成功。

2. 部署 & 启动 DeepSeek Harness

两种部署路线：npm 一键安装（新手首选）、源码编译部署（适合二次开发、跟踪最新代码）

方案一：npm 快速部署（推荐新手）

临时运行（无需本地安装，一行命令拉起）

直接使用 npx 在线拉取依赖并启动 Web 服务：

bash 复制代码

npx @deepseek-ai/dsh web

首次执行会自动下载全部依赖，终端持续滚动日志属于正常现象。看到 dsh web: http://127.0.0.1:3080 输出，代表服务启动成功。浏览器访问该地址，填入 API Key 即可使用。

固定目录安装

想要把程序固定存放在指定文件夹（示例路径 D:\Tools\dsh）：

bash 复制代码

mkdir D:\Tools\dsh
cd D:\Tools\dsh
npm init -y
npm install @deepseek-ai/dsh

目录结构参考：

bash 复制代码

D:\Tools\dsh\
├── package.json
├── package-lock.json
└── node_modules\
   └── @deepseek-ai\
      └── dsh\

后续启动命令：

复制代码

cd D:\Tools\dsh
npx dsh web

也可以全局安装，之后任意终端直接调用dsh web启动：

复制代码

npm install -g @deepseek-ai/dsh

方案二：源码编译部署

适合需要阅读源码、自定义插件、跟进最新提交的开发者，该方式需要提前安装 pnpm：npm install -g pnpm

复制代码

# 拉取源码
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
# 安装依赖+构建
pnpm install
pnpm run build
# 启动web界面
pnpm dsh web

自定义存放目录示例（D:\Tools\dsh）

复制代码

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

后续再次启动无需重新构建：

复制代码

cd /d D:\Tools\dsh
pnpm dsh web

官方版本更新时，拉取代码并重新构建：

复制代码

cd /d D:\Tools\dsh
git pull
pnpm install
pnpm run build
pnpm dsh web

3. WebUI 首次使用，3 个必要操作

访问 http://127.0.0.1:3080 进入页面，首次打开要完成初始化：

填入之前申请好的 DeepSeek API Key
选定工作区：添加允许 Agent 操作的本地文件夹；默认会将服务启动所在目录作为工作区。未选定工作区前输入框锁定，属于正常限制
发起任务：例如让 AI「读取这个仓库代码，梳理核心包结构」。Agent 会自动读取文件、执行终端命令、维护任务计划；当需要修改本地文件时，Web 会弹出权限审批窗口，需要手动确认。

4. 4 种内置会话模式，按需选用

新建会话时可以切换预设模式，能力范围差异明显：

标准模式 Standard：全能编程智能体，文件编辑、Shell 命令、联网检索、任务规划、子智能体全部启用。日常写代码、工程分析首选。
PTC 模式：程序化工具调用，支持用 TypeScript 编写自动化工作流
极简模式 Minimal：仅保留 Shell 和文件编辑工具，多用于模型能力基准测试
创造模式 Creator：在标准模式基础上开放运行时检视，适合调试插件、自定义智能体方案

5. 重要注意事项

项目处于开发者预览阶段，后续更新存在破坏性变更，不要在生产环境依赖该版本，仅适合本地体验。
Node 版本最低推荐 22+，低版本 Node 容易出现兼容报错。
API 计费：DeepSeek 在 2026-08-16 起启用峰谷计费策略，大规模使用时留意费用消耗。
权限风险：Agent 执行写文件、运行 shell 指令前，务必仔细审阅操作内容，不要无脑全部允许。

总结

普通用户最简流程：安装 Node.js → 执行 npx @deepseek-ai/dsh web → 浏览器访问 3080 端口，填入密钥、选择工作区，即可拥有本地代码 Agent，自动读库、执行命令、处理工程任务。依托「一切皆插件」的架构，后续模型、工具都可以灵活替换，是值得持续关注的开源 Agent 项目。