@eya46/dsh-plugin-info 0.0.2 → 0.0.3

package/README.md

@@ -2,7 +2,7 @@
 
 面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的插件信息页。包名 `@eya46/dsh-plugin-info`，挂到当前 Profile 后，设置里会出现「插件信息」分区。
 
-它只看 **Profile 用户自己加的插件**（`profiles/<name>/package.json` 的 `dependencies`），不把 `@deepseek-ai/dsh-base` 这类随发行版带的 bundle 算进去。默认仅展示 `@eya46/` 命名空间下的插件（见下方 `allowScopes`），可按需放开。
+它只看 **Profile 用户自己加的插件**（`profiles/<name>/package.json` 的 `dependencies`），不把 `@deepseek-ai/dsh-base` 这类随发行版带的 bundle 算进去。默认展示全部用户插件；如需只看特定命名空间，可配置 `allowScopes`。
 
 - 列出已安装插件、当前版本、来源（npm / 本地 / git）
 - 对 registry 安装的包对照 `dist-tags.latest`，标出可更新
@@ -11,6 +11,12 @@
 
 实现方式对齐 [dsh-model-meta-autofill](https://github.com/QJAG1024/dsh-model-meta-autofill)：Host 注册本机 HTTP API，Client half 通过 `dsh.client` 挂到 `settings.section`。
 
+### 可选：dsh-better-sidebar 标签页
+
+若 Profile 同时安装了 [`dsh-better-sidebar`](https://github.com/omdsh-dev/DSH-better-sidebar) (≥0.4.0)，本插件会自动在侧边栏 `+` 菜单里多注册一个**插件信息**标签页（id `@eya46/dsh-plugin-info`，order 90，单实例），内容与设置页完全一致——侧边栏较窄，内部已做滚动/宽度适配。
+
+实现是**软依赖**：不写 `peerDependencies`，不 `import 'dsh-better-sidebar'`，只用 Cordis 的 `ctx.inject(['betterSidebar'], ...)` 开一个子 fiber——未安装时回调永不触发，其他功能不受影响；禁用 / HMR 任一插件时 disposer 随各自 fiber 清理，不会残留 `"already registered"`。
+
 ## 安装
 
 在仓库根目录构建后，把它加进当前 Profile：
@@ -41,7 +47,7 @@ dsh plugin --profile web add "file:./packages/dsh-plugin-info"
 | `defaultVersionLimit` | `10` | 默认版本条数 |
 | `timeoutMs` | `15000` | 注册表 / GitHub 超时 |
 | `cacheTtlMs` | `300000` | packument 与说明缓存 |
-| `allowScopes` | `['@eya46/']` | 名称前缀白名单；为空数组时展示全部用户插件 |
+| `allowScopes` | 无（展示全部） | 名称前缀白名单；省略或为空数组时展示全部用户插件 |
 
 覆盖写在 Profile 的 `cordis.patch.yml`：
 

package/lib/client.js

@@ -46,13 +46,26 @@
                 '.dpi-version:hover { background: var(--dsw-alias-interactive-bg-hover-solid); }',
                 '.dpi-version[data-open="1"] { background: var(--dsw-alias-interactive-bg-hover-solid); }',
                 '.dpi-notes { display: flex; flex-direction: column; gap: 6px; padding: 8px 2px 2px; }',
-                '.dpi-notesBody { margin: 0; white-space: pre-wrap; font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-secondary); }',
                 '.dpi-commits { margin: 0; padding-left: 18px; font-size: 13px; line-height: 20px; }',
                 '.dpi-link { color: inherit; text-underline-offset: 3px; }',
                 '.dpi-copyTag { box-sizing: border-box; border: 1px solid var(--dsw-alias-border-l3); color: var(--dsw-alias-label-secondary); background: transparent; border-radius: 4px; padding: 1px 6px; font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: 11px; line-height: 16px; cursor: pointer; }',
                 '.dpi-copyTag:hover { color: var(--dsw-alias-label-primary); border-color: var(--dsw-alias-border-l2); }',
+                // Sidebar tab wrapper: the panel sits in a narrow right-side column
+                // (default 420px), where PluginInfoPanel's 720px max-width and
+                // non-scrolling body would overflow. Force full width + own scroll.
+                '.dpi-sidebar { box-sizing: border-box; width: 100%; height: 100%; overflow-y: auto; overflow-x: hidden; padding: 12px 14px 16px; background: var(--dsw-alias-bg-base); }',
+                '.dpi-sidebar .dpi-section { max-width: none; gap: 10px; }',
+                '.dpi-sidebar .dpi-card .dpi-head { padding: 10px 12px; }',
+                '.dpi-sidebar .dpi-card .dpi-body { padding: 0 12px 12px; }',
+                '.dpi-sidebar .dpi-actions { gap: 6px; }',
+                '.dpi-sidebar .dpi-rowButton { height: 26px; padding: 0 8px; }',
             ].join('\n');
             const React = require('react');
+            // Reuse DSH's shared untrusted-Markdown renderer instead of rolling our
+            // own — it ships in the web shell's static module table and handles GFM,
+            // math, code fences, and sanitization (raw HTML / unsafe URLs stripped).
+            const uiPrimitives = require('@deepseek-ai/dsh-client-ui-primitives');
+            const MarkdownText = uiPrimitives.MarkdownText;
             const h = React.createElement.bind(React);
             const ensureStyles = () => {
                 if (document.querySelector('style[data-plugin="@eya46/dsh-plugin-info"]') !== null)
@@ -212,7 +225,7 @@
                 const updateCount = rows.filter((row) => row.hasUpdate).length;
                 const children = [
                     h('h2', { key: 'title', className: 'dpi-title' }, '插件信息'),
-                    h('p', { key: 'intro', className: 'dpi-intro' }, '当前 Profile 里 @eya46 命名空间下的插件。展开后默认看最近 10 个版本，点版本可看更新说明。'),
+                    h('p', { key: 'intro', className: 'dpi-intro' }, '当前 Profile 里用户添加的插件（不含随发行版内置的 bundle）。展开后默认看最近 10 个版本，点版本可看更新说明。'),
                     h('div', { key: 'toolbar', className: 'dpi-toolbar' }, h('button', { className: 'dpi-secondaryButton', disabled: busy, onClick: () => { load(); } }, busy ? '刷新中…' : '刷新'), h('span', { className: 'dpi-status' }, '共 ' + rows.length + ' 个插件' + (updateCount > 0 ? ' · ' + updateCount + ' 个可更新' : ''))),
                 ];
                 if (error !== '')
@@ -296,8 +309,9 @@
                                     else if (note.source === 'github-release') {
                                         if (note.title !== undefined)
                                             noteChildren.push(h('p', { key: 'nt', className: 'dpi-meta' }, note.title));
-                                        if (note.body !== undefined)
-                                            noteChildren.push(h('pre', { key: 'nb', className: 'dpi-notesBody' }, note.body));
+                                        if (note.body !== undefined && note.body !== '') {
+                                            noteChildren.push(h(MarkdownText, { key: 'nb', text: note.body }));
+                                        }
                                         if (note.url !== undefined) {
                                             noteChildren.push(h('a', { key: 'nu', className: 'dpi-link', href: note.url, target: '_blank', rel: 'noreferrer' }, '在 GitHub 查看 Release'));
                                         }
@@ -309,7 +323,10 @@
                                         }
                                     }
                                     else {
-                                        noteChildren.push(h('p', { key: 'nnone', className: 'dpi-meta' }, note.body ?? '这个版本没有找到 GitHub Release 或提交说明。'));
+                                        const fallback = note.body ?? '这个版本没有找到 GitHub Release 或提交说明。';
+                                        // Error payloads and the "none" source are plain text; keep
+                                        // them literal rather than feeding them through Markdown.
+                                        noteChildren.push(h('p', { key: 'nnone', className: 'dpi-meta' }, fallback));
                                     }
                                 }
                                 return h('div', { key: row.version }, h('button', {
@@ -330,6 +347,48 @@
                 children.push(h('ul', { key: 'cards', className: 'dpi-cards' }, ...cards));
                 return h('div', { className: 'dpi-section' }, ...children);
             };
+            /**
+             * Sidebar-tab wrapper: same content as the settings panel, but hosted in
+             * the narrow right-side better-sidebar pane where it must manage its own
+             * vertical scroll and drop the 720px max-width.
+             */
+            const PluginInfoSidebarPanel = () => {
+                return h('div', { className: 'dpi-sidebar' }, h(PluginInfoPanel, null));
+            };
+            /** Small Cordis-plugin outline glyph (same geometry as the settings
+             *  nav uses, suitable for the sidebar's 16px tab icon slot). */
+            const PluginIcon = (size) => {
+                return h('svg', {
+                    width: size,
+                    height: size,
+                    viewBox: '0 0 14 14',
+                    fill: 'none',
+                    'aria-hidden': true,
+                }, h('path', {
+                    fill: 'currentColor',
+                    d: 'M3.03426 5.66661L1.70084 7.00003L3.0315 8.33069L2.14762 9.21457L-0.0669245 7.00003L2.15038 4.78273L3.03426 5.66661ZM7 14.067L4.77924 11.8462L5.66313 10.9623L7 12.2992L8.33342 10.9658L9.2173 11.8496L7 14.067ZM11.8489 9.21803L10.965 8.33414L12.2992 7.00003L10.9623 5.66316L11.8462 4.77927L14.0669 7.00003L11.8489 9.21803ZM8.33066 3.03153L7 1.70087L5.66589 3.03498L4.782 2.1511L7 -0.0668945L9.21454 2.14765L8.33066 3.03153Z',
+                }), h('rect', { x: 5.98535, y: 5.98535, width: 2.02942, height: 2.02942, fill: 'currentColor' }));
+            };
+            /**
+             * Register the sidebar tab ONLY when dsh-better-sidebar is present. The
+             * child fiber waits for the `betterSidebar` service; if that plugin is
+             * not installed the callback never runs and the rest of this plugin is
+             * unaffected. The disposer returned by registerTab is attached to the
+             * child fiber, so disabling/HMR of either side cleans up cleanly.
+             */
+            const registerSidebarTab = (ctx) => {
+                ctx.inject(['betterSidebar'], ((sctx) => {
+                    const service = sctx.betterSidebar;
+                    sctx.effect(() => service.registerTab({
+                        id: '@eya46/dsh-plugin-info',
+                        title: '插件信息',
+                        icon: (size) => PluginIcon(size),
+                        order: 90,
+                        single: true,
+                        component: PluginInfoSidebarPanel,
+                    }), '@eya46/dsh-plugin-info: better-sidebar tab');
+                }));
+            };
             return {
                 name: 'dsh-plugin-info',
                 inject: ['slots'],
@@ -338,6 +397,9 @@
                     ctx.slots.inject('settings.section', () => {
                         ctx.slots.register({ name: 'settings.section', id: 'plugin-info', order: 16, label: '插件信息' }, PluginInfoPanel);
                     });
+                    // Optional injection into dsh-better-sidebar: no-op when that
+                    // plugin is absent from the profile.
+                    registerSidebarTab(ctx);
                 },
             };
         },

package/lib/index.js

@@ -460,7 +460,7 @@ const Config = z.object({
 	defaultVersionLimit: z.number().step(1).min(1).max(50).default(10),
 	timeoutMs: z.number().step(1).min(1e3).default(15e3),
 	cacheTtlMs: z.number().step(1).min(0).default(3e5),
-	allowScopes: z.array(z.string()).default(["@eya46/"])
+	allowScopes: z.array(z.string())
 });
 /**
 * Register the plugin-info HTTP API when a web server is present.

package/lib/types/client.d.ts

@@ -21,14 +21,38 @@ interface MinimalReact {
     useEffect(effect: () => void | (() => void), deps?: unknown[]): void;
     useCallback<T>(fn: T, deps: unknown[]): T;
 }
+/**
+ * Subset of DSH's `MarkdownText` shared primitive. The real component is
+ * GFM + KaTeX with unsafe HTML/protocols stripped; we only need the `text`
+ * prop for rendering release-note bodies.
+ */
+type MarkdownTextComponent = (props: {
+    text: string;
+}) => unknown;
 interface SlotsService {
     inject(key: string, register: () => void): void;
     register(options: Record<string, unknown>, component: unknown): void;
 }
+/**
+ * Minimal structural mirror of dsh-better-sidebar's client service — the
+ * only method we call is `registerTab`. The plugin is an OPTIONAL soft
+ * dependency: this plugin does not value-import it, does not list it in
+ * peerDependencies, and reaches the service through `ctx.inject(...)` so
+ * the whole registration block is inert when better-sidebar is absent.
+ */
+interface BetterSidebarServiceLike {
+    registerTab(descriptor: Record<string, unknown>): () => void;
+}
 interface ClientContext {
     slots: SlotsService;
     /** Cordis fiber-lifetime effect: runs now, disposes on fiber unload. */
     effect(callback: () => (() => void) | void, label?: string): () => void;
+    /**
+     * Cordis child-fiber spawn: waits until all named services are available
+     * before running the callback. Used to register with better-sidebar only
+     * when that plugin is loaded (optional soft dependency).
+     */
+    inject(deps: string[], apply: (ctx: ClientContext) => void): unknown;
 }
 interface PluginRow {
     name: string;

package/lib/types/types.d.ts

@@ -102,10 +102,11 @@ export interface PluginConfig {
     /** How long packument and notes stay cached. */
     cacheTtlMs: number;
     /**
-     * Optional allow-list: when non-empty, only plugins whose npm name starts
-     * with one of these prefixes (case-insensitive, e.g. `@eya46/`) appear in
-     * the settings page and the version/notes APIs. Set to `[]` to show all.
+     * Optional allow-list: when omitted or empty, all profile-added plugins
+     * appear in the settings page and the version/notes APIs. When non-empty,
+     * only plugins whose npm name starts with one of these prefixes appear
+     * (case-insensitive, e.g. `@eya46/`).
      */
-    allowScopes: string[];
+    allowScopes?: string[];
 }
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@eya46/dsh-plugin-info",
   "description": "List profile-added DSH plugins, mark available updates, and show recent version notes",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",