前言¶
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，如需通过社区目录查找，请以目录站实际入口为准。
