dsh 最小安装:只想用网页、只用命令行、要桌面窗口,各装什么、各不装什么,按画像来装别多装
最小安装不是「装最少的包」,而是「按你的使用方式只装那一条入口」。 先回答「你在哪用」,再决定装什么,可以省掉一半以上的排错。
dsh 安装前先回答一个问题
如果只能问自己一句话,就问:我平时是在浏览器里发消息,还是在终端里跑命令,还是要一个桌面窗口。 三种答案对应三条最小路径,互不叠加:
| 你的答案 | 最小入口 | 需要 Node | 需要安装包 |
|---|---|---|---|
| 浏览器里发消息 | npx @deepseek-ai/dsh web | 是 | 否 |
| 终端里跑命令 / 写脚本 | 全局 npm | 是 | 否 |
| 想要窗口与托盘 | 桌面端 | 否(自带运行时) | 是 |
三条路径共用同一份数据目录。 换入口不会自动迁移数据,但也不会丢,因为配置、会话、凭据都在 DSH_HOME 下。
dsh 画像 A:只在浏览器里用
只发消息、偶尔看看会话的人,npx 就是完整方案,不需要任何全局安装。 步骤:
- 确认
node -v能输出版本号; - 执行
npx @deepseek-ai/dsh web; - 按启动输出里的地址打开浏览器,默认
127.0.0.1:3080; - 在设置里填一次模型凭据;
- 用完直接关掉进程。
这条路径「不装」的东西很明确:不装全局命令、不装桌面端、先不装插件。 首次运行会自动初始化 web profile,你不需要手动准备目录。
代价是版本会变。 npx 可能每次拉到不同版本,适合体验与轻量使用;一旦你开始依赖某个版本的行为,就该换下一条路径。
dsh 画像 B 与 C:终端脚本和桌面窗口
要写脚本、配别名、固定版本的人,全局安装才是最小方案,npx 反而多一层不确定性。 步骤:
- 确认 npm 全局 bin 目录在 PATH 里;
- 执行
npm install -g @deepseek-ai/dsh; - 用
dsh --version确认命令可用; - 记录版本号,写进你的环境说明;
- 需要升级时显式升级,而不是重装。
这条路径不装桌面端,也不需要在每个项目里再装一份。 一个全局命令足以支撑 dsh web、dsh --profile headless "任务" 等入口。
注意 profile 是按名称初始化的。 第一次用 headless、sdk 这些入口时会自动准备对应 profile,不需要你提前创建。
与前一种需求相邻但目标不同的,是「要一个窗口」,它对应的完全是另一套分发方式。
只有确实需要窗口、托盘与系统集成时才选桌面端,它不是命令行的替代品。 步骤:
- 从 Releases 下载对应系统的安装包;
- 安装并启动,按引导完成初始化;
- 在应用内配置模型;
- 更新走应用内提示,不手动覆盖安装目录;
- 卸载走系统流程,再决定是否清理数据。
桌面端不注册 dsh 命令。 装完发现终端里 dsh 仍然找不到是正常现象,因为两者是两套分发。要在终端里用,还得回到画像 A 或 B。
Linux 没有官方桌面包。 这种情况直接用命令行加浏览器,不要找第三方打包。
dsh 最小组合对照表与四样不该装的东西
把「装什么」和「不装什么」并排写,才不容易多装。 对照如下:
| 画像 | 装 | 明确不装 |
|---|---|---|
| 浏览器发消息 | Node + npx | 全局命令、桌面端、插件 |
| 终端自动化 | Node + 全局 npm | 桌面端、项目内重复安装 |
| 桌面窗口 | 系统安装包 | 全局命令(除非也要终端) |
| 桌面 + 终端 | 安装包 + 全局 npm | 第三份 npx 常驻 |
最后一行是唯一需要装两份的情况,而且两份各有明确用途。 其他组合装两份,只会让 which dsh 的结果变得难以解释。
对照表反过来看,就是一份「多数情况下多余」的清单。 多装带来的不是能力,而是排查成本。常见多余动作:
- 先装一堆插件再验证基础功能,出问题分不清是内核还是插件;
- 同一台机器同时保留 npx 缓存、全局包和桌面端,却说不清各自版本;
- 为了「保险」重复执行安装命令,导致全局目录出现多份同包;
- 照抄教程装 pnpm、装构建工具,实际只用浏览器发消息。
判断标准很简单:这个东西如果删掉,你常用的入口还能不能跑。 能跑,就不该装。
dsh 最小安装的验收与升级时机
不用追求装全,只要三条能过。 验收:
- 你的主入口能启动,且启动输出里没有报错;
- 发一条消息能得到回答,说明凭据与模型链路通;
- 重启一次仍然可用,说明不是偶然成功。
三条都过就可以停手。 需要插件时再加插件,需要脚本时再加全局命令,按需叠加比一次装齐更可控。
最小方案不是永久方案。 出现「每次启动版本都不同」「脚本要写死命令」「需要窗口」「要在多台机器复现」任一信号,就说明最小方案不够用了。升级方式是替换而不是叠加:换到全局后清掉 npx 缓存,避免下次又跑到旧版本。
dsh 安装下一步
先定画像,再动手装。 想看四种方式的完整对比,读 DeepSeek Harness 四条安装路;想看安装前的环境预检,读 安装前六项预检;想看装完怎么验收,读 装完十分钟验收;想比较 npx 与全局,读 npx 与全局安装的区别。
来源:DeepSeek Harness 官方文档、dsh CLI README、deepseek-harness Releases
常见问题
只要能跑 Node.js 的 npx,执行 npx @deepseek-ai/dsh web 就够了,不需要全局安装,也不需要桌面端。首次运行会自动初始化 web profile,会话与配置落在 DSH_HOME。
只有在需要稳定命令名或离线复用缓存时,才需要再给 dsh 做一次全局安装。npx 每次可能拉到不同版本,如果你要写脚本、配别名、固定版本,再换成全局安装;两者同时装不会更快,反而容易搞不清在跑哪一份。
dsh 的桌面端与 CLI 是两套分发,互不替代。桌面端自带运行时,但不会把 dsh 注册到系统 PATH。要在终端里用命令,仍需 npx 或全局 npm 安装。
插件管理走 dsh plugin --profile <名称>,底层调用 pnpm 往 profile 目录写依赖,所以需要目标环境能拿到 pnpm。只发消息不装插件的话,这一步可以完全跳过。
相关术语
- 使用画像
- 使用画像是对「你在哪、怎么用」的一句话描述,例如只在浏览器发消息、要在脚本里调用,用来反推所需的最小组件集合。— DeepSeek Harness 官方文档
- 全局安装
- 全局安装是一种把包装到 npm 全局目录并注册 `dsh` 命令的安装方式,适合长期使用与脚本调用,但升级要自己管。— dsh CLI README
- profile
- profile 是 DeepSeek Harness 的具名组装环境,web、headless、sdk 各自维护独立依赖,首次使用时会从随附模板自动初始化。— dsh CLI README
- DSH_HOME
- DSH_HOME 是 DeepSeek Harness 的数据根目录,默认 ~/.dsh,保存配置、会话、插件与凭据,与安装方式无关。— DeepSeek Harness 官方文档
来源
- DeepSeek Harness 官方文档· deepseek-harness
- dsh CLI README· deepseek-ai
- deepseek-harness Releases· deepseek-ai