dsh-plugins-folders — DSH 插件栏分组管理

给 DeepSeek Harness 的「插件」页加一层文件夹：把装了一堆的插件按用途收进分组，按组开关，一键搜索、拖动排序，卸载了还能从记录里重新装回来。

装了几十个插件之后，插件列表就变成一条越来越长的传送带。这个插件不改变任何插件的实际行为，只在插件页上多一层你自己定义的收纳结构——像给抽屉装隔板。

核心功能

1. 文件夹分组：新建 / 重命名 / 删除文件夹，把任意已装插件移进分组；未分组的自动落在「未分类」里，随时可再挪。
2. 单条开关 + 整组开关：每行自带开关，直接调用 remote.pluginManager.setBundleEnabled，改的是真实插件状态；分组开关一次拨动整组。被上级配置接管（只读）的插件会明确标出，不会假装能改。
3. 批量操作：多选后一次性「移动到…」另一组，或批量启停；每次改动都能撤销，切错了按一下就回去。
4. 搜索：按插件名称或简介实时过滤，跨分组命中，不用一层层展开找。
5. 长按拖动排序：按住约 320ms 进入拖动，把插件或整个分组拖到你想要的位置；顺序与分组一起存本地，重开浏览器还在。
6. 右键卸载 + 卸载记录：右键任意插件即弹出「卸载插件」，确认后真卸载（不会误删分组插件自己）。卸掉的插件自动记入「已卸载」，按卸载前的安装地址一键重装，也可以移除这条记录。
7. 跟随界面语言：中文 / English 两套文案随宿主语言切换。

安装

从插件市场

市场索引收录后，在 插件 → 发现 里搜索「插件分组 / Plugin folders」一键安装，或直接执行：

dsh plugin --profile web add github:awaYFawa/dsh-plugins-folders

从源码

git clone https://github.com/awaYFawa/dsh-plugins-folders.git
cd dsh-plugins-folders
dsh plugin --profile web add .

装完重启 dsh web 生效。插件是纯 ESM、零运行时依赖，不需要构建、不需要 npm install。

卸载

dsh plugin --profile web rm @dsh-user/dsh-plugins-folders

分组数据存在浏览器 localStorage 里，卸载插件不会自动清掉；想清干净就在浏览器控制台删掉下面两节列出的两个键。

使用说明

打开插件页，右下角（shell.overlay，order 20）会出现「插件分组」浮标，点开就是分组面板：

想做的事	怎么做
建分组	顶部「新建文件夹」，输入名字后「创建」
把插件放进分组	行内的「所在分组」下拉，或选中多条后「移动到…」
改分组名 / 删分组	分组标题右侧的铅笔 / 垃圾桶；删除只删分组，插件本身不动
开关插件	行尾开关；分组标题右侧的整组开关
调整顺序	长按约 320ms 后拖动，插件和分组都能拖
卸载	右键该行 →「卸载插件」→ 确认
重装回来	展开「已卸载」→「重新安装」（按卸载前的安装地址装）
找插件	顶部搜索框，按名称或简介过滤

关于开关的诚实说明

• 分组只影响这一页的展示，不改变插件之间的加载顺序或依赖关系。
• 有的插件由上层配置统一接管，页面改不了它的开关，行上会显示为只读并给出原因——这是如实反映，不是面板失灵。
• 改动即时写入真实插件状态；若某插件需要重启 Harness 才生效，面板会提示「改动已保存，需要重启 Harness 才生效」。

数据与隐私

全部数据只存在你本机浏览器的 localStorage，不外传、不联网、不写宿主配置目录：

键	内容
dsh.plugins-folders.v1	分组结构（名称、顺序、成员、折叠状态）
dsh.plugins-folders.uninstalled.v1	卸载记录（最多 60 条：插件名、标题、安装地址、时间）

卸载记录里含插件原本的安装地址（例如 github:owner/repo 或包名），只为「重新安装」用；介意的话可以随时在面板里移除记录。

目录结构

dsh-plugins-folders/
├── package.json          # dsh.bundle manifest + client 入口声明
├── cordis.patch.yml      # 插入 plugins-folders 这个 bundle
├── index.js              # Host 端：把插件清单注入前端
├── client.js             # 前端：分组面板全部逻辑与样式
├── locale/
│   ├── zh.json
│   └── en.json
├── icon.svg              # 插件图标（矢量）
└── assets/
    └── icon-180.png      # 市场卡片用的位图图标

兼容与要求

• DeepSeek Harness，Web 端（platform: web）；shell.overlay 插槽存在即可用。
• 依赖宿主提供的 slots、locale、remote.pluginManager 服务，不额外安装任何 npm 包。
• 需要 DSH 具备插件开关能力（remote.pluginManager.setBundleEnabled）；没有时面板会给出明确报错，而不是静默失败。

常见问题

装完在插件页找不到入口？ 确认已经重启 dsh web；再看浏览器控制台有没有 dsh-plugins-folders 开头的警告（插槽未就绪时它只警告、不打断页面）。

分组丢了？ 分组存在当前浏览器的 localStorage 里，换浏览器 / 换 profile / 清了站点数据都会看不到旧分组。插件本身不动，重新分组即可。

卸载别的插件会不会把它一起弄没？ 面板里明确禁止卸载分组插件自己（会提示「不能卸载分组插件自己」）。

开关点了没反应？ 该插件可能由上级配置接管（只读），或者正处于上一次操作的处理中（显示「处理中…」）。

许可

MIT