用 npx 一条命令启动 Web UI 的方法
前置条件
- 一台装好 Node.js 开发工具链的电脑(没有的话先去 Node.js 官网安装 LTS 版)。
- 稳定的网络(首次运行会拉取包)。
一条命令启动
在终端执行:
npx @deepseek-ai/dsh web
命令会下载并启动 Web UI,完成后终端里会打印访问地址。默认地址是本机的 127.0.0.1:3080,用电脑浏览器打开即可看到界面。
首次打开后
- 配置模型:进入 设置 → Models,填入模型 API 密钥并保存,模型路由立即可用(详见模型与 API 密钥配置教程)。
- 选择工作区:点 Choose workspace,把项目目录加进来并选中它——没选工作区之前,会话输入是不可用的(详见选择工作区并跑通第一个任务)。
- 发第一个任务:开一个会话,随便给它一个读仓库、改文件或跑命令的活,体会一下「模型动真格」是什么感觉。
端口与常用变体
- 改上游端口:
dsh web --port <端口号>(默认 3080)。后面装移动访问插件时,手机侧的独立 HTTPS 入口是另一个端口 3443,两者别混(见端口 3080 与 3443 的区别和防火墙放行)。 - npx 方式适合快速体验;长期使用建议看从源码克隆并安装的步骤或桌面客户端怎么装。
常见小问题
- 终端提示找不到命令:多数是 Node.js 没装好或 PATH 没生效,重开终端再试。
- 端口被占用:用
--port换一个即可。 - 命令行不想用 npx 拉包:源码安装是另一条路。