@zhin.js/core 1.0.25 → 1.0.27

package/lib/built/permission.js

@@ -1,9 +1,19 @@
-export class PermissionService extends Array {
+/**
+ * PermissionFeature
+ * 权限管理服务，继承自 Feature 抽象类
+ */
+import { Feature } from "../feature.js";
+import { getPlugin } from "../plugin.js";
+export class PermissionFeature extends Feature {
+    name = 'permission';
+    icon = 'Shield';
+    desc = '权限';
     constructor() {
         super();
+        // 注册默认权限检查器（使用 'built-in' 作为插件名）
         this.add(Permissions.define(/^adapter\([^)]+\)$/, (name, message) => {
             return message.$adapter === name.replace(/^adapter\(([^)]+)\)$/, '$1');
-        }));
+        }), '__built-in__');
         this.add(Permissions.define(/^group\([^)]+\)$/, (name, message) => {
             const match = name.match(/^group\(([^)]+)\)$/);
             if (!match)
@@ -14,7 +24,7 @@ export class PermissionService extends Array {
             if (id === '' || id === '*')
                 return true;
             return message.$channel.id === id;
-        }));
+        }), '__built-in__');
         this.add(Permissions.define(/^private\([^)]+\)$/, (name, message) => {
             const match = name.match(/^private\(([^)]+)\)$/);
             if (!match)
@@ -25,7 +35,7 @@ export class PermissionService extends Array {
             if (id === '' || id === '*')
                 return true;
             return message.$channel.id === id;
-        }));
+        }), '__built-in__');
         this.add(Permissions.define(/^channel\([^)]+\)$/, (name, message) => {
             const match = name.match(/^channel\(([^)]+)\)$/);
             if (!match)
@@ -36,26 +46,57 @@ export class PermissionService extends Array {
             if (id === '' || id === '*')
                 return true;
             return message.$channel.id === id;
-        }));
+        }), '__built-in__');
         this.add(Permissions.define(/^user\([^)]+\)$/, (name, message) => {
-            const match = name.match(/^channel\(([^)]+)\)$/);
+            const match = name.match(/^user\(([^)]+)\)$/);
             if (!match)
                 return false;
             const id = match[1];
             return message.$sender.id === id;
-        }));
-    }
-    add(permission) {
-        this.push(permission);
+        }), '__built-in__');
     }
+    /**
+     * 检查权限
+     */
     async check(name, message) {
-        for (const permission of this) {
+        for (const permission of this.items) {
             const passed = await permission.check(name, message);
             if (passed)
                 return true;
         }
         return false;
     }
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName) {
+        const list = pluginName ? this.getByPlugin(pluginName) : this.items;
+        return {
+            name: this.name,
+            icon: this.icon,
+            desc: this.desc,
+            count: list.length,
+            items: list.map(p => ({
+                name: p.name instanceof RegExp ? p.name.source : p.name,
+            })),
+        };
+    }
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions() {
+        const feature = this;
+        return {
+            addPermission(permission) {
+                const plugin = getPlugin();
+                const dispose = feature.add(permission, plugin.name);
+                const permName = permission.name instanceof RegExp ? permission.name.source : permission.name;
+                plugin.recordFeatureContribution(feature.name, permName);
+                plugin.onDispose(dispose);
+                return dispose;
+            },
+        };
+    }
 }
 export var Permissions;
 (function (Permissions) {
@@ -64,4 +105,8 @@ export var Permissions;
     }
     Permissions.define = define;
 })(Permissions || (Permissions = {}));
+/**
+ * @deprecated Use PermissionFeature instead
+ */
+export const PermissionService = PermissionFeature;
 //# sourceMappingURL=permission.js.map

package/lib/built/permission.js.map

@@ -1 +1 @@
-{"version":3,"file":"permission.js","sourceRoot":"","sources":["../../src/built/permission.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../../src/built/permission.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAe,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA8BzC,MAAM,OAAO,iBAAkB,SAAQ,OAAuB;IACnD,IAAI,GAAG,YAAqB,CAAC;IAC7B,IAAI,GAAG,QAAQ,CAAC;IAChB,IAAI,GAAG,IAAI,CAAC;IAErB;QACE,KAAK,EAAE,CAAC;QACR,iCAAiC;QACjC,IAAI,CAAC,GAAG,CACN,WAAW,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACzD,OAAO,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;QACzE,CAAC,CAAC,EACF,cAAc,CACf,CAAC;QACF,IAAI,CAAC,GAAG,CACN,WAAW,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC/C,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;YACpD,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YACzC,OAAO,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC,CAAC,EACF,cAAc,CACf,CAAC;QACF,IAAI,CAAC,GAAG,CACN,WAAW,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACtD,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YACzC,OAAO,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC,CAAC,EACF,cAAc,CACf,CAAC;QACF,IAAI,CAAC,GAAG,CACN,WAAW,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACtD,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YACzC,OAAO,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC,CAAC,EACF,cAAc,CACf,CAAC;QACF,IAAI,CAAC,GAAG,CACN,WAAW,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAC9C,IAAI,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACpB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC,CAAC,EACF,cAAc,CACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAwD;QAChF,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACrD,IAAI,MAAM;gBAAE,OAAO,IAAI,CAAC;QAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAmB;QACxB,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI,YAAY,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;aACxD,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC;QACrB,OAAO;YACL,aAAa,CAAC,UAA0B;gBACtC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrD,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,YAAY,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC9F,MAAM,CAAC,yBAAyB,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACzD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC1B,OAAO,OAAO,CAAC;YACjB,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,KAAW,WAAW,CAO3B;AAPD,WAAiB,WAAW;IAC1B,SAAgB,MAAM,CACpB,IAAqB,EACrB,KAA2B;QAE3B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IALe,kBAAM,SAKrB,CAAA;AACH,CAAC,EAPgB,WAAW,KAAX,WAAW,QAO3B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC"}

package/lib/built/skill.d.ts

@@ -0,0 +1,117 @@
+/**
+ * SkillFeature — AI 可见能力描述层
+ *
+ * 核心概念：
+ *   Plugin = 运行时容器（生命周期、服务注册、中间件）
+ *   Skill  = AI 可见的能力接口（名称、描述、工具列表）
+ *
+ * 每个 Plugin 可以声明一个 Skill 描述，告诉 AI Agent：
+ *   "我叫什么、我能做什么、我有哪些工具"
+ *
+ * SkillFeature 全局收集所有 Skill，供 Agent 进行两级过滤：
+ *   1. 粗筛：根据用户消息选择相关 Skill
+ *   2. 细筛：从选中 Skill 内选择具体 Tool
+ */
+import { Feature, FeatureJSON } from '../feature.js';
+import type { Tool } from '../types.js';
+/**
+ * Skill — AI 可见的能力描述
+ */
+export interface Skill {
+    /** 技能名称（通常与插件名一致） */
+    name: string;
+    /** 技能描述（AI 用来理解这个 Skill 的用途） */
+    description: string;
+    /** 该 Skill 提供的工具列表 */
+    tools: Tool[];
+    /**
+     * 触发关键词
+     * 当用户消息包含这些关键词时，优先选择此 Skill
+     */
+    keywords?: string[];
+    /**
+     * 分类标签
+     * 用于按领域分组（如 'news', 'weather', 'entertainment'）
+     */
+    tags?: string[];
+    /** 来源插件名 */
+    pluginName: string;
+}
+/**
+ * Skill 元数据 — 开发者在插件中声明
+ * 由 plugin.declareSkill() 注册
+ */
+export interface SkillMetadata {
+    /** 技能描述（必填） */
+    description: string;
+    /** 触发关键词（可选，自动从工具中聚合） */
+    keywords?: string[];
+    /** 分类标签（可选） */
+    tags?: string[];
+}
+export interface SkillContextExtensions {
+    /**
+     * 声明本插件的 Skill 元数据
+     * 调用后，插件的工具会自动聚合为一个 Skill 注册到 SkillFeature
+     */
+    declareSkill(metadata: SkillMetadata): void;
+}
+declare module '../plugin.js' {
+    namespace Plugin {
+        interface Extensions extends SkillContextExtensions {
+        }
+        interface Contexts {
+            skill: SkillFeature;
+        }
+    }
+}
+export declare class SkillFeature extends Feature<Skill> {
+    #private;
+    readonly name: "skill";
+    readonly icon = "Brain";
+    readonly desc = "\u6280\u80FD";
+    /** 按名称索引 */
+    readonly byName: Map<string, Skill>;
+    /**
+     * 添加 Skill
+     */
+    add(skill: Skill, pluginName: string): () => void;
+    /**
+     * 移除 Skill
+     */
+    remove(skill: Skill): boolean;
+    /**
+     * 按名称获取 Skill
+     */
+    get(name: string): Skill | undefined;
+    /**
+     * 获取所有已注册 Skill
+     */
+    getAll(): Skill[];
+    /**
+     * 按关键词/标签搜索相关 Skill
+     * 返回按相关性排序的 Skill 列表
+     */
+    search(query: string, options?: {
+        maxResults?: number;
+    }): Skill[];
+    /**
+     * 获取所有 Skill 的工具（扁平化）
+     */
+    collectAllTools(): Tool[];
+    /**
+     * 已注册 Skill 数量
+     */
+    get size(): number;
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName?: string): FeatureJSON;
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions(): {
+        declareSkill(metadata: SkillMetadata): void;
+    };
+}
+//# sourceMappingURL=skill.d.ts.map

package/lib/built/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/built/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAMxC;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,KAAK,EAAE,IAAI,EAAE,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;IAEpB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CAC7C;AAED,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,MAAM,CAAC;QACf,UAAU,UAAW,SAAQ,sBAAsB;SAAG;QACtD,UAAU,QAAQ;YAChB,KAAK,EAAE,YAAY,CAAC;SACrB;KACF;CACF;AAMD,qBAAa,YAAa,SAAQ,OAAO,CAAC,KAAK,CAAC;;IAC9C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,IAAI,kBAAQ;IAErB,YAAY;IACZ,QAAQ,CAAC,MAAM,qBAA4B;IAE3C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI;IAKjD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAK7B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC;;OAEG;IACH,MAAM,IAAI,KAAK,EAAE;IAIjB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,EAAE;IAWjE;;OAEG;IACH,eAAe,IAAI,IAAI,EAAE;IAQzB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IA0CD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;IAiBxC;;OAEG;IACH,IAAI,UAAU;+BAGa,aAAa;MAiDvC;CACF"}

package/lib/built/skill.js

@@ -0,0 +1,191 @@
+/**
+ * SkillFeature — AI 可见能力描述层
+ *
+ * 核心概念：
+ *   Plugin = 运行时容器（生命周期、服务注册、中间件）
+ *   Skill  = AI 可见的能力接口（名称、描述、工具列表）
+ *
+ * 每个 Plugin 可以声明一个 Skill 描述，告诉 AI Agent：
+ *   "我叫什么、我能做什么、我有哪些工具"
+ *
+ * SkillFeature 全局收集所有 Skill，供 Agent 进行两级过滤：
+ *   1. 粗筛：根据用户消息选择相关 Skill
+ *   2. 细筛：从选中 Skill 内选择具体 Tool
+ */
+import { Feature } from '../feature.js';
+import { getPlugin } from '../plugin.js';
+// ============================================================================
+// SkillFeature 实现
+// ============================================================================
+export class SkillFeature extends Feature {
+    name = 'skill';
+    icon = 'Brain';
+    desc = '技能';
+    /** 按名称索引 */
+    byName = new Map();
+    /**
+     * 添加 Skill
+     */
+    add(skill, pluginName) {
+        this.byName.set(skill.name, skill);
+        return super.add(skill, pluginName);
+    }
+    /**
+     * 移除 Skill
+     */
+    remove(skill) {
+        this.byName.delete(skill.name);
+        return super.remove(skill);
+    }
+    /**
+     * 按名称获取 Skill
+     */
+    get(name) {
+        return this.byName.get(name);
+    }
+    /**
+     * 获取所有已注册 Skill
+     */
+    getAll() {
+        return [...this.items];
+    }
+    /**
+     * 按关键词/标签搜索相关 Skill
+     * 返回按相关性排序的 Skill 列表
+     */
+    search(query, options) {
+        const maxResults = options?.maxResults ?? 5;
+        const scored = this.items
+            .map(skill => ({ skill, score: this.#scoreSkill(skill, query) }))
+            .filter(({ score }) => score > 0)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, maxResults);
+        return scored.map(({ skill }) => skill);
+    }
+    /**
+     * 获取所有 Skill 的工具（扁平化）
+     */
+    collectAllTools() {
+        const tools = [];
+        for (const skill of this.items) {
+            tools.push(...skill.tools);
+        }
+        return tools;
+    }
+    /**
+     * 已注册 Skill 数量
+     */
+    get size() {
+        return this.items.length;
+    }
+    /**
+     * 简单的关键词匹配评分
+     */
+    #scoreSkill(skill, query) {
+        const lowerQuery = query.toLowerCase();
+        let score = 0;
+        // 关键词精确匹配
+        if (skill.keywords) {
+            for (const kw of skill.keywords) {
+                if (lowerQuery.includes(kw.toLowerCase()))
+                    score += 1.0;
+            }
+        }
+        // 标签匹配
+        if (skill.tags) {
+            for (const tag of skill.tags) {
+                if (lowerQuery.includes(tag.toLowerCase()))
+                    score += 0.5;
+            }
+        }
+        // 名称匹配
+        if (lowerQuery.includes(skill.name.toLowerCase()))
+            score += 0.3;
+        // 描述匹配（双向）
+        const lowerDesc = skill.description.toLowerCase();
+        if (lowerDesc.includes(lowerQuery))
+            score += 0.2;
+        if (lowerQuery.includes(lowerDesc))
+            score += 0.15;
+        // 工具名/描述匹配
+        for (const tool of skill.tools) {
+            if (lowerQuery.includes(tool.name.toLowerCase()))
+                score += 0.4;
+            if (tool.description && lowerQuery.includes(tool.description.toLowerCase().slice(0, 10))) {
+                score += 0.1;
+            }
+        }
+        return score;
+    }
+    /**
+     * 序列化为 JSON
+     */
+    toJSON(pluginName) {
+        const list = pluginName ? this.getByPlugin(pluginName) : this.items;
+        return {
+            name: this.name,
+            icon: this.icon,
+            desc: this.desc,
+            count: list.length,
+            items: list.map(s => ({
+                name: s.name,
+                desc: s.description,
+                toolCount: s.tools.length,
+                keywords: s.keywords,
+                tags: s.tags,
+            })),
+        };
+    }
+    /**
+     * 提供给 Plugin.prototype 的扩展方法
+     */
+    get extensions() {
+        const feature = this;
+        return {
+            declareSkill(metadata) {
+                const plugin = getPlugin();
+                const pluginName = plugin.name;
+                // 收集该插件注册的工具
+                const toolService = plugin.root.inject('tool');
+                let tools = [];
+                if (toolService && typeof toolService.getToolsByPlugin === 'function') {
+                    tools = toolService.getToolsByPlugin(pluginName);
+                }
+                else {
+                    // 回退：从插件本地工具获取
+                    tools = plugin.getAllTools?.() || [];
+                }
+                // 聚合关键词：开发者声明 + 工具自带
+                const allKeywords = new Set(metadata.keywords || []);
+                for (const tool of tools) {
+                    if (tool.keywords) {
+                        for (const kw of tool.keywords) {
+                            allKeywords.add(kw);
+                        }
+                    }
+                }
+                // 聚合标签
+                const allTags = new Set(metadata.tags || []);
+                for (const tool of tools) {
+                    if (tool.tags) {
+                        for (const tag of tool.tags) {
+                            allTags.add(tag);
+                        }
+                    }
+                }
+                const skill = {
+                    name: pluginName,
+                    description: metadata.description,
+                    tools,
+                    keywords: Array.from(allKeywords),
+                    tags: Array.from(allTags),
+                    pluginName,
+                };
+                const dispose = feature.add(skill, pluginName);
+                plugin.recordFeatureContribution(feature.name, pluginName);
+                plugin.onDispose(dispose);
+            },
+        };
+    }
+}
+//# sourceMappingURL=skill.js.map

package/lib/built/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/built/skill.ts"],"names":[],"mappings":"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"}