前言¶
在 DSH web-mode 的使用场景中，确认当前 DSH 的运行版本是常见的需求。开发者通常需要打开终端或查看日志来获取版本信息，操作路径较长。dsh-version-plugin 插件将版本信息直接集成到设置界面，提供了直观的版本查看与更新入口。
核心功能¶
该插件主要提供以下能力：
1. 读取主机端已安装的 @deepseek-ai/dsh 的 package.json，获取当前版本。
2. 在设置对话框的「通用设置」底部新增一行「DSH Version」。
3. 提供一键查询 npm 仓库最新版本的功能。
4. 提供一键全局更新按钮，执行 npm install -g @deepseek-ai/dsh@latest 并在 UI 中展示命令输出。
安装与启用¶
使用官方推荐的 npm 安装命令即可完成添加。
dsh plugin --profile web add dsh-version-plugin
安装完成后，启动 web-mode 并打开设置对话框即可使用。
典型用法¶
- 启动 DSH web-mode：
dsh --profile web web
- 打开设置对话框，进入「通用设置」。
- 在列表底部找到「DSH Version」行。
- 点击「Check for updates」查看最新版本，或点击「Update to latest」执行全局更新。
注意事项¶
- 更新范围：点击「Update to latest」仅会更新全局安装的
@deepseek-ai/dsh，不会更新本地 pnpm workspace 的源代码。 - pnpm 版本限制：如果使用 pnpm >= 10 从 GitHub 源码安装，默认会阻止构建脚本执行。需要在
pnpm-workspace.yaml中配置allowBuilds后重新安装。 - 生效时机：更新后如果版本未显示变化，需要重启 web 进程并刷新页面。
总结¶
dsh-version-plugin 通过在设置界面增加一行状态展示，解决了查看版本和触发全局更新的痛点。适合需要频繁确认 DSH 版本或通过 CLI 管理全局安装的开发者。
- 项目目录：https://www.skillhub.cn/plugins/hotpot-labs/dsh-version-plugin
- 源码地址：https://github.com/hotpot-labs/dsh-version-plugin
