ChatGPTClaudeGrok / X / CursorGemini

dsh 最小安装:只想用网页、只用命令行、要桌面窗口,各装什么、各不装什么,按画像来装别多装

安装与快速上手发布于 2026-11-02作者: DeepSeek Plugin 插件市场
dsh 安装最小安装安装方式npx桌面端
不用把四种安装方式都试一遍。按「在哪用」反推最小组合:浏览器发消息只要 npx,脚本自动化装全局,要窗口才装桌面端,并给出不该多装的东西。

最小安装不是「装最少的包」,而是「按你的使用方式只装那一条入口」。 先回答「你在哪用」,再决定装什么,可以省掉一半以上的排错。

dsh 安装前先回答一个问题

如果只能问自己一句话,就问:我平时是在浏览器里发消息,还是在终端里跑命令,还是要一个桌面窗口。 三种答案对应三条最小路径,互不叠加:

你的答案最小入口需要 Node需要安装包
浏览器里发消息npx @deepseek-ai/dsh web是否
终端里跑命令 / 写脚本全局 npm是否
想要窗口与托盘桌面端否(自带运行时)是

三条路径共用同一份数据目录。 换入口不会自动迁移数据,但也不会丢,因为配置、会话、凭据都在 DSH_HOME 下。

dsh 画像 A:只在浏览器里用

只发消息、偶尔看看会话的人,npx 就是完整方案,不需要任何全局安装。 步骤:

  1. 确认 node -v 能输出版本号;
  2. 执行 npx @deepseek-ai/dsh web;
  3. 按启动输出里的地址打开浏览器,默认 127.0.0.1:3080;
  4. 在设置里填一次模型凭据;
  5. 用完直接关掉进程。

这条路径「不装」的东西很明确:不装全局命令、不装桌面端、先不装插件。 首次运行会自动初始化 web profile,你不需要手动准备目录。

代价是版本会变。 npx 可能每次拉到不同版本,适合体验与轻量使用;一旦你开始依赖某个版本的行为,就该换下一条路径。

dsh 画像 B 与 C:终端脚本和桌面窗口

要写脚本、配别名、固定版本的人,全局安装才是最小方案,npx 反而多一层不确定性。 步骤:

  1. 确认 npm 全局 bin 目录在 PATH 里;
  2. 执行 npm install -g @deepseek-ai/dsh;
  3. 用 dsh --version 确认命令可用;
  4. 记录版本号,写进你的环境说明;
  5. 需要升级时显式升级,而不是重装。

这条路径不装桌面端,也不需要在每个项目里再装一份。 一个全局命令足以支撑 dsh web、dsh --profile headless "任务" 等入口。

注意 profile 是按名称初始化的。 第一次用 headless、sdk 这些入口时会自动准备对应 profile,不需要你提前创建。

与前一种需求相邻但目标不同的,是「要一个窗口」,它对应的完全是另一套分发方式。

只有确实需要窗口、托盘与系统集成时才选桌面端,它不是命令行的替代品。 步骤:

  1. 从 Releases 下载对应系统的安装包;
  2. 安装并启动,按引导完成初始化;
  3. 在应用内配置模型;
  4. 更新走应用内提示,不手动覆盖安装目录;
  5. 卸载走系统流程,再决定是否清理数据。

桌面端不注册 dsh 命令。 装完发现终端里 dsh 仍然找不到是正常现象,因为两者是两套分发。要在终端里用,还得回到画像 A 或 B。

Linux 没有官方桌面包。 这种情况直接用命令行加浏览器,不要找第三方打包。

dsh 最小组合对照表与四样不该装的东西

把「装什么」和「不装什么」并排写,才不容易多装。 对照如下:

画像装明确不装
浏览器发消息Node + npx全局命令、桌面端、插件
终端自动化Node + 全局 npm桌面端、项目内重复安装
桌面窗口系统安装包全局命令(除非也要终端)
桌面 + 终端安装包 + 全局 npm第三份 npx 常驻

最后一行是唯一需要装两份的情况,而且两份各有明确用途。 其他组合装两份,只会让 which dsh 的结果变得难以解释。

对照表反过来看,就是一份「多数情况下多余」的清单。 多装带来的不是能力,而是排查成本。常见多余动作:

  1. 先装一堆插件再验证基础功能,出问题分不清是内核还是插件;
  2. 同一台机器同时保留 npx 缓存、全局包和桌面端,却说不清各自版本;
  3. 为了「保险」重复执行安装命令,导致全局目录出现多份同包;
  4. 照抄教程装 pnpm、装构建工具,实际只用浏览器发消息。

判断标准很简单:这个东西如果删掉,你常用的入口还能不能跑。 能跑,就不该装。

dsh 最小安装的验收与升级时机

不用追求装全,只要三条能过。 验收:

  1. 你的主入口能启动,且启动输出里没有报错;
  2. 发一条消息能得到回答,说明凭据与模型链路通;
  3. 重启一次仍然可用,说明不是偶然成功。

三条都过就可以停手。 需要插件时再加插件,需要脚本时再加全局命令,按需叠加比一次装齐更可控。

最小方案不是永久方案。 出现「每次启动版本都不同」「脚本要写死命令」「需要窗口」「要在多台机器复现」任一信号,就说明最小方案不够用了。升级方式是替换而不是叠加:换到全局后清掉 npx 缓存,避免下次又跑到旧版本。

dsh 安装下一步

先定画像,再动手装。 想看四种方式的完整对比,读 DeepSeek Harness 四条安装路;想看安装前的环境预检,读 安装前六项预检;想看装完怎么验收,读 装完十分钟验收;想比较 npx 与全局,读 npx 与全局安装的区别。

来源:DeepSeek Harness 官方文档、dsh CLI README、deepseek-harness Releases

ChatGPTClaudeGrok / X / CursorGemini

常见问题

只想在浏览器里用 DeepSeek Harness,最小要装哪些东西?

只要能跑 Node.js 的 npx,执行 npx @deepseek-ai/dsh web 就够了,不需要全局安装,也不需要桌面端。首次运行会自动初始化 web profile,会话与配置落在 DSH_HOME。

已经用 npx 跑通 DeepSeek Harness 了,还有必要再全局装一份吗?

只有在需要稳定命令名或离线复用缓存时,才需要再给 dsh 做一次全局安装。npx 每次可能拉到不同版本,如果你要写脚本、配别名、固定版本,再换成全局安装;两者同时装不会更快,反而容易搞不清在跑哪一份。

桌面端安装完成以后,为什么在终端命令行里还是找不到 dsh 命令?

dsh 的桌面端与 CLI 是两套分发,互不替代。桌面端自带运行时,但不会把 dsh 注册到系统 PATH。要在终端里用命令,仍需 npx 或全局 npm 安装。

按最小方式安装完 dsh 之后,想再装插件还需要额外准备哪些东西?

插件管理走 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 官方文档

来源