dsh-plugin-lens

An enhancement layer for the official DSH Plugins page: it adds an Overview tab and a Source block on every bundle's detail page.

插件管理的增强层：在官方「插件」页加「总览」标签，在详情页加「来源归属」区块。

It does not modify the desktop core, the sidebar, or the official install / uninstall / upgrade / configure flows — those stay where they are.

What the Overview tab gives you

• Stats bar: total, local lab, packed, built-in, error, disabled, uninstalled.
• Search across name, version, description, source, component names, aliases, notes, category names and tags (space-separated terms are ANDed).
• Filters: all / error / disabled / local lab / packed / built-in / uninstalled. Uninstalled placeholders stay hidden until you ask for them.
• Categories: your own categories, a package can belong to several (up to 24), rename and delete without touching packages.
• Grouping: by category / source / purpose (8 groups) / status / none, all collapsible.
• Sorting and paging: name, status, source, version, component count or a custom order; 20 / 50 / 100 rows per page.
• Compact rows: status dot, alias, version, source badge, component and running counts, inline edit, enable/disable.
• Inline editing: alias, multi-line note, purpose, categories, tags, pin, reset to default; drag rows to set a custom order.
• Sidebar entry management: show or hide any plugin's sidebar entry from the overview (local to this machine).
• Uninstall placeholders: a removed bundle keeps its row and your local settings, and comes back when you reinstall it.
• Detail block: source type, original declaration, local path (copyable), runtime summary, override rows, readonly reason, error code.

Requirements

• DSH desktop with the plugin manager.
• Node.js 22+ inside the DSH runtime.
• No third-party runtime dependencies (only the react the host provides).

Install

1. Open DSH desktop → Plugins → Add plugin.
2. Enter dsh-plugin-lens (or a Git URL / local path to this package).
3. Quit the app from the tray and relaunch.

The Host half is a single composition row; all the work is in the browser module. Host changes can be hot-reloaded by toggling the plugin, client changes need a page refresh.

Where the state lives

• UI state (search, filter, grouping, sort, page, collapse, alias, note, purpose, pin, custom order): localStorage key dsh-plugin-lens.v1.ui.
• Bundle history used for uninstall placeholders: localStorage key dsh-plugin-lens.v1.history.
• Sidebar hiding tags matching button[class*="panelRow"] with data-plugin-center-hidden, kept in place by a MutationObserver plus a 1.5 s poll, because the core exposes no API to unregister another plugin's slot.

Design constraints

• Registers only two officially declared slots: plugins.tab (id plugin-center, order -2) and plugins.detail.section (id plugin-center-source, order 80).
• Only require('react'); colours come from --dsw-alias-* tokens; CSS is prefixed dpc- and injected once.
• Reads through ctx.remote.pluginManager.listBundles() / listPlugins() and toggles through setBundleEnabled().

Known limitations

• Hiding a sidebar entry is DOM-based and re-applies on a 1.5 s timer; a core UI change can break the row selector.
• Categories, tags, notes, aliases and ordering are local to this machine (localStorage), they are not synchronised anywhere.
• An "uninstalled" row is only a placeholder; it never reinstalls anything.
• Introductions fall back to a built-in English→Chinese table; packages it does not know keep their English description.

License

MIT. See LICENSE.