dsh-plugin-ctl：DSH 插件啓停控制

DSH 的核心設計理念是「一切皆插件」。在 Web 界面的「設置 → 插件」中，原生的「插件列表」標籤頁通常僅提供查看功能，無法對插件進行啓停操作。下面介紹一個開源插件，用於在 Web 設置中新增啓停控制標籤頁，從而實現對 Cordis Loader 插件的動態管理。

插件定位¶

• 名稱：dsh-plugin-ctl
• 維護者：LinscStef
• 協議：MIT
• 核心價值：在 DSH Web 界面中新增啓停控制標籤頁，用於啓動或停止任意 Cordis Loader 插件。

核心功能¶

1. 新增控制標籤頁
   在「設置 → 插件」界面中新增「啓停控制」標籤頁，位置排在原生的「插件列表」之後。

2. 列出非 Group Loader 條目
   列出所有非 group 的 Loader 條目。每行顯示模塊名、條目 ID、配置狀態（已啓用 / 已停用）以及 Cordis 狀態（未掛載 / 等待依賴 / 加載中 / 已掛載 / 掛載失敗 / 卸載中）。

3. 一鍵啓停
   支持一鍵啓動或停止插件。對於核心插件（如 dsh-web-app、dsh-base），停止操作需要二次確認，防止誤操作導致功能卸載。

4. 持久化配置
   啓停操作的結果會寫入 Loader 配置。重啓 DSH 後，插件將保持上次的啓停狀態。

5. 交互細節
   支持搜索功能、界面語言跟隨系統語言、操作錯誤時顯示內聯提示。

安裝與啓用¶

使用該插件前，需確保目標機器已安裝 DSH（dsh 命令可用）與 pnpm，且環境中的 @deepseek-ai/cordis 版本不低於 ^4.0.1。

執行安裝命令：

dsh plugin --profile web add git+https://github.com/LinscStef/dsh-plugin-ctl.git

安裝完成後重啓 DSH，打開「設置 → 插件」，即可看到新增的「啓停控制」標籤頁。

典型用法¶

1. 重啓 DSH 進程以加載新插件。
2. 在設置界面切換到「啓停控制」標籤頁。
3. 找到目標插件條目，點擊「啓動」按鈕。
4. 若需停止核心插件，點擊「停止」後需在彈出的對話框中再次確認。

注意事項¶

• 依賴環境：請確保本地已安裝 DSH 和 pnpm。
• 核心插件風險：停用核心插件（如 dsh-web-app、dsh-base）會當場卸載對應功能，請務必謹慎操作，停止核心插件需二次確認。
• 鑑權範圍：/plugin-ctl/api 路由與其他本地插件一樣使用未鑑權路由，僅面向本機 Web 界面，不存在遠程訪問風險。

生態鏈接¶

• GitHub 倉庫：https://github.com/LinscStef/dsh-plugin-ctl
• 社區目錄：https://www.skillhub.cn/plugins/LinscStef/dsh-plugin-ctl