本教程带你从零上手 DeepSeek Harness（DSH），讲清楚"临时安装"和"永久安装"的区别，以及日常最常用的命令。全程实操，复制即用。
一、什么是 DeepSeek Harness？
DeepSeek Harness（简称 DSH）是 DeepSeek 官方的 AI 编程助手运行框架，提供 Web 图形界面、终端对话、任务执行等多种模式。
- 官方包名：
@deepseek-ai/dsh - Web 界面默认地址：
http://127.0.0.1:3080 - 依赖：Node.js 22+（建议 24）
二、两种安装方式，先看结论
| 对比项 | 临时安装（npx） | 永久安装（npm -g） |
|---|---|---|
| 安装命令 | npx @deepseek-ai/dsh web | npm install -g @deepseek-ai/dsh |
| 安装位置 | npm 缓存 _npx/ 目录 | 全局目录 AppData\Roaming\npm |
| 启动方式 | 每次都要 npx 前缀 | 直接敲 dsh |
| 适合人群 | 想先体验一下 | 打算长期使用 |
| 升级方式 | 自动用最新版（联网） | 手动 npm update -g @deepseek-ai/dsh |
一句话：想先试试用 npx，确定好用就 npm 全局装。
三、方式一：临时安装（先体验）
# 一键启动 Web 界面（首次会自动下载，稍等片刻）
npx --yes @deepseek-ai/dsh web
启动成功后，浏览器打开：http://127.0.0.1:3080
特点：
- 不污染全局环境，用完即走
- 包缓存在
C:\Users\你的用户名\AppData\Local\npm-cache\_npx\ - 想删掉？直接删掉
_npx目录即可（不影响其他软件）
缺点：
- 每次都要带
npx前缀 - 依赖 npx 缓存，清理缓存后要重新下载
四、方式二：永久安装（推荐长期使用）
第 1 步：全局安装
npm install -g @deepseek-ai/dsh
第 2 步：验证安装
dsh --version
能输出版本号（如 0.1.0-rc.6）即安装成功。
第 3 步：启动 Web 界面
dsh web
浏览器打开 http://127.0.0.1:3080 即可使用。
💡 以后每次使用，只需要一条命令：
dsh web
升级 / 卸载
# 升级到最新版
npm update -g @deepseek-ai/dsh
# 卸载
npm uninstall -g @deepseek-ai/dsh
五、常用命令速查表（小白必备）
🔧 基础命令
| 命令 | 作用 |
|---|---|
dsh --version | 查看版本号 |
dsh --help | 查看所有命令帮助 |
dsh web | 启动 Web 图形界面（最常用） |
dsh web --help | 查看 Web 界面的参数 |
🖥️ Web 界面相关
| 命令 | 作用 |
|---|---|
dsh web | 启动 Web 界面，默认端口 3080 |
dsh --profile web | 等价于 dsh web（完整写法） |
🤖 其他运行模式
| 命令 | 作用 |
|---|---|
dsh --profile headless "运行测试" | 无界面模式，回答一个任务后退出 |
dsh --profile tui | 终端交互界面模式 |
dsh --profile tui --resume <会话ID> | 恢复之前的会话 |
📦 插件管理
| 命令 | 作用 |
|---|---|
dsh plugin --profile web add <包名> | 给 Web 模式安装插件 |
dsh plugin --profile web remove <包名> | 移除插件 |
🛠️ 调试与配置
| 命令 | 作用 |
|---|---|
dsh --dump-config | 打印当前完整配置树 |
dsh --dump-default-config | 打印默认配置（不含用户自定义） |
dsh --patch <文件路径> | 加载额外的配置覆盖层 |
六、小白常见问题
Q1：npx 每次都提示下载，很慢怎么办？
答： 直接换永久安装：
npm install -g @deepseek-ai/dsh
以后直接 dsh web，不再联网下载。
Q2：永久安装后，dsh 命令找不到？
答： 全局安装目录没加入系统 PATH。检查方法：
npm config get prefix
把输出的路径（如 C:\Users\你的用户名\AppData\Roaming\npm）加入系统环境变量 Path，然后重开终端。
Q3：临时安装的缓存想清理？
# 直接删除 npx 缓存目录（安全，下次自动重建）
rmdir /s /q "%LOCALAPPDATA%\npm-cache\_npx"
Q4：端口 3080 被占用了怎么办？
答： 运行 dsh web --help 查看端口参数，按提示修改端口后重新启动。
Q5：装过临时版，又装了永久版，会不会冲突？
答： 不会。两者是独立的：npx 缓存和全局安装互不影响。只要记住——永久版用 dsh 启动，临时版用 npx @deepseek-ai/dsh 启动。建议二选一，长期用推荐永久版。
七、完整上手流程（照着做就行）
# ① 永久安装
npm install -g @deepseek-ai/dsh
# ② 验证
dsh --version
# ③ 启动 Web 界面
dsh web
# ④ 浏览器打开 http://127.0.0.1:3080 开始使用
以后每次使用：
dsh web
就这一条命令，完事。
总结
临时版：npx @deepseek-ai/dsh web → 体验用
永久版：npm install -g @deepseek-ai/dsh → 长期用
启动：dsh web → 打开 http://127.0.0.1:3080
如果本文对你有帮助，欢迎点赞收藏！有问题评论区见~
转载自 CSDN-专业IT技术社区
原文链接：https://blog.csdn.net/m0_73353792/article/details/163781648
