安装 DSH 与第一个插件
这一页只讲能跑通的最小路径。命令均在 DSH 0.2.1-rc.2 上实测。
1. 装主程序
npm i -g @deepseek-ai/dsh
dsh --version
需要 Node 18 以上。装完 /usr/bin/dsh 或 %APPDATA%\npm\dsh.cmd 就在 PATH 里了。
2. 启动 Web 界面
dsh web
默认监听 127.0.0.1:3080，浏览器打开就能用。注意 dsh 的 CLI 不接受 --host 0.0.0.0，想对外提供服务得改 profile 里的 webserver 配置，或者用 nginx 反代。
这一步很容易踩坑：很多人以为加个
--host就能局域网访问，实际上命令行会直接报错退出。
3. profile 是什么
DSH 把「一套配置 + 一组插件」打包成一个 profile，放在 ~/.dsh/profiles/<名字>/（Windows 是 %USERPROFILE%\.dsh\profiles\）。桌面端用 desktop，网页端用 web，装插件时必须指明改哪个 profile。
dsh plugin --profile web add dsh-cost-meter
这条命令实际上是把参数透传给 profile 目录里的 pnpm，所以 add / remove / why 这些 pnpm 子命令都能用。
4. 插件从哪来
三个入口，按可信度排：
- DSH 内置插件市场：装
dshmarket后，在界面里直接浏览安装，最省事。 - npm 搜索：关键词
dsh或dsh-plugin，按下载量排序。 - 社区目录：
awesome-dsh-plugin及其镜像 feed。
装之前建议先看一眼仓库最近一次提交时间。DSH 内核迭代很快，三个月没更新的插件大概率已经跑不动了。
5. 装完没生效？
改配置和装插件都只在启动时加载。装完插件必须重启 DSH：
# Linux（systemd 托管）
systemctl restart dsh
# Windows 桌面端：退出程序再打开
装完不重启、界面里找不到新功能，是新手最常见的困惑。