想让 DeepSeek 的大模型真正“跑起来”，你需要的不是只会聊天，而是把它接进可执行的 Agent 运行框架。DeepSeek Harness 就是用来承接工具调用、文件读写和任务循环的那一层。
下面按最常见的 Web UI 路线整理：准备环境 → 启动本地服务 → 配置 API Key 与工作区 → 选择运行模式开始跑任务。
一、DeepSeek Harness 是什么：它负责让 Agent 动起来
可以用一句话拆开理解：Agent = Model + Harness。大模型负责生成内容，但它本身不会自动读取文件、执行命令或串联多步操作。
Harness 则提供执行“脚手架”：把模型接到工具与运行环境上，让它能在你的工作区里读写、调用、推进任务流程。
DeepSeek Harness 于 2026 年 8 月 13 日以 MIT 协议开源，采用“一切皆插件”的思路，模型、工具、UI，乃至 Agent 主循环都可以被替换或扩展。
二、安装前先准备好这些环境
先把基础环境弄好，后面的步骤会顺很多。
| 环境项 | 要求 | 说明 |
| 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，用浏览器打开即可。
方式二：全局安装（长期使用更省事）
先安装：
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、选择工作区：点击 “Choose workspace”，选择一个本地目录作为 Agent 的操作空间。
工作区确定后，Agent 才知道从哪里读写文件、在哪个目录执行任务。
五、运行模式速览：按任务类型选最合适的
Web UI 里通常会提供多种模式。你可以先从“标准模式”熟悉工作流，再逐步尝试其它选项。
| 模式 | 特点 | 适用场景 |
| 标准模式 | 文件编辑 + Shell + 搜索 + 子 Agent，开箱即用 | 日常编程、项目管理 |
| PTC 模式 | 模型生成代码批量编排工具调用，省 Token | 批量爬虫、多文件处理 |
| 极简模式 | 仅保留 Shell 和文件编辑器 | 模型基准测试、裸能力评估 |
| 创造模式 | 可探查运行时、在线调试插件、创建新 Agent | 插件开发、架构实验 |
如果你只是想先跑通链路，建议从标准模式开始；遇到更复杂的批量任务，再切到 PTC 会更省心。
六、不想搭环境？用 OpenClaw 部署助手先体验模型
如果你暂时不想在本地搭起 Harness，也可以先用图形化方式体验 DeepSeek 模型的对话能力。原文提到可以用「OpenClaw 部署助手」完成模型配置。
步骤1：打开 OpenClaw 部署助手，点击左侧菜单栏的 “AI 模型”。
步骤2：在 AI 模型管理页面，选择 “内置 AI” 服务商。
步骤3：在配置页的“默认模型”下拉框里选择 deepseek-v4-pro。
步骤4：点击蓝色的 “保存并应用”，等待配置生效。
步骤5：进入 OpenClaw Chat 聊天界面，右下角状态栏会显示当前模型为 deepseek-v4-pro，即可开始对话。
等熟悉之后，再回到 Harness 走“Agent 可执行工作流”，体验会更完整。
七、FAQ：常见问题按这个排查
Q：DeepSeek Harness 和 DeepSeek V4 Pro 是什么关系？
A：V4 Pro 是模型（大脑），Harness 是运行框架（神经系统）。Harness 可以调用 V4 Pro，也可以接入其它厂商模型。
Q：安装时提示 node 不是内部命令怎么办？
A：一般是 Node.js 未正确安装或环境变量没生效。按原文建议可重新安装 Node.js LTS，并关闭终端后再打开重试。
Q：关闭终端后 Harness 还能用吗？
A：原文说明：通过 npx 或 dsh web 启动的是本地服务，关闭终端即停止；如需长期运行，需要考虑桌面版封装方案。
Q：API Key 填错或泄露了怎么办？
A：原文建议立即删除该 Key 并重新创建，且不要把 Key 贴到公开仓库或截图中。
Q：Harness 目前稳定吗？适合生产环境吗？
A：原文提到当前为 v0.1 开发者预览版，官方提示未来可能出现破坏兼容的变更；更适合学习、实验和个人项目，生产环境需谨慎评估。
你可以先按“方式一 npx 快速体验”跑通流程：确认本地服务地址能打开、API Key 能生效、工作区能读写。下一步再根据任务类型挑选标准/PTC/极简/创造模式。
