dsh 安装怎么做？DeepSeek Harness 三种安装方式：npx 一键运行、npm 全局安装、源码构建全对比
DeepSeek Harness 有三种安装方式：npx 一键运行免安装（新手推荐）、npm 全局安装 dsh 命令（日常推荐）、源码构建（开发与追新版）。本文用对比表讲清三种方式的适用场景、前置条件、命令步骤、安装后验证与卸载说明，最后附常见问题排查表。
概览：三种安装方式对比表
选 npx 还是全局装，取决于你要「尝鲜」还是「常用」。 三种方式数据目录相同（默认 ~/.dsh），插件与配置互通，随时可以切换（来源）：
| 方式 | 适用场景 | 前置条件 | 启动命令 | 卸载方式 |
|---|---|---|---|---|
| npx 一键运行 | 快速体验、不想装环境 | Node.js | npx @deepseek-ai/dsh web | 无本地安装，无需卸载 |
| npm 全局安装 | 长期日常使用 | Node.js + npm | dsh web | npm uninstall -g @deepseek-ai/dsh |
| 源码构建 | 追最新代码、二次开发 | Node.js + git | 构建后 dsh web | 删除克隆的仓库目录 |
方式一：npx 一键运行（新手推荐）
一条命令下载并启动，不写任何全局文件，是体验 DeepSeek Harness 最快的路。
前置条件：
- 本机已安装 Node.js（含 npm），终端执行
node -v能输出版本号； - 网络可访问 npm registry（国内网络可先配置 npm 镜像加速）。
操作步骤：
- 打开终端，执行启动命令：
npx @deepseek-ai/dsh web
- 首次运行自动下载
@deepseek-ai/dsh包并初始化 web profile，等待「服务已启动」提示； - 浏览器自动打开
http://127.0.0.1:3080；没自动打开就手动输入该地址； - 完成首次设置（如配置模型提供方）即可开始使用。
失败兜底：提示 npx: command not found 说明 Node.js 未安装或 PATH 未配置，先装 Node.js 再重试；下载缓慢或超时，切换 npm 镜像（npm config set registry https://registry.npmmirror.com）后重跑。
方式二：npm 全局安装（日常推荐）
把 dsh 命令装进系统，之后随开随用，更新与卸载都走 npm，管理最顺。
前置条件：Node.js + npm 可用，终端执行 npm -v 能输出版本号。
操作步骤：
- 全局安装：
npm install -g @deepseek-ai/dsh
- 验证安装：执行
dsh --version，应输出版本号； - 启动服务：
dsh web
- 浏览器打开
http://127.0.0.1:3080，完成首次设置。
失败兜底：提示 dsh: command not found 时，用 npm prefix -g 查出全局 bin 目录并加入 PATH，重开终端再试；报 EACCES 权限错误时，用 sudo npm install -g @deepseek-ai/dsh 或配置用户级 npm prefix。
方式三：源码构建（开发与追新版）
克隆官方仓库自己构建，适合读源码、二次开发或抢鲜未发布功能。
前置条件：Node.js（node -v 可用）、git（git --version 可用）、网络能访问 GitHub。
操作步骤：
- 克隆官方仓库：
git clone https://github.com/deepseek-ai/deepseek-harness
- 进入目录并安装依赖：
cd deepseek-harness
npm install
- 按仓库文档执行构建命令（具体命令以仓库 README 为准）；
- 构建完成后运行
dsh web启动，浏览器打开http://127.0.0.1:3080。
失败兜底：git clone 超时说明 GitHub 访问受限，配置代理后重试；npm install 报错先看是否 Node 版本过低，升级 Node.js 后重跑。
安装后验证与下一步
装完先验证，再进入插件生态。 操作步骤：
dsh --version能看到版本号 = 本体安装成功；dsh web（或npx @deepseek-ai/dsh web）能打开http://127.0.0.1:3080= 完全可用；- 下一步安装 DSH Plugin Hub，执行
dsh plugin --profile web add dsh-plugin； - 重启 dsh web 并刷新页面，在设置 → 插件中心使用。
三种方式的卸载说明
怎么装的怎么卸，注意本体与 ~/.dsh 数据目录是两回事。 对应命令：
# npx 方式：无本地安装，最多清临时缓存（数据目录保留）
rm -rf ~/.npm/_npx
# npm 全局安装
npm uninstall -g @deepseek-ai/dsh
# 源码构建：删除克隆的仓库目录
rm -rf ~/path/to/deepseek-harness
卸载只删程序本体，~/.dsh 下的配置、密钥与会话默认保留；想彻底清数据再手动删 ~/.dsh（清前先备份）。
常见问题与解决
装不上、打不开，先按下面的表定位。 常见问题清单：
| 问题 | 可能原因 | 解决办法 |
|---|---|---|
npx: command not found | Node.js 未安装或 PATH 未配置 | 安装 Node.js，重开终端再试 |
dsh: command not found | 全局 bin 目录不在 PATH | npm prefix -g 查目录并加入 PATH，重开终端 |
| 安装 / 下载超时 | 网络慢、registry 访问受限 | 配置 npm 镜像：npm config set registry https://registry.npmmirror.com |
| 权限错误（EACCES） | 全局目录无写权限 | 用 sudo 安装，或配置用户级 npm prefix |
git clone 超时 | GitHub 访问受限 | 配置代理后重试 |
| 浏览器打不开 3080 端口 | 服务未启动或端口被占用 | 确认终端服务仍在运行，检查并释放 3080 端口后重启 |
总结速查
一句话：新手 npx 起步、常用装全局、开发用源码，装完先 dsh --version 再 dsh web。 四个提醒：
- 三种方式数据互通，切换安装方式不会丢
~/.dsh里的配置、会话与插件； - 先装 Node.js：三种方式都依赖 Node.js，装前先确认
node -v； - 首次下载慢正常：npx 与全局安装首次都要拉包，配 npm 镜像可加速；
- 装完进插件生态：
dsh plugin --profile web add dsh-plugin装好 DSH Plugin Hub，再从设置 → 插件中心安装其他插件。
来源：dsh CLI README、DeepSeek Harness 官方文档 - Quickstart、dshplugin/dsh-plugin-hub
常见问题
三种：npx 一键运行（npx @deepseek-ai/dsh web，免安装即用）、npm 全局安装（npm install -g @deepseek-ai/dsh，装完用 dsh web 启动）、源码构建（git clone https://github.com/deepseek-ai/deepseek-harness 后 npm install 并按文档构建）。
推荐 npx：一条命令自动下载并启动，始终用最新版，不写任何全局文件；确认长期使用后升级为全局安装（npm install -g @deepseek-ai/dsh），启动更快。
启动直接运行 dsh web，浏览器打开 http://127.0.0.1:3080；更新执行 npm update -g @deepseek-ai/dsh；验证版本用 dsh --version。
需要 Node.js 环境（node -v 确认版本）、git（git --version 可用），网络能访问 GitHub；克隆后进入 deepseek-harness 目录执行 npm install，再按仓库文档执行构建命令。
两步验证：dsh --version 能看到版本号 = 本体就绪；再运行 dsh web（或 npx @deepseek-ai/dsh web），浏览器能打开 http://127.0.0.1:3080 = 完全可用。
来源
- dsh CLI README· deepseek-ai
- DeepSeek Harness 官方文档 - Quickstart· deepseek-harness
- dshplugin/dsh-plugin-hub GitHub 仓库· GitHub