@zhin.js/core 1.5.2 → 1.5.4

package/lib/plugin-runtime/im/message-dispatcher.js

@@ -12,12 +12,10 @@ export const defaultCommandPrefixResolver = (message, snapshot) => {
     const config = snapshot.config.get(ownerOfMessage(message));
     if (!config)
         return '';
-    const endpointName = typeof message.metadata?.endpoint === 'string'
-        ? message.metadata.endpoint
-        : undefined;
-    if (endpointName && Array.isArray(config.endpoints)) {
+    const endpointId = message.endpointId;
+    if (endpointId && Array.isArray(config.endpoints)) {
         const entry = config.endpoints.find((item) => !!item && typeof item === 'object'
-            && item.name === endpointName);
+            && item.id === endpointId);
         if (typeof entry?.commandPrefix === 'string')
             return entry.commandPrefix;
     }
@@ -31,79 +29,35 @@ export class MessageDispatcher {
     async dispatch(message, snapshot) {
         const prefix = this.resolvePrefix(message, snapshot);
         let input = message.content.trim();
-        logger.debug(formatCompact({
-            op: 'command_dispatch_start',
-            adapter: ownerOfMessage(message),
-            endpoint: typeof message.metadata?.endpoint === 'string'
-                ? message.metadata.endpoint
-                : undefined,
-            prefix: prefix || '(none)',
-            preview: truncatePreview(input),
-            segments: summarizeSegmentTypes(message.segments),
-        }));
-        if (prefix) {
-            if (!input.startsWith(prefix)) {
-                logger.debug(formatCompact({
-                    op: 'command_dispatch_miss',
-                    reason: 'prefix_miss',
-                    prefix,
-                    preview: truncatePreview(input),
-                }));
-                return Object.freeze({ matched: false });
-            }
-            input = input.slice(prefix.length).trim();
-        }
-        if (!input) {
-            logger.debug(formatCompact({
-                op: 'command_dispatch_miss',
-                reason: 'empty_after_prefix',
-                prefix: prefix || '(none)',
-            }));
+        if (prefix && !input.startsWith(prefix)) {
             return Object.freeze({ matched: false });
         }
+        if (prefix)
+            input = input.slice(prefix.length).trim();
+        if (!input)
+            return Object.freeze({ matched: false });
         const commands = snapshot.projections.get(commandFeatureId);
-        if (!isCommandIndex(commands)) {
-            logger.debug(formatCompact({
-                op: 'command_dispatch_miss',
-                reason: 'no_command_index',
-            }));
+        if (!isCommandIndex(commands))
             return Object.freeze({ matched: false });
-        }
         const structuredInput = message.segments
             ? stripCommandPrefix(message.segments, prefix)
             : undefined;
-        if (message.segments && structuredInput === undefined) {
-            logger.debug(formatCompact({
-                op: 'command_dispatch_fallback_text',
-                reason: 'strip_prefix_failed',
-                prefix: prefix || '(none)',
-                segments: summarizeSegmentTypes(message.segments),
-            }));
-        }
         const matchInput = structuredInput ?? input;
-        logger.debug(formatCompact({
-            op: 'command_dispatch_match_input',
-            mode: typeof matchInput === 'string' ? 'text' : 'segments',
-            preview: typeof matchInput === 'string'
-                ? truncatePreview(matchInput)
-                : summarizeSegmentTypes(matchInput),
-        }));
         const result = await commands.dispatch(matchInput, message);
         if (result.matched && result.value !== undefined) {
             if (!result.owner)
                 throw new Error('Matched Command is missing its owner');
             logger.debug(formatCompact({
-                op: 'command_dispatch_hit',
+                op: 'dispatch_hit',
                 command: result.command,
                 owner: result.owner,
             }));
             await message.$replyFrom(result.owner, result.value);
         }
-        else {
+        else if (!result.matched) {
             logger.debug(formatCompact({
-                op: 'command_dispatch_miss',
-                reason: result.matched ? 'empty_value' : 'no_match',
-                command: result.command,
+                op: 'dispatch_miss',
+                preview: truncatePreview(input),
             }));
         }
         return result;
@@ -151,17 +105,3 @@ function stripCommandPrefix(segments, prefix) {
     }
     return pendingPrefix ? undefined : result;
 }
-function summarizeSegmentTypes(segments) {
-    if (!segments?.length)
-        return undefined;
-    return segments
-        .map((segment) => {
-        if (typeof segment.type === 'string')
-            return segment.type;
-        if (segment.type && typeof segment.type === 'object' && 'name' in segment.type) {
-            return String(segment.type.name);
-        }
-        return '?';
-    })
-        .join(',');
-}

package/lib/plugin-runtime/im/outbound-renderer.d.ts

@@ -1,6 +1,7 @@
 import type { PluginId, RuntimeSnapshot } from '@zhin.js/plugin-runtime';
-import { type SendContent } from './contracts.js';
+import type { ConversationRef } from '@zhin.js/im-contract';
+import { type IncomingContext, type SendContent } from './contracts.js';
 export declare class OutboundRenderer {
     #private;
-    render(content: SendContent, requester: PluginId, snapshot: RuntimeSnapshot): Promise<unknown>;
+    render(content: SendContent, requester: PluginId, snapshot: RuntimeSnapshot, conversation?: ConversationRef, incoming?: IncomingContext): Promise<unknown>;
 }

package/lib/plugin-runtime/im/outbound-renderer.js

@@ -1,30 +1,66 @@
+import { componentHostToken } from '@zhin.js/plugin-runtime';
 import { componentFeatureId, isComponentIndex, } from '@zhin.js/component';
 import { isComponentCall, isRawContent, isSegmentContent, } from './contracts.js';
 const maxComponentDepth = 32;
+const TEMPLATE_MARKER = '${';
 export class OutboundRenderer {
-    async render(content, requester, snapshot) {
-        return this.#render(content, requester, snapshot, 0);
+    async render(content, requester, snapshot, conversation, incoming) {
+        const host = resolveComponentHost(snapshot);
+        const ctx = conversation ? buildTemplateContext(conversation, incoming) : undefined;
+        return this.#render(content, requester, snapshot, host, ctx, 0);
     }
-    async #render(content, requester, snapshot, depth) {
+    async #render(content, requester, snapshot, host, ctx, depth) {
         if (depth > maxComponentDepth)
             throw new Error('Component render depth exceeded 32');
         if (typeof content === 'string')
-            return content;
+            return compileText(content, host, ctx);
         if (Array.isArray(content)) {
-            return Promise.all(content.map((item) => this.#render(item, requester, snapshot, depth)));
+            return Promise.all(content.map((item) => this.#render(item, requester, snapshot, host, ctx, depth)));
         }
         if (isRawContent(content))
             return content.payload;
-        // canonical Segment 一等公民：原样透传，由下游 normalizeOutboundPayload 归一与协商
-        if (isSegmentContent(content))
+        if (isSegmentContent(content)) {
+            if (content.type === 'text') {
+                const text = content.data?.text;
+                if (typeof text === 'string' && text.includes(TEMPLATE_MARKER) && host && ctx) {
+                    return { ...content, data: { ...content.data, text: host.compileTemplate(text, ctx) } };
+                }
+            }
             return content;
+        }
         if (isComponentCall(content)) {
             const rendered = await requireComponents(snapshot).render(requester, content.name, content.props);
-            return this.#render(rendered, requester, snapshot, depth + 1);
+            return this.#render(rendered, requester, snapshot, host, ctx, depth + 1);
         }
         throw new TypeError('Unsupported SendContent');
     }
 }
+function compileText(text, host, ctx) {
+    if (!host || !ctx || !text.includes(TEMPLATE_MARKER))
+        return text;
+    return host.compileTemplate(text, ctx);
+}
+function buildTemplateContext(conversation, incoming) {
+    return {
+        adapter: conversation.endpoint.adapter,
+        endpoint: conversation.endpoint.id,
+        kind: conversation.kind,
+        conversationId: conversation.id,
+        sender: incoming?.sender,
+        content: incoming?.content,
+        segments: incoming?.segments,
+        messageId: incoming?.messageId,
+        timestamp: incoming?.timestamp,
+        endpointId: incoming?.endpointId,
+        mentioned: incoming?.mentioned,
+    };
+}
+function resolveComponentHost(snapshot) {
+    const host = snapshot.resources.get(snapshot.root)?.get(componentHostToken.id);
+    return host && typeof host.compileTemplate === 'function'
+        ? host
+        : undefined;
+}
 function requireComponents(snapshot) {
     const projection = snapshot.projections.get(componentFeatureId);
     if (!isComponentIndex(projection)) {

package/lib/plugin-runtime/im/service-tokens.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Core service tokens — typed Token 替代 legacy string-based inject('x')。
+ *
+ * Slice 2：Token 指向当前 Feature 实例（双写窗口）。
+ * Slice 4：Feature 删除后，Token 类型改为 Runtime projection 接口。
+ */
+import type { CommandFeature } from '../../built/command.js';
+import type { ComponentFeature } from '../../built/component.js';
+import type { ScheduleFeature } from '../../built/schedule.js';
+import type { ConfigFeature } from '../../built/config.js';
+import type { SchemaFeature } from '../../built/schema-feature.js';
+import type { MessageDispatcherService } from '../../built/dispatcher.js';
+export declare const commandServiceToken: import("@zhin.js/plugin-runtime").Token<CommandFeature>;
+export declare const componentServiceToken: import("@zhin.js/plugin-runtime").Token<ComponentFeature>;
+export declare const schedulerServiceToken: import("@zhin.js/plugin-runtime").Token<ScheduleFeature>;
+export declare const configServiceToken: import("@zhin.js/plugin-runtime").Token<ConfigFeature>;
+export declare const schemaServiceToken: import("@zhin.js/plugin-runtime").Token<SchemaFeature>;
+export declare const dispatcherServiceToken: import("@zhin.js/plugin-runtime").Token<MessageDispatcherService>;

package/lib/plugin-runtime/im/service-tokens.js

@@ -0,0 +1,13 @@
+/**
+ * Core service tokens — typed Token 替代 legacy string-based inject('x')。
+ *
+ * Slice 2：Token 指向当前 Feature 实例（双写窗口）。
+ * Slice 4：Feature 删除后，Token 类型改为 Runtime projection 接口。
+ */
+import { createToken } from '@zhin.js/plugin-runtime';
+export const commandServiceToken = createToken('zhin.im.command-service');
+export const componentServiceToken = createToken('zhin.im.component-service');
+export const schedulerServiceToken = createToken('zhin.im.scheduler-service');
+export const configServiceToken = createToken('zhin.im.config-service');
+export const schemaServiceToken = createToken('zhin.im.schema-service');
+export const dispatcherServiceToken = createToken('zhin.im.dispatcher-service');

package/lib/plugin.d.ts

@@ -10,7 +10,7 @@ import { MessageMiddleware, RegisteredAdapter, MaybePromise, ArrayItem, SendOpti
 import type { InteractiveHandler } from "./built/interactive-segments/types.js";
 import { Adapter, Adapters } from "./adapter.js";
 import { PluginBase, PluginBaseLifecycle, type PluginLike } from '@zhin.js/kernel';
-export { getPlugin } from "./plugin-context.js";
+export { getPlugin, markPluginRuntimeActive, isPluginRuntimeActive, resetPluginRuntimeFlag } from "./plugin-context.js";
 export { storage, getCurrentFile } from "./plugin-context.js";
 export { setHostRootPlugin, getHostRootPlugin } from "./host-plugin-registry.js";
 declare const contextsKey: unique symbol;
@@ -22,11 +22,8 @@ export type DisposeFn<A> = (context: ArrayItem<A>) => MaybePromise<void>;
 export type ContextList<CS extends (keyof Plugin.Contexts)[]> = CS extends [infer L, ...infer R] ? R extends (keyof Plugin.Contexts)[] ? [ContextItem<L>, ...ContextList<R>] : never[] : never[];
 type ContextItem<L> = L extends keyof Plugin.Contexts ? Plugin.Contexts[L] : never;
 /**
- * 获取当前插件实例（经典 AsyncLocalStorage 路径）。
- * 同一上下文中同一文件多次调用返回同一实例。
- *
- * @deprecated 仅 `zhin.js/node`（`bootstrapNode`）可用；`zhin runtime start` 下不工作。
- * 新插件请用 `definePlugin` + 约定目录。见 `docs/contributing/public-api-surface.md`。
+ * @deprecated **已删除**。请使用 `definePlugin` + 约定目录（`zhin runtime start`）。
+ * @throws 总是抛出——仅保留签名供编译期过渡。
  */
 export declare function usePlugin(): Plugin;
 export interface Plugin extends Plugin.Extensions {
@@ -223,7 +220,7 @@ export declare namespace Plugin {
         path?: 'chat' | 'fast' | 'agent' | 'multimodal' | 'rate_limited';
         userId?: string;
         platform?: string;
-        endpointId?: string;
+        endpointKey?: string;
         sceneId?: string;
         messageId?: string;
         scope?: string;

package/lib/plugin.js

@@ -14,9 +14,8 @@ import { compose, remove, resolveEntry } from "./utils.js";
 import { ensureInteractiveMiddleware, registerInteractiveHandler as registerInteractiveHandlerCore, } from "./built/interactive-segments/handlers.js";
 import { Adapter } from "./adapter.js";
 import { Feature, PluginBase, resolvePluginResolveDir as _resolvePluginResolveDir, pluginCreateRequire as _pluginCreateRequire, getFileHash, watchFile, registerExtension, unregisterExtensions, installExtensionProxy } from '@zhin.js/kernel';
-import { storage, getCurrentFile } from "./plugin-context.js";
-// Re-export getPlugin from plugin-context for backward compatibility
-export { getPlugin } from "./plugin-context.js";
+import { storage } from "./plugin-context.js";
+export { getPlugin, markPluginRuntimeActive, isPluginRuntimeActive, resetPluginRuntimeFlag } from "./plugin-context.js";
 export { storage, getCurrentFile } from "./plugin-context.js";
 export { setHostRootPlugin, getHostRootPlugin } from "./host-plugin-registry.js";
 const contextsKey = Symbol("contexts");
@@ -27,34 +26,13 @@ const loadedModules = new Map();
 function pluginCreateRequire() {
     return _pluginCreateRequire();
 }
-// ============================================================================
-// usePlugin — 获取或创建当前插件实例
-// ============================================================================
 /**
- * 获取当前插件实例（经典 AsyncLocalStorage 路径）。
- * 同一上下文中同一文件多次调用返回同一实例。
- *
- * @deprecated 仅 `zhin.js/node`（`bootstrapNode`）可用；`zhin runtime start` 下不工作。
- * 新插件请用 `definePlugin` + 约定目录。见 `docs/contributing/public-api-surface.md`。
+ * @deprecated **已删除**。请使用 `definePlugin` + 约定目录（`zhin runtime start`）。
+ * @throws 总是抛出——仅保留签名供编译期过渡。
  */
 export function usePlugin() {
-    // 必须传入 plugin.ts 的 import.meta.url：getCurrentFile 默认锚定在 plugin-context.ts，
-    // 否则会多跳一层 usePlugin 帧，把调用方误判为 plugin.ts（plugin.name === "plugin"）。
-    const callerFile = getCurrentFile(import.meta.url);
-    // 如果当前 store 已是同一文件创建的插件，直接返回
-    const current = storage.getStore();
-    if (current && current.filePath.replace(/\?t=\d+$/, '') === callerFile.replace(/\?t=\d+$/, '')) {
-        return current;
-    }
-    const parentPlugin = current;
-    const newPlugin = new Plugin(callerFile, parentPlugin);
-    try {
-        storage.enterWith(newPlugin);
-    }
-    catch {
-        // Cloudflare Workers 等环境未实现 enterWith；调用方须用 storage.run()
-    }
-    return newPlugin;
+    throw new Error('usePlugin() has been removed. Use `definePlugin` + convention directories instead. '
+        + 'See docs/contributing/public-api-surface.md');
 }
 /**
  * Plugin 类 - IM 特化插件，继承 PluginBase
@@ -210,10 +188,9 @@ export class Plugin extends PluginBase {
                 sideEffect.finished = false;
             };
             this.on('context.dispose', disposeFn);
-            // 确保 dispose 时清理监听器（只注册一次）
             const cleanupOnDispose = () => {
                 this.off('context.dispose', disposeFn);
-                dispose(this.inject(args[0]));
+                dispose(this.inject(contexts[0]));
             };
             this.once('dispose', cleanupOnDispose);
         };

package/lib/request.d.ts

@@ -2,7 +2,7 @@ import type { MaybePromise } from './types.js';
 import type { Adapters } from './adapter.js';
 import type { RequestKind } from './side-event/types.js';
 import type { SideEventBase } from './side-event/base.js';
-export type { RequestKind, ComposedRequestName, RequestType } from './side-event/types.js';
+export type { RequestKind, ComposedRequestName } from './side-event/types.js';
 /**
  * 请求基础结构 — 继承 SideEventBase，附加审批方法。
  *
@@ -11,7 +11,7 @@ export type { RequestKind, ComposedRequestName, RequestType } from './side-event
  * const request = Request.from(rawEvent, {
  *   $id: rawEvent.flag,
  *   $adapter: 'icqq',
- *   $endpoint: endpointId,
+ *   $endpoint: endpointKey,
  *   $type: 'request',
  *   $scene_id: groupId,
  *   $scene_type: 'group',

package/lib/side-event/types.d.ts

@@ -9,10 +9,6 @@ export type RequestKind = 'request';
 /** 完整组合名（测试 / 文档 / 消费者匹配用） */
 export type ComposedNoticeName = 'notice.group.member_increase' | 'notice.group.member_decrease' | 'notice.group.admin_change' | 'notice.group.ban' | 'notice.group.recall' | 'notice.group.poke' | 'notice.group.transfer' | 'notice.group.upload' | 'notice.group.emoji_reaction' | 'notice.group.card_change' | 'notice.group.essence_add' | 'notice.group.essence_delete' | 'notice.friend.recall' | 'notice.friend.increase' | 'notice.friend.poke' | 'notice.endpoint.lifecycle' | (string & {});
 export type ComposedRequestName = 'request.friend.add' | 'request.group.add' | 'request.group.invite' | (string & {});
-/** @deprecated 使用 ComposedNoticeName + formatSideEventName */
-export type NoticeType = ComposedNoticeName;
-/** @deprecated 使用 ComposedRequestName + formatSideEventName */
-export type RequestType = ComposedRequestName;
 export interface SideEventParts {
     scene_type: string;
     sub_type: string;

package/lib/types.d.ts

@@ -1,4 +1,4 @@
-import { MessageChannel, Message, MessageComponent } from './message.js';
+import type { MessageChannel, Message, MessageComponent } from './message.js';
 import { Adapter, Adapters } from './adapter.js';
 import { Endpoint } from './endpoint.js';
 import { SystemLog } from './models/system-log.js';
@@ -85,9 +85,6 @@ export interface EditMessageOptions {
     type: 'private' | 'group' | 'channel';
     content: SendContent;
 }
-export interface EditableEndpoint {
-    $editMessage?(options: EditMessageOptions): Promise<void>;
-}
 /** 出站回复来源（指令 / AI / proactive），仅当经 MessageDispatcher.replyWithPolish 或 runWithOutboundPolish 发出时由框架填入异步上下文 */
 export type OutboundReplySource = 'command' | 'ai' | 'proactive';
 export type OutboundReplyTrigger = 'inbound' | 'proactive';
@@ -125,7 +122,7 @@ export interface MessageSender {
 /**
  * 通用字典类型
  */
-export type Dict<V = any, K extends string | symbol = string> = Record<K, V>;
+export type { Dict } from '@zhin.js/kernel';
 /**
  * 用户信息结构
  */
@@ -180,7 +177,7 @@ export type BeforeSendHandler = (options: SendOptions) => MaybePromise<SendOptio
  * JSON Schema 定义，用于描述工具参数
  */
 /** Message 通讯上下文上可经 resolveContextKey 自动注入的字段名 */
-export type ContextInjectableKey = 'platform' | 'endpointId' | 'sceneId' | 'senderId' | 'scope';
+export type ContextInjectableKey = 'platform' | 'endpointKey' | 'sceneId' | 'senderId' | 'scope';
 export interface ToolJsonSchema {
     type: string;
     properties?: Record<string, ToolJsonSchema & {
@@ -195,7 +192,7 @@ export interface ToolJsonSchema {
     /**
      * 自动从 Message 通讯上下文注入的字段名（经 resolveContextKey 映射 $ 字段）。
      * 设置后该参数对 AI 隐藏，执行时自动从上下文填充。
-     * 例如: contextKey: 'endpointId' → 执行时自动填入 message.$endpoint
+     * 例如: contextKey: 'endpointKey' → 执行时自动填入 message.$endpoint
      */
     contextKey?: ContextInjectableKey;
     [key: string]: any;
@@ -340,6 +337,8 @@ export interface Tool<TArgs extends Record<string, any> = Record<string, any>> {
      * 执行此工具需要的权限列表
      */
     permissions?: string[];
+    /** Per-tool approval policy; `on-risk` remains fail-closed at Agent boundaries. */
+    approval?: 'always' | 'once' | 'never' | 'on-risk';
     /**
      * 支持的平台列表
      * 例如：['qq', 'telegram', 'discord']
@@ -372,10 +371,6 @@ export interface Tool<TArgs extends Record<string, any> = Record<string, any>> {
      */
     command?: ToolCommandConfig | false;
 }
-/**
- * @deprecated 使用 `Tool<TArgs>` 替代。Tool 已原生支持泛型。
- */
-export type ToolDefinition<TArgs extends Record<string, any> = Record<string, any>> = Tool<TArgs>;
 export declare namespace Tool {
     /**
      * 参数信息

package/lib/utils.js

@@ -4,6 +4,8 @@
  * Generic utilities are re-exported from @zhin.js/kernel.
  * IM-specific utilities (compose, segment) remain here.
  */
+import { getLogger } from '@zhin.js/logger';
+const logger = getLogger('Middleware');
 // ── Re-export generic utils from kernel ──
 export { evaluate, execute, clearEvalCache, getEvalCacheStats, getValueWithRuntime, compiler, remove, isEmpty, Time, supportedPluginExtensions, resolveEntry, sleep, } from '@zhin.js/kernel';
 import { formatSegmentPreview } from "./built/segment-contract/preview.js";
@@ -39,7 +41,7 @@ export function compose(middlewares) {
                 return await fn(message, () => dispatch(i + 1));
             }
             catch (error) {
-                console.error("Middleware error:", error);
+                logger.error("Middleware error:", error);
                 throw error;
             }
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/core",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "Zhin机器人核心框架",
   "type": "module",
   "main": "./lib/index.js",
@@ -70,16 +70,17 @@
     "segment-matcher": "^1.0.5",
     "smol-toml": "^1.7.1",
     "yaml": "^2.9.0",
-    "@zhin.js/adapter": "1.1.5",
-    "@zhin.js/command": "1.0.7",
-    "@zhin.js/component": "1.0.6",
-    "@zhin.js/database": "1.0.78",
-    "@zhin.js/im-contract": "1.0.1",
-    "@zhin.js/kernel": "1.0.5",
-    "@zhin.js/logger": "1.0.75",
-    "@zhin.js/middleware": "1.0.6",
-    "@zhin.js/plugin-runtime": "1.1.3",
-    "@zhin.js/schema": "1.0.72"
+    "@zhin.js/command": "1.0.9",
+    "@zhin.js/adapter": "1.1.7",
+    "@zhin.js/component": "1.0.8",
+    "@zhin.js/database": "1.0.79",
+    "@zhin.js/im-contract": "1.0.3",
+    "@zhin.js/kernel": "1.0.7",
+    "@zhin.js/logger": "1.0.76",
+    "@zhin.js/middleware": "1.0.8",
+    "@zhin.js/permission": "1.0.1",
+    "@zhin.js/plugin-runtime": "1.1.5",
+    "@zhin.js/schema": "1.0.73"
   },
   "peerDependencies": {
     "zod": "^4.0.0"
@@ -94,7 +95,7 @@
     "@types/qrcode": "^1.5.6",
     "ajv": "8.18.0",
     "typescript": "^6.0.3",
-    "@zhin.js/ai": "1.5.0"
+    "@zhin.js/ai": "1.5.2"
   },
   "repository": {
     "type": "git",

package/lib/built/qrcode-segment.d.ts

@@ -1,18 +0,0 @@
-/**
- * 出站 `qrcode` 消息段（legacy 导出；新代码请用 rich-segments）。
- * @deprecated 出站渲染由 Adapter.renderSendMessage → resolveRichSegments 统一处理
- */
-import type { SendContent } from '../types.js';
-import { QrcodeSegment, readQrcodeSegmentData, type QrcodeSegmentData } from './rich-segments/qrcode-segment.js';
-export type { QrcodeSegmentData };
-export { QrcodeSegment, readQrcodeSegmentData };
-export type QrcodeOutboundMode = 'image' | 'terminal' | 'text';
-export declare function hasQrcodeSegment(content: SendContent | undefined): boolean;
-/** 创建 qrcode 出站段 */
-export declare function qrcodeSegment(text: string, options?: Omit<QrcodeSegmentData, 'text'>): QrcodeSegment;
-/** IM 适配器：qrcode → image(data URL + base64) */
-export declare function resolveQrcodeSegmentsToImages(content: SendContent | undefined): Promise<SendContent | undefined>;
-/** process 适配器：终端 ASCII + 文本占位（legacy；process endpoint 现解释 origin qrcode） */
-export declare function resolveQrcodeSegmentsToTerminal(content: SendContent | undefined): Promise<SendContent | undefined>;
-/** 不支持图片的平台：仅输出链接文本 */
-export declare function coerceQrcodeSegmentsToText(content: SendContent): SendContent;

package/lib/built/qrcode-segment.js

@@ -1,78 +0,0 @@
-import { segment } from '../utils.js';
-import { GeneratedQrCode } from './generated-qrcode.js';
-import { QrcodeSegment, readQrcodeSegmentData, } from './rich-segments/qrcode-segment.js';
-export { QrcodeSegment, readQrcodeSegmentData };
-function asArray(content) {
-    return Array.isArray(content) ? content : [content];
-}
-function packSegments(out) {
-    if (out.length === 0)
-        return segment.text('');
-    if (out.length === 1)
-        return out[0];
-    return out;
-}
-export function hasQrcodeSegment(content) {
-    if (content == null)
-        return false;
-    return asArray(content).some((item) => typeof item !== 'string' && item?.type === 'qrcode');
-}
-/** 创建 qrcode 出站段 */
-export function qrcodeSegment(text, options = {}) {
-    return new QrcodeSegment({ text, ...options });
-}
-const LEGACY_QRCODE_ONLY_POLICY = {
-    qrcode: 'image',
-    html: 'origin',
-    markdown: 'origin',
-};
-/** IM 适配器：qrcode → image(data URL + base64) */
-export async function resolveQrcodeSegmentsToImages(content) {
-    if (content == null)
-        return content;
-    const { resolveRichSegments } = await import('./rich-segments/index.js');
-    return resolveRichSegments(content, LEGACY_QRCODE_ONLY_POLICY);
-}
-/** process 适配器：终端 ASCII + 文本占位（legacy；process endpoint 现解释 origin qrcode） */
-export async function resolveQrcodeSegmentsToTerminal(content) {
-    if (content == null)
-        return content;
-    if (!hasQrcodeSegment(content))
-        return content;
-    const items = asArray(content);
-    const out = [];
-    for (const item of items) {
-        if (typeof item === 'string') {
-            out.push(item);
-            continue;
-        }
-        if (item.type !== 'qrcode') {
-            out.push(item);
-            continue;
-        }
-        const payload = readQrcodeSegmentData(item.data ?? {});
-        const qr = await GeneratedQrCode.generate(payload.text, payload);
-        await qr.printToTerminal({ small: payload.small ?? true });
-        out.push(segment.text(`[二维码] ${payload.text}`));
-    }
-    return packSegments(out);
-}
-/** 不支持图片的平台：仅输出链接文本 */
-export function coerceQrcodeSegmentsToText(content) {
-    const items = asArray(content);
-    const out = [];
-    for (const item of items) {
-        if (typeof item === 'string') {
-            out.push(item);
-            continue;
-        }
-        if (item?.type === 'qrcode') {
-            const text = typeof item.data?.text === 'string' ? item.data.text : '';
-            if (text)
-                out.push(segment.text(`[二维码] ${text}`));
-            continue;
-        }
-        out.push(item);
-    }
-    return packSegments(out);
-}

package/lib/types-generator.d.ts

@@ -1,5 +0,0 @@
-/**
- * 更新 tsconfig.json 的类型声明
- * @param cwd 项目根目录
- */
-export declare function generateEnvTypes(cwd: string): Promise<void>;