前言¶
DSH 採用“一切皆插件”的方式擴展能力。當插件來源分散後，設置裏的插件列表容易出現自帶插件與第三方插件混排的問題：查找不直觀，導入、開關、刪除也缺少統一入口。
dsh-plugin-optimization 由 AJUbest 維護，定位是 DSH 插件管理器。它把設置中的插件列表分成“自帶插件 / 自定義插件”兩個分區，並將自定義插件統一存放在獨立目錄，再提供瀏覽文件夾、導入、註冊、開啓/關閉、刪除、自動收納與依賴/衝突檢查等操作。
這是什麼¶
dsh-plugin-optimization 是一個 MIT 許可證的 DSH 插件管理組件。它解決的核心問題是：在 DSH 中維護多個插件時，將官方自帶插件和自定義插件分區展示，並把自定義插件收斂到固定目錄 ~/.dsh/custom-plugins/。
核心功能¶
- 把插件列表分成自帶插件 / 自定義插件兩個分區。
- 自定義插件統一存放在
~/.dsh/custom-plugins/。 - 自帶插件（
@deepseek-ai/*）只讀瀏覽。 - 瀏覽文件夾：打開自定義分區 / 自帶分區目錄。
- 導入 git 地址 / 本地文件夾路徑 / npm 包名，並自動落入自定義分區並註冊。
- 註冊 / 開啓 / 關閉 / 刪除自定義插件。
- 自動把歷史遺留的已註冊插件收納進自定義分區。
- 依賴與衝突性檢查：檢查缺失依賴和插件衝突並提醒。
安裝與啓用¶
先確認本機已有 Node.js 與 pnpm，因爲 dsh plugin 命令依賴它們。沒有 pnpm 時，可執行：
npm install -g pnpm
也可以使用：
corepack enable pnpm
然後執行安裝命令，把插件添加到 web profile：
dsh plugin --profile web add https://github.com/AJUbest/dsh-plugin-optimization.git
安裝完成後，重啓網關：
dsh-restart
或者重啓啓動器。隨後刷新頁面，進入：
設置 → 插件管理
剛安裝後建議重啓兩次：第一次讓本插件生效並自動收納歷史插件，第二次讓收納結果完全加載。
典型用法¶
瀏覽文件夾¶
打開自定義分區或自帶分區目錄，可直接查看、添加、刪除插件文件。
導入插件¶
輸入 git 地址、本地路徑或 npm 包名，插件會自動複製到自定義分區並註冊，重啓後生效。
註冊插件¶
如果已經手動把插件放進自定義分區目錄，點「註冊」加載它，重啓後生效。
開啓 / 關閉插件¶
開啓或關閉會寫入 profile 的 cordis.patch.yml 禁用條目，重啓後生效。
刪除插件¶
刪除會取消註冊並刪除插件目錄。
收納歷史插件¶
點擊「收納到分區」，把歷史遺留的已註冊插件移入自定義分區。
依賴與衝突檢查¶
通過依賴與衝突性檢查，檢查是否存在缺失依賴，並檢查是否有插件衝突並給出提醒。
卸載¶
如需移除該管理器本身，執行：
dsh plugin --profile web remove dsh-plugin-optimization
適用場景與注意¶
適合在 DSH 中管理多個插件、希望把第三方插件和自帶插件分開維護的使用者。
插件會隨當前 dsh 進程加載，安裝前建議先查看源碼與許可證；該項目許可證爲 MIT。
使用上注意兩點：
- 僅允許本機 / 同主機來源調用。
- 所有路徑做包含校驗，防目錄穿越。
結尾¶
dsh-plugin-optimization 的價值在於把 DSH 插件管理從“安裝列表”變成可分區的日常維護流程：查看、導入、註冊、開關、刪除、收納和依賴/衝突提醒都能在一個入口完成。
GitHub 地址：
https://github.com/AJUbest/dsh-plugin-optimization
本次已覈實資料未提供可確認的目錄頁 URL，如需通過社區目錄查找，請以目錄站實際入口爲準。
