前言¶

DSH 生態把能力以插件 bundle 的形式擴展。一個 profile 裏可能已經安裝多個插件包，安裝、更新、卸載、檢查新版本時，如果只能在命令行、倉庫頁和市場搜索之間來回切換，操作會比較分散。

dsh-plugin-manager 是一個可獨立發佈的 DSH bundle。它在 Settings → Plugins 中提供一個帶分類的插件管理器，用於管理 Desktop 和 native Web profile 中的已安裝插件包。

基礎信息¶

• 倉庫：TAOxxx7/dsh-plugin-manager
• 維護者：TAOxxx7
• 許可證：MIT
• 定位：DSH Settings plugin manager bundle for Desktop and native Web profiles

下面是 package.json 中與安裝、運行相關的關鍵字段：

{
  "name": "dsh-plugin-manager-community",
  "version": "0.1.3",
  "engines": {
    "node": ">=20"
  },
  "license": "MIT"
}

安裝命令中使用的是 npm 包名 dsh-plugin-manager-community。如果發佈者重命名包名，需要替換安裝命令中的包名。

核心功能¶

dsh-plugin-manager 提供的能力如下：

• 在 Settings → Plugins 提供帶分類的插件管理器。
• 爲已安裝 profile 包提供分類。
• 支持 GitHub dsh-plugin 市場搜索。
• 重複安裝檢測。
• 市場倉庫發佈 DSH bundle 時優先 npm 安裝。
• 未發佈倉庫走 GitHub fallback。
• 支持卸載、單包更新、更新檢查和啓動檢查。
• 對源碼安裝插件進行 GitHub Release 檢查，支持 semver tags，未固定源使用 commit-head fallback。
• 顯式 pnpm build 審批/重試並捕獲診斷。
• Desktop 和 native Web 安裝完成後的重啓提示。
• 在 DSH Desktop 與 npx @deepseek-ai/dsh web 中保持相同 active-profile 行爲。

安裝與啓用¶

先確認當前 DSH 運行環境滿足 Node 引擎要求：>=20。

爲 Desktop profile 安裝最新版社區插件包：

dsh plugin --profile desktop add dsh-plugin-manager-community@latest

爲 native Web profile 安裝插件包並啓動 Web：

npx -y @deepseek-ai/dsh plugin --profile web add dsh-plugin-manager-community@latest
npx -y @deepseek-ai/dsh web

安裝更新包版本後，需要重啓當前 DSH 進程以加載新 bundle 層。市場安裝成功後，Settings tab 會詢問是否重啓。

典型用法¶

查看已安裝包¶

安裝完成後，進入 Settings → Plugins。這裏會展示已安裝 profile 包，並給出分類。

搜索並安裝市場插件¶

通過 GitHub dsh-plugin 市場搜索候選插件倉庫。

• 如果市場倉庫已發佈 DSH bundle，優先走 npm 安裝。
• 如果倉庫未發佈，走 GitHub fallback。
• 安裝前會進行重複安裝檢測。

更新與卸載¶

插件管理器支持：

• 卸載。
• 單包更新。
• 更新檢查。
• 啓動檢查。

對於源碼安裝的插件，會進行 GitHub Release 檢查：

• 支持 semver tags。
• 未固定源使用 commit-head fallback。

pnpm build 審批與重試¶

當插件流程需要執行 pnpm build 時，dsh-plugin-manager 會要求顯式審批/重試，並捕獲診斷信息。

Native Web 重啓行爲¶

Native Web 的重啓會替換運行中的 Node 進程。根據瀏覽器請求時機，觸發重啓的那個 HTTP 請求可能顯示 Failed to fetch。當前客戶端會識別這種 Web-only 斷開爲預期重啓，並顯示 reconnecting 狀態。

Windows native Web 的 pnpm 解析順序¶

在 Windows native Web 中，pnpm 的解析順序爲：

1. DSH_PNPM_BIN
2. active profile/shared DSH pnpm package
3. PNPM_HOME / npm global directories
4. PATH
5. Node.js Corepack

如果上述位置都不可用，需要安裝 Node.js/Corepack，或者將 DSH_PNPM_BIN 設置爲完整 pnpm.cmd 路徑，然後重啓 Web 進程。

適用場景與注意¶

適合在 DSH Desktop 或 native Web 中管理 profile 插件包的人。這個插件把分類、市場搜索、安裝、更新、卸載、重啓提示集中在 Settings → Plugins 中。

使用前注意：

• 它會以當前 dsh 進程權限運行。安裝前應檢查源碼、許可證和包名。
• dsh.client.platform 爲 web，描述瀏覽器界面，不是 GitHub-only 安裝模式。
• lib/ 是從驗證過的 Harness build 複製的 release artifact。
• src/ 供審查和未來維護。
• 許可證爲 MIT。
• 要求 Node >=20。

結尾¶

dsh-plugin-manager 的價值是把 DSH 插件的查看、搜索、安裝、更新、卸載和重啓提示放進 Settings 面板，減少 Desktop 和 native Web 之間重複操作。

GitHub：https://github.com/TAOxxx7/dsh-plugin-manager

目錄頁：已覈實資料中未出現目錄頁 URL，本文不補全。