DeepSeek Harness 源码安装教程（Windows 篇）

摘要DeepSeek 开源的 agent 框架 DeepSeek Harnessdsh采用「一切皆插件」架构目前处于开发者预览阶段。本文基于实际操作完整演示在 Windows 下从源码安装的流程下载源码 → 安装依赖 → 构建项目 → 启动 Web 页面 → 配置模型每一步附命令与截图说明。适合想在本地跑起来、二次开发或研究其插件架构的前端 / Node.js 开发者。一、背景DeepSeek Harness 是什么DeepSeek Harness命令名dsh是 DeepSeek 开源的 agent harness智能体框架主打**一切皆插件Everything is a Plugin**的架构底层由 Cordis 驱动。两点先说清楚它目前处于开发者预览阶段迭代很快后续版本可能出现破坏兼容性的变更官方提供了两种运行方式npm 直接运行npx deepseek-ai/dsh web免构建和源码运行。本文讲的是后者——适合想读源码、改代码、跟进最新提交的场景。仓库地址deepseek-ai/deepseek-harness二、环境准备系统Windows 10 / 11本文实操环境Node.js^22.19.0 || 24.0.0这是仓库package.json里engines字段的硬性要求版本低了会装不上或跑不起来pnpm仓库使用 pnpm workspace 管理多包必须用 pnpm 安装依赖Git克隆仓库和后续构建都需要 git 环境注意即使手动下载 ZIP构建步骤同样依赖 Git未安装会在构建时报错详见步骤 1 的说明磁盘空间克隆后源码 node_modules体积不小预留几个 GB检查环境的命令node-vpnpm-vgit--version如果没装 pnpmnpminstall-gpnpm三、源码安装步骤步骤 1获取源码方式 A命令下载推荐gitclone https://github.com/deepseek-ai/deepseek-harness.git方式 B手动下载打开仓库主页点击绿色Code按钮 →Download ZIP解压到本地目录。适合网络环境不便或不想装 Git 的情况但后续无法git pull更新。注意即使走手动下载 ZIP 这条路后面的构建步骤pnpm install/pnpm run build依然需要本机有 Git 环境。构建过程会依赖 git 命令没装 Git 的话到这一步会报错。所以除非实在没法装 Git否则更建议直接走方式 A。手动下载的另一个不足是后续无法git pull更新。步骤 2进入目录cddeepseek-harness进入后能看到apps、packages、scripts、pnpm-workspace.yaml等目录和文件——这是一个 pnpm workspace 多包仓库。小技巧Windows在资源管理器中打开该目录后在地址栏输入cmd回车即可在当前路径直接打开命令行不用手动cd。步骤 3安装依赖pnpminstall这一步会根据pnpm-lock.yaml拉取全部 workspace 依赖耗时取决于网络耐心等进度条走完。步骤 4构建项目pnpmrun buildpnpm run build会准备好仓库的全部构建产物前端页面、CLI 等。后面启动时直接使用这些产物不会重新构建——所以这一步不能省。步骤 5启动 Web 页面pnpmdsh web启动成功后默认在http://127.0.0.1:3080提供 Web UI本机启动时会自动用默认浏览器打开页面。如果不想自动打开浏览器可以加参数pnpmdsh web --no-open四条命令连起来就是gitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harnesspnpminstallpnpmrun buildpnpmdsh web步骤 6配置模型打开页面后进入设置 → 模型进行配置配置 DeepSeekDeepSeek 卡片提供了一个 API 密钥字段输入密钥并保存即可。密钥是只写的保存后页面只会收到脱敏描述符明文存储在本地$DSH_HOME/.credentials.yaml中。添加目录提供方选择「添加提供方」可选取 Anthropic、OpenAI 等输入对应 API 密钥保存。添加自定义提供方对于自建网关或目录里没有的服务选择「添加自定义提供方」填写小写 Provider ID、基础 URL、API 协议、凭据和至少一个模型。凡兼容 OpenAI 协议的接口都可以走这个入口接入例如各厂商的 OpenAI 兼容端点。模型变更会在下一次请求时生效不需要重启服务器。四、常见问题 / 避坑Q1pnpm install报 Node 版本错误怎么办A仓库engines要求^22.19.0 || 24.0.0。用node -v检查版本过低先升级 Node建议用 nvm 管理多版本。Q2pnpm不是内部或外部命令A没装 pnpm。执行npm install -g pnpm或用corepack enable启用 Node 自带的包管理器支持。Q3clone 很慢或失败A网络问题。可以改用方式 B 手动下载 ZIP或给 git 配置代理pnpm install慢则可以考虑切换 npm 镜像源。注意手动下载 ZIP 并不能省掉 Git——构建步骤依然依赖 git 环境没装的话先装 Git。Q4手动下载 ZIP 后pnpm run build报 git 相关错误A构建过程依赖 git 命令手动下载的目录不是 git 仓库且本机没有 Git 环境时会失败。安装 Git 后重试或者改用git clone方式获取源码。Q5pnpm dsh web和pnpm dev:web有什么区别Adsh web直接使用pnpm run build产出的构建产物不重新构建dev:web是开发模式watch 热更新适合改源码调试。只想跑起来的按本文流程用dsh web即可。Q6启动后浏览器没自动打开A手动访问http://127.0.0.1:3080SSH 远程场景下按终端打印的宿主机 URL 访问。Q7一定要从源码装吗A不需要。只是体验功能的话官方提供了免构建方式npx deepseek-ai/dsh web源码安装的意义在于能读源码、能改代码、能跟进最新提交适合研究「一切皆插件」架构或做插件开发的开发者。五、总结DeepSeek Harness 的源码安装流程非常规整clone → install → build → run四步走Web UI 默认跑在 3080 端口模型在「设置 → 模型」里配置密钥即可用。整体上是一个比较标准的 pnpm workspace monorepo 工程前端同学上手门槛不高。值得留意的两点一是项目处于开发者预览阶段更新频繁建议git pull后重新pnpm install pnpm run build二是它的插件化架构是主要看点后续可以尝试写一个自己的插件跑起来。具体界面与功能以官方文档和实际版本为准有问题欢迎在评论区交流。延伸阅读官方仓库https://github.com/deepseek-ai/deepseek-harness配置模型官方中文文档https://github.com/deepseek-ai/deepseek-harness/blob/main/docs/user/guide/providers.zh.mdWeb UI 使用指南https://github.com/deepseek-ai/deepseek-harness/blob/main/docs/user/guide/index.zh.mdCordis 框架https://github.com/cordiverse/cordis