2026 年 8 月 13 日DeepSeek 开源了自家的Agent 运行框架 DeepSeek Harness命令行里叫dsh。官方给的公式很直白Model Harness Agent——模型负责思考Harness 负责工具调用、任务规划、上下文管理这些「让模型真正干活的工程活」。它基于一套叫 Cordis 的插件内核构建设计理念是「一切皆插件」对标 OpenAI Codex、Claude Code 这类代码智能体。目前还是v0.1 开发者预览版官方明确提醒后续会有不兼容的破坏性变更所以先把环境跑起来玩玩正合适。下面是我自己安装的过程记录两种方式都给上按需取用。0. 先准备 DeepSeek 的 API KeyHarness 本地跑起来后需要在 Web 界面里填入 API Key 才能对话所以先去申请一个。打开 DeepSeek 开放平台DeepSeek注册账号 → 充值 → 在控制台里创建 API Key把 Key 存好后面打开 Web UI 时要用。Key 的格式一般是sk-开头。1. 安装 Node.jsdsh是用 TypeScript 写的跑在 Node.js 上所以第一件事是装 Node.js。下载地址Node.js — 在任何地方运行 JavaScript建议装LTS 长期支持版预览阶段推荐 Node.js 22 及以上装完后打开终端验证一下Windows 搜索「CMD」或「PowerShell」即可node --version npm --version能看到版本号就说明环境 OK 了。2. 安装并启动 DeepSeek Harness这里有两种路线方式一用 npm 一行命令最省事推荐新手方式二从源码构建适合想追最新功能或二次开发的。方式一通过npm安装推荐默认路径一键启动最简单不用单独安装直接让 npm 现场拉取并启动npx deepseek-ai/dsh web第一次运行会花一两分钟下载依赖终端滚动一堆日志是正常现象。看到类似下面的输出就启动成功了dsh web: http://127.0.0.1:3080打开浏览器访问 http://127.0.0.1:3080 就能进入 Web 界面输入前面准备好的 API Key 即可使用。指定路径安装想固定位置如果你想把它装到某个固定目录比如D:\Tools\dshmkdir D:\Tools\dsh cd D:\Tools\dsh npm init -y npm install deepseek-ai/dsh装完后目录结构大致是D:\Tools\dsh\ ├── package.json ├── package-lock.json └── node_modules\ └── deepseek-ai\ └── dsh\以后启动 Web UIcd D:\Tools\dsh npx dsh web想省去每次npx现场下载也可以全局安装npm install -g deepseek-ai/dsh之后直接用dsh web启动。方式二通过源码安装如果你要追最新提交、或者想读源码/改插件就从 GitHub 拉源码自己构建。源码方式需要pnpm没有的话先npm install -g pnpm装一下。默认路径终端里一条一条执行git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web指定路径比如装到 D:\Tools\dshcd /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 web3. 首次打开 Web UI 要做的三件事启动成功后访问 http://127.0.0.1:3080首次进入会有一些初始化步骤照着来就行填 API Key选择工作区点「选择工作区」添加你希望 Agent 操作的目录dsh 默认会把启动时所在目录当作工作区。没选工作区前会话输入框是禁用的这是正常现象。发第一个任务比如让 Agent「Summarize this repository and identify its main packages.」它会读文件、跑命令、维护执行计划遇到写操作时Web UI 会按权限策略弹窗让你审批。4. 顺带了解四种运行模式Harness 内置了几套预设模式新建会话时可以选体验差别挺大标准模式Standard完整编程助手文件编辑、Shell、搜索、规划、子智能体全开。PTC 模式程序化工具调用可以用 TypeScript 写自动化流程。极简模式Minimal只保留 Shell 文件编辑两个工具适合给模型做基准测试。创造模式Creator在标准模式基础上开放运行时检视方便试新插件、组合新模式。日常写代码辅助标准模式最顺手想让 Agent 大刀阔斧地操作文件和跑命令也是标准模式。5. 几个注意事项预览版会变官方明确说会有破坏性变更API 和核心插件还在演进别拿来做生产环境的稳定依赖。Node 版本预览阶段建议 Node.js 22太老的版本可能跑不起来。API 计费DeepSeek 的平价计费在 2026-08-16 16:00 UTC 后会改为峰谷定价用量大的话留意一下成本。权限审批Agent 涉及写文件/执行命令时网页会弹确认第一次用建议仔细看每一步它要干什么别一路无脑点「允许」。小结整体下来最省事的方式就是# 装好 Node.js 后一行搞定 npx deepseek-ai/dsh web然后浏览器开 http://127.0.0.1:3080填 Key、选工作区就能让本地 Agent 帮你读代码、跑命令了。想追新功能就走源码构建那条路更新用git pull重构建即可。一切皆插件的架构意味着以后模型和工具都能自由替换值得持续关注。装好之后欢迎交流使用心得下篇推荐给它加装备环境跑起来之后就该给它添置插件了。我在下一篇《DeepSeek Harness 插件推荐》里盘点了 9 个高人气实用插件插件市场、终端界面、视觉路由、联网搜索、对话里现找插件、开箱编码、架构约束、长期记忆还有一款深海鲸鱼娘主题皮肤并整理了 3 个找插件的网站。 传送门DeepSeek Harness 插件推荐装好之后这 9 个插件值得一试-CSDN博客装好之后欢迎交流使用心得
DeepSeek Harness 安装教程：从 API Key 到本地 Web UI 跑起来
2026 年 8 月 13 日DeepSeek 开源了自家的Agent 运行框架 DeepSeek Harness命令行里叫dsh。官方给的公式很直白Model Harness Agent——模型负责思考Harness 负责工具调用、任务规划、上下文管理这些「让模型真正干活的工程活」。它基于一套叫 Cordis 的插件内核构建设计理念是「一切皆插件」对标 OpenAI Codex、Claude Code 这类代码智能体。目前还是v0.1 开发者预览版官方明确提醒后续会有不兼容的破坏性变更所以先把环境跑起来玩玩正合适。下面是我自己安装的过程记录两种方式都给上按需取用。0. 先准备 DeepSeek 的 API KeyHarness 本地跑起来后需要在 Web 界面里填入 API Key 才能对话所以先去申请一个。打开 DeepSeek 开放平台DeepSeek注册账号 → 充值 → 在控制台里创建 API Key把 Key 存好后面打开 Web UI 时要用。Key 的格式一般是sk-开头。1. 安装 Node.jsdsh是用 TypeScript 写的跑在 Node.js 上所以第一件事是装 Node.js。下载地址Node.js — 在任何地方运行 JavaScript建议装LTS 长期支持版预览阶段推荐 Node.js 22 及以上装完后打开终端验证一下Windows 搜索「CMD」或「PowerShell」即可node --version npm --version能看到版本号就说明环境 OK 了。2. 安装并启动 DeepSeek Harness这里有两种路线方式一用 npm 一行命令最省事推荐新手方式二从源码构建适合想追最新功能或二次开发的。方式一通过npm安装推荐默认路径一键启动最简单不用单独安装直接让 npm 现场拉取并启动npx deepseek-ai/dsh web第一次运行会花一两分钟下载依赖终端滚动一堆日志是正常现象。看到类似下面的输出就启动成功了dsh web: http://127.0.0.1:3080打开浏览器访问 http://127.0.0.1:3080 就能进入 Web 界面输入前面准备好的 API Key 即可使用。指定路径安装想固定位置如果你想把它装到某个固定目录比如D:\Tools\dshmkdir D:\Tools\dsh cd D:\Tools\dsh npm init -y npm install deepseek-ai/dsh装完后目录结构大致是D:\Tools\dsh\ ├── package.json ├── package-lock.json └── node_modules\ └── deepseek-ai\ └── dsh\以后启动 Web UIcd D:\Tools\dsh npx dsh web想省去每次npx现场下载也可以全局安装npm install -g deepseek-ai/dsh之后直接用dsh web启动。方式二通过源码安装如果你要追最新提交、或者想读源码/改插件就从 GitHub 拉源码自己构建。源码方式需要pnpm没有的话先npm install -g pnpm装一下。默认路径终端里一条一条执行git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web指定路径比如装到 D:\Tools\dshcd /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 web3. 首次打开 Web UI 要做的三件事启动成功后访问 http://127.0.0.1:3080首次进入会有一些初始化步骤照着来就行填 API Key选择工作区点「选择工作区」添加你希望 Agent 操作的目录dsh 默认会把启动时所在目录当作工作区。没选工作区前会话输入框是禁用的这是正常现象。发第一个任务比如让 Agent「Summarize this repository and identify its main packages.」它会读文件、跑命令、维护执行计划遇到写操作时Web UI 会按权限策略弹窗让你审批。4. 顺带了解四种运行模式Harness 内置了几套预设模式新建会话时可以选体验差别挺大标准模式Standard完整编程助手文件编辑、Shell、搜索、规划、子智能体全开。PTC 模式程序化工具调用可以用 TypeScript 写自动化流程。极简模式Minimal只保留 Shell 文件编辑两个工具适合给模型做基准测试。创造模式Creator在标准模式基础上开放运行时检视方便试新插件、组合新模式。日常写代码辅助标准模式最顺手想让 Agent 大刀阔斧地操作文件和跑命令也是标准模式。5. 几个注意事项预览版会变官方明确说会有破坏性变更API 和核心插件还在演进别拿来做生产环境的稳定依赖。Node 版本预览阶段建议 Node.js 22太老的版本可能跑不起来。API 计费DeepSeek 的平价计费在 2026-08-16 16:00 UTC 后会改为峰谷定价用量大的话留意一下成本。权限审批Agent 涉及写文件/执行命令时网页会弹确认第一次用建议仔细看每一步它要干什么别一路无脑点「允许」。小结整体下来最省事的方式就是# 装好 Node.js 后一行搞定 npx deepseek-ai/dsh web然后浏览器开 http://127.0.0.1:3080填 Key、选工作区就能让本地 Agent 帮你读代码、跑命令了。想追新功能就走源码构建那条路更新用git pull重构建即可。一切皆插件的架构意味着以后模型和工具都能自由替换值得持续关注。装好之后欢迎交流使用心得下篇推荐给它加装备环境跑起来之后就该给它添置插件了。我在下一篇《DeepSeek Harness 插件推荐》里盘点了 9 个高人气实用插件插件市场、终端界面、视觉路由、联网搜索、对话里现找插件、开箱编码、架构约束、长期记忆还有一款深海鲸鱼娘主题皮肤并整理了 3 个找插件的网站。 传送门DeepSeek Harness 插件推荐装好之后这 9 个插件值得一试-CSDN博客装好之后欢迎交流使用心得