@zhin.js/core 1.0.50 → 1.0.52

package/lib/built/dispatcher.js

@@ -11,32 +11,52 @@
  *                  ▼
  *   ┌────────────────────────────────────────┐
  *   │  Stage 2: Route（路径判定）             │
- *   │  精确命令 → Command 快速路径            │
- *   │  其它消息 → AI Agent 路径               │
+ *   │  exclusive：命令与 AI 互斥（旧行为）     │
+ *   │  dual：命令与 AI 独立判定，可同时命中     │
  *   └──────────────┬─────────────────────────┘
  *                  ▼
  *   ┌────────────────────────────────────────┐
  *   │  Stage 3: Handle（处理）                │
  *   │  Command: commandService.handle()      │
  *   │  AI: aiHandler (由 AI 模块注册)         │
+ *   │  出站：replyWithPolish → $reply → Adapter.sendMessage → before.sendMessage │
  *   └────────────────────────────────────────┘
  *
  * 注意：Context key 为 'dispatcher'，避免与 HTTP 模块的 'router' 冲突。
+ *
+ * 默认路由为 exclusive（命令与 AI 互斥）；需双轨时请显式 dualRoute.mode: 'dual'。
  */
+import { AsyncLocalStorage } from 'node:async_hooks';
 import { getPlugin } from '../plugin.js';
+/** Dispatcher 管理的「会话回复」异步上下文，供 `before.sendMessage` 内读取（与 Adapter.renderSendMessage 同链） */
+const outboundReplyAls = new AsyncLocalStorage();
+export function getOutboundReplyStore() {
+    return outboundReplyAls.getStore();
+}
+const DUAL_ROUTE_DEFAULTS = {
+    mode: 'exclusive',
+    order: 'command-first',
+    allowDualReply: false,
+};
+function resolveDualRouteConfig(partial) {
+    return {
+        mode: partial?.mode ?? DUAL_ROUTE_DEFAULTS.mode,
+        order: partial?.order ?? DUAL_ROUTE_DEFAULTS.order,
+        allowDualReply: partial?.allowDualReply ?? DUAL_ROUTE_DEFAULTS.allowDualReply,
+    };
+}
 // ============================================================================
 // 实现
 // ============================================================================
-/**
- * 创建 MessageDispatcher Context
- */
-export function createMessageDispatcher() {
+export function createMessageDispatcher(options) {
     const guardrails = [];
+    /** mounted 前注册的润色，在 mounted 时挂到 root.before.sendMessage */
+    const pendingOutboundPolish = [];
     let aiHandler = null;
     let aiTriggerMatcher = null;
     let commandMatcher = null;
     let rootPlugin = null;
-    // Command prefix index — rebuilt lazily for O(1) lookup
+    let dualRoute = resolveDualRouteConfig(options?.dualRoute);
     let commandPrefixIndex = null;
     let lastCommandCount = -1;
     function rebuildCommandIndex() {
@@ -62,16 +82,15 @@ export function createMessageDispatcher() {
         }
         return commandPrefixIndex;
     }
-    /**
-     * Guardrail pipeline — a guardrail that does NOT call next() blocks the message.
-     */
     async function runGuardrails(message) {
         if (guardrails.length === 0)
             return true;
         for (const guardrail of guardrails) {
             let nextCalled = false;
             try {
-                await guardrail(message, async () => { nextCalled = true; });
+                await guardrail(message, async () => {
+                    nextCalled = true;
+                });
             }
             catch {
                 return false;
@@ -81,12 +100,42 @@ export function createMessageDispatcher() {
         }
         return true;
     }
-    function route(message) {
+    function extractText(message) {
+        if (!message.$content)
+            return '';
+        return message.$content
+            .map((seg) => {
+            if (typeof seg === 'string')
+                return seg;
+            if (seg.type === 'text')
+                return seg.data?.text || '';
+            return '';
+        })
+            .join('')
+            .trim();
+    }
+    function matchCommandInternal(message) {
+        const text = extractText(message);
+        if (commandMatcher && commandMatcher(text, message))
+            return true;
+        const index = getCommandIndex();
+        for (const [prefix] of index) {
+            if (text.startsWith(prefix))
+                return true;
+        }
+        return false;
+    }
+    function matchAIInternal(message) {
+        if (!aiTriggerMatcher)
+            return { triggered: false, content: '' };
+        return aiTriggerMatcher(message);
+    }
+    /** 互斥路由（与旧版 route 一致） */
+    function routeExclusive(message) {
         const text = extractText(message);
         if (commandMatcher && commandMatcher(text, message)) {
             return { type: 'command' };
         }
-        // Use indexed lookup instead of O(N) scan
         const index = getCommandIndex();
         for (const [prefix] of index) {
             if (text.startsWith(prefix)) {
@@ -101,62 +150,111 @@ export function createMessageDispatcher() {
         }
         return { type: 'skip' };
     }
-    function extractText(message) {
-        if (!message.$content)
-            return '';
-        return message.$content
-            .map((seg) => {
-            if (typeof seg === 'string')
-                return seg;
-            if (seg.type === 'text')
-                return seg.data?.text || '';
-            return '';
-        })
-            .join('')
-            .trim();
+    function wrapPolishAsBeforeSend(handler) {
+        return async (options) => {
+            const store = outboundReplyAls.getStore();
+            if (!store)
+                return;
+            const ctx = {
+                message: store.message,
+                content: options.content,
+                source: store.source,
+            };
+            const next = await handler(ctx);
+            if (next !== undefined)
+                return { ...options, content: next };
+        };
+    }
+    function flushPendingOutboundPolish() {
+        if (!rootPlugin)
+            return;
+        const root = rootPlugin.root;
+        for (const mw of pendingOutboundPolish) {
+            const fn = wrapPolishAsBeforeSend(mw);
+            root.on('before.sendMessage', fn);
+        }
+        pendingOutboundPolish.length = 0;
+    }
+    async function replyWithPolishInternal(message, source, content) {
+        if (!rootPlugin) {
+            return message.$reply(content);
+        }
+        return outboundReplyAls.run({ message, source }, () => message.$reply(content));
+    }
+    async function runCommandBranch(message) {
+        if (!rootPlugin)
+            return;
+        const commandService = rootPlugin.inject('command');
+        if (!commandService)
+            return;
+        const response = await commandService.handle(message, rootPlugin);
+        if (response) {
+            await replyWithPolishInternal(message, 'command', response);
+        }
+    }
+    async function runCustomMiddlewares(message) {
+        if (!rootPlugin)
+            return;
+        const customMiddlewares = rootPlugin._getCustomMiddlewares?.();
+        if (customMiddlewares && customMiddlewares.length > 0) {
+            const { compose } = await import('../utils.js');
+            const composed = compose(customMiddlewares);
+            await composed(message, async () => { });
+        }
     }
     const service = {
         async dispatch(message) {
-            // Stage 1: Guardrail
             const passed = await runGuardrails(message);
             if (!passed)
                 return;
-            // Stage 2: Route
-            const result = route(message);
-            // Stage 3: Handle
-            switch (result.type) {
-                case 'command': {
-                    if (rootPlugin) {
-                        const commandService = rootPlugin.inject('command');
-                        if (commandService) {
-                            const response = await commandService.handle(message, rootPlugin);
-                            if (response) {
-                                await message.$reply(response);
-                            }
-                        }
-                    }
-                    break;
+            const cfg = dualRoute;
+            if (cfg.mode === 'exclusive') {
+                const result = routeExclusive(message);
+                switch (result.type) {
+                    case 'command':
+                        await runCommandBranch(message);
+                        break;
+                    case 'ai':
+                        if (aiHandler)
+                            await aiHandler(message, result.content);
+                        break;
+                    default:
+                        break;
                 }
-                case 'ai': {
-                    if (aiHandler) {
-                        await aiHandler(message, result.content);
-                    }
-                    break;
-                }
-                case 'skip':
-                default:
-                    break;
+                await runCustomMiddlewares(message);
+                return;
             }
-            // Run legacy custom middlewares (skip the built-in command middleware at index 0).
-            // This ensures plugins that registered middlewares via addMiddleware() still work.
-            if (rootPlugin) {
-                const customMiddlewares = rootPlugin._getCustomMiddlewares?.();
-                if (customMiddlewares && customMiddlewares.length > 0) {
-                    const { compose } = await import('../utils.js');
-                    const composed = compose(customMiddlewares);
-                    await composed(message, async () => { });
-                }
+            // dual 模式
+            let wantCmd = matchCommandInternal(message);
+            const aiRes = matchAIInternal(message);
+            let wantAi = aiRes.triggered;
+            if (!wantCmd && !wantAi) {
+                await runCustomMiddlewares(message);
+                return;
+            }
+            if (!cfg.allowDualReply && wantCmd && wantAi) {
+                if (cfg.order === 'command-first')
+                    wantAi = false;
+                else
+                    wantCmd = false;
             }
+            const runCmd = async () => {
+                if (wantCmd)
+                    await runCommandBranch(message);
+            };
+            const runAi = async () => {
+                if (wantAi && aiHandler)
+                    await aiHandler(message, aiRes.content);
+            };
+            if (cfg.order === 'ai-first') {
+                await runAi();
+                await runCmd();
+            }
+            else {
+                await runCmd();
+                await runAi();
+            }
+            await runCustomMiddlewares(message);
         },
         addGuardrail(guardrail) {
             guardrails.push(guardrail);
@@ -178,6 +276,35 @@ export function createMessageDispatcher() {
         hasAIHandler() {
             return aiHandler !== null;
         },
+        setDualRouteConfig(config) {
+            dualRoute = resolveDualRouteConfig({ ...dualRoute, ...config });
+        },
+        getDualRouteConfig() {
+            return { ...dualRoute };
+        },
+        addOutboundPolish(handler) {
+            const fn = wrapPolishAsBeforeSend(handler);
+            if (rootPlugin) {
+                const root = rootPlugin.root;
+                root.on('before.sendMessage', fn);
+                return () => root.off('before.sendMessage', fn);
+            }
+            pendingOutboundPolish.push(handler);
+            return () => {
+                const i = pendingOutboundPolish.indexOf(handler);
+                if (i !== -1)
+                    pendingOutboundPolish.splice(i, 1);
+            };
+        },
+        replyWithPolish(message, source, content) {
+            return replyWithPolishInternal(message, source, content);
+        },
+        matchCommand(message) {
+            return matchCommandInternal(message);
+        },
+        matchAI(message) {
+            return matchAIInternal(message);
+        },
     };
     return {
         name: 'dispatcher',
@@ -185,6 +312,7 @@ export function createMessageDispatcher() {
         value: service,
         mounted(plugin) {
             rootPlugin = plugin.root;
+            flushPendingOutboundPolish();
             return service;
         },
         extensions: {
@@ -194,6 +322,12 @@ export function createMessageDispatcher() {
                 plugin.onDispose(dispose);
                 return dispose;
             },
+            addOutboundPolish(handler) {
+                const plugin = getPlugin();
+                const dispose = service.addOutboundPolish(handler);
+                plugin.onDispose(dispose);
+                return dispose;
+            },
         },
     };
 }

package/lib/built/dispatcher.js.map

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

package/lib/built/login-assist.d.ts

@@ -0,0 +1,61 @@
+/**
+ * LoginAssist — 登录辅助生产者-消费者
+ *
+ * 适配器在需要人为辅助登录时（扫码、短信、滑块等）作为生产者投递待办；
+ * Web 控制台、命令行等作为消费者拉取待办并提交结果。
+ * 待办未消费前会一直保留，刷新页面后仍可继续消费。
+ *
+ * 事件：
+ *   bot.login.pending — 有新待办时触发，payload: PendingLoginTask
+ */
+import type { Plugin } from '../plugin.js';
+export type LoginAssistType = 'qrcode' | 'sms' | 'slider' | 'device' | 'other';
+export interface PendingLoginTaskPayload {
+    /** 说明文案（如「请扫码登录」） */
+    message?: string;
+    /** 二维码图片 URL 或 base64（type=qrcode 时） */
+    image?: string;
+    /** 滑块验证 URL（type=slider 时） */
+    url?: string;
+    /** 其它扩展字段 */
+    [key: string]: unknown;
+}
+export interface PendingLoginTask {
+    id: string;
+    adapter: string;
+    botId: string;
+    type: LoginAssistType;
+    payload: PendingLoginTaskPayload;
+    createdAt: number;
+}
+export declare class LoginAssist {
+    private readonly plugin;
+    private readonly pending;
+    private idSeq;
+    constructor(plugin: Plugin);
+    /**
+     * 生产者：等待用户输入后 resolve。会发出 bot.login.pending 事件，未消费前可被 listPending 拉取（刷新后可继续消费）。
+     */
+    waitForInput(adapter: string, botId: string, type: LoginAssistType, payload?: PendingLoginTaskPayload): Promise<string | Record<string, unknown>>;
+    /**
+     * 消费者：提交结果，对应 waitForInput 的 Promise 会 resolve。
+     */
+    submit(id: string, value: string | Record<string, unknown>): boolean;
+    /**
+     * 消费者：取消某条待办，对应 Promise 会 reject。
+     */
+    cancel(id: string, reason?: string): boolean;
+    /**
+     * 列出未消费的待办（供 Web/CLI 展示，刷新后仍可拉取同一列表）。
+     */
+    listPending(): PendingLoginTask[];
+    dispose(): void;
+}
+declare module '../plugin.js' {
+    namespace Plugin {
+        interface Contexts {
+            loginAssist: LoginAssist;
+        }
+    }
+}
+//# sourceMappingURL=login-assist.d.ts.map

package/lib/built/login-assist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login-assist.d.ts","sourceRoot":"","sources":["../../src/built/login-assist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAM3C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,uBAAuB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAYD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,KAAK,CAAK;gBAEN,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACH,YAAY,CACV,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiB5C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAQpE;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,OAAO;IAQjD;;OAEG;IACH,WAAW,IAAI,gBAAgB,EAAE;IAIjC,OAAO,IAAI,IAAI;CAMhB;AAMD,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,MAAM,CAAC;QACf,UAAU,QAAQ;YAChB,WAAW,EAAE,WAAW,CAAC;SAC1B;KACF;CACF"}

package/lib/built/login-assist.js

@@ -0,0 +1,75 @@
+/**
+ * LoginAssist — 登录辅助生产者-消费者
+ *
+ * 适配器在需要人为辅助登录时（扫码、短信、滑块等）作为生产者投递待办；
+ * Web 控制台、命令行等作为消费者拉取待办并提交结果。
+ * 待办未消费前会一直保留，刷新页面后仍可继续消费。
+ *
+ * 事件：
+ *   bot.login.pending — 有新待办时触发，payload: PendingLoginTask
+ */
+// ============================================================================
+// LoginAssist 服务
+// ============================================================================
+export class LoginAssist {
+    plugin;
+    pending = new Map();
+    idSeq = 0;
+    constructor(plugin) {
+        this.plugin = plugin;
+    }
+    /**
+     * 生产者：等待用户输入后 resolve。会发出 bot.login.pending 事件，未消费前可被 listPending 拉取（刷新后可继续消费）。
+     */
+    waitForInput(adapter, botId, type, payload = {}) {
+        const id = `login-${Date.now()}-${++this.idSeq}`;
+        const task = {
+            id,
+            adapter,
+            botId,
+            type,
+            payload: { message: payload.message ?? '', ...payload },
+            createdAt: Date.now(),
+        };
+        const promise = new Promise((resolve, reject) => {
+            this.pending.set(id, { task, resolve, reject });
+            this.plugin.emit('bot.login.pending', task);
+        });
+        return promise;
+    }
+    /**
+     * 消费者：提交结果，对应 waitForInput 的 Promise 会 resolve。
+     */
+    submit(id, value) {
+        const entry = this.pending.get(id);
+        if (!entry)
+            return false;
+        this.pending.delete(id);
+        entry.resolve(value);
+        return true;
+    }
+    /**
+     * 消费者：取消某条待办，对应 Promise 会 reject。
+     */
+    cancel(id, reason = 'cancelled') {
+        const entry = this.pending.get(id);
+        if (!entry)
+            return false;
+        this.pending.delete(id);
+        entry.reject(new Error(reason));
+        return true;
+    }
+    /**
+     * 列出未消费的待办（供 Web/CLI 展示，刷新后仍可拉取同一列表）。
+     */
+    listPending() {
+        return [...this.pending.values()].map((e) => e.task);
+    }
+    dispose() {
+        for (const [, entry] of this.pending) {
+            entry.reject(new Error('LoginAssist disposed'));
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=login-assist.js.map

package/lib/built/login-assist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login-assist.js","sourceRoot":"","sources":["../../src/built/login-assist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoCH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,OAAO,WAAW;IACL,MAAM,CAAS;IACf,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IACnD,KAAK,GAAG,CAAC,CAAC;IAElB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,YAAY,CACV,OAAe,EACf,KAAa,EACb,IAAqB,EACrB,UAAmC,EAAE;QAErC,MAAM,EAAE,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACjD,MAAM,IAAI,GAAqB;YAC7B,EAAE;YACF,OAAO;YACP,KAAK;YACL,IAAI;YACJ,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE;YACvD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAmC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAChF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,KAAuC;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,MAAM,GAAG,WAAW;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,OAAO;QACL,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACrC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/lib/built/skill.d.ts

@@ -5,8 +5,7 @@
  *   Plugin = 运行时容器（生命周期、服务注册、中间件）
  *   Skill  = AI 可见的能力接口（名称、描述、工具列表）
  *
- * 每个 Plugin 可以声明一个 Skill 描述，告诉 AI Agent：
- *   "我叫什么、我能做什么、我有哪些工具"
+ * Skill 记录由运行时注入（如 Agent 从磁盘 SKILL.md 同步），供 Agent 粗筛与工具关联。
  *
  * SkillFeature 全局收集所有 Skill，供 Agent 进行两级过滤：
  *   1. 粗筛：根据用户消息选择相关 Skill
@@ -38,28 +37,18 @@ export interface Skill {
     pluginName: string;
 }
 /**
- * Skill 元数据 — 开发者在插件中声明
- * 由 plugin.declareSkill() 注册
+ * SKILL.md frontmatter 常见字段（类型提示；运行时由 Agent 等同步到 SkillFeature）
  */
 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;
         }
@@ -107,11 +96,5 @@ export declare class SkillFeature extends Feature<Skill> {
      * 序列化为 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

@@ -1 +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;MAgDvC;CACF"}
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/built/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,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;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;IAEpB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,MAAM,CAAC;QACf,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;CAgBzC"}

package/lib/built/skill.js

@@ -5,15 +5,13 @@
  *   Plugin = 运行时容器（生命周期、服务注册、中间件）
  *   Skill  = AI 可见的能力接口（名称、描述、工具列表）
  *
- * 每个 Plugin 可以声明一个 Skill 描述，告诉 AI Agent：
- *   "我叫什么、我能做什么、我有哪些工具"
+ * Skill 记录由运行时注入（如 Agent 从磁盘 SKILL.md 同步），供 Agent 粗筛与工具关联。
  *
  * SkillFeature 全局收集所有 Skill，供 Agent 进行两级过滤：
  *   1. 粗筛：根据用户消息选择相关 Skill
  *   2. 细筛：从选中 Skill 内选择具体 Tool
  */
 import { Feature } from '../feature.js';
-import { getPlugin } from '../plugin.js';
 // ============================================================================
 // SkillFeature 实现
 // ============================================================================
@@ -136,55 +134,5 @@ export class SkillFeature extends Feature {
             })),
         };
     }
-    /**
-     * 提供给 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