前言¶
DSH 框架採用「一切皆插件」的理念。在迭代框架版本或管理插件時，升級失敗或版本不兼容往往導致服務中斷，且現有的管理方式缺乏對供應鏈和兼容性的嚴格校驗。DSH Plugin Gating Hub（原名 dsh-plugin-hub）旨在解決這些問題，提供框架升級的安全保障和插件版本門控機制。
插件簡介¶
這是一個爲 DSH 框架設計的升級安全與插件版本管理插件。它由 Noob-stupid 維護，採用 MIT 協議。插件核心價值在於：實現升級失敗自動回滾、內置多源插件市場以及對供應鏈變更的嚴格檢測。
核心功能¶
框架升級安全¶
插件提供一鍵升級能力，包含配置備份和全樹回滾點。升級過程中若發生失敗，系統會自動回滾整棵樹；同時內置 15 分鐘硬超時檢測，防止進程卡死。
環境指紋檢測¶
針對官方桌面更新器或手動 pnpm 造成的框架變更，插件通過環境指紋檢測識別差異。只有具備硬證據（如包解析失敗、file:// 目標丟失、啓動失敗日誌中提及）時，纔會強制禁用插件行；核心插件行不會被誤禁。
插件升級門控¶
支持版本與聲明門控（如 dsh.engines.framework、@deepseek-ai/* 範圍），內置零依賴的 semver 引擎。安裝腳本不會自動授權，且 pnpm 的供應鏈門控不會被繞過，確保升級不會靜默引入不兼容組件。
合約預檢與回滾點¶
在安裝前執行數據驅動的合約預檢（消息合約、依賴 API、配置 Schema 等），並生成全樹回滾點，爲異常恢復提供基礎。
多源插件市場¶
內置發現層，支持 500+ 插件和 300+ 技能。支持自定義源，包括私有內網註冊表、自定義搜索源、自託管索引源以及本地 Git 倉庫，可實現純內網或離線環境下的插件瀏覽與安裝。
安裝與啓用¶
使用官方提供的安裝命令添加插件：
dsh plugin --profile web add @noob-stupid/dsh-plugin-console
安裝完成後，重啓 dsh 服務，刷新頁面，進入 設置 -> 插件 -> 插件控制台。
典型用法¶
在插件控制台中，可以執行插件安裝、升級和適配操作。當升級失敗時，點擊「回滾到上版」按鈕，系統會停止服務並恢復全樹，確保環境快速回到穩定狀態。
適用場景與注意¶
該插件適合需要嚴格管控框架升級風險和管理內部插件生態的管理員使用。插件以當前 dsh 進程權限運行，安裝前建議檢查源碼與許可證。需要注意的是，這是一個非官方社區項目，Web 和 Desktop 均支持，且安裝腳本不具備自動授權能力。
結尾¶
DSH Plugin Gating Hub 通過自動回滾和環境指紋檢測，降低了 DSH 框架升級的試錯成本。更多細節與源碼可參考項目主頁。
