安装DeepSeek Harness

1. 快速验证（确保路径生效）

刚装完 Node.js，最好刷新一下环境变量。输入以下命令，确认能正常显示版本号：

node -v
npm -v

如果都显示了版本号（特别是 node 显示 v24.x.x），说明安装成功。如果提示“不是内部命令”，请重新打开一个新的命令行窗口再试。

2. 一键启动 DeepSeek Harness

无需额外安装，直接执行下面这条神奇的命令，它会自动把 Harness 跑起来：

npx @deepseek-ai/dsh web

• 首次运行：会花 1-2 分钟下载必要的依赖包，请耐心等待，不要按 Ctrl+C 中断。

• 启动成功：终端里会出现一行提示，类似 Server running on http://127.0.0.1:3080。

3. 打开浏览器使用

看到上面的地址后，打开你的浏览器（Chrome/Edge），访问 http://127.0.0.1:3080。

进去之后，你需要做两件事：

1. 填 API Key：去 DeepSeek 开放平台复制你的密钥，粘贴进去。

2. 选工作区：选择一个你电脑上空的或者存有代码的文件夹，作为 Agent 的工作目录。

1. 迁移位置

   第1步：创建大文件存放目录

   打开命令提示符（cmd），执行以下命令，在D盘建好文件夹：

   cmd

   mkdir G:\ruanjian\DeepSeekData
   mkdir G:\ruanjian\DeepSeekData\npm-cache
   mkdir G:\ruanjian\DeepSeekData\dsh-home

   ---

   第2步：转移 Node.js 下载缓存（解决 npx 下载占用）

   执行这条命令，告诉 npm 以后所有下载的安装包都放到 D 盘：

   cmd

   npm config set cache G:\ruanjian\DeepSeekData\npm-cache

   ---

   第3步：转移 Harness 运行数据（最关键，省空间大户）

   Harness 会把代码索引、向量数据库等超大文件默认藏在 C:\Users\你的用户名\.dsh 里。我们通过设置环境变量，强制它改存到 D 盘：

   cmd

   setx DSH_HOME G:\ruanjian\DeepSeekData\dsh-home

   （看到 成功 的提示后，必须关闭并重新打开一个新的命令提示符窗口，这个设置才会生效）

   ---

   第4步：在新窗口里重新启动 Harness

   重新打开 cmd，执行启动命令：

   cmd

   npx @deepseek-ai/dsh web

   此时，所有大文件都会自动写入 G:\ruanjian\DeepSeekData 里，你的系统盘空间不会再被吃掉了。

1. Node.js 内存不足（JavaScript heap out of memory）

   立即修复（三步走）

   第1步：关闭当前命令行窗口，重新打开一个新的 cmd

   因为我们要设置新的环境变量，必须重启窗口才生效。

   第2步：给 Node.js 增加内存上限

   在新的 cmd 窗口中，依次执行以下命令（每条单独执行）：

   cmd

   set NODE_OPTIONS=--max-old-space-size=4096
   npm cache clean --force

   第一条命令把内存上限临时提升到 4GB（如果你的电脑物理内存有 8GB 或以上，可以改成 8192 更保险）。
   第二条命令清除之前可能损坏的缓存，避免残留问题。

   第3步：重新运行启动命令

   现在再执行：

   cmd

   npx @deepseek-ai/dsh web

   此时 npx 会重新下载，但这次内存足够用了。耐心等待，应该能顺利启动。

   ---

   💡 如果 4GB 还不够（或你电脑只有 4GB 内存）

   可以尝试以下替代方案：

   方案 A：直接全局安装（避免 npx 临时解压的开销）

   cmd

   npm install -g @deepseek-ai/dsh
   dsh web

   全局安装会把包完整下载到本地，后续启动时内存压力会小一些。

   方案 B：使用社区桌面版（完全避开 Node.js 内存问题）
   如果你电脑内存实在紧张（比如 ≤4GB），强烈建议改用 DeepSeek Harness 桌面版（.exe 安装包）。它是独立的应用程序，不依赖 Node.js 运行时，内存管理更友好，而且同样支持修改数据存储路径（在设置里可改）。

   
   

1. 做个桌面“一键启动”图标（懒人福音）

   如果你不想每次都用鼠标去点“开始菜单”找命令行，可以直接在桌面上创建一个启动脚本，双击就能用。

   1. 在桌面空白处右键 -> 新建 -> 文本文档。

   2. 把下面这三行代码复制进去（注意把D:\DeepSeekData替换成你之前设的路径）：

      cmd

      @echo off
      set NODE_OPTIONS=--max-old-space-size=4096
      npx @deepseek-ai/dsh web
      pause

   3. 保存文件，然后把文件名改为 启动Harness.bat（注意后缀是 .bat，不是 .txt）。

   4. 以后要用时，双击这个图标就行，命令行会自动弹出并启动 Harness。

   ---

   ⚠️ 关于内存设置的重要提醒

   你刚才用的 set NODE_OPTIONS=--max-old-space-size=4096 是临时的，关掉命令行就失效了。

   • 如果你选了方案一或方案二，建议把内存设置加入系统环境变量，一劳永逸：

     1. 按 Win + R，输入 sysdm.cpl 回车。

     2. 点“高级” -> “环境变量”。

     3. 在“系统变量”里点“新建”，变量名填 NODE_OPTIONS，变量值填 --max-old-space-size=4096，保存即可。

   • 如果你选了方案三（批处理），内存设置已经写在脚本里了，不用再管环境变量。