dsh CLI 安装与常用命令
两条命令装好，九条命令够用。含版本要求与常见报错排查。
安装 CLI
免安装方式（推荐先试）
npx @deepseek-ai/dsh web不写入全局环境，适合先体验或临时使用。
全局安装（长期使用）
npm install -g @deepseek-ai/dsh装完之后直接用 dsh 命令。Node.js 需 ≥ 22.19。
DeepSeek API Key：CLI 只是运行时， 首次启动后需要在 Web UI 设置里填入 DeepSeek API Key（在 DeepSeek 开放平台创建）才能实际调用模型。
常用命令速查
| 命令 | 说明 |
|---|---|
npx @deepseek-ai/dsh web | 免安装直接启动 Web UI（推荐先试这个） |
npm install -g @deepseek-ai/dsh | 全局安装 CLI 引擎 |
dsh web | 启动 Web UI，默认 http://127.0.0.1:3080 |
dsh web --port 8080 | 改用其他端口（默认 3080；--port 会覆盖配置文件里的值） |
dsh plugin --profile web add <owner/repo> | 安装插件（--profile 为必需参数，owner 不可省） |
dsh plugin --profile web remove <owner/repo> | 卸载插件 |
dsh plugin --profile web list | 查看已安装插件列表 |
dsh plugin --profile <name> add <owner/repo> | 装到其他 profile（把 <name> 换成目标 profile 名；web = 浏览器 UI） |
dsh --version | 查看当前 CLI 版本 |
dsh --help | 查看全部可用命令与参数 |
常见问题
dsh: command not found
全局安装后仍找不到命令，通常是 npm 全局目录不在 PATH 里。 先跑
npm bin -g 查看路径并加入 PATH； 或者直接用 npx @deepseek-ai/dsh web 绕过。Node 版本报错
dsh 要求 Node ≥ 22.19。用 nvm 切版本：
nvm install 22 && nvm use 22。端口 3080 被占用
启动时若提示端口占用，先关掉占用该端口的进程，或换端口启动（见
dsh --help 的端口参数）。