前言¶
用 DeepSeek Harness（DSH）做智能體開發時，同一個機器上往往同時存在多種「dsh」來源：全局 npm install -g、npx 緩存裏的多版本並存、以及官方桌面客戶端。升級 npx 副本不會立刻換掉當前進程，重啓又要自己拼命令；桌面裝包和 CLI 裝包也不在同一個界面裏。下面介紹的 dsh-version-manager（維護者 ccsdyc）是一個 DSH 客戶端插件（Harness bundle），在左側導航增加「版本管理 / Versions」面板，把 npm、npx、desktop 三類安裝放在分段切換器裏統一查看和操作。
這是什麼¶
dsh-version-manager 在 npm 上發佈爲 dsh-version-manager（當前資料中的包版本爲 1.0.0，許可證 MIT）。它通過 cordis.patch.yml 注入客戶端 UI，並在 Host 側註冊一組 /dsh-versions/* API，用於列舉本機安裝、拉取 registry 最新 rc/alpha、執行升級與刪除、下載官方桌面安裝包、寫桌面快捷方式，以及在 CLI 場景下安全重啓 DSH。
分類上屬於 客戶端 插件：package.json 中 dsh.client.platform 爲 web，並依賴 @deepseek-ai/dsh-client-ui-sidebar 等佈局能力。社區目錄頁見 SkillHub；源碼與完整說明見 GitHub。
核心功能¶
三區域版本面板¶
面板默認按「當前進程來源」優先排序，其餘區域爲 npm、npx、desktop。切換器下有一條狀態行：區分正在運行的版本與磁盤上已安裝的最新版本（例如 npx 並列安裝時出現 running 0.2.2-alpha.2 · newest installed 0.2.2-alpha.3）。
- npm：全局安裝的
@deepseek-ai/dsh，可升級，不可刪除。 - npx：緩存中的多版本列表；最新 rc 與 alpha 各一行，其餘已裝版本可升級或刪除；
running角標跟當前進程的_npx/<hash>。 - desktop：讀取本機已裝桌面版（Windows 卸載註冊表、macOS
DeepSeek*.app的CFBundleShortVersionString），並與download.deepseek.com固定安裝 URL 上解析出的發佈版本對比；可觸發兩步式下載與啓動安裝程序。
有未確認的更新時，側欄入口與對應分段會出現 new 標記；點開分段即視爲確認該區域的發佈版本，狀態寫入 localStorage 鍵 dsh-version-manager:dismissed。
升級、刪除與重啓¶
升級路徑與 README 一致：
- 全局 npm：
npm install --global @deepseek-ai/dsh@<version> - npx：
npx --yes @deepseek-ai/dsh@<version> --version（只填充緩存，不刪舊副本）
若升級的是當前進程所在安裝，面板會要求確認並在完成後自動重啓；僅升級另一區域則只安裝副本。工具欄 Restart DSH 僅對 CLI 啓動（npm/npx）且 launcher 提供 ctx.appExit 時可用，桌面客戶端不走此路徑。重啓日誌默認落在 $DSH_HOME/logs/dsh-version-manager-restart.log（macOS、Windows 另有回退路徑）。
刪除規則：不能刪「當前運行來源」和「各渠道最新已裝」；npm 區域不提供刪除。npx 刪除會清理對應 _npx 目錄及匹配的 npm cache 索引項。
桌面客戶端一鍵裝包¶
官方安裝包 URL 固定、文件名不含版本號：
https://download.deepseek.com/desktop/dsh-latest-windows-x64.exe
https://download.deepseek.com/desktop/dsh-latest-macos-arm64.dmg
https://download.deepseek.com/desktop/dsh-latest-macos-x64.dmg
流程分兩步：先用 Host 原生目錄選擇器選保存位置，再下載並拉起安裝程序（macOS 用 open 掛載 DMG）。僅接受上述域名與 URL；下載失敗會刪除殘缺文件。
桌面快捷方式¶
工具欄 桌面快捷方式 / Desktop shortcut 按本次會話的啓動方式寫啓動器，而不是簡單指向「已安裝的桌面 exe」。Windows 生成 DeepSeek Harness.lnk；macOS CLI 爲 DeepSeek Harness.command，桌面客戶端爲指向 bundle 的 DeepSeek Harness.app 符號鏈接。CLI 快捷方式會保留當前的 profile 與啓動參數（含 web / --profile 等，去掉 --no-open）。
Windows 默認圖標來自插件自帶的 assets/tray.ico；可通過環境變量 DSH_VERSION_MANAGER_ICON 覆蓋。圖標會先複製到 %LOCALAPPDATA%\dsh-version-manager\shortcut.ico 再寫入 .lnk，以避免工作區低完整性標籤導致 Explorer 不刷新圖標。
語言與界面¶
面板語言默認由 IANA 時區推斷：大陸常用時區（如 Asia/Shanghai）顯示中文，其餘（含港澳時區）顯示英文，不跟隨應用 locale。頁腳 English / 中文 按鈕優先級更高，選擇保存在 localStorage。
安裝與啓用¶
插件以 npm 包形式發佈。README 給出的標準裝法如下（web profile）：
dsh plugin --profile web add dsh-version-manager
若 CLI 只添加了依賴，還需在插件管理器中啓用 bundle，再重啓 DSH。Host 端在啓動時加載，package.json 要求 Node >= 24.9.0。
離線或無法直接訪問 registry 時，可將倉庫中的 dsh-version-manager 文件夾打成 zip（根目錄爲文件夾本身），在目標機上：
- 解壓到任意路徑，例如
D:\dsh\dsh-version-manager。 - 完全退出 DSH。
- Windows 雙擊
install.cmd；macOS/Linux 執行sh install.sh。 - 重啓 DSH 並刷新頁面。
安裝腳本會定位 %DSH_HOME%（或 ~/.dsh）與 web profile，嘗試 dsh plugin --profile web add link:<路徑> 並寫入本地 link；可用 --profile、--dsh、--dry-run、--no-cli 等選項。安裝前會把 profile 的 package.json 備份爲 package.json.dshvm-backup。
自託管插件市場索引可參考 README：用 node tools/make-market-index.mjs 生成 index.json 後掛到 HTTPS 靜態站點，再在 DSH 的 plugin-market 設置裏添加該 URL（格式 1 支持 npm/Git 源，不支持 zip 作爲市場源）。
典型用法¶
日常操作主要在 DSH Web 客戶端左側 版本管理 / Versions 入口完成，無需記憶零散 shell 命令。
- 打開面板，在分段切換器中查看 npm / npx / desktop 的安裝與運行狀態；有紅點或側欄
new時先做 re-check 或點開對應分段確認更新。 - 在 npx 或 npm 區域對目標 semver 執行升級；若提示需重啓，使用狀態行中的 Restart on 指定版本動作或工具欄 Restart DSH。
- 需要固定啓動方式時，點擊 桌面快捷方式，在桌面得到與當前會話一致的啓動器（npx 會話不會誤寫成桌面 exe 快捷方式）。
- 桌面版落後時，切換到 desktop 分段，選目錄後完成官方安裝包下載與安裝。
Host 側路由包括 /dsh-versions/list、/upgrade、/restart、/delete、/desktop/install、/shortcut 等，Client 通過同源 fetch 調用；具體行爲以 README「Transport」一節爲準。
適用場景與注意¶
適合誰：經常在同一臺開發機上切換 DSH 的 rc/alpha 通道、用 npx 試新版本又不想手工清緩存，或希望從 Web UI 拉官方桌面安裝包並與本機已裝版本對比的開發者。
權限與安全：插件與當前 DSH 進程使用相同權限執行升級、刪緩存、寫桌面快捷方式、下載安裝包等操作。安裝前應閱讀 源碼倉庫 與 MIT 許可證，確認路由與 shell 調用符合你的環境策略。修改 index.js 後必須重啓 DSH 才能生效新 Host 邏輯；僅刷新頁面只重載瀏覽器端。
環境依賴：面板會驅動本機 npm/npx；Windows 快捷方式優先 PowerShell；macOS 讀取 plist 依賴 plutil/open。registry 與桌面安裝功能需要網絡。Intel macOS 的 x64 DMG 若未返回 Content-Disposition，界面會顯示 latest version unavailable 且不設更新點——README 說明這是當前製品行爲，將來頭信息補齊後會自動生效。
生態說明：DSH 採用「一切皆插件」的擴展方式；SkillHub 等社區目錄由第三方維護，與 DeepSeek / 幻方無官方從屬關係，本文不以「官方應用商店」描述安裝來源。
結尾¶
經過上面的步驟，可以把本機多種 DSH 安裝源收攏到一塊麪板：看得見「正在跑誰、磁盤上最新是誰」，按需升級、刪 npx 副本、拉桌面包，並在 CLI 場景下一鍵重啓。需要安裝名與時區語言細節時，以倉庫 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/ccsdyc/dsh-version-manager
- GitHub：https://github.com/ccsdyc/dsh-version-manager
