前言¶
在 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