前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構，第三方能力往往以 npm 包形式安裝並在插件管理或 dshmarket 中啓用。插件一多，逐個查版本、停用、卸載舊包、裝新版本、再按原意圖啓用，既重複又容易漏掉「本來關着的插件被誤開」。維護者 ricardooooooa 的 dsh-plugin-batch-toggle（客戶端類插件）在 Installed、Discover 與 dshmarket 共用頁頭提供 一鍵更新，按順序處理符合條件的 npm 來源 bundle，並在更新前後儘量保留啓用/關閉狀態；失敗項會嘗試回滾並繼續後續包。下文介紹其定位、能力與安裝用法，事實以 GitHub 倉庫 README 爲準。
這是什麼¶
dsh-plugin-batch-toggle 是面向 DSH 桌面客戶端的插件，當前發行版本爲 v0.2.0（MIT 許可證）。它在插件管理和 dshmarket 界面增加批量更新入口，對「可管理、以自身包名從 npm 註冊表安裝的第三方 bundle」依次執行：檢查版本 → 必要時取消使用 → 移除舊包 → 安裝更新 → 恢復原啓用意圖並覈對結果。原先關閉的插件在更新後仍保持關閉。
社區目錄頁：skillhub.cn 插件條目。截至資料記載（2026-10-30），該包未發佈到 npm，也未提交社區目錄收錄 PR；安裝需使用 GitHub Release 預編譯 tarball。
核心功能¶
一鍵順序更新¶
點擊頁頭 一鍵更新 後，每個符合條件的包單獨走完版本檢查與安裝流程。界面展示當前項、階段、進度、失敗數量與逐項結果；單項明確失敗並完成收尾後，會繼續處理後面的項目。
啓用狀態恢復¶
更新前會記錄啓用意圖；安裝完成後按記錄恢復。官方啓用 API 可能把恢復的 bundle 追加到列表末尾，不能保證與原先交錯排列的完整配置順序完全一致；插件也不會強制打開包內原先關閉的 Cordis 插件項。
停止與安全收尾¶
運行中同一按鈕變爲 停止更新。停止請求會等待當前項安全收尾或回滾，不會立刻終止底層安裝進程。
結果與接續恢復¶
批量更新 標籤展示完整結果與恢復狀態；「添加插件」菜單另有入口。詳情頁只顯示該插件自身操作，不重複頁頭按鈕。結果與未完成項保存在當前 profile 的 .dsh-plugin-batch-toggle/，重啓後可接續；若有 v0.1 遺留恢復記錄，會先按記錄接續。
失敗回滾與限制說明¶
安裝或校驗失敗時會盡力重裝原版本並恢復原啓用意圖。回滾並非完全撤銷：第三方腳本、數據變更與運行狀態不保證能還原；回滾失敗的項目會保留恢復責任。卸載本插件前應先處理未完成項。
更新範圍與跳過項¶
自動更新僅適用於可管理、以自身包名從 npm 註冊表安裝的第三方 bundle。下列情況會跳過（原因可在詳情查看）：
- 本插件自身、市場載體、官方/核心組件、只讀與不可管理項
- Git、本地 file/link、tarball/URL 與 npm 別名來源
查詢到的 latest 僅爲參考版本。實際安裝走 DSH 官方插件管理 SDK，受註冊表配置、兼容性檢查、腳本審批和 minimumReleaseAge 等策略約束；剛發佈的版本可能尚不可裝。結果會分別顯示更新前版本、查詢最新版本與實際安裝版本。
本插件不會在一鍵更新流程中更新自己；升級請使用 DSH 的添加/更新插件入口。DSH 要求重啓時只會提示，本插件不自動重啓。
安裝與啓用¶
運行驗收基線爲 DSH 0.2.1-rc.5，package.json 中兼容聲明爲 >=0.2.1-rc.5 <0.2.2-0，需要 Node.js 24+。
- 在 DSH 中打開 插件 → 添加插件。
- 粘貼下面 v0.2.0 預編譯安裝包鏈接，或先下載後填寫文件的絕對路徑。
- 安裝並啓用本插件；若 DSH 提示需要重啓，按提示重啓。
預編譯包無需 TypeScript 或其他構建工具。若使用桌面 profile 的命令行安裝，應先完全退出桌面端，並使用與 rc.5 安裝附帶的同一 CLI。
https://github.com/ricardooooooa/dsh-plugin-batch-toggle/releases/download/v0.2.0/dsh-plugin-batch-toggle-0.2.0.tgz
典型用法¶
安裝並啓用後，在以下任一位置使用頁頭 一鍵更新（頁頭入口依賴 DOM 標記；宿主頁面結構變化時，可改用原生 批量更新 標籤或菜單）：
- 插件管理中的 Installed、Discover 標籤
- dshmarket 市場標籤（與市場自帶更新按鈕分開顯示）
- dshmarket 獨立設置/側欄面板
操作步驟：
- 打開插件管理或 dshmarket，確認列表中有待更新的 npm 來源第三方插件。
- 點擊 一鍵更新，觀察當前項、階段與進度。
- 完成後在 批量更新 標籤查看逐項結果與恢復狀態；若有失敗項，按詳情處理未完成恢復後再卸載本插件。
需要中途放棄時，點擊 停止更新，等待當前項收尾後再查看結果頁。
適用場景與注意¶
適合誰： 在 DSH 0.2.1-rc.5 上維護較多 npm 來源第三方插件、希望一次性對齊 registry 最新可用版本，並儘量保持「關着的繼續關着」的開發者。
權限與安全： 本插件在 DSH 進程內運行，使用 DSH 現有 Owner 認證與同源校驗，不額外監聽端口，不需要模型密鑰；不上傳會話，查詢與安裝會訪問你配置的 npm 註冊表。安裝前請閱讀 源碼與 LICENSE，確認接受第三方包安裝腳本帶來的風險。
生態說明： dshmarket 等爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係；本 tarball 發行版不進入要求 npm 元數據的官方 Discover 索引，文中的 Discover 入口指安裝後在客戶端界面看到的按鈕。
結尾¶
dsh-plugin-batch-toggle 把 DSH 裏重複的 npm 插件更新收成一次順序任務，並在失敗時儘量回滾、繼續後續項，同時持久化恢復狀態。更多細節、截圖與驗證記錄見 GitHub README；安裝使用上述 Release tarball。
- 目錄頁：https://www.skillhub.cn/plugins/ricardooooooa/dsh-plugin-batch-toggle
- GitHub：https://github.com/ricardooooooa/dsh-plugin-batch-toggle
