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