安装 DeepSeek Harness

从安装 Node.js 到一行命令启动，再到选择工作区——十分钟从零跑起 DSH，附数据目录位置与彻底卸载方法。

约 6 分钟读完

读完这篇你会

  • 在自己的电脑上跑起 DeepSeek Harness
  • 打开它的网页界面
  • 知道它把数据存在哪里、怎么彻底删掉它

整个过程大约十分钟，唯一的门槛是你要会用终端输入命令。别怕，每一步都可以直接复制粘贴。

第一步：安装 Node.js

DeepSeek Harness 用 Node.js 编写，跑它需要先装 Node.js 22 或更高版本（建议直接装最新的 LTS 长期支持版）。

先检查电脑上有没有装过。打开终端（macOS 打开"终端"，Windows 打开"PowerShell"），输入：

node -v
  • 如果输出 v22.x.x 或更高（如 v24.x.x）——恭喜，跳过这一步。
  • 如果提示"命令不存在"或版本低于 22，去 nodejs.org 下载 LTS 安装包，一路"下一步"装完，重新打开终端再试一次 node -v。

小知识：Node.js 相当于一个"电器插板"，dsh 这个"电器"要插上才能工作。装一次就不用管了。

第二步：一行命令启动

在终端里粘贴这一行并回车：

npx @deepseek-ai/dsh web

第一次运行会发生什么：

  1. npx 会自动从 npm 下载 DeepSeek Harness（约一两分钟，取决于网速）；
  2. 下载完自动启动，终端会打印一行访问地址，类似：
DeepSeek Harness is running at http://127.0.0.1:3080
  1. 打开浏览器，访问 http://127.0.0.1:3080，就能看到界面了。

注意：这个终端窗口要保持开着，它就是 DSH 的"发动机"。关掉窗口 = 关掉 DSH。想停止服务，在终端里按 Ctrl + C。

npx 是 Node.js 自带的"临时运行器"：不用真正安装软件，输入命令时它自动帮你下载并运行。适合先体验试试。

第三步：选择工作区

第一次打开界面时，聊天框是不可用的，因为 DSH 还不知道该操作哪个文件夹。

点击界面上的选择工作区，把你想让它干活的文件夹加进来（比如你的代码项目目录），然后选中它。选中后，输入框就解锁了。

工作区就是 DSH 的"活动范围"——它能读写的文件都限于这个目录内。想换项目，随时再点选择工作区切换。

第四步（可选）：填 API Key，让它开口说话

此时你可能发现：DSH 还不能真正回答问题，因为它还没接上模型。这一步只需两分钟：

  1. 去 platform.deepseek.com 注册并创建一个 API Key；
  2. 在 DSH 界面打开设置 → 模型，把 Key 粘贴进去保存。

详细图文步骤（包括充值、常见报错）见配置模型教程。到这一步，DSH 就完全可用了。

想更省事：全局安装 dsh

用 npx 每次启动都要敲一长串。如果你打算长期用，推荐全局安装：

npm install -g @deepseek-ai/dsh

装完之后，以后启动只需要：

dsh web

两种方式没有功能区别，只是命令更短。新手上路先用 npx 完全没问题，想换全局安装随时可以装。

数据都存在哪里

DeepSeek Harness 的所有数据都集中在一个目录里：

系统位置
macOS / Linux~/.dsh
WindowsC:\Users\你的用户名\.dsh

里面主要有：

  • profiles/——各套插件组合（Profile）的配置与已装插件；
  • .credentials.yaml——你保存的 API 密钥；
  • 会话日志——你和 AI 的完整对话记录。

想备份：把这个目录整个复制走即可。想彻底重置：退出 dsh，删掉这个目录，下次启动就是全新状态。

常见问题速查

  • 终端报错 command not found: npx：Node.js 没装好，回到第一步；装完记得重开终端。
  • npx 下载特别慢：是网络问题。可以给 npm 换国内镜像：npm config set registry https://registry.npmmirror.com，再重新运行。
  • 浏览器打不开 3080 端口：先确认终端窗口还开着、没有报错。端口被占用等更多情况见常见问题。
  • 杀毒软件/防火墙提示：dsh 要在本机开一个端口提供网页服务，选"允许"即可。它不会对外网开放。

下一步

装好了，接下来把模型配置明白，让 DSH 真正"长出大脑"：

配置模型（API Key）→

全部教程