@zhin.js/core 1.1.26 → 1.1.28

package/lib/message-quote.js

@@ -0,0 +1,91 @@
+const MAX_RAW_QUOTE_SCAN = 64_000;
+function replySegmentId(seg) {
+    if (seg.type !== 'reply' || !seg.data || typeof seg.data !== 'object')
+        return undefined;
+    const data = seg.data;
+    const raw = data.message_id ?? data.id;
+    if (raw == null)
+        return undefined;
+    const id = String(raw).trim();
+    return id || undefined;
+}
+/** 从 segments 解析首个 reply 的 ID */
+export function quoteIdFromContent(content) {
+    if (!content?.length)
+        return undefined;
+    for (const seg of content) {
+        const id = replySegmentId(seg);
+        if (id)
+            return id;
+    }
+    return undefined;
+}
+function extractBracketTag(raw, tag) {
+    const open = `[${tag}:`;
+    const idx = raw.toLowerCase().indexOf(open.toLowerCase());
+    if (idx === -1)
+        return undefined;
+    const close = raw.indexOf(']', idx + open.length);
+    if (close === -1)
+        return undefined;
+    const id = raw.slice(idx + open.length, close).trim();
+    return id || undefined;
+}
+function extractCqReplyId(raw) {
+    const marker = '[cq:reply';
+    const lower = raw.toLowerCase();
+    let search = 0;
+    while (search < raw.length) {
+        const idx = lower.indexOf(marker, search);
+        if (idx === -1)
+            return undefined;
+        const close = raw.indexOf(']', idx);
+        if (close === -1)
+            return undefined;
+        const segment = raw.slice(idx, close + 1);
+        const idIdx = segment.toLowerCase().indexOf('id=');
+        if (idIdx !== -1) {
+            let start = idIdx + 3;
+            while (start < segment.length && /[,\s]/.test(segment[start]))
+                start++;
+            let end = start;
+            while (end < segment.length && segment[end] !== ',' && segment[end] !== ']' && segment[end] !== '&') {
+                end++;
+            }
+            const id = segment.slice(start, end).trim();
+            if (id)
+                return id;
+        }
+        search = close + 1;
+    }
+    return undefined;
+}
+/** icqq raw_message / OneBot CQ 中的 reply id（$content 未含 reply 段时兜底） */
+export function quoteIdFromRaw(raw) {
+    if (typeof raw !== 'string' || !raw.trim())
+        return undefined;
+    const text = raw.length > MAX_RAW_QUOTE_SCAN ? raw.slice(0, MAX_RAW_QUOTE_SCAN) : raw;
+    return extractBracketTag(text, 'reply') ?? extractCqReplyId(text);
+}
+/** 无 $quote_id 时从 $content / $raw 回填 */
+export function syncQuoteId(message) {
+    if (message.$quote_id)
+        return;
+    const id = quoteIdFromContent(message.$content) ?? quoteIdFromRaw(message.$raw);
+    if (id)
+        message.$quote_id = id;
+}
+/** 将 reply 段的 id / message_id 与 $quote_id 对齐 */
+export function alignReplySegments(content, quoteId) {
+    const id = quoteId ?? quoteIdFromContent(content);
+    if (!id)
+        return;
+    for (const seg of content) {
+        if (seg.type !== 'reply' || !seg.data || typeof seg.data !== 'object')
+            continue;
+        const data = seg.data;
+        data.id = id;
+        data.message_id = id;
+    }
+}
+//# sourceMappingURL=message-quote.js.map

package/lib/message-quote.js.map

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

package/lib/message.d.ts

@@ -35,6 +35,8 @@ export interface MessageBase {
     $channel: MessageChannel;
     $timestamp: number;
     $raw: string;
+    /** 本条消息引用的上游 message_id（平台原样字符串） */
+    $quote_id?: string;
 }
 /**
  * 完整消息类型，支持扩展
@@ -45,5 +47,8 @@ export declare namespace Message {
      * 工具方法：合并自定义字段与基础消息结构
      */
     function from<T extends object>(input: T, format: MessageBase): Message<T>;
+    function quoteIdFromContent(content: MessageElement[]): string | undefined;
+    function syncQuoteId(message: Message<any>): void;
+    function alignReplySegments(content: MessageElement[], quoteId?: string): void;
 }
 //# sourceMappingURL=message.d.ts.map

package/lib/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAE,aAAa,EAAE,WAAW,EAAC,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAE;IAC3C,IAAI,EAAC,SAAS,CAAC,CAAC,GAAC;QAAC,QAAQ,CAAC,EAAC,WAAW,GAAC,OAAO,CAAC,WAAW,CAAC,CAAA;KAAC,CAAC,CAAA;IAC9D,IAAI,EAAC,CAAC,CAAA;CACT,CAAA;AACD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;CACrB;AACD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;AACzD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAC,MAAM,QAAQ,CAAA;IACvB,IAAI,EAAC,MAAM,CAAA;IACX,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,OAAO,EAAC,WAAW,EAAC,KAAK,CAAC,EAAC,OAAO,GAAC,MAAM,GAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACjE,OAAO,IAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB;AACD;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,GAAC,EAAE,IAAE,WAAW,GAAC,CAAC,CAAC;AACvD,yBAAiB,OAAO,CAAA;IACpB;;OAEG;IACH,SAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAC,CAAC,EAAC,MAAM,EAAC,WAAW,GAAE,OAAO,CAAC,CAAC,CAAC,CAE5E;CACJ"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAE,aAAa,EAAE,WAAW,EAAC,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAMxC;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAE;IAC3C,IAAI,EAAC,SAAS,CAAC,CAAC,GAAC;QAAC,QAAQ,CAAC,EAAC,WAAW,GAAC,OAAO,CAAC,WAAW,CAAC,CAAA;KAAC,CAAC,CAAA;IAC9D,IAAI,EAAC,CAAC,CAAA;CACT,CAAA;AACD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;CACrB;AACD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;AACzD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAC,MAAM,QAAQ,CAAA;IACvB,IAAI,EAAC,MAAM,CAAA;IACX,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,OAAO,EAAC,WAAW,EAAC,KAAK,CAAC,EAAC,OAAO,GAAC,MAAM,GAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACjE,OAAO,IAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AACD;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,GAAC,EAAE,IAAE,WAAW,GAAC,CAAC,CAAC;AACvD,yBAAiB,OAAO,CAAA;IACpB;;OAEG;IACH,SAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAC,CAAC,EAAC,MAAM,EAAC,WAAW,GAAE,OAAO,CAAC,CAAC,CAAC,CAE5E;IAED,SAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,GAAG,SAAS,CAEhF;IAED,SAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAEvD;IAED,SAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAEpF;CACJ"}

package/lib/message.js

@@ -1,3 +1,4 @@
+import { alignReplySegments as alignReplySegmentsImpl, quoteIdFromContent as quoteIdFromContentImpl, syncQuoteId as syncQuoteIdImpl, } from "./message-quote.js";
 export var Message;
 (function (Message) {
     /**
@@ -7,5 +8,17 @@ export var Message;
         return Object.assign(input, format);
     }
     Message.from = from;
+    function quoteIdFromContent(content) {
+        return quoteIdFromContentImpl(content);
+    }
+    Message.quoteIdFromContent = quoteIdFromContent;
+    function syncQuoteId(message) {
+        syncQuoteIdImpl(message);
+    }
+    Message.syncQuoteId = syncQuoteId;
+    function alignReplySegments(content, quoteId) {
+        alignReplySegmentsImpl(content, quoteId);
+    }
+    Message.alignReplySegments = alignReplySegments;
 })(Message || (Message = {}));
 //# sourceMappingURL=message.js.map

package/lib/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAwCA,MAAM,KAAW,OAAO,CAOvB;AAPD,WAAiB,OAAO;IACpB;;OAEG;IACH,SAAgB,IAAI,CAAmB,KAAO,EAAC,MAAkB;QAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAC,MAAM,CAAC,CAAA;IACtC,CAAC;IAFe,YAAI,OAEnB,CAAA;AACL,CAAC,EAPgB,OAAO,KAAP,OAAO,QAOvB"}
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,IAAI,sBAAsB,EAC5C,kBAAkB,IAAI,sBAAsB,EAC5C,WAAW,IAAI,eAAe,GAC/B,MAAM,oBAAoB,CAAC;AAwC5B,MAAM,KAAW,OAAO,CAmBvB;AAnBD,WAAiB,OAAO;IACpB;;OAEG;IACH,SAAgB,IAAI,CAAmB,KAAO,EAAC,MAAkB;QAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAC,MAAM,CAAC,CAAA;IACtC,CAAC;IAFe,YAAI,OAEnB,CAAA;IAED,SAAgB,kBAAkB,CAAC,OAAyB;QACxD,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAFe,0BAAkB,qBAEjC,CAAA;IAED,SAAgB,WAAW,CAAC,OAAqB;QAC7C,eAAe,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAFe,mBAAW,cAE1B,CAAA;IAED,SAAgB,kBAAkB,CAAC,OAAyB,EAAE,OAAgB;QAC1E,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAFe,0BAAkB,qBAEjC,CAAA;AACL,CAAC,EAnBgB,OAAO,KAAP,OAAO,QAmBvB"}

package/lib/plugin.d.ts

@@ -1,14 +1,17 @@
 /**
- * Plugin 类 - 基于 zhinjs/next 的 Hooks 实现
- * 移除 Dependency 继承，使用 AsyncLocalStorage 管理上下文
+ * Plugin 类 — IM 特化插件，继承 PluginBase
+ *
+ * 在 PluginBase 的 DI/生命周期/事件基础上增加：
+ * - Context 类型安全（Plugin.Contexts 映射）
+ * - 生命周期事件类型安全（Plugin.Lifecycle）
+ * - 中间件系统、适配器管理、useContext 等
  */
 import { AsyncLocalStorage } from "node:async_hooks";
-import { EventEmitter } from "node:events";
 import type { PluginManifest } from "./types.js";
-import { Logger } from "@zhin.js/logger";
 import { MessageMiddleware, RegisteredAdapter, MaybePromise, ArrayItem, SendOptions } from "./types.js";
-import { Adapters } from "./adapter.js";
-import { Feature } from "./feature.js";
+import { Adapter, Adapters } from "./adapter.js";
+import { PluginBase, PluginBaseLifecycle } from "@zhin.js/kernel";
+import type { PluginLike } from "@zhin.js/kernel";
 declare const contextsKey: unique symbol;
 export type SideEffect<A extends (keyof Plugin.Contexts)[]> = {
     (...args: ContextList<A>): MaybePromise<void | DisposeFn<ContextList<A>>>;
@@ -30,28 +33,37 @@ export declare function usePlugin(): Plugin;
  */
 export declare function getPlugin(): Plugin;
 export interface Plugin extends Plugin.Extensions {
+    on<K extends keyof Plugin.Lifecycle>(name: K, listener: (...args: Plugin.Lifecycle[K]) => void): this;
+    on(name: string | symbol, listener: (...args: any[]) => void): this;
+    off<K extends keyof Plugin.Lifecycle>(name: K, listener: (...args: Plugin.Lifecycle[K]) => void): this;
+    off(name: string | symbol, listener: (...args: any[]) => void): this;
+    once<K extends keyof Plugin.Lifecycle>(name: K, listener: (...args: Plugin.Lifecycle[K]) => void): this;
+    once(name: string | symbol, listener: (...args: any[]) => void): this;
+    emit<K extends keyof Plugin.Lifecycle>(name: K, ...args: Plugin.Lifecycle[K]): boolean;
+    emit(name: string | symbol, ...args: any[]): boolean;
 }
 /**
- * Plugin 类 - 核心插件系统
- * 直接继承 EventEmitter
+ * Plugin 类 - IM 特化插件，继承 PluginBase
+ *
+ * 类型窄化：
+ * - children: Plugin[] (而非 PluginBase[])
+ * - parent: Plugin | undefined
+ * - root: Plugin
+ * - $contexts: Map<string, Context<any>>
+ * - dispatch/broadcast: Plugin.Lifecycle 类型安全
  */
-export declare class Plugin extends EventEmitter<Plugin.Lifecycle> {
+export declare class Plugin extends PluginBase implements PluginLike {
     #private;
-    parent?: Plugin | undefined;
     static [contextsKey]: string[];
     adapters: (keyof Plugin.Contexts)[];
     started: boolean;
-    $contexts: Map<string, Context<any>>;
-    children: Plugin[];
-    filePath: string;
-    fileHash: string;
-    logger: Logger;
+    get root(): Plugin;
     get middleware(): MessageMiddleware<RegisteredAdapter>;
     recordFeatureContribution(featureName: string, itemName: string): void;
     /**
      * 构造函数
      */
-    constructor(filePath?: string, parent?: Plugin | undefined);
+    constructor(filePath?: string, parent?: Plugin);
     /**
      * 添加中间件
      * 中间件用于处理消息流转
@@ -66,13 +78,12 @@ export declare class Plugin extends EventEmitter<Plugin.Lifecycle> {
      */
     get manifest(): PluginManifest | undefined;
     /**
-     * 根插件
+     * 上下文收集 — 使用类型窄化的 inject 替代直接 Map 访问
      */
-    get root(): Plugin;
-    get contexts(): Map<string, Context>;
     useContext<T extends (keyof Plugin.Contexts)[]>(...args: [...T, SideEffect<T>]): void;
     inject<T extends keyof Plugin.Contexts>(name: T): Plugin.Contexts[T] | undefined;
     inject(name: string): unknown;
+    injectAdapter(name: string): Adapter | undefined;
     contextIsReady<T extends keyof Plugin.Contexts>(name: T): boolean;
     /**
      * 启动插件
@@ -99,30 +110,29 @@ export declare class Plugin extends EventEmitter<Plugin.Lifecycle> {
     onMounted(callback: () => void | Promise<void>): void;
     onDispose(callback: () => void | Promise<void>): () => void;
     /**
-     * dispatch - 向上冒泡到父插件，或在根节点广播
+     * dispatch - 向上冒泡到父插件，或者在根节点广播（类型安全版本）
      */
     dispatch<K extends keyof Plugin.Lifecycle>(name: K, ...args: Plugin.Lifecycle[K]): Promise<void>;
     /**
-     * broadcast - 向下广播到所有子插件
+     * broadcast - 向下广播到所有子插件（类型安全版本）
      */
     broadcast<K extends keyof Plugin.Lifecycle>(name: K, ...args: Plugin.Lifecycle[K]): Promise<void>;
     /**
-     * 注册上下文
+     * 注册上下文（类型安全版本）
      */
-    provide<T extends keyof Plugin.Contexts>(context: Context<T>): this;
-    provide(feature: Feature<unknown>): this;
+    provide(target: any): this;
     /**
-     * 导入插件
+     * 导入插件（Plugin 类型窄化版本）
      */
     import(entry: string, t?: number): Promise<Plugin>;
     /**
-     * 重载插件
+     * 重载插件（Plugin 类型窄化版本）
      */
-    reload(plugin?: Plugin): Promise<void>;
+    reload(plugin?: PluginBase): Promise<void>;
     /**
-     * 监听文件变化
+     * 监听文件变化（Plugin 类型窄化版本）
      */
-    watch(callback: (p: Plugin) => void | Promise<void>, recursive?: boolean): void;
+    watch(callback: (p: PluginBase) => void | Promise<void>, recursive?: boolean): void;
     /**
      * 自动绑定核心方法（只在构造函数中调用一次）
      */
@@ -154,22 +164,78 @@ export declare namespace Plugin {
     }
     /**
      * 生命周期事件
+     *
+     * 必须包含索引签名以满足 PluginBaseLifecycle 结构子类型约束。
      */
-    interface Lifecycle {
-        mounted: [];
-        dispose: [];
-        "before-start": [Plugin];
-        started: [Plugin];
+    interface Lifecycle extends PluginBaseLifecycle {
         "before-mount": [Plugin];
         "before-dispose": [Plugin];
-        "call.recallMessage": [string, string, string];
-        'before.sendMessage': [SendOptions];
         "context.mounted": [keyof Plugin.Contexts];
         "context.dispose": [keyof Plugin.Contexts];
+        "call.recallMessage": [string, string, string];
+        'before.sendMessage': [SendOptions];
         "message.receive": [any];
         "bot.login.pending": [import('./built/login-assist.js').PendingLoginTask];
         "request.receive": [any];
         "notice.receive": [any];
+        "ai.processing.start": [Plugin.AIEventPayload];
+        "ai.processing.finish": [Plugin.AIEventPayload];
+        "ai.processing.error": [Plugin.AIEventPayload];
+        "ai.agent.start": [Plugin.AIEventPayload];
+        "ai.agent.finish": [Plugin.AIEventPayload];
+        "ai.thinking": [Plugin.AIEventPayload];
+        "ai.tool.call": [Plugin.AIEventPayload];
+        "ai.tool.result": [Plugin.AIEventPayload];
+        "ai.response": [Plugin.AIEventPayload];
+        "ai.typing.start": [Plugin.AIEventPayload];
+        "ai.typing.stop": [Plugin.AIEventPayload];
+        "ai.subagent.spawn": [Plugin.AIEventPayload];
+        "ai.subagent.start": [Plugin.AIEventPayload];
+        "ai.subagent.finish": [Plugin.AIEventPayload];
+        "ai.deferred.start": [Plugin.AIEventPayload];
+        "ai.deferred.finish": [Plugin.AIEventPayload];
+        "ai.mcp.connect.start": [Plugin.AIEventPayload];
+        "ai.mcp.connect.finish": [Plugin.AIEventPayload];
+        "ai.mcp.connect.error": [Plugin.AIEventPayload];
+        "ai.session.new": [Plugin.AIEventPayload];
+        "ai.session.compact": [Plugin.AIEventPayload];
+        "ai.hook": [Plugin.AIEventPayload];
+    }
+    interface AIEventPayload {
+        sessionId: string;
+        source: 'zhin-agent' | 'ai-hook' | 'orchestrator-hook';
+        mode?: 'text' | 'multimodal';
+        path?: 'chat' | 'fast' | 'agent' | 'multimodal' | 'rate_limited';
+        userId?: string;
+        platform?: string;
+        botId?: string;
+        sceneId?: string;
+        messageId?: string;
+        scope?: string;
+        content?: string;
+        reply?: string;
+        thinking?: string;
+        toolName?: string;
+        args?: Record<string, unknown>;
+        result?: unknown;
+        error?: string;
+        model?: string;
+        iterations?: number;
+        reason?: string;
+        taskId?: string;
+        label?: string;
+        status?: 'ok' | 'partial' | 'error';
+        serverName?: string;
+        loadedToolNames?: string[];
+        hookType?: string;
+        hookAction?: string;
+        hookContext?: Record<string, unknown>;
+        messages?: string[];
+        agentId?: string;
+        compactedCount?: number;
+        savedTokens?: number;
+        totalTokensBefore?: number;
+        totalTokensAfter?: number;
     }
     /**
      * 服务类型扩展点

package/lib/plugin.d.ts.map

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

package/lib/plugin.js

@@ -1,22 +1,21 @@
 /**
- * Plugin 类 - 基于 zhinjs/next 的 Hooks 实现
- * 移除 Dependency 继承，使用 AsyncLocalStorage 管理上下文
+ * Plugin 类 — IM 特化插件，继承 PluginBase
+ *
+ * 在 PluginBase 的 DI/生命周期/事件基础上增加：
+ * - Context 类型安全（Plugin.Contexts 映射）
+ * - 生命周期事件类型安全（Plugin.Lifecycle）
+ * - 中间件系统、适配器管理、useContext 等
  */
 import { AsyncLocalStorage } from "node:async_hooks";
-import { EventEmitter } from "node:events";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import logger, { formatCompact } from "@zhin.js/logger";
+import { formatCompact } from "@zhin.js/logger";
 import { compose, remove, resolveEntry } from "./utils.js";
 import { Adapter } from "./adapter.js";
-import { Feature } from "./feature.js";
-import { resolvePluginResolveDir as _resolvePluginResolveDir, pluginCreateRequire as _pluginCreateRequire, getFileHash, watchFile, registerExtension, unregisterExtensions, installExtensionProxy, } from "@zhin.js/kernel";
+import { Feature } from "@zhin.js/kernel";
+import { PluginBase, resolvePluginResolveDir as _resolvePluginResolveDir, pluginCreateRequire as _pluginCreateRequire, getFileHash, watchFile, registerExtension, unregisterExtensions, installExtensionProxy, } from "@zhin.js/kernel";
 const contextsKey = Symbol("contexts");
-function runtimeCwd() {
-    const g = globalThis;
-    return g.Deno?.cwd?.() ?? process.cwd();
-}
 function resolvePluginResolveDir(parent) {
     return _resolvePluginResolveDir(parent);
 }
@@ -33,7 +32,7 @@ export const storage = new AsyncLocalStorage();
  */
 function getCurrentFile(metaUrl = import.meta.url) {
     if (typeof metaUrl !== "string" || metaUrl.length === 0) {
-        return path.join(runtimeCwd(), "__zhin_edge_bootstrap__.mjs");
+        return path.join(process.cwd(), "__zhin_edge_bootstrap__.mjs");
     }
     const previousPrepareStackTrace = Error.prepareStackTrace;
     Error.prepareStackTrace = function (_, stack) {
@@ -45,7 +44,7 @@ function getCurrentFile(metaUrl = import.meta.url) {
     const idx = stackFiles.findIndex((f) => f === fileURLToPath(metaUrl) || f === metaUrl);
     const result = stackFiles[idx + 1];
     if (!result) {
-        return path.join(runtimeCwd(), "__zhin_edge_bootstrap__.mjs");
+        return path.join(process.cwd(), "__zhin_edge_bootstrap__.mjs");
     }
     try {
         return fileURLToPath(result);
@@ -88,25 +87,26 @@ export function getPlugin() {
     return plugin;
 }
 /**
- * Plugin 类 - 核心插件系统
- * 直接继承 EventEmitter
+ * Plugin 类 - IM 特化插件，继承 PluginBase
+ *
+ * 类型窄化：
+ * - children: Plugin[] (而非 PluginBase[])
+ * - parent: Plugin | undefined
+ * - root: Plugin
+ * - $contexts: Map<string, Context<any>>
+ * - dispatch/broadcast: Plugin.Lifecycle 类型安全
  */
-export class Plugin extends EventEmitter {
-    parent;
+export class Plugin extends PluginBase {
     static [contextsKey] = [];
     #cachedName;
     #manifest;
     adapters = [];
-    started = false;
-    // 上下文存储
-    $contexts = new Map();
-    // 子插件
-    children = [];
-    // 文件信息
-    filePath;
-    fileHash = "";
-    // Logger
-    logger;
+    // children/parent 继承 PluginBase 的类型（PluginBase[] / PluginBase | undefined），
+    // 具体的 Plugin 类型通过 getter/builder 方法按需窄化
+    get root() {
+        return super.root;
+    }
+    // 插件功能
     #messageMiddleware = async (message, next) => {
         const commandService = this.inject('command');
         if (!commandService)
@@ -119,7 +119,6 @@ export class Plugin extends EventEmitter {
             return await next();
         await message.$reply(result);
     };
-    // 插件功能
     #middlewares = [this.#messageMiddleware];
     // Feature 贡献追踪
     #featureContributions = new Map();
@@ -138,17 +137,10 @@ export class Plugin extends EventEmitter {
      * 构造函数
      */
     constructor(filePath = "", parent) {
-        super();
-        this.parent = parent;
-        // 增加 EventEmitter 监听器限制，避免警告
-        // 因为插件可能注册多个命令/组件/中间件，每个都会添加 dispose 监听器
-        this.setMaxListeners(50);
-        this.filePath = filePath.replace(/\?t=\d+$/, "");
-        this.logger = this.name ? logger.getLogger(this.name) : logger;
-        // 自动添加到父节点
-        if (parent && !parent.children.includes(this)) {
-            parent.children.push(this);
-        }
+        super(filePath, parent);
+        // 自动添加到父节点 — PluginBase constructor 已处理，
+        // 但 PluginBase 使用 PluginBase[]，这里需要确保正确
+        // （super 已调用 parent.children.push(this)，类型已通过 declare 窄化）
         // 绑定方法以支持解构使用
         this.$bindMethods();
     }
@@ -233,26 +225,10 @@ export class Plugin extends EventEmitter {
         this.#manifest = null;
         return undefined;
     }
+    // 根插件类型窄化已在 interface Plugin 声明
     /**
-     * 根插件
+     * 上下文收集 — 使用类型窄化的 inject 替代直接 Map 访问
      */
-    get root() {
-        if (!this.parent)
-            return this;
-        return this.parent.root;
-    }
-    get contexts() {
-        const result = new Map();
-        for (const [key, value] of this.$contexts) {
-            result.set(key, value);
-        }
-        for (const child of this.children) {
-            for (const [key, value] of child.contexts) {
-                result.set(key, value);
-            }
-        }
-        return result;
-    }
     useContext(...args) {
         const contexts = args.slice(0, -1);
         const sideEffect = args[args.length - 1];
@@ -295,6 +271,10 @@ export class Plugin extends EventEmitter {
         const context = this.root.contexts.get(name);
         return context?.value;
     }
+    injectAdapter(name) {
+        const value = this.inject(name);
+        return value instanceof Adapter ? value : undefined;
+    }
     #contextsIsReady(contexts) {
         if (!contexts.length)
             return true;
@@ -459,7 +439,7 @@ export class Plugin extends EventEmitter {
             }
         }
         this.#disposables.clear();
-        // 清理 middlewares 数组（保留默认的消息中间件）
+        // 清空 middlewares 数组（保留默认的消息中间件）
         this.#middlewares.length = 1;
         // 清理 feature 贡献记录
         this.#featureContributions.clear();
@@ -495,7 +475,7 @@ export class Plugin extends EventEmitter {
     // 事件广播
     // ============================================================================
     /**
-     * dispatch - 向上冒泡到父插件，或在根节点广播
+     * dispatch - 向上冒泡到父插件，或者在根节点广播（类型安全版本）
      */
     async dispatch(name, ...args) {
         if (this.parent) {
@@ -504,7 +484,7 @@ export class Plugin extends EventEmitter {
         return this.broadcast(name, ...args);
     }
     /**
-     * broadcast - 向下广播到所有子插件
+     * broadcast - 向下广播到所有子插件（类型安全版本）
      */
     async broadcast(name, ...args) {
         const listeners = this.listeners(name);
@@ -520,6 +500,12 @@ export class Plugin extends EventEmitter {
             await child.broadcast(name, ...args);
         }
     }
+    // ============================================================================
+    // 依赖注入
+    // ============================================================================
+    /**
+     * 注册上下文（类型安全版本）
+     */
     provide(target) {
         if (target instanceof Feature) {
             const feature = target;
@@ -561,7 +547,7 @@ export class Plugin extends EventEmitter {
     // 插件加载
     // ============================================================================
     /**
-     * 导入插件
+     * 导入插件（Plugin 类型窄化版本）
      */
     async import(entry, t) {
         if (!entry)
@@ -594,25 +580,26 @@ export class Plugin extends EventEmitter {
         return plugin;
     }
     /**
-     * 重载插件
+     * 重载插件（Plugin 类型窄化版本）
      */
     async reload(plugin = this) {
-        this.logger.info(formatCompact({ name: plugin.name, reload: true }));
+        const p = plugin;
+        this.logger.info(formatCompact({ name: p.name, reload: true }));
         const now = Date.now();
-        if (!plugin.parent) {
+        if (!p.parent) {
             // 根插件重载 = 退出进程（由 CLI 重启）
             return process.exit(51);
         }
-        const entry = plugin.filePath;
-        const parent = plugin.parent;
-        await plugin.stop();
+        const entry = p.filePath;
+        const parent = p.parent;
+        await p.stop();
         let fresh;
         try {
             fresh = await parent.import(entry, now);
         }
         catch (err) {
             this.logger.error(formatCompact({
-                name: plugin.name,
+                name: p.name,
                 reload: false,
                 error: err instanceof Error ? err.message : String(err),
                 hint: 'full_restart',
@@ -623,7 +610,7 @@ export class Plugin extends EventEmitter {
         this.logger.debug(formatCompact({ name: fresh.name, reload_ms: Date.now() - now }));
     }
     /**
-     * 监听文件变化
+     * 监听文件变化（Plugin 类型窄化版本）
      */
     watch(callback, recursive = false) {
         if (!this.filePath || this.filePath.includes("node_modules"))