DeepSeek Harness 源码安装：git clone 与 pnpm 本地启动，国内出站分开验

官方把源码安装写得很直白：从 GitHub clone 仓库，用 pnpm 装依赖、构建，再 pnpm dsh web 起 Web UI。仓库地址：

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

适合要写插件、读 docs/development.md、跟 CI 的人。只想先看界面，优先走npx 一键启动。概念层仍看Harness 是什么；国内出站看代理专文。

环境：Node、pnpm、Git

Node.js：文档要求 22.19+ 或 24+（以 development 文档当前表述为准）。
pnpm：仓库用 Corepack 钉版本；若 pnpm -v 不对，先 corepack enable 再按 package 管理器字段走。
Git：开发文档对 Git 版本有下限要求；过旧可能影响 hook / worktree 相关脚本。

可选：准备 DEEPSEEK_API_KEY（或文档写明的其它变量）以便 Web / headless 演示真正调模型。没有 Key 时，你仍可能完成依赖安装与 UI 启动，但 Agent 任务会停在鉴权前。

逐步：clone → install → build → web

git clone https://github.com/deepseek-ai/deepseek-harness.git 并进入目录。
pnpm install：拉 workspace 依赖；若 postinstall 跳过导致 hook 缺失，按开发文档补跑官方脚本（不要随手删 hooks 目录「加速」）。
pnpm run build：产出本地可运行的构建结果。
pnpm dsh web：启动 Web UI；默认仍多指向本机 3080 端口（以进程输出为准）。

命令若与 README 不一致，以仓库为准——预览版改脚本名称比改文章快。

对照表：源码 vs npx

	npx @deepseek-ai/dsh web	git clone + pnpm
目标	快速试用 UI	开发、插件、跟主线
磁盘与时间	相对轻	整仓 + build，更重
主要出站	npm registry	GitHub + npm（及可能的其它 CDN）
升级方式	再跑 npx 拉新包	git pull 后按文档重装/重建

国内网络：GitHub 与 registry 分开验

clone 卡在 GitHub、install 卡在 npm，是两类失败。用 Clash Verge Rev 时建议：Rule 模式 + Tun（或终端 HTTP(S)_PROXY），新开 shell，先让 git ls-remote 或一次小 clone 成功，再跑 pnpm install。连接页应分别看得到 github 与 registry 相关记录。总策略见Tun 与 AI；端口冲突见7890/7897。客户端：下载中心。

直连规则别把 github.com、registry.npmjs.org 误送 DIRECT。改规则后重做「最小 clone / 最小 install」，不要凭感觉开 Global。

两段出站各用一条最小命令自检，先过 Git 再跑 pnpm：

git ls-remote https://github.com/deepseek-ai/deepseek-harness.git HEAD
npm ping

第一条能列出 HEAD，说明 Git 走到 GitHub；第二条返回 registry 延迟，说明 npm 出站通。任一条失败，都先别跑 pnpm install。

验收与止损

过关：仓库在本地、依赖装完、build 成功、Web UI 可开、（若已配 Key）最小只读任务成功。失败时按层拆：Git 失败只动 Git/代理；pnpm 失败先看 registry 出站与 Node；UI 起不来再查 build 日志。不要为了源码安装关掉公司 EDR，也不要把 Clash 重装当成每一次超时的默认动作。