dsh插件市场

教程 02 · 安装与启动

dsh 安装与第一次启动:从命令到第一个会话

dsh 安装教程:先装 Node.js,用 npx @deepseek-ai/dsh web 启动 Web UI(默认 127.0.0.1:3080),或从源码用 pnpm 构建。附第一次启动后配置模型、选择工作区和装第一个插件的步骤。文中命令均可在官方仓库核对,数据更新于 2026-11-20。

上次核对:2026-11-20

症状 / 是什么

你还没有装 dsh,或者装完不知道下一步该做什么。目标不是「装完一个包」,而是看到一个能发消息的 Web UI。

为什么会这样

dsh 通过 npm 分发,但不是装完就有一个完整产品:它需要一个 Node.js 环境、一个模型配置和一个工作区。官方 README 把启动方式分成 npx 和源码两种,两条路都会落到 Web UI。

步骤

1. 装 Node.js

官方 README 只写「Install Node.js」,没有给最低版本;以 npm 上 @deepseek-ai/dsh 包声明的 engines 为准。装完在终端执行:

node -v

能看到版本号就继续。

2. 启动 Web UI

npx @deepseek-ai/dsh web

默认在 http://127.0.0.1:3080 启动并自动打开浏览器。SSH 启动只打印地址,转发由 SSH 客户端或编辑器负责。不想自动打开就加 --no-open。

3. 配模型

打开 Settings → Models,填入 DeepSeek API Key,保存。官方 Web UI 指南说模型路由会立即生效,不需要重启。要用别的供应商,按同页的 provider 配置添加。

4. 选工作区

点 Choose workspace,把你要让 dsh 处理的目录加进来并选中。没有选中工作区时,会话输入框不可用。

5. 发第一条消息

新建会话,输入一个本地、可验证的任务,比如「列出这个仓库的主要包,并说明每个包的用途」。确认能返回、能看到工具调用。

6. 装第一个插件(可选)

确认基础会话跑通后,再装插件:

dsh plugin --profile web add <包名>

装完重启 dsh 或刷新页面。插件清单见插件大全,装之前读怎么判断值不值得装。

常见坑

  • 端口被占。 3080 被别的程序占用时,用 --port 换一个端口。
  • 没选工作区。 输入框不可用通常不是模型问题,是还没选工作区。
  • npx 每次重新下载。 这是 npx 的正常行为;想要固定版本就用源码方式或按插件 README 的全局安装说明。
  • 装完插件没重启。 大部分插件要重启宿主才生效。
  • 把插件问题当安装问题。 先卸掉最近装的插件,再判断。

相关

相关插件

常见问题

必须装 Node.js 吗?

官方 README 的 npx 和源码两种方式都需要 Node.js;源码方式还需要 pnpm。没有 Node 环境就无法按官方方式启动。

3080 端口能改吗?

能。官方 CLI 帮助里有 `--port <port>`,例如 `dsh web --port 8080`。

第一次启动一定要配 API Key 吗?

要发消息就需要一个可用的模型路由。官方 Web UI 指南的第一步就是 Settings → Models 填 DeepSeek API Key。

接着看

教程目录