先搞懂：这到底是个什么东西？
想象你买了一台高级音响（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
