DeepSeek Harness 快速开始：npx @deepseek-ai/dsh web

你真正要跑的命令

Node.js 已在 PATH 之后，公开快速开始是：

npx @deepseek-ai/dsh web

包名写错会浪费一下午。Web UI 常见地址是 http://127.0.0.1:3080/。终端要留着，关掉服务就停。

上游文档写 Node ^22.19.0 或 >=24.0.0。过旧的 18/20 常常在 engines 检查失败。请在 同一个 shell 里跑 node -v 和 npx——nvm/fnm 在另一个窗口选的版本帮不上忙。

分系统，但不假装我们发安装包

• Windows： 装 LTS（winget 或 nodejs.org），重开终端，cd 到项目目录再 npx。PATH、PowerShell vs Git Bash、受控文件夹访问与 WSL 路径坑，见 Windows 上的 DeepSeek Harness。
• macOS： 官方 pkg 或 Homebrew。第一天不要「以防万一」打开完全磁盘访问——PATH、TCC 与芯片架构见 macOS 上跑 DeepSeek Harness。
• Linux / WSL： nvm 或发行版 Node 22/24。不要用 root。WSL 工作区放在 Linux 文件系统。

完整一键命令在 安装页。本文是叙事，那一页才是清单。

UI 起来之后

1. 设置 → 模型（预览版文案会变）。粘贴 DeepSeek 平台密钥。本站不发放密钥。本地 UI 默认不是 本地推理。
2. 选 可丢弃 工作区。整个用户主目录是错误的第一目标。
3. 先发低风险任务：列顶层文件、用五点总结 README。看工具调用。若开始删文件或乱 chmod，立刻停。

无头/CLI 留给以后的 CI——DeepSeek Harness headless、--json 与 --session-id 的操作笔记见 无头跑 DeepSeek Harness。第一个小时仍留在浏览器里，才能看见 Trajectory 一类轨迹。

失败时去哪

npx 超时、缓存到老 rc、缺 pnpm（插件 add 常会调 pnpm）、3080 被占、Unix 凭证文件权限、macOS TCC——这些写在 排错，不要在博客评论里猜。同一批失败的决策树（Node engines → npx 拉取 → 端口 3080 → 密钥）见 修好 npx 与端口 3080。镜像落后就换官方 npm registry。

源码安装是另一份工作

贡献者 clone deepseek-ai/deepseek-harness，再 pnpm install、pnpm run build、pnpm dsh web。那是写 Cordis 插件时的路，不是「我只想看一眼 UI」。两套心智混在一起，就会把 pnpm 报错贴进 npx 帖子。

下一步：先看 运行模式，别把 Creative 实验开在工作仓库上；等第一环无聊地成功了，再去 社区插件。

不需要英雄主义的第一个小时

1. 在即将跑 npx 的同一个窗口执行 node -v。若是 18 或 20，停下来装 22.19+ 或 24+。
2. cd 进一个可以扔掉的克隆。先把密钥拷走。
3. 跑 npx @deepseek-ai/dsh web，等到终端打出本机 URL。不要用 Ctrl+C「看它活着没」。
4. 打开 http://127.0.0.1:3080/——除非你清楚谁能访问，否则不要随手开云隧道。
5. 在设置里粘贴平台密钥。除非你自己装了本地权重栈，否则不要把 UI 理解成本地推理。
6. 提示词：「列出顶层文件，并引用 README 的第一个标题。」看工具列表。若要大范围删除或 chmod，拒绝。

这足以决定预览版值不值得第二个小时，不足以对准给人发薪的单体仓库。

npx 和全局安装

全局 npm i -g 看起来省事，两个终端解析到不同大版本时就会吓你一跳。文档里的快速开始是对 scoped 包使用 npx。提缺陷时把版本写进备注：「rc.N，Node 22.19.0，Windows 11，工作区 D:\scratch\demo」。上游无法调试「它挂了」。

公司代理中间人会让 npm 超时，看起来像产品缺陷。排错 覆盖镜像与缓存；本文不会为每份 PAC 发明代理教程。

「成功」长什么样

你能用一句话说清 Agent 可以碰哪个文件夹。你能打开会话检查器指到一条工具结果。你没有在同一场里装皮肤市场、「免费 overlay」和三个 GitHub 话题。做到这些，再进 运行模式，最多再加一个精选插件——仍然当软件，仍然留卸载路径。

写给会踩坑的同事

把 npx 和源码 pnpm 写在同一条聊天里，是最常见的混乱。只想看 UI 就走 npx；要改 Cordis 再 clone。工作区选错比命令写错更贵：主目录一旦被当成根，Trajectory 里会出现你不认得的路径。先停，换可丢弃克隆，再继续。密钥只存在运行时要求的文件里，chmod 按上游来，不要贴进 README「方便大家」。公司 npm 镜像若落后 rc，换官方 registry 再试，而不是换三条「加速教程」。做完第一环，用同一句提示词在 Standard 看工具列表，再决定要不要 社区插件。皮肤先看 界面皮肤，不要从截图商店一键装。

核对 Node 与 npx 必须在同一窗口。预览 UI 文案会变，设置里的「模型」二字可能改名，事实是你要贴平台密钥。本地界面默认仍走云端提供方。工作区根写进你自己的笔记，和 rc 号放一起。失败先看 排错 的端口、pnpm、镜像，再怀疑产品本身。源码安装是另一条职业路径，写插件才需要。第一环成功之前，不要打开皮肤市场。