资料核对日期:2026-11-16;未做本地安装实测。本文依据 DeepSeek Harness 官方仓库提交 39163dd30f703a79079e2d2446545cff3c453738 的中文 README 核对安装准备流程。该项目仍处于开发者预览阶段,未来可能出现破坏兼容性的变更。本文只确认该提交记录的源码运行路线,不把主分支视为稳定版本,也不据此断言其他提交仍支持完全相同的步骤。

本次任务与输入

目标是准备一套能够从官方仓库源码构建并启动 DeepSeek Harness 的环境,随后完成最低限度的启动验收。需要输入的是可访问官方 GitHub 仓库的命令行环境,以及 Git、Node.js 和 pnpm。除 README 外,还需核对同一提交的 package.json:其 engines.node 要求为 >=24.9.0,packageManager 固定为 pnpm@11.28.5。因此本文源码路线应准备 Node.js 24.9.0 或更新版本,并使用 pnpm 11.28.5;Git 用于克隆仓库。后续提交可能调整这些要求,不能将其他版本文章中的下限直接套到本提交。

开始前应阅读仓库中的安全说明。由于官方将当前状态标为开发者预览,不应把本文引用的提交、默认分支或命令行为包装成长期稳定承诺。若需要可复现地固定某个发行版本,发布标签、支持周期及对应切换命令均需从仓库当前发布信息另行确认,不能自行补写。

对照版本文件检查环境

检查对象 本文所核对提交的要求
Node.js package.json 的 engines.node 为 >=24.9.0
pnpm packageManager 为 pnpm@11.28.5

先将实际环境与这两项对应起来,再安装依赖。如果实际检出的源码不是本文所核对的提交,应重新读取该检出版本的清单,不能只凭教程日期选择版本。

按官方顺序准备源码

在准备好的终端中逐行执行官方 README 给出的完整源码路线:

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

这条路线先克隆仓库并进入项目目录,再安装依赖、准备仓库产物,最后启动 Web UI。不要在这里加入未经来源确认的全局 pnpm 安装命令、强制安装选项、提交切换命令或产物目录名称。尤其要注意,git clone 获取的是执行当时仓库默认分支指向的内容;本文所核对的文档来自指定提交,但官方材料没有提供固定到该提交的操作命令。

如果当前目标只是快速运行而非检查源码构建,官方另有 npm 路线:先安装 Node.js,然后执行:

npx @deepseek-ai/dsh web

该命令默认在 http://127.0.0.1:3080 启动 Web UI。本篇以仓库环境核对为目标,默认采用前述源码路线,不继续展开模型、密钥或插件配置。

成功验收

验收时应确认五条命令按顺序完成,并且最后的 pnpm dsh web 没有因前置依赖或构建失败而中止。官方说明 pnpm run build 用于准备仓库产物,随后 pnpm dsh web 会直接使用这些已构建产物,不会重新构建;因此启动阶段不应被当作构建命令的替代品。

若采用 npm 路线,可在本机浏览器访问 http://127.0.0.1:3080 作为最低限度的界面验收。通过 SSH 启动时,官方说明终端只打印宿主机 URL,本地转发地址由 SSH 客户端或编辑器持有,所以不能仅因浏览器没有自动打开就判定启动失败。

一个失败场景及检查

若源码路线在 pnpm install、pnpm run build 或 pnpm dsh web 阶段中止,先核对是否已经成功执行 cd deepseek-harness,并确认没有跳过前一条官方命令。再核对报错中的引擎与包管理器版本,确认 Node.js 满足 >=24.9.0、pnpm 为 11.28.5,并与实际检出的 package.json 一致。若当前源码已更新,以当前检出提交声明的条件为准。不要用 pnpm install --force 跳过真实的依赖或版本错误。

仍无法继续时,应保留终端原始错误信息,并前往官方 GitHub Discussions 提交反馈或 bug 报告。由于没有本地执行证据,本文只能给出上述验收条件,不能声称安装已经成功。

官方参考资料

继续阅读