@zerowall/dsh-plugin-skills 0.1.0-preview.4 → 0.1.0-preview.5

package/README.i18n.yaml

@@ -12,8 +12,8 @@
   en: 21744e6415a744df
   zh: 054ba34c61b48ecd
 /zerowall-dsh-plugin-skills/sources-and-state:
-  en: 452d9902dc4e35f0
-  zh: ff03b7f8e55b3c8b
+  en: 337af80caaa23ebf
+  zh: 6bbd33e85d5344fc
 /zerowall-dsh-plugin-skills/limits:
   en: ae5577470ed2d396
   zh: 8c498bd4e294a958

package/README.md

@@ -15,7 +15,7 @@ Folder, ZIP, Markdown and public GitHub imports require a preview. GitHub source
 
 ## Sources and state
 
-Plugin-owned instructions appear in the owning plugin's Usage instructions section. Its switch controls model instructions independently of plugin activation. Bundled entries declare `metadata.ownerPackage`; `providerOwners` maps official providers without modifying official packages. Project and user overrides remain in Skills according to their actual source. The registry still supplies enabled instructions to the Skill tool, PPT lazy tools and Claude projection. `resources/plugin-instructions.json` records the retired duplicate help copies; active guidance and third-party notices remain with their owners.
+Plugin-owned instructions appear in the owning plugin's Usage instructions section. Its switch controls model instructions independently of plugin activation. Bundled entries declare `metadata.ownerPackage`; `providerOwners` maps official providers without modifying official packages. Owners without a bundle page receive a package-named detail entry, generated from the registry; bundle pages are not duplicated. Entries refresh after plugin management changes and are released with their client scope. Project and user overrides remain in Skills according to their actual source. The registry still supplies enabled instructions to the Skill tool, PPT lazy tools and Claude projection. `resources/plugin-instructions.json` records the retired duplicate help copies; active guidance and third-party notices remain with their owners.
 
 The shared registry supplies plugin, project and user sources, winner selection and enablement. Disabled and shadowed entries remain visible. Standard DSH consumers and Claude use the same policies. Plugin-owned instructions remain with their owning plugin; the curated package provides no duplicate navigation Skill.
 

package/README.zh.md

@@ -15,7 +15,7 @@ description: "通过 DSH 共享注册表管理整理后的科研工作流与导
 
 ## 来源与状态
 
-插件说明显示在所属插件详情的“使用说明”中，开关仅控制向模型提供的说明，与插件启停独立。内置条目通过 `metadata.ownerPackage` 声明归属，`providerOwners` 映射官方 provider，无需修改官方包。项目和用户覆盖项仍按实际来源显示在 Skills 中。注册表继续向 Skill 工具、PPT 按需工具和 Claude 投影提供已启用的说明。`resources/plugin-instructions.json` 记录已整理的重复副本，活动说明与第三方声明由所属包维护。
+插件说明显示在所属插件详情的“使用说明”中，开关仅控制向模型提供的说明，与插件启停独立。内置条目通过 `metadata.ownerPackage` 声明归属，`providerOwners` 映射官方 provider，无需修改官方包。没有组合包页面的所属包，会根据注册表生成以包名标识的详情入口；已有组合包页面不会重复显示。入口随插件管理变更刷新，并随客户端作用域释放。项目和用户覆盖项仍按实际来源显示在 Skills 中。注册表继续向 Skill 工具、PPT 按需工具和 Claude 投影提供已启用的说明。`resources/plugin-instructions.json` 记录已整理的重复副本，活动说明与第三方声明由所属包维护。
 
 共享注册表提供插件、项目和用户来源、同名胜出选择及启停策略。停用和被覆盖的条目仍可查看。标准 DSH 和 Claude 消费方采用相同策略。插件使用说明由所属插件提供，整理包不提供重复的导航 Skill。
 

package/lib/client.js

@@ -345,6 +345,36 @@ function createSkillsViewStore() {
   });
 }
 
+// src/client/instruction-pages.ts
+function createInstructionPages(options) {
+  const pages = /* @__PURE__ */ new Map();
+  let disposed = false;
+  let pending = Promise.resolve();
+  return {
+    refresh() {
+      pending = pending.then(async () => {
+        if (disposed) return;
+        const inventory = await options.load();
+        if (disposed) return;
+        const bundles = new Set(inventory.packages);
+        const owners = new Set(inventory.entries.flatMap((entry) => entry.kind === "plugin-instructions" && entry.ownerPackage && !bundles.has(entry.ownerPackage) ? [entry.ownerPackage] : []));
+        for (const [owner, dispose] of pages) if (!owners.has(owner)) {
+          dispose();
+          pages.delete(owner);
+        }
+        for (const owner of owners) if (!pages.has(owner)) pages.set(owner, options.register(owner));
+      }).catch(options.failed);
+      return pending;
+    },
+    async dispose() {
+      disposed = true;
+      await pending;
+      for (const dispose of pages.values()) dispose();
+      pages.clear();
+    }
+  };
+}
+
 // src/client/index.ts
 var inject = ["slots", "locale", "uiWorkspace", "remote.zerowallSkills"];
 function apply(ctx) {
@@ -360,6 +390,28 @@ function apply(ctx) {
   ctx.slots.inject("settings.section", () => ctx.slots.register({ name: "settings.section", id: "zerowall-skills", order: 35, label: () => ctx.locale.bind(NS)("title"), locale: NS, store, inject: configuration }, SkillsPanel));
   ctx.slots.inject("plugins.bundle.config", () => ctx.slots.register({ name: "plugins.bundle.config", key: "@zerowall/dsh-plugin-skills", locale: NS, store, inject: configuration }, SkillsPanel));
   ctx.slots.inject("plugins.detail.section", () => ctx.slots.register({ name: "plugins.detail.section", id: "zerowall-plugin-instructions", locale: NS, store, inject: configuration }, PluginInstructionsPanel));
+  ctx.inject(["remote", "remote.pluginManager"], (scope) => {
+    scope.slots.inject("plugins.item", () => {
+      const pages = createInstructionPages({
+        load: async () => {
+          const [skills, bundles] = await Promise.all([request({ action: "list" }), scope.remote.pluginManager.listBundles()]);
+          if (!bundles.ok) throw new Error(bundles.error.message);
+          return { entries: skills.entries ?? [], packages: bundles.value.map((bundle) => bundle.name) };
+        },
+        register: (ownerPackage) => scope.effect(() => scope.slots.register({ name: "plugins.item", id: ownerPackage, order: 70, label: () => ownerPackage }, ({ view }) => view === "summary" ? scope.locale.bind(NS)("pluginDescription") : null)),
+        failed: (error51) => scope.logger.warn(`Plugin instruction pages could not refresh: ${String(error51)}`)
+      });
+      const refresh = () => {
+        void pages.refresh();
+      };
+      refresh();
+      const unsubscribe = scope.remote.$on("plugin-manager/changed", refresh);
+      return async () => {
+        unsubscribe();
+        await pages.dispose();
+      };
+    });
+  });
   ctx.slots.inject("shell.overlay", () => ctx.slots.register({ name: "shell.overlay", id: "zerowall-skills-feedback", locale: NS, store }, SkillsFeedback));
 }
 

package/lib/types/client/instruction-pages.d.ts

@@ -0,0 +1,20 @@
+/** Keep instructions reachable for providers whose packages have no bundle detail page. */
+import type { ManagedSkill } from '../shared/types.js';
+interface InstructionPagesOptions {
+    load(): Promise<{
+        entries: readonly ManagedSkill[];
+        packages: readonly string[];
+    }>;
+    register(ownerPackage: string): () => void;
+    failed(error: unknown): void;
+}
+/**
+ * Reconcile package-owned instruction pages and release all contributions on teardown.
+ * @param options - Inventory reader, page registration and error reporting owned by the client scope.
+ * @returns Serialized refresh and teardown operations; failed reads retain current pages.
+ */
+export declare function createInstructionPages(options: InstructionPagesOptions): {
+    refresh(): Promise<void>;
+    dispose(): Promise<void>;
+};
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerowall/dsh-plugin-skills",
-  "version": "0.1.0-preview.4",
+  "version": "0.1.0-preview.5",
   "description": "Curated scientific skills, imports and shared enablement management.",
   "type": "module",
   "main": "./lib/index.js",