插件目录管理 fengs2021/dsh-plugin-catalog

dsh-plugin-catalog

DSH Web GUI 插件目录：设置 → 插件目录。已装插件自动分类、搜索、逐插件备注（host 端持久化，跨设备共享）。

Features

- Auto-grouped catalog: DSH 官方核心 / UI 全家桶 / 社区扩展 / OMDSH 生态 / GitHub 安装 / 本地自装 / 其他 — collapsible groups, sorted by name
- Per-plugin info: package name, version, group badge, description (falls back to the dsh main package for built-in bundles), source (local / GitHub / built-in)
- Search: realtime filter over name + description
- Notes (annotations): one note per plugin, saved host-side to $DSH_HOME/plugin-catalog/notes.json — same notes on your phone and desktop
- Refresh: reloads the list at any time
- Version check (v0.2.0): every open auto-checks the latest version per source — npm (dist-tags max), github (locked commit vs remote HEAD), link (local vs remote HEAD), builtin (skipped, DSH-managed). Updated packages show a badge + one-click update for npm packages (backup → pnpm update --depth 1 → rollback on failure). link/github packages are read-only hints (see Notes)

How it works

- Host half (lib/index.js): two read-only-ish HTTP APIs
- GET /plugin-catalog/api/list — reads the profile package.json (bundles + dependencies) and each package's metadata, returns { entries, notes }
- GET/PUT /plugin-catalog/api/notes — note read/write (the only write: your notes file under $DSH_HOME/plugin-catalog/, never touches node_modules)
- Browser half (lib/client.js): a Settings section "插件目录" registered via slots.inject('settings.section') (same pattern as dsh-plugin-guard's backup manager), rendered with React.createElement

Install

dsh plugin --profile web add github:fengs2021/dsh-plugin-catalog
systemctl restart dsh-web # or hot-mount via dev tools (no restart)

Then open 设置 → 插件目录 (Settings → Plugin Catalog).

Notes

- Update safety: one-click update is limited to npm-registry packages (exact allowlist, backup + rollback, in-flight lock, no auto-restart — you restart dsh-web yourself). link/github packages only show change hints: github packages pin commits in the profile spec (pnpm update cannot cross a pinned commit), link packages are your local dev copies (updating could overwrite local work) — handle those manually
- Safe by design: the host half only reads package.json metadata and writes one JSON file under $DSH_HOME/plugin-catalog/ — it never writes into node_modules or any dsh-managed path
- Categories are auto-derived from the dependency spec (link: / github: / built-in / scope prefix)

功能

- 自动分类目录：DSH 官方核心 / UI 全家桶 / 社区扩展 / OMDSH 生态 / GitHub 安装 / 本地自装 / 其他 —— 分组可折叠，按名称排序
- 逐插件信息：包名、版本、分组徽标、描述（内置 bundle 回退到 dsh 主包）、来源（本地 / GitHub / 内置）
- 搜索：按名称 + 描述实时过滤
- 备注（注释）：每个插件一条备注，保存在 host 端 $DSH_HOME/plugin-catalog/notes.json —— 手机和桌面看到同一份备注
- 刷新：随时重新加载列表
- 版本检查（v0.2.0）：每次打开都按来源自动检查最新版本 —— npm（dist-tags 取最大）、github（锁定 commit 对比远端 HEAD）、link（本地对比远端 HEAD）、builtin（跳过，由 DSH 管理）。有更新的包会显示徽标，npm 包还支持一键更新（备份 → pnpm update --depth 1 → 失败回滚）。link/github 包只给只读提示（见备注）

工作原理

- Host 端（lib/index.js）：两个偏只读的 HTTP API
- GET /plugin-catalog/api/list —— 读取 profile 的 package.json（bundles + dependencies）和每个包的元数据，返回 { entries, notes }
- GET/PUT /plugin-catalog/api/notes —— 备注读写（唯一的写操作：写 $DSH_HOME/plugin-catalog/ 下的备注文件，绝不碰 node_modules）
- 浏览器端（lib/client.js）：通过 slots.inject('settings.section') 注册设置分区「插件目录」（和 dsh-plugin-guard 的备份管理器同一套写法），用 React.createElement 渲染

安装

dsh plugin --profile web add github:fengs2021/dsh-plugin-catalog
systemctl restart dsh-web # or hot-mount via dev tools (no restart)

然后打开 设置 → 插件目录（Settings → Plugin Catalog）。

备注

- 更新安全：一键更新只限 npm registry 包（精确白名单、备份 + 回滚、进行中加锁、不自动重启 —— dsh-web 由你自己重启）。link/github 包只显示变更提示：github 包在 profile spec 里锁定了 commit（pnpm update 跨不过锁定的 commit），link 包是你本地的开发副本（更新可能覆盖本地改动）—— 这两种请手动处理
- 设计上就安全：host 端只读 package.json 元数据，只写 $DSH_HOME/plugin-catalog/ 下一个 JSON 文件 —— 绝不写入 node_modules 或任何 dsh 管理的路径
- 分类由依赖 spec 自动推导（link: / github: / 内置 / scope 前缀）
- 自动分类：已装插件按来源自动分 7 组（DSH 官方核心 / UI 全家桶 / 社区扩展 / OMDSH 生态 / GitHub 安装 / 本地自装 / 其他），分组可折叠、组内按名称排序
- 每插件信息：包名、版本、分类徽标、描述（内置包自动回退读 dsh 主包）、来源（本地/GitHub/内置）
- 搜索：按插件名或描述关键字实时过滤
- 备注：每插件一个备注输入框，存到 $DSH_HOME/plugin-catalog/notes.json——手机/电脑跨设备共享
- 刷新：随时重新加载列表
- 版本检查（v0.2.0）：每次打开自动按来源检查最新版本——npm（dist-tags 最大）、github（锁定 commit vs 远端 HEAD）、link（本地 vs 远端 HEAD）、内置（跳过，跟随 DSH 托管）；有更新的包显示徽标，npm 包支持一键更新（备份 → pnpm update --depth 1 → 失败自动回滚）；link/github 包仅只读提示（见说明）

实现

- host（lib/index.js）：
- GET /plugin-catalog/api/list：读 profile package.json（bundles + dependencies）与各包元数据，返回 { entries, notes }
- GET/PUT /plugin-catalog/api/notes：备注读写（唯一的写操作 = 你的备注文件，绝不碰 node_modules）
- client（lib/client.js）：设置页 section「插件目录」（slots.inject('settings.section') 模式，同 dsh-plugin-guard 备份管理），React.createElement 渲染

安装

dsh plugin --profile web add github:fengs2021/dsh-plugin-catalog
systemctl restart dsh-web # 或 dev 工具热装配（免重启）

然后打开 设置 → 插件目录。

说明

- 更新安全：一键更新仅限 npm registry 包（精确白名单、备份+回滚、进行中锁、不自动重启——由你自行重启 dsh-web）；link/github 包只显示变更提示：github 包在 profile spec 里锁定 commit（pnpm update 无法跨越锁定 commit），link 包是本地开发副本（更新可能覆盖本地工作）——请手动处理
- 安全设计：host 半只读 package.json 元数据 + 写一个 $DSH_HOME/plugin-catalog/ 下的 JSON 文件——绝不写入 node_modules 或任何 dsh 管理路径
- 分类自动派生：按依赖 spec（link: / github: / 内置 / scope 前缀）

License

MIT