安装与环境准备

目标

准备一台能跑通 npx @deepseek-ai/dsh web 或源码安装的环境，少踩 PATH、端口与权限的坑。

前置检查清单

1. Node.js LTS 已在 PATH（node -v、npm -v）。
2. 能访问 npm（或已配置镜像）。
3. 需要真实对话时，准备官方平台的 DeepSeek API Key（本站不发放密钥）。
4. 准备一个 可丢弃的工作区目录，不要第一次就指向整个用户主目录。

路径 A — npx 快速体验

npx @deepseek-ai/dsh web

会拉取开发者预览包并启动本地 Web UI（常见为 http://127.0.0.1:3080）。使用期间保持终端运行。

路径 B — 源码安装（贡献者）

git clone https://github.com/deepseek-ai/deepseek-harness

按仓库 README 完成安装。写 Cordis 插件或紧跟上游时更适合源码路径。

环境建议

• 用 nvm/fnm 等管理 Node 版本，避免零散安装。
• 公司代理导致 npx 失败时，先修好 registry/代理。
• 明确工作区属主用户，便于沙箱与文件工具行为可预期。

FAQ

• npx 卡住或 UI 打不开？ 按决策树排查：修复 npx 与 3080，再对照 排错 条目。
• 这一章是不是第二篇快速开始？ 不是——叙事上手见 npx 快速开始；本章是环境清单。

下一步

打开 快速上手，在 UI 里跑完一个低风险闭环。