波仔
🐳 第二章 从零开始运行DSH
📄 一句话概括

跑 DSH 的门槛只有一条：一台装了 Node.js（^20.19 或 >=22）的电脑，然后一条 npx 命令；真正需要小心的不是安装，是工作区别选错。

📝 本节和前面几节的关系

第一章讲完了【DSH 是什么、处在哪一层】，第二章开始动手。2.1 是第一步：把环境弄对。它和 2.2（选工作区）、2.3（配模型）一起，构成【能跑起来】的最小闭环。

一、前置条件只有一条

DSH 是一个跑在本机的程序，它的前置条件只有一条：

装好 Node.js，版本要 ^20.19 或者 >=22。

除此之外没有别的要求——不用服务器、不用数据库、不用 Docker。 本机实测的这台机器是 v22.22.2，满足条件。

只有【从源码构建】那条路才额外需要 pnpm 包管理器。走 npm 快速体验的话， 有 Node 就够了。

二、两种装法

两条路的差别不在【谁更专业】，而在【你要干什么】。 只是想把书读完、把实验做一遍，第一条路足够。

要注意：从源码构建必须先 build——生产运行依赖构建产物， 跳过构建会得到一堆莫名其妙的报错。

三、第一次会比以后慢

第一次跑 npx 会慢得多，因为它要下载一整套依赖。 本机实测：首次拉包花了 7 分 9 秒。

之后就快了——包进了本地缓存，再跑同一条命令只要几秒。 所以第一次装的时候别以为卡死了，耐心等它跑完。

装完之后，你会有一个属于自己的 DSH_HOME（默认在用户目录下）。 所有跟这台机器上的 DSH 有关的东西——配置、凭据、会话记录——都在那儿。 本机实测的 DSH_HOME 里当时只有一个 profiles 目录。

四、装完先验三件事

跑完安装命令，先确认三件事，再往下走：

  1. Node 版本够不够：node -v，看是不是 ^20.19 或 >=22。
  2. 包能不能拿到：npx @deepseek-ai/dsh --version，能打印出版本号就说明网络和包都没问题。
  3. DSH_HOME 落在哪儿：默认在用户目录，如果 C 盘吃紧， 现在就改到别的盘，别等装了一堆东西再搬。

这三步加起来花不了一分钟，但能省掉后面一大半【装不上】的排查。

五、动手 Demo：把环境查一遍（本机真跑）

下面这段是真跑出来的，不是模拟：

node -v
npm -v
node -e "console.log(process.platform + ' / ' + process.arch)"
npx -y @deepseek-ai/[email protected] --version

实跑输出：

--------------------------------------------------------------------
把环境查一遍（本机真跑）
--------------------------------------------------------------------
  下面这段不是在沙箱里模拟的，是在这台 Windows 机器上真跑出来的。

  $ node -v
  v22.22.2
  $ npm -v
  10.9.7
  $ node -e "console.log(process.platform + ' / ' + process.arch)"
  win32 / x64
  $ npx -y @deepseek-ai/[email protected] --version
  0.2.0-rc.2
  $ echo $DSH_HOME
  C:/Users/admin/.workbuddy/binaries/node/workspace/dsh_home
  $ ls $DSH_HOME
  profiles

  几点说明：
  - 前置条件是 Node.js ^20.19 或 >=22，这台机器是 v22.22.2，满足。
  - 平台是 win32 / x64。这一条后面有用——
    配置树里能看到 tool-bash 和 tool-pwsh 是按平台二选一加载的。
  - 第一次拉包花了 7 分 9 秒（要下载一堆依赖）；
    之后走的是本地缓存，再跑同一条命令只要几秒。
  - DSH_HOME 里现在只有一个 profiles 目录——这是默认位置，
    你当然可以用环境变量换到别的盘。

输出里最该记住的是两行：v22.22.2（版本满足要求）和 win32 / x64（平台）。 平台这一条后面有用——配置树里会看到 tool-bash 和 tool-pwsh 是按平台二选一加载的： Windows 上 pwsh 启用、bash 禁用，反过来在 Linux 上就是另一套。 同一个配置文件，在不同平台上挂的工具并不完全一样。

30 秒实验

  1. 在自己电脑上跑一次 node -v，看版本号够不够（要 ^20.19 或 >=22）。
  2. 用 npx @deepseek-ai/dsh --version 探一下，先不装，看能不能拿到包。
  3. 想清楚 DSH_HOME 放哪儿——默认在用户目录，C 盘紧张的话现在就改。

常见误区

  1. 错误：要买服务器才能跑。——纠正：DSH 在本机就能跑，一条 npx 命令起一个本地 Web 界面；服务器不是前置条件。
  2. 错误：得先有 API 密钥才能装。——纠正：安装不需要密钥，密钥是配模型那一步才要的。
  3. 错误：从源码构建更靠谱。——纠正：npx 走的是官方发布包；从源码构建反而多一层坑（要 pnpm、要先 build）。
自测三问（点开对答案） 1. 跑 DSH 的前置条件是什么？ —— 装了 Node.js（版本 ^20.19 或 >=22）；只有从源码构建才额外需要 pnpm。 2. 一条命令启动 Web 界面怎么写？ —— `npx @deepseek-ai/dsh web`，默认地址 `127.0.0.1:3080`。 3. 第一次为什么特别慢？ —— 要下载一整套依赖（本机实测 7 分 9 秒）；**之后走本地缓存就快了**。

相关笔记