Windows安装deepseek-harness教程（踩坑版）
DeepSeek Harness（dsh）是由 DeepSeek AI 开发的开源 agent harness（智能体框架）。近期2026年8月刚刚推出，DeepSeek Harness 目前处于 开发者预览 阶段，正在快速迭代。未来将出现破坏兼容性的变更。
在此阶段，我尝试在本机已有nodejs环境下安装启动过程中 deepseek-harness 会报很多错误，存在一定的门槛，故总结踩坑流程，方便我们 Agent 开发者能够顺利安装使用。
以下按步骤说明即可顺利运行。
一、卸载原有nodejs，安装pnpm
- 卸载原有nodejs
如果本机已经有nodejs，那么需要在控制面板找到nodejs图标，选择卸载。以前如果设置过相关环境变量，也可以已删除，毕竟已经没用了。保持纯净性。
- 安装pnpm
deepseek-harness 官方推荐使用 pnpm 来管理依赖。pnpm 可以更好地处理项目复杂的依赖结构，有时能绕过 npm 自身的某些问题。
打开 PowerShell 命令行，执行以下命令接口下载：
▼bash复制代码Invoke-WebRequest https://get.pnpm.io/install.ps1 -UseBasicParsing | Invoke-Expression
（如果后续powershell爆红可改用cmd，下载用powershell即可）
deepseek-harness 的官方文档明确要求 Node.js 版本为 ^22.19.0 或 >=24.0.0。因此，安装完先执行以下命令查看当前nodejs是否符合标准：
▼bash复制代码pnpm env list
默认都是支持的，无需自己再额外安装：
至此，pnpm安装完成。
二、拉取deepseek-harness源码并启动
deepseek官方提供了两种本地启动方式：
这里使用源码配置的方式，原因是更可控，也方便后续进行源码阅读和学习。
首先拉取代码到本地，然后进入目录（由于是从GitHub上拉取代码，故可能需要科学上网才能流畅下载）：
▼bash复制代码git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness
紧接着按照依赖：
▼bash复制代码pnpm env use --global 26.8.1 （选择上方显示的nodejs 版本） pnpm install
然后就是重点，安装依赖然后启动。
这里先说结论，不要按照官方提供的命令直接运行，一般都会报错，直接按照以下命令依次执行才可成功：
▼bash复制代码# 1. 清理（首次或构建失败后必须） pnpm run clean # 2. host 阶段：先生成类型，再打包 pnpm exec tsc -b tsconfig.host.json pnpm exec tsdown --env.DSH_BUILD_FACE host # 3. client 阶段：依赖 host 生成的 typert 注册表 pnpm exec tsc -b tsconfig.client.json pnpm exec tsdown --env.DSH_BUILD_FACE client # 4. 前端 pnpm run build:web
每一步耐心等待几秒到几十秒执行完依次执行即可。
至于原理，这里我参考了文章，有写为何如此做：DeepSeek Harness 实战：从零安装到跑起 Web UI 的全流程避坑指南 - 新科技观察员 - 博客园
总结如下：
然后就可以启动：
▼bash复制代码pnpm dsh web --no-open
--no-open 表示不自动打开浏览器。不加会默认用系统浏览器打开。启动成功会打印：
▼cpp复制代码dsh web: http://127.0.0.1:3080
浏览器访问 http://127.0.0.1:3080 即可看到 Web UI。
进来之后需要填写配置 deepseek-platform 的 api-key，可以自行到官网（https://platform.deepseek.com/api_keys）充值和创建配置。
三、测试
配置完成就可以使用了，和 codex 等产品用法差不多，都是选定一个工作目录，然后提出需求即可让其工作，如：
