教程 02 · 安装与启动
dsh 安装与第一次启动:从命令到第一个会话
dsh 安装教程:先装 Node.js,用 npx @deepseek-ai/dsh web 启动 Web UI(默认 127.0.0.1:3080),或从源码用 pnpm 构建。附第一次启动后配置模型、选择工作区和装第一个插件的步骤。文中命令均可在官方仓库核对,数据更新于 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 的全局安装说明。
- 装完插件没重启。 大部分插件要重启宿主才生效。
- 把插件问题当安装问题。 先卸掉最近装的插件,再判断。
相关
相关插件
- dsh-tui 怎么安装使用:装完想换终端界面就看这个。
- dsh-wallpaper-engine 怎么安装使用:装完想换外观和壁纸就看这个。
常见问题
必须装 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。