1. 检查前置条件

使用 Node.js 22.13 或更高版本。DSHub 在 8 月 20 日的实测环境为 macOS arm64、Node.js 24.19，以及干净且隔离的 DSH_HOME。

node --version
npm --version

2. 选择滚动版本或固定版本

官方 README 当前推荐下面这条不固定版本的命令。它会跟随 npm 的 latest tag，适合希望使用项目当前支持路径的新用户。

如果需要可复现的排查环境，先固定到经过测试的 release candidate。DSHub 使用 pnpm dlx 验证了 rc.7 package 的 CLI 版本和 Web Profile，因为同一 package 通过本机 npm 解析依赖时没有在测试窗口内完成。这是一次 package 解析观察，不代表官方 npx 命令对所有用户都会失败。

# Official rolling command
npx @deepseek-ai/dsh web

# Reproducible version check used by DSHub
pnpm dlx @deepseek-ai/dsh@0.1.0-rc.7 --version

# Pinned Web Profile used by DSHub
pnpm dlx @deepseek-ai/dsh@0.1.0-rc.7 web

3. 验证首次启动

  • 使用固定命令时，CLI 应输出 0.1.0-rc.7。
  • 终端会显示本地 Web Profile 地址；rc.7 默认使用 3080 端口。
  • 浏览器先显示内部测试提示，然后进入 workspace 界面。
  • 参数以当前 CLI help 为准。实测 rc.7 Web 命令提供 host、port 和 trusted-host 选项，不要依赖旧版本中未记录的参数。
pnpm dlx @deepseek-ai/dsh@0.1.0-rc.7 web --help

4. 建立已知可用的基线

  • 打开一个不包含敏感信息的测试 workspace。
  • 先配置一个 model provider，不添加社区 Bundle。
  • 运行一个只读任务并保留结果。
  • 记录 Harness、Node.js、模型和 Profile 版本。
  • 切换版本前使用 Control-C 正常停止进程。

5. 判断是否需要更新

核对时 GitHub 已列出 0.1.0-rc.8，但 npm latest 仍解析到 rc.7，npm next 解析到 rc.8。正因为这些版本口径可能不同，DSHub 不会直接用最新 upstream tag 替换已经测试过的基线。

更新前先阅读 release notes、确认准备使用的 npm tag，并保留当前可工作的 Profile。如果启动行为变化，回到固定命令，每次只比较一个变量。

继续阅读模型配置指南 →