@zerowall/dsh-plugin-skills 0.1.0-preview.3 → 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: 0aadfc4c1c6b1d89
-  zh: c0f4b9af1cff8c21
+  en: 337af80caaa23ebf
+  zh: 6bbd33e85d5344fc
 /zerowall-dsh-plugin-skills/limits:
   en: ae5577470ed2d396
   zh: 8c498bd4e294a958

package/README.md

@@ -15,6 +15,8 @@ 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. 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.
 
 The bundle disables the profile's `skill` row and mounts this package's `./registry` subpath as the sole active registry. The standard filesystem provider and Skill tool remain enabled. It ships the extended registry under the ZeroWall package name and retains the DSH MIT license; no modified official version is republished.

package/README.zh.md

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

package/dsh.bundle.patch.yml

@@ -9,3 +9,7 @@
       name: '@zerowall/dsh-plugin-skills/registry'
     - id: zerowall-skills
       name: '@zerowall/dsh-plugin-skills'
+      config:
+        providerOwners:
+          dsh-office: '@deepseek-ai/dsh-skill-office'
+          dsh-windows-acl: '@deepseek-ai/dsh-sandbox-windows-acl'

package/lib/client.js

@@ -57,13 +57,13 @@ function SkillsFeedback({ useStore, actions, t }) {
   const toast = useStore((state) => state.toast);
   return toast ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Toast, { text: t(toast.key), ...toast.success ? { tone: "success" } : {}, onDone: actions.clear }, toast.id) : null;
 }
-function SkillsPanel({ request, pickDirectory, t, actions, view }) {
+function SkillsPanel({ request, pickDirectory, t, actions, view, ownerPackage }) {
   const [entries, setEntries] = (0, import_react.useState)([]);
   const [complete, setComplete] = (0, import_react.useState)(true);
   const [query, setQuery] = (0, import_react.useState)("");
   const [source, setSource] = (0, import_react.useState)("");
   const [cwd, setCwd] = (0, import_react.useState)();
-  const [scope, setScope] = (0, import_react.useState)("workspace");
+  const [scope, setScope] = (0, import_react.useState)(ownerPackage ? "global" : "workspace");
   const [preview, setPreview] = (0, import_react.useState)();
   const [replace, setReplace] = (0, import_react.useState)(false);
   const [content, setContent] = (0, import_react.useState)();
@@ -111,11 +111,12 @@ function SkillsPanel({ request, pickDirectory, t, actions, view }) {
     }
   }
   if (view !== void 0 && view !== "page") return null;
-  const visible = entries.filter((row) => `${row.name} ${row.description}`.toLowerCase().includes(query.toLowerCase()));
+  const visible = entries.filter((row) => (ownerPackage ? row.kind === "plugin-instructions" && row.ownerPackage === ownerPackage : row.kind !== "plugin-instructions") && `${row.name} ${row.description}`.toLowerCase().includes(query.toLowerCase()));
   const topics = [...new Set(visible.map((row) => row.topic))];
+  if (ownerPackage && !visible.length && !failure) return null;
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("section", { className: panel_default.root, "aria-label": t("title"), "aria-busy": busy, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h2", { children: t("title") }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { children: t("description") }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("h2", { children: t(ownerPackage ? "plugin" : "title") }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { children: t(ownerPackage ? "pluginDescription" : "description") }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: panel_default.toolbar, children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Input, { "aria-label": t("search"), placeholder: t("search"), value: query, onChange: (event) => setQuery(event.target.value) }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { disabled: busy, onClick: () => {
@@ -140,7 +141,7 @@ function SkillsPanel({ request, pickDirectory, t, actions, view }) {
       ] })
     ] }),
     !complete && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { role: "status", children: t("incomplete") }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("details", { className: panel_default.import, children: [
+    !ownerPackage && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("details", { className: panel_default.import, children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("summary", { children: t("preview") }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { children: t("importNote") }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: panel_default.toolbar, children: [
@@ -207,7 +208,7 @@ function SkillsPanel({ request, pickDirectory, t, actions, view }) {
               row.license
             ] })
           ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Switch, { label: `${t("enable")}: ${row.name}`, checked: row.enabled, disabled: busy || !row.effective || scope === "workspace" && !cwd, onChange: (enabled2) => {
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Switch, { label: `${t(ownerPackage ? "enableInstructions" : "enable")}: ${row.name}`, checked: row.enabled, disabled: busy || !row.effective || scope === "workspace" && !cwd, onChange: (enabled2) => {
             void operate({ action: "set-enabled", name: row.name, enabled: enabled2 });
           } }),
           row.removable && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.Button, { disabled: busy, onClick: () => {
@@ -223,15 +224,21 @@ function SkillsPanel({ request, pickDirectory, t, actions, view }) {
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("pre", { children: content.text })
     ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("small", { children: t("removeNote") })
+    !ownerPackage && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("small", { children: t("removeNote") })
   ] });
 }
+function PluginInstructionsPanel({ subject, ...props }) {
+  const ownerPackage = subject.kind === "item" ? subject.id : subject.kind === "row" ? subject.row.moduleName.split("/").slice(0, subject.row.moduleName.startsWith("@") ? 2 : 1).join("/") : subject.pkg.name;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(SkillsPanel, { ...props, ownerPackage }, ownerPackage);
+}
 
 // src/client/locales.ts
 var NS = "zerowall.skills";
 var en = {
   title: "Skills",
   description: "Core workflows are enabled by default. Optional topics load only when enabled. Plugin instructions stay with their owning plugin.",
+  pluginDescription: "These instructions help the model use this plugin. Their switch controls instructions, not plugin activation.",
+  enableInstructions: "Provide instructions to the model",
   search: "Search skills",
   refresh: "Refresh",
   source: "Folder, ZIP, Markdown or public GitHub URL",
@@ -277,6 +284,8 @@ var en = {
 var zh = {
   title: "Skills \u7BA1\u7406",
   description: "\u6838\u5FC3\u5DE5\u4F5C\u6D41\u9ED8\u8BA4\u542F\u7528\uFF0C\u4E13\u9898\u6309\u9700\u5F00\u542F\uFF1B\u63D2\u4EF6\u63D0\u4F9B\u7684\u4F7F\u7528\u8BF4\u660E\u968F\u63D2\u4EF6\u7BA1\u7406",
+  pluginDescription: "\u8FD9\u4E9B\u8BF4\u660E\u5E2E\u52A9\u6A21\u578B\u4F7F\u7528\u672C\u63D2\u4EF6\uFF1B\u5F00\u5173\u4EC5\u63A7\u5236\u8BF4\u660E\u662F\u5426\u63D0\u4F9B\u7ED9\u6A21\u578B\uFF0C\u4E0D\u63A7\u5236\u63D2\u4EF6\u542F\u505C",
+  enableInstructions: "\u5411\u6A21\u578B\u63D0\u4F9B\u4F7F\u7528\u8BF4\u660E",
   search: "\u641C\u7D22 Skill",
   refresh: "\u5237\u65B0",
   source: "\u6587\u4EF6\u5939\u3001ZIP\u3001Markdown \u8DEF\u5F84\u6216\u516C\u5F00 GitHub \u5730\u5740",
@@ -336,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) {
@@ -350,6 +389,29 @@ function apply(ctx) {
   const configuration = () => ({ request, pickDirectory: () => ctx.uiWorkspace.pickDirectory() });
   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));
 }
 
@@ -15035,6 +15097,8 @@ var _zerowall_dsh_plugin_skills_zerowallSkills_request_result$schema = () => _ze
     "description": external_exports.string(),
     "source": external_exports.string(),
     "provider": external_exports.string(),
+    "kind": external_exports.union([external_exports.literal("standalone"), external_exports.literal("plugin-instructions")]),
+    "ownerPackage": external_exports.union([external_exports.undefined(), external_exports.string()]).optional(),
     "topic": external_exports.string(),
     "enabled": external_exports.boolean(),
     "effective": external_exports.boolean(),
@@ -15102,9 +15166,9 @@ var TYPERT_REMOTE = createTypertRemoteInfo({
         typeSymbol: "@zerowall/dsh-plugin-skills/types#SkillsResponse",
         create: _zerowall_dsh_plugin_skills_zerowallSkills_request_result$schema,
         description: "committed state or a read-only import preview; imported code is never executed.",
-        jsonSchema: { "type": "object", "properties": { "entries": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "source": { "type": "string" }, "provider": { "type": "string" }, "topic": { "type": "string" }, "enabled": { "type": "boolean" }, "effective": { "type": "boolean" }, "removable": { "type": "boolean" }, "path": { "type": "string" }, "license": { "type": "string" }, "requirements": { "type": "array", "items": { "type": "string" } } }, "required": ["id", "name", "description", "source", "provider", "topic", "enabled", "effective", "removable", "requirements"], "additionalProperties": true } }, "complete": { "type": "boolean", "enum": [false, true] }, "content": { "type": "string" }, "preview": { "type": "object", "properties": { "id": { "type": "string" }, "source": { "type": "string" }, "commit": { "type": "string" }, "skills": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "relativePath": { "type": "string" }, "conflict": { "type": "boolean" } }, "required": ["name", "description", "relativePath", "conflict"], "additionalProperties": true } } }, "required": ["id", "source", "skills"], "additionalProperties": true }, "installed": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string" } }, "required": [], "additionalProperties": true }
+        jsonSchema: { "type": "object", "properties": { "entries": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "source": { "type": "string" }, "provider": { "type": "string" }, "kind": { "type": "string", "enum": ["standalone", "plugin-instructions"] }, "ownerPackage": { "type": "string" }, "topic": { "type": "string" }, "enabled": { "type": "boolean" }, "effective": { "type": "boolean" }, "removable": { "type": "boolean" }, "path": { "type": "string" }, "license": { "type": "string" }, "requirements": { "type": "array", "items": { "type": "string" } } }, "required": ["id", "name", "description", "source", "provider", "kind", "topic", "enabled", "effective", "removable", "requirements"], "additionalProperties": true } }, "complete": { "type": "boolean", "enum": [false, true] }, "content": { "type": "string" }, "preview": { "type": "object", "properties": { "id": { "type": "string" }, "source": { "type": "string" }, "commit": { "type": "string" }, "skills": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "relativePath": { "type": "string" }, "conflict": { "type": "boolean" } }, "required": ["name", "description", "relativePath", "conflict"], "additionalProperties": true } } }, "required": ["id", "source", "skills"], "additionalProperties": true }, "installed": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string" } }, "required": [], "additionalProperties": true }
       },
-      sourceLocation: { "file": "packages/plugin/src/host/index.ts", "line": 153, "column": 9 }
+      sourceLocation: { "file": "packages/plugin/src/host/index.ts", "line": 155, "column": 9 }
     }
   }
 }, external_exports);

package/lib/index.js

@@ -217,7 +217,7 @@ async function publishImport(prepared, destination) {
 // src/host/index.ts
 var name = "zerowall-skills";
 var inject = ["skills"];
-var Config = configSchema.object({ home: configSchema.string(), resources: configSchema.string() });
+var Config = configSchema.object({ home: configSchema.string(), resources: configSchema.string(), providerOwners: configSchema.dict(configSchema.string()) });
 var requestSchema = z.object({ action: z.enum(["list", "detail", "set-enabled", "set-topic", "preview", "install", "remove"]), cwd: z.string().optional(), id: z.string().optional(), name: z.string().optional(), enabled: z.boolean().optional(), topic: z.string().optional(), source: z.string().optional(), scope: z.enum(["workspace", "global"]).optional(), replace: z.boolean().optional() });
 var importSchema = z.object({ id: z.string(), name: z.string(), description: z.string(), path: z.string(), root: z.string(), source: z.string(), cwd: z.string().optional(), commit: z.string().optional() });
 var stateSchema = z.object({ version: z.literal(1), overrides: z.record(z.string(), z.boolean()), workspaceOverrides: z.record(z.string(), z.record(z.string(), z.boolean())), topics: z.array(z.string()), imports: z.array(importSchema) });
@@ -231,6 +231,7 @@ var SkillsManagement = class extends (_a = TypertRemoteService, _request_dec = [
     __publicField(this, "catalog", []);
     __publicField(this, "root");
     __publicField(this, "resources");
+    __publicField(this, "providerOwners");
     __publicField(this, "ready");
     __publicField(this, "policyControl");
     __publicField(this, "providerControl");
@@ -238,6 +239,7 @@ var SkillsManagement = class extends (_a = TypertRemoteService, _request_dec = [
     __publicField(this, "previews", /* @__PURE__ */ new Map());
     __publicField(this, "disposed", false);
     __publicField(this, "registry");
+    this.providerOwners = config.providerOwners ?? {};
     this.registry = host.get("skills");
     this.root = join2(resolve2(config.home ?? resolveDshHome()), "zerowall-skills");
     const ownFile = fileURLToPath(import.meta.url).replace(/\.asar([\\/])/u, ".asar.unpacked$1");
@@ -360,7 +362,8 @@ ${content}` : content;
     const entries = snapshot.entries.map((entry) => {
       const imported = this.state.imports.find((row) => row.path === entry.skill.path);
       const curated = entry.skill.provider === "zerowall-curated" ? this.catalog.find((row) => row.name === entry.skill.name) : void 0;
-      return { id: imported?.id ?? `${entry.skill.provider}:${entry.skill.path ?? entry.skill.name}`, name: entry.skill.name, description: entry.skill.description, source: entry.skill.source, provider: entry.skill.provider, topic: curated?.topic ?? (imported ? "imported" : "plugin"), enabled: entry.enabled, effective: entry.effective, removable: imported !== void 0, ...entry.skill.path ? { path: entry.skill.path } : {}, ...curated ? { license: curated.license } : {}, requirements: curated?.requirements ?? [] };
+      const owner = entry.skill.source === "bundled" && !imported && !curated ? typeof entry.metadata?.ownerPackage === "string" ? entry.metadata.ownerPackage : this.providerOwners[entry.skill.provider] : void 0;
+      return { id: imported?.id ?? `${entry.skill.provider}:${entry.skill.path ?? entry.skill.name}`, name: entry.skill.name, description: entry.skill.description, source: entry.skill.source, provider: entry.skill.provider, kind: owner ? "plugin-instructions" : "standalone", ...owner ? { ownerPackage: owner } : {}, topic: curated?.topic ?? (imported ? "imported" : "plugin"), enabled: entry.enabled, effective: entry.effective, removable: imported !== void 0, ...entry.skill.path ? { path: entry.skill.path } : {}, ...curated ? { license: curated.license } : {}, requirements: curated?.requirements ?? [] };
     });
     if (input.action === "detail") {
       const item = entries.find((row) => row.id === input.id);

package/lib/typert.host.js

@@ -23,6 +23,8 @@ const _zerowall_dsh_plugin_skills_zerowallSkills_request_result$schema = () => (
   'description': z.string(),
   'source': z.string(),
   'provider': z.string(),
+  'kind': z.union([z.literal("standalone"), z.literal("plugin-instructions")]),
+  'ownerPackage': z.union([z.undefined(), z.string()]).optional(),
   'topic': z.string(),
   'enabled': z.boolean(),
   'effective': z.boolean(),
@@ -91,9 +93,9 @@ const $remote = createTypertRemoteInfo({
         typeSymbol: '@zerowall/dsh-plugin-skills/types#SkillsResponse',
         create: _zerowall_dsh_plugin_skills_zerowallSkills_request_result$schema,
         description: 'committed state or a read-only import preview; imported code is never executed.',
-        jsonSchema: {"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"source":{"type":"string"},"provider":{"type":"string"},"topic":{"type":"string"},"enabled":{"type":"boolean"},"effective":{"type":"boolean"},"removable":{"type":"boolean"},"path":{"type":"string"},"license":{"type":"string"},"requirements":{"type":"array","items":{"type":"string"}}},"required":["id","name","description","source","provider","topic","enabled","effective","removable","requirements"],"additionalProperties":true}},"complete":{"type":"boolean","enum":[false,true]},"content":{"type":"string"},"preview":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"commit":{"type":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"relativePath":{"type":"string"},"conflict":{"type":"boolean"}},"required":["name","description","relativePath","conflict"],"additionalProperties":true}}},"required":["id","source","skills"],"additionalProperties":true},"installed":{"type":"array","items":{"type":"string"}},"status":{"type":"string"}},"required":[],"additionalProperties":true},
+        jsonSchema: {"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"source":{"type":"string"},"provider":{"type":"string"},"kind":{"type":"string","enum":["standalone","plugin-instructions"]},"ownerPackage":{"type":"string"},"topic":{"type":"string"},"enabled":{"type":"boolean"},"effective":{"type":"boolean"},"removable":{"type":"boolean"},"path":{"type":"string"},"license":{"type":"string"},"requirements":{"type":"array","items":{"type":"string"}}},"required":["id","name","description","source","provider","kind","topic","enabled","effective","removable","requirements"],"additionalProperties":true}},"complete":{"type":"boolean","enum":[false,true]},"content":{"type":"string"},"preview":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"commit":{"type":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"relativePath":{"type":"string"},"conflict":{"type":"boolean"}},"required":["name","description","relativePath","conflict"],"additionalProperties":true}}},"required":["id","source","skills"],"additionalProperties":true},"installed":{"type":"array","items":{"type":"string"}},"status":{"type":"string"}},"required":[],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/plugin/src/host/index.ts","line":153,"column":9},
+      sourceLocation: {"file":"packages/plugin/src/host/index.ts","line":155,"column":9},
     },
   },
 }, z)
@@ -129,7 +131,7 @@ export const TYPERT = {
           },
           {
             "name": "ManagedSkill",
-            "declaration": "export interface ManagedSkill {\n    id: string;\n    name: string;\n    description: string;\n    source: string;\n    provider: string;\n    topic: string;\n    enabled: boolean;\n    effective: boolean;\n    removable: boolean;\n    path?: string;\n    license?: string;\n    requirements: string[];\n}"
+            "declaration": "export interface ManagedSkill {\n    id: string;\n    name: string;\n    description: string;\n    source: string;\n    provider: string;\n    kind: 'standalone' | 'plugin-instructions';\n    ownerPackage?: string;\n    topic: string;\n    enabled: boolean;\n    effective: boolean;\n    removable: boolean;\n    path?: string;\n    license?: string;\n    requirements: string[];\n}"
           },
           {
             "name": "SkillsRequest",

package/lib/typert.remote-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typert.remote-client.d.ts","names":["request"],"sources":["../src/host/index.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;IAwJQA,O;;;IAAAA,wB","ignoreList":[]}
+{"version":3,"file":"typert.remote-client.d.ts","names":["request"],"sources":["../src/host/index.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;IA0JQA,O;;;IAAAA,wB","ignoreList":[]}

package/lib/typert.remote-client.js

@@ -23,6 +23,8 @@ const _zerowall_dsh_plugin_skills_zerowallSkills_request_result$schema = () => (
   'description': z.string(),
   'source': z.string(),
   'provider': z.string(),
+  'kind': z.union([z.literal("standalone"), z.literal("plugin-instructions")]),
+  'ownerPackage': z.union([z.undefined(), z.string()]).optional(),
   'topic': z.string(),
   'enabled': z.boolean(),
   'effective': z.boolean(),
@@ -91,9 +93,9 @@ export const TYPERT_REMOTE = createTypertRemoteInfo({
         typeSymbol: '@zerowall/dsh-plugin-skills/types#SkillsResponse',
         create: _zerowall_dsh_plugin_skills_zerowallSkills_request_result$schema,
         description: 'committed state or a read-only import preview; imported code is never executed.',
-        jsonSchema: {"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"source":{"type":"string"},"provider":{"type":"string"},"topic":{"type":"string"},"enabled":{"type":"boolean"},"effective":{"type":"boolean"},"removable":{"type":"boolean"},"path":{"type":"string"},"license":{"type":"string"},"requirements":{"type":"array","items":{"type":"string"}}},"required":["id","name","description","source","provider","topic","enabled","effective","removable","requirements"],"additionalProperties":true}},"complete":{"type":"boolean","enum":[false,true]},"content":{"type":"string"},"preview":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"commit":{"type":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"relativePath":{"type":"string"},"conflict":{"type":"boolean"}},"required":["name","description","relativePath","conflict"],"additionalProperties":true}}},"required":["id","source","skills"],"additionalProperties":true},"installed":{"type":"array","items":{"type":"string"}},"status":{"type":"string"}},"required":[],"additionalProperties":true},
+        jsonSchema: {"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"source":{"type":"string"},"provider":{"type":"string"},"kind":{"type":"string","enum":["standalone","plugin-instructions"]},"ownerPackage":{"type":"string"},"topic":{"type":"string"},"enabled":{"type":"boolean"},"effective":{"type":"boolean"},"removable":{"type":"boolean"},"path":{"type":"string"},"license":{"type":"string"},"requirements":{"type":"array","items":{"type":"string"}}},"required":["id","name","description","source","provider","kind","topic","enabled","effective","removable","requirements"],"additionalProperties":true}},"complete":{"type":"boolean","enum":[false,true]},"content":{"type":"string"},"preview":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"string"},"commit":{"type":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"relativePath":{"type":"string"},"conflict":{"type":"boolean"}},"required":["name","description","relativePath","conflict"],"additionalProperties":true}}},"required":["id","source","skills"],"additionalProperties":true},"installed":{"type":"array","items":{"type":"string"}},"status":{"type":"string"}},"required":[],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/plugin/src/host/index.ts","line":153,"column":9},
+      sourceLocation: {"file":"packages/plugin/src/host/index.ts","line":155,"column":9},
     },
   },
 }, z)

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/lib/types/client/locales.d.ts

@@ -4,6 +4,8 @@ export declare const NS = "zerowall.skills";
 export declare const en: {
     readonly title: "Skills";
     readonly description: "Core workflows are enabled by default. Optional topics load only when enabled. Plugin instructions stay with their owning plugin.";
+    readonly pluginDescription: "These instructions help the model use this plugin. Their switch controls instructions, not plugin activation.";
+    readonly enableInstructions: "Provide instructions to the model";
     readonly search: "Search skills";
     readonly refresh: "Refresh";
     readonly source: "Folder, ZIP, Markdown or public GitHub URL";

package/lib/types/client/panel.d.ts

@@ -1,4 +1,5 @@
 import type { InjectFace, PropsLocale, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PluginDetailProps } from '@deepseek-ai/dsh-client-ui-plugin-manager/client';
 import type { SkillsRequest, SkillsResponse } from '../shared/types.js';
 import type { NS } from './locales.js';
 import type { createSkillsViewStore } from './view-store.js';
@@ -10,9 +11,12 @@ export interface SkillsFace {
 type FeedbackProps = PropsStore<ReturnType<typeof createSkillsViewStore>> & PropsLocale<typeof NS>;
 type PanelProps = FeedbackProps & InjectFace<SkillsFace> & {
     view?: string;
+    ownerPackage?: string;
 };
 /** Render feedback in the shell so it survives panel dismissal. */
 export declare function SkillsFeedback({ useStore, actions, t }: FeedbackProps): import("react").JSX.Element | null;
 /** Render the complete management page without exposing Cordis services to components. */
-export declare function SkillsPanel({ request, pickDirectory, t, actions, view }: PanelProps): import("react").JSX.Element | null;
+export declare function SkillsPanel({ request, pickDirectory, t, actions, view, ownerPackage }: PanelProps): import("react").JSX.Element | null;
+/** Show registry-owned instructions on their installed plugin's detail page. */
+export declare function PluginInstructionsPanel({ subject, ...props }: Omit<PanelProps, 'ownerPackage'> & PluginDetailProps): import("react").JSX.Element;
 export {};

package/lib/types/host/index.d.ts

@@ -8,14 +8,17 @@ export declare const inject: string[];
 export declare const Config: configSchema<Schemastery.ObjectS<NoInfer<{
     home: configSchema<string, string, "plain">;
     resources: configSchema<string, string, "plain">;
+    providerOwners: configSchema<import("@deepseek-ai/cosmokit").Dict<string, string>, import("@deepseek-ai/cosmokit").Dict<string, string>, "plain">;
 }>>, Schemastery.ObjectT<NoInfer<{
     home: configSchema<string, string, "plain">;
     resources: configSchema<string, string, "plain">;
+    providerOwners: configSchema<import("@deepseek-ai/cosmokit").Dict<string, string>, import("@deepseek-ai/cosmokit").Dict<string, string>, "plain">;
 }>>, "plain">;
 /** Configured storage and shipped resource roots; neither depends on an installation directory. */
 export interface Config {
     home?: string;
     resources?: string;
+    providerOwners?: Record<string, string>;
 }
 declare module '@deepseek-ai/cordis' {
     interface Context {
@@ -30,6 +33,7 @@ export declare class SkillsManagement extends TypertRemoteService {
     private catalog;
     private readonly root;
     private readonly resources;
+    private readonly providerOwners;
     private readonly ready;
     private policyControl?;
     private providerControl?;

package/lib/types/shared/types.d.ts

@@ -5,6 +5,8 @@ export interface ManagedSkill {
     description: string;
     source: string;
     provider: string;
+    kind: 'standalone' | 'plugin-instructions';
+    ownerPackage?: string;
     topic: string;
     enabled: boolean;
     effective: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerowall/dsh-plugin-skills",
-  "version": "0.1.0-preview.3",
+  "version": "0.1.0-preview.5",
   "description": "Curated scientific skills, imports and shared enablement management.",
   "type": "module",
   "main": "./lib/index.js",
@@ -111,6 +111,7 @@
   "files": [
     "lib",
     "resources",
+    "!resources/plugin-help/**",
     "locale",
     "plugin-detail.md",
     "plugin-detail.zh.md",

package/resources/plugin-instructions.json

@@ -0,0 +1,95 @@
+{
+  "description": "Usage guidance is maintained in the owning plugin. Legacy duplicate copies are excluded from this package; upstream notices remain in THIRD-PARTY-LICENSES.",
+  "retired": [
+    {
+      "name": "gpt-image-generator",
+      "owner": "@zerowall/dsh-imagecreate",
+      "sha256": "3a10dcf871a3f474510ae9864bbf8affcc89d4f1ab29682e5ae502c56680519e"
+    },
+    {
+      "name": "zerowall-aichem",
+      "owner": "@zerowall/dsh-plugin-mcp",
+      "sha256": "9edf74f36789a063e4fa4d441ffdd4ce680f15c9955d5768ee042ba1d25d9720"
+    },
+    {
+      "name": "zerowall-bio-tools",
+      "owner": "@zerowall/dsh-plugin-mcp",
+      "sha256": "8e51c1e6cb827b1e60ec361cab776cebb5ab433739a1b556a81bc8d4644b9b04"
+    },
+    {
+      "name": "zerowall-bio",
+      "owner": "@zerowall/dsh-plugin-mcp",
+      "sha256": "5434944ed89b2b1d0f4b8bd03d334568ff48d137947aeecd551d32972e76c662"
+    },
+    {
+      "name": "zerowall-ketcher",
+      "owner": "@zerowall/dsh-plugin-mcp",
+      "sha256": "eeb5c2b8b6971796e894517161e45df56e6cae48bc3fad06f55c245d2cea8941"
+    },
+    {
+      "name": "zerowall-mcp-guide",
+      "owner": "@zerowall/dsh-plugin-mcp",
+      "sha256": "1f28dfce6c62baf04e4f5167571c7c089c1857d87344c4b37e33667d9f563cb3"
+    },
+    {
+      "name": "zerowall-r-files",
+      "owner": "@zerowall/dsh-plugin-mcp",
+      "sha256": "040ec9e7a0ddac619c8c6b554466adaab9951ab98d2f2f6d62ec31d1e37aafcb"
+    },
+    {
+      "name": "zerowall-r-packages",
+      "owner": "@zerowall/dsh-plugin-mcp",
+      "sha256": "a5e7c26240426524fc3f98d06e31a70496fcf2f44503d79de822302a4d273bbe"
+    },
+    {
+      "name": "zerowall-rmcp",
+      "owner": "@zerowall/dsh-plugin-mcp",
+      "sha256": "07c14c0f8eaf3e812e24d5b24a3fa7b18d1289d6a96f2d436f9b86e6df0b8b31"
+    },
+    {
+      "name": "zerowall-rplatform",
+      "owner": "@zerowall/dsh-plugin-mcp",
+      "sha256": "2941173336aa825c4cb19ab7a5d84e92d66989449f69d31a01f7f4980612fa65"
+    },
+    {
+      "name": "zerowall-scimaster",
+      "owner": "@zerowall/dsh-plugin-mcp",
+      "sha256": "c8b0258310d68e1f53fb415b54bb1e9d8a06a5f5ff2e9e6dc36b0603f6c7cab0"
+    },
+    {
+      "name": "mineru-document-parser",
+      "owner": "@zerowall/dsh-plugin-mineru",
+      "sha256": "9e61b026b8cf143ca74b821202c20aad79552099b892570237e1a1b7576a7129"
+    },
+    {
+      "name": "local-env-setup",
+      "owner": "@zerowall/dsh-plugin-python",
+      "sha256": "eeb63cb779d1d9a845a6664f97dfe6a280535dbfb991bd3947da5c4d20755169"
+    },
+    {
+      "name": "zerowall-python-packages",
+      "owner": "@zerowall/dsh-plugin-python",
+      "sha256": "689555de7e5005ae1a264d6e62a1907ca0ad1a0c93279a6ae2110c9f44621c04"
+    },
+    {
+      "name": "zerowall-presentation",
+      "owner": "@zerowall/dsh-pptcreate",
+      "sha256": "a1ba96e3b4d2a15145be7bf5f7cb6088d559cfa4e0237e735f47c5b7f7f44086"
+    },
+    {
+      "name": "pubmed-literature",
+      "owner": "@zerowall/dsh-zotero",
+      "sha256": "e88992d1d8bc9aeb437d691d5a2775abb49c7337542fcc937ebac790f9f647bc"
+    },
+    {
+      "name": "pyzotero",
+      "owner": "@zerowall/dsh-zotero",
+      "sha256": "f0175f09556017723eb2fbe6ecb9cb1335ffd050d72cf43bf99c7846cd3f42da"
+    },
+    {
+      "name": "zerowall-spreadsheet",
+      "owner": "@deepseek-ai/dsh-skill-office",
+      "sha256": "268b3a8535f6028727b228ff9a89dc367fe4b2f06d00267fef60c0a2ea02d13e"
+    }
+  ]
+}

package/zerowall.plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerowall/dsh-plugin-skills",
-  "version": "0.1.0-preview.3",
+  "version": "0.1.0-preview.4",
   "host": "./lib/index.js",
   "client": "./lib/client.js",
   "remote": "./lib/typert.remote-client.js",