DSH 安装与使用指南
从环境检查、启动 Web UI 到添加插件，每一步都有检查点与常见问题。
准备 Windows 终端与运行环境
按 Win，搜索 PowerShell 或 Windows Terminal 并打开。
前往 Node.js 官方网站，选择 Windows 安装程序。安装完成后重新打开终端。
node --versionnpm --version检查点
Node.js 官方下载 两条命令都应显示版本号。当前官方源码主分支 package.json 声明 Node.js ≥ 24.9.0。已发布 npm 包或桌面版的要求可能不同，请以对应版本说明为准。
启动 DSH Web UI
下面是官方入口提供的 npx 启动方式。首次运行会下载所需包；确认包名后再继续安装提示。
npx @deepseek-ai/dsh web检查点
以终端实际输出的本地地址为准，用浏览器打开。不要把本机 Web UI 直接暴露到公网。需要停止服务时，在运行它的终端中按 Ctrl + C。
如果环境已有 dsh 命令，可以使用 dsh web。下面的全局安装是可选步骤：
npm install -g @deepseek-ai/dsh添加第一个社区插件
先在插件市场打开详情，核对 README、许可证、宿主版本与安装命令。不同插件、Skill 和桌面程序的安装方式可能不同，不应互换。
dsh plugin add github:owner/repository检查点
去插件市场 将 owner/repository 替换为目标仓库，或直接复制详情页记录的命令。根据该项目 README，在 DSH 中确认是否需要启用或重启。
常用检查与帮助
查看命令帮助
npx @deepseek-ai/dsh --help查看插件命令帮助
npx @deepseek-ai/dsh plugin --help检查 Node.js 版本
node --version检查 npm 版本
npm --version命令参数可能随版本变化。这里提供帮助入口，不虚构卸载、升级或配置参数。
遇到问题时，按现象排查
| 现象 | 先做什么 | 下一步 |
|---|---|---|
| 找不到 node / npm | 安装后关闭并重新打开终端 | 重新检查版本与 PATH |
| Unsupported engine | 读取报错中的 Node 版本要求 | 切换到对应版本，再重试 |
| 包下载失败 | 核对网络与 npm 错误信息 | 保存完整日志，查看官方问题讨论 |
| 浏览器无法打开 | 确认终端服务仍在运行 | 使用终端打印的实际 URL 与端口 |
| 插件启用失败 | 核对宿主版本和依赖 | 按插件仓库的反馈模板报告问题 |
| 安装脚本权限错误 | 先看项目明确要求 | 避免直接用管理员权限重跑未知脚本 |
常见问题
桌面版和 Web UI 怎么选？
希望直接下载应用可先看官方桌面入口；需要细致管理环境或开发插件，可使用命令行路线。社区启动器有不同平台和维护状态，请在比较页核对。
可以把 API Key 填到本站吗？
不需要。本站是目录与文档导航，不接收 DSH 的模型密钥。
所有公开项目都能免费商用吗？
不能这样推断。使用前请查看具体许可证，以及可能独立存在的 EULA 和素材使用条款。
参考与核对来源
本页文档核对日期：2026-10-29。源码分支与已发布包的要求需分别确认。