先搞懂：这到底是个什么东西？

想象你买了一台高级音响（DeepSeek 的 AI 模型），但光有音响还不能听歌——你还需要一套机柜、遥控器和操作面板把它运转起来。

DeepSeek Harness（缩写 DSH）就是这套"操作台"：DeepSeek 官方出品的运行框架，负责把 AI 能力包装成你能直接上手的形态。装好之后，你可以在浏览器里跟 AI 聊天、写代码、执行任务，体验类似在线 AI 工具，但一切跑在你自己电脑上。

三种使用姿势，按上手难度排序：

姿势	长什么样	适合谁
Web 模式（主推）	浏览器里的聊天页面	所有人，尤其小白
TUI 模式	终端里的文字对话框	习惯命令行的开发者
Headless 模式	扔一个问题进去，拿到答案就退出	写脚本做自动化的人

开工前唯一要确认的事：电脑上有没有 Node.js 22 以上版本（建议 24）。没有的话，去 nodejs.org 下载安装包，一路点"下一步"即可。装完在终端输入 node -v 能看到版本号就 OK。

【JS-Node】node.js环境安装及使用-CSDN博客文章浏览阅读354次，点赞6次，收藏4次。Node.js是一个基于Chrome V8引擎的JavaScript运行时环境，适用于服务器端开发。安装时，可从官网下载对应操作系统的安装包，或通过包管理器（如Homebrew、Chocolatey）快速部署。https://blog.csdn.net/qq_39150957/article/details/160229375

---

安装：两条路，怎么选？

安装 DSH 有两种思路，区别类似"住酒店"和"买房"：

• 临时方式（npx）——像住酒店：随住随走不留痕迹，但每次进门都要办手续（联网下载）；
• 永久方式（npm 全局安装）——像买房：一次装修到位，之后推门就住。

	临时方式	永久方式
触发方式	每次完整输入 npx @deepseek-ai/dsh web	装好后只需 dsh web
首次之后还联网吗	可能重复下载	不需要
占用情况	存在缓存目录里	装进全局工具目录
适合场景	用一两次、尝鲜	日常使用（推荐）

建议：不确定的话先用临时方式感受一下，觉得顺手再转永久安装。

路线 A：先尝鲜（临时方式）

终端里粘贴这一行，回车：

bash

npx --yes @deepseek-ai/dsh web

第一次运行会先下载程序包，耐心等一会儿。看到启动成功的提示后，浏览器访问 http://127.0.0.1:3080 就能看到界面了。

小提示：npx 的意思是"临时借用一个程序来运行"，它把包缓存在 C:\Users\你的用户名\AppData\Local\npm-cache\_npx\ 下。哪天不想用了，删掉这个文件夹就干干净净。

路线 B：正式安家（永久安装，长期推荐）

分三步，每步一分钟：

① 安装（-g 表示装成全局命令）

npm install -g @deepseek-ai/dsh

② 检查：能打印出版本号（例如 0.1.0-rc.6）就算成功

dsh --version

③ 启动

dsh web

在浏览器打开提示的网址即可：

从今往后，你与 DSH 之间的全部日常交互就是四个字母加三个字母：dsh web。

日后想升级或告别，分别用：

npm update -g @deepseek-ai/dsh    # 升级
npm uninstall -g @deepseek-ai/dsh # 卸载

---

日常使用：一个命令走天下

每次想用 DSH，流程固定为：

打开终端 → 输入 dsh web → 浏览器打开 http://127.0.0.1:3080 → 开聊

想退出？回到终端按 Ctrl + C 即可关闭服务。

进阶：这些命令偶尔会用到

新手阶段你大概率只用得上 dsh web，但下面这些迟早会派上用场，收藏备用：

查看信息类

dsh --help        # 忘了命令怎么写？先看这个
dsh --version     # 确认当前版本

换种打开方式

dsh --profile tui                      # 终端对话模式（不开浏览器）
dsh --profile headless "帮我写个快速排序"  # 一问一答模式，答完自动退出
dsh --profile tui --resume <会话ID>     # 接着上次的对话继续聊

折腾配置类

dsh --dump-config         # 看当前生效的全部配置
dsh --dump-default-config # 看出厂默认配置
dsh --patch <配置文件路径>  # 用自己的配置文件覆盖默认值

装插件类

dsh plugin --profile web add <插件包名>    # 给 Web 界面加插件
dsh plugin --profile web remove <插件包名> # 移除插件

---

出问题了？先看这里

① 提示 dsh 不是可识别的命令

说明系统的 PATH 里没有 npm 的全局目录。运行 npm config get prefix 查看安装路径（一般是 C:\Users\你的用户名\AppData\Roaming\npm），把这个路径加进系统环境变量 Path，然后关掉终端重新打开再试。

② 端口 3080 被占用了

有别的程序在用这个端口。运行 dsh web --help 看看有没有指定端口的参数，换个端口启动就行。

③ 临时方式每次都要重新下载，太慢

这正是转永久安装的理由：npm install -g @deepseek-ai/dsh 装好后就不联网了。

④ 之前 npx 用过，又装了全局版，会打架吗？

不会，两者文件互不相干。只需记住启动口令的区别：临时版念全名 npx @deepseek-ai/dsh web，永久版念短名 dsh web。为了不混淆，建议固定用一种。

---

最后，把整个流程压缩成一张卡片

准备：装好 Node.js 22+（node -v 能出版本号）
安装：npm install -g @deepseek-ai/dsh
验证：dsh --version
使用：dsh web → 浏览器打开 http://127.0.0.1:3080
退出：终端 Ctrl + C