插件目录分类 LUTAO581314/dsh-plugin-catalog

dsh-plugin-catalog

在 DSH 的 插件 → 已安装 页里，把已安装插件、内置插件配置和实验性插件合成一份可搜索、按分类分组的列表。

- 搜索：按插件标题、包名、描述、作者、市场关键词和分类名过滤；空格分隔的多个词必须全部命中。
- 按分类分组：
- 社区插件按下载时插件市场的分类分组。每个插件在第一次被看到时记下它当时的分类；同一版本不会被后来的市场改分类覆盖，升级到新版本才按新下载重新记录。可以手动「重新同步分类」。
- DSH 自带的 plugins.item 配置项（子智能体、网页搜索、Agent 循环、终端等）归入内置。
- DSH 随附的 official bundle（包括平常收在「更多」里的实验性组合包）归入实验性。
- 市场索引里没有的第三方插件归入未分类。
- 每行右侧保留启用/停用开关（内置配置项没有开关，点开就是配置页）；点行主体打开该插件/配置项的详情页。
- 图标：内置配置项用官方原语图标（终端 / Agent 循环 / 子智能体 / 网页搜索），其余插件优先用包自带的 meta.icon，没有或读不到时用官方默认插件图，不再用标题首字占位。
- 宽度与插件页其它区块一致（max-width: 960px），并与页面一样居中。

安装

从 npm 安装（发布后可用）：

dsh plugin add @lutao581314/dsh-plugin-catalog

或直接从 GitHub 安装（无构建步骤）：

dsh plugin add github:LUTAO581314/dsh-plugin-catalog

本地开发时把本仓库链接进 desktop profile：

dsh plugin --profile desktop add link:<本仓库的本地路径>

等 HMR 重新组合（或完全退出并重开 DSH 一次）。打开侧栏 插件 → 已安装 即可看到搜索框和分类分组。

卸载：

dsh plugin remove @lutao581314/dsh-plugin-catalog

它是怎么嵌进「已安装」页的

插件页把 plugins.overview 声明成一个 root 级 list slot，位置就在「已安装」主列表的上方。本插件向它注册一个条目，并在数据就绪后隐藏页面自带的三个分组，避免出现两份列表：

| 页面自带分组 | 隐藏条件 | 本插件里的替代分组 |
| data-plugin-group="bundles" | body[data-dsh-catalog-ready="1"] | 市场分类 / 未分类 |
| data-plugin-group="basic" | body[data-dsh-catalog-builtins="1"] | 内置 |
| data-plugin-group="extensions" | body[data-dsh-catalog-experimental="1"] | 实验性 |

这些 data-* 标记只在对应数据源真的拿到内容时才设置：例如 plugins.item 还没注册完时不会隐藏「内置插件配置」，official bundle 读取失败时也不会隐藏「实验性插件」。插件被停用或加载失败时，样式表随之移除，页面恢复成官方列表。

数据与接口

快照存在 $DSH_HOME/dsh-plugin-catalog/state.json（默认 C:\Users\<你>\.dsh\dsh-plugin-catalog\state.json），只在第一次写入时创建。宿主半身提供三个路由：

| 路由 | 作用 |
| GET /dsh-plugin-catalog/state | 当前快照 |
| POST /dsh-plugin-catalog/capture | 记录一批分类（JSON body） |
| GET /dsh-plugin-catalog/status | 目录、条目数、更新时间 |

capture 的语义：

- mode: "capture"（默认）：首次记录为准。同版本的插件不会被覆盖；记录里的 version 和已记录版本不同时，视为一次新的下载并更新；之前「未收录」的插件后来出现在市场里，也会补上分类。
- mode: "resync"：按提交值整体覆盖（界面上的「重新同步分类」）。

快照条目：

{
"version": 1,
"updatedAt": 1792600000000,
"categories": { "usage": { "zh": "用量与计费", "en": "Usage & Billing" } },
"categoryOrder": ["agi", "ui", "usage"],
"packages": {
"dsh-cost-meter": {
"name": "dsh-cost-meter",
"listed": true,
"categoryId": "usage",
"category": { "zh": "用量与计费", "en": "Usage & Billing" },
"indexUrl": "https://cdn.jsdelivr.net/gh/realguan/dsh-plugin-market@dist/dsh-index.json",
"marketTitle": { "zh": "DSH 插件市场", "en": "DSH Plugin Market" },
"author": "…",
"keywords": ["cost", "usage"],
"version": "1.9.15",
"source": "download",
"capturedAt": 1792600000000
}
}
}

source 取值：download（首次看到）、backfill（本功能上线时对已有插件的回填）、update（版本变化）、resync（手动同步）。

为什么分类要找宿主问

浏览器半身通过 ctx.remote.pluginMarket.search(indexUrl, { text: 包名, sort: { kind: "relevance" } }) 一次查一个已安装插件，从返回的 metadata.category 与 metadata.categories 里取分类 id / 标题。
索引只由宿主拉取一次（宿主有 10 分钟缓存），所以本插件不会自己下载 7 MB 的索引；插件市场不可用时，分类沿用上一次记录。

测试

node test-host.mjs # 快照合并、路由、原子写、损坏文件
node test-client.mjs # 分组/搜索、市场抓取、卡片/开关与 overview 注册

两个测试都是零依赖的，不需要启动 DSH。

兼容性

DSH 0.2.1-rc.2（在 desktop 配置档上验证）。package.json 同时声明了 engines.dsh 与 dsh.compatibility.dshReleases，便于市场判断版本。

License

MIT