DeepSeek Harness 下载试用的最快路径，不是去找 exe 安装包，而是官方写在仓库首页的一句话：装好 Node 后执行 npx @deepseek-ai/dsh web。这条命令会按需拉取 @deepseek-ai/dsh（当前 npm 上可见开发者预览版），并拉起本机 Web UI；文档默认地址多为 http://127.0.0.1:3080。
本站做 Clash Verge Rev 资料。npx 本质是「终端里的 npm 下载 + 启动」。国内常见翻车点是：浏览器能开 GitHub，shell 却直连 registry 超时。概念见Harness 是什么；代理验收见Harness + Clash Verge；要跟源码主线见git clone 安装。
一键启动前：只检查三样
-
Node 版本：官方开发文档写明 22.19+ 或 24+。终端跑
node -v，不够就升级，别硬扛旧 LTS。 - 干净终端：若要用代理，先开好 Clash，再新开窗口跑 npx；旧窗口可能仍是空代理环境。
-
预期地址：启动成功后用本机浏览器打开
127.0.0.1:3080（若官方改了默认端口，以当前输出为准）。
不需要先会写插件，也不需要先 clone 整仓。预览版接口会变，命令以 deepseek-ai/deepseek-harness README 为准。
两条最小自检，跑在启动之前：
node -v
npm pingnode -v 结果低于 22.19 就先升级；npm ping 若超时，说明 registry 出站没通，先解决网络再跑 npx。
执行：npx @deepseek-ai/dsh web
npx @deepseek-ai/dsh web第一次会拉 CLI 包与依赖，时间取决于网速与是否进代理。看到本地监听日志后，浏览器打开 Web UI，按界面配置 DeepSeek（或其他已适配）API Key。验收不要一上来「重构 monorepo」：列目录、读一个小文件即可。
| 现象 | 先怀疑哪一层 | 下一步 |
|---|---|---|
| npx 卡住 / ETIMEDOUT | npm 出站 | Tun 或 HTTPS_PROXY 后重试 |
| 命令秒退、引擎报错 | Node 版本 | 升到文档要求区间 |
| UI 开了但任务失败 | Key / 工具权限 / 模型侧 | 别重装 Clash 当第一反应 |
| UI 开了、工具要访问海外仍超时 | Agent 子进程出站 | 按代理专文做最小出站任务 |
国内：何时必须先动 Clash Verge
npx 下载走的是当前 shell 的网络栈。系统代理绿灯救不了无视它的 Node。长期跑 Agent：Clash Verge 开 Tun（Windows 常需服务模式）；临时试跑：在同一终端设置：
-
HTTP_PROXY=http://127.0.0.1:混合端口 -
HTTPS_PROXY=http://127.0.0.1:混合端口
端口以客户端界面为准（常见 7897）。总览Tun 与 AI；终端细节命令行代理。客户端安装走下载中心——下的是代理客户端，不是 Harness 本体。
和源码安装怎么分工
npx：交付快，适合「今天先看见 UI」。源码：git clone → pnpm install → pnpm run build → pnpm dsh web，适合改插件、跟 CI、读开发文档。两条路径都可能在第一次依赖安装时撞到同一类出站问题；只是 npx 失败面更窄（主要是 npm），clone 还会叠 GitHub。选型表见源码专文。
验收与止损
过关：npx 结束进入监听、浏览器打开 Web UI、Key 可保存、最小只读任务成功。拉包连续失败时，一次只改网络层（Tun 或变量），不要同时升 Node、换镜像、开 Global。UI 已通但工具海外超时，转到代理专文做连接页验收，而不是反复重装 dsh。