@cxyhhhhh/dsh-qqbot 0.1.0-dev.202608141525

package/dist/mention.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @mention 检测和清理工具
+ *
+ * QQ 群消息中 @bot 的格式为: <@OPENID> (十六进制字符串)
+ * 例如: <@BD9386750A680BA80CB124E27A7B8089>
+ */
+/**
+ * 检测消息是否包含 @mention
+ */
+export declare function detectMention(content: string | undefined): boolean;
+/**
+ * 移除消息中的 @mention，返回干净的用户意图文本
+ */
+export declare function stripMention(content: string): string;
+//# sourceMappingURL=mention.d.ts.map

package/dist/mention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.d.ts","sourceRoot":"","sources":["../src/mention.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/dist/mention.js

@@ -0,0 +1,25 @@
+/**
+ * @mention 检测和清理工具
+ *
+ * QQ 群消息中 @bot 的格式为: <@OPENID> (十六进制字符串)
+ * 例如: <@BD9386750A680BA80CB124E27A7B8089>
+ */
+/** QQ @mention 格式: <@OPENID> 或 <@!OPENID>，OPENID 是十六进制或数字字符串 */
+const MENTION_PATTERN = /<@!?[A-Fa-f0-9]+>/g;
+/**
+ * 检测消息是否包含 @mention
+ */
+export function detectMention(content) {
+    if (!content)
+        return false;
+    return MENTION_PATTERN.test(content);
+}
+/**
+ * 移除消息中的 @mention，返回干净的用户意图文本
+ */
+export function stripMention(content) {
+    return content
+        .replace(MENTION_PATTERN, '')
+        .trim();
+}
+//# sourceMappingURL=mention.js.map

package/dist/mention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention.js","sourceRoot":"","sources":["../src/mention.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gEAAgE;AAChE,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,OAAO;SACX,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/outbound.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 出站处理器 — dsh session/event → QQ 消息发送
+ */
+import type { SessionManager } from './session-manager.js';
+import type { ImQQBotConfig } from './config.js';
+import type { Logger, ReplyTarget } from './types.js';
+/** QQ Bot 发送接口 */
+export interface QQBotSender {
+    sendMarkdown(target: ReplyTarget, content: string): Promise<unknown>;
+}
+/** dsh SessionEvent 简化类型 */
+export interface SessionEvent {
+    type: string;
+    data: Record<string, unknown>;
+}
+/** dsh Session 简化类型 */
+export interface SessionLike {
+    header: {
+        id: string;
+    };
+}
+/**
+ * 创建出站事件处理器
+ *
+ * 返回一个 handler 函数，应注册到 ctx.on('session/event', handler)
+ */
+export declare function createOutboundHandler(manager: SessionManager, bot: QQBotSender, config: ImQQBotConfig, logger: Logger): (session: SessionLike, event: SessionEvent) => void;
+//# sourceMappingURL=outbound.d.ts.map

package/dist/outbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../src/outbound.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGtD,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtE;AAED,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,uBAAuB;AACvB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACxB;AAqED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CA0BrD"}

package/dist/outbound.js

@@ -0,0 +1,162 @@
+import { chunkMarkdownText } from './chunker.js';
+/**
+ * 出站文本缓冲 — 收集流式 chunk 并 debounce 发送
+ */
+class OutboundBuffer {
+    record;
+    bot;
+    limit;
+    logger;
+    buffer = '';
+    timer = null;
+    flushing = false;
+    constructor(record, bot, limit, logger) {
+        this.record = record;
+        this.bot = bot;
+        this.limit = limit;
+        this.logger = logger;
+    }
+    /** 追加文本增量 */
+    append(text) {
+        this.buffer += text;
+    }
+    /** 获取当前累积文本 */
+    get text() {
+        return this.buffer;
+    }
+    /** 安排延迟发送（debounce） */
+    scheduleSend(delayMs) {
+        if (this.timer)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.flush();
+        }, delayMs);
+    }
+    /** 立即发送所有累积文本 */
+    async flush() {
+        if (this.flushing || !this.buffer.trim())
+            return;
+        this.flushing = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        try {
+            const chunks = chunkMarkdownText(this.buffer, this.limit);
+            for (const chunk of chunks) {
+                await this.bot.sendMarkdown(this.record.replyTarget, chunk);
+            }
+        }
+        catch (err) {
+            this.logger.error(`im-qqbot: sendMarkdown failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            this.buffer = '';
+            this.flushing = false;
+        }
+    }
+    /** 取消未发送的定时器 */
+    cancel() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.buffer = '';
+    }
+}
+/**
+ * 创建出站事件处理器
+ *
+ * 返回一个 handler 函数，应注册到 ctx.on('session/event', handler)
+ */
+export function createOutboundHandler(manager, bot, config, logger) {
+    const buffers = new Map();
+    const limit = config.textChunkLimit;
+    return (session, event) => {
+        const sessionId = session.header.id;
+        const record = manager.findBySessionId(sessionId);
+        if (!record)
+            return; // 非本插件管理的会话
+        switch (event.type) {
+            case 'assistant/chunk': {
+                handleChunk(sessionId, record, event, buffers, bot, limit, logger);
+                break;
+            }
+            case 'assistant/message': {
+                handleMessage(sessionId, record, event, buffers, bot, limit, logger);
+                break;
+            }
+            case 'turn/end': {
+                handleTurnEnd(sessionId, buffers, logger);
+                break;
+            }
+        }
+    };
+}
+/** 处理流式文本增量 */
+function handleChunk(sessionId, record, event, buffers, bot, limit, logger) {
+    const chunk = event.data.chunk;
+    if (!chunk || chunk.type !== 'text-delta' || !chunk.text)
+        return;
+    let buffer = buffers.get(sessionId);
+    if (!buffer) {
+        buffer = new OutboundBuffer(record, bot, limit, logger);
+        buffers.set(sessionId, buffer);
+    }
+    buffer.append(chunk.text);
+    // 不实时发 chunk，等 assistant/message 完整输出后一起发
+    // 如需流式体验，可改为 scheduleSend(500) 定期推送
+}
+/** 处理完整 assistant 消息 */
+function handleMessage(sessionId, record, event, buffers, bot, limit, logger) {
+    // 如果已有 buffer 积累了 chunk，直接用 buffer（chunk 更完整）
+    const buffer = buffers.get(sessionId);
+    if (buffer && buffer.text.trim()) {
+        void buffer.flush();
+        buffers.delete(sessionId);
+        return;
+    }
+    // 否则从 message content 中提取文本
+    const message = event.data;
+    const blocks = message?.message?.content;
+    if (!blocks || !Array.isArray(blocks))
+        return;
+    const textParts = [];
+    for (const block of blocks) {
+        if (block.type === 'text' && block.text) {
+            textParts.push(block.text);
+        }
+    }
+    const fullText = textParts.join('\n');
+    if (!fullText.trim())
+        return;
+    const chunks = chunkMarkdownText(fullText, limit);
+    void (async () => {
+        for (const chunk of chunks) {
+            try {
+                await bot.sendMarkdown(record.replyTarget, chunk);
+            }
+            catch (err) {
+                logger.error(`im-qqbot: sendMarkdown failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    })();
+    buffers.delete(sessionId);
+}
+/** 处理轮次结束，清理 buffer */
+function handleTurnEnd(sessionId, buffers, logger) {
+    const buffer = buffers.get(sessionId);
+    if (buffer) {
+        // flush 任何残留
+        if (buffer.text.trim()) {
+            void buffer.flush();
+        }
+        else {
+            buffer.cancel();
+        }
+        buffers.delete(sessionId);
+    }
+    logger.debug(`im-qqbot: turn/end sessionId=${sessionId}`);
+}
+//# sourceMappingURL=outbound.js.map

package/dist/outbound.js.map

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

package/dist/session-manager.d.ts

@@ -0,0 +1,106 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { ChatScope, Logger, ReplyTarget } from './types.js';
+import type { ImQQBotConfig } from './config.js';
+/** AgentSetup hook 类型 */
+export type AgentSetup = (agentCtx: Context) => Promise<void> | void;
+/** dsh Agent 简化接口 */
+export interface DshAgent {
+    readonly id: string;
+    readonly ctx: Context;
+    cancel(cause: {
+        kind: string;
+    }): void;
+    followup(message: unknown): void;
+    whenIdle(): Promise<void>;
+}
+export interface DshAgentHandle {
+    agent: DshAgent;
+    dispose(): Promise<void>;
+}
+export interface DshAgentRegistry {
+    /** 获取进程内已存活的 agent */
+    get(sessionId: string): DshAgent | undefined;
+    /** 从持久化存储恢复 session */
+    resume(options: {
+        resumeSessionId: string;
+        agentOptions?: {
+            provider?: string;
+            model?: string;
+        };
+        setup?: AgentSetup;
+    }): Promise<DshAgentHandle>;
+    /** 创建全新 session */
+    create(options: {
+        sessionId: string;
+        meta?: {
+            cwd?: string;
+            agentPreset?: string;
+        };
+        agentOptions?: {
+            provider?: string;
+            model?: string;
+        };
+        setup?: AgentSetup;
+    }): Promise<DshAgentHandle>;
+}
+/** agent-presets 服务接口（可选，部署中可能没有） */
+export interface AgentPresetsLike {
+    readonly defaultId: string;
+    resolve(id?: string): Promise<{
+        id: string;
+    }>;
+    mount(agentCtx: Context, id?: string): Promise<unknown>;
+}
+/** 单个会话记录 */
+export interface SessionRecord {
+    sessionKey: string;
+    sessionId: string;
+    agent: DshAgent;
+    handle: DshAgentHandle;
+    replyTarget: ReplyTarget;
+    scope: ChatScope;
+    peerId: string;
+    senderId: string;
+    lastActivity: number;
+    agentPreset?: string;
+}
+export declare class SessionManager {
+    private readonly ctx;
+    private readonly agents;
+    private readonly config;
+    private readonly logger;
+    private sessions;
+    private idleTimer;
+    constructor(ctx: Context, agents: DshAgentRegistry, config: ImQQBotConfig, logger: Logger);
+    /**
+     * 生成 sessionKey
+     *
+     * 格式: qqbot:${appId}:${kind}:${peerId}
+     */
+    private sessionKey;
+    /**
+     * 从 sessionKey 确定性生成 SessionId
+     */
+    private deriveSessionId;
+    /**
+     * 组合 preset：解析 preset id 并生成 setup hook
+     *
+     * 如果部署中没有 agent-presets 服务，返回空组合（使用宿主默认配置）
+     */
+    private composePreset;
+    /** 获取或恢复或创建会话（get → resume → create） */
+    getOrCreate(scope: ChatScope, peerId: string, senderId: string, replyTarget: ReplyTarget): Promise<SessionRecord>;
+    /** 根据 sessionId 查找 record */
+    findBySessionId(sessionId: string): SessionRecord | undefined;
+    /** 根据 agent 查找 record */
+    findByAgent(agent: DshAgent): SessionRecord | undefined;
+    /** 删除并销毁指定会话 */
+    remove(scope: ChatScope, peerId: string): Promise<void>;
+    /** 定期回收闲置会话 */
+    private evictIdle;
+    /** 关闭所有会话并释放资源 */
+    disposeAll(): Promise<void>;
+    /** 当前活跃会话数 */
+    get size(): number;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session-manager.d.ts.map

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

package/dist/session-manager.js

@@ -0,0 +1,201 @@
+/**
+ * SessionManager — 管理 QQ peer → dsh Agent 的映射和生命周期
+ *
+ * sessionKey 格式: `qqbot:${appId}:${kind}:${peerId}`
+ *   - c2c:   peerId = senderId (用户 openid)
+ *   - group: peerId = groupOpenid
+ *
+ * SessionId 由 sessionKey 确定性派生（SHA-256），
+ * 保证同一个用户/群的消息始终路由到同一个会话，
+ * 重启后可根据 key 恢复 session。
+ *
+ * 支持 agent-presets 系统：通过 setup hook 在 create/resume 时
+ * 挂载 preset（工具集、prompt sections 等），实现场景化配置。
+ */
+import { createHash } from 'node:crypto';
+import { SessionId } from '@deepseek-ai/dsh-session';
+export class SessionManager {
+    ctx;
+    agents;
+    config;
+    logger;
+    sessions = new Map();
+    idleTimer = null;
+    constructor(ctx, agents, config, logger) {
+        this.ctx = ctx;
+        this.agents = agents;
+        this.config = config;
+        this.logger = logger;
+        if (config.sessionIdleTimeout > 0) {
+            this.idleTimer = setInterval(() => this.evictIdle(), 60_000);
+        }
+    }
+    /**
+     * 生成 sessionKey
+     *
+     * 格式: qqbot:${appId}:${kind}:${peerId}
+     */
+    sessionKey(scope, peerId) {
+        return `qqbot:${this.config.appId}:${scope}:${peerId}`;
+    }
+    /**
+     * 从 sessionKey 确定性生成 SessionId
+     */
+    deriveSessionId(sessionKey) {
+        const hash = createHash('sha256').update(sessionKey).digest('hex');
+        return `${hash.slice(0, 8)}-${hash.slice(8, 12)}-${hash.slice(12, 16)}-${hash.slice(16, 20)}-${hash.slice(20, 32)}`;
+    }
+    /**
+     * 组合 preset：解析 preset id 并生成 setup hook
+     *
+     * 如果部署中没有 agent-presets 服务，返回空组合（使用宿主默认配置）
+     */
+    async composePreset(presetId) {
+        const presets = this.ctx.agentPresets
+            ?? this.ctx.get?.('agentPresets');
+        if (!presets)
+            return {};
+        try {
+            const resolved = await presets.resolve(presetId);
+            const resolvedId = resolved.id;
+            return {
+                agentPreset: resolvedId,
+                setup: async (agentCtx) => {
+                    await presets.mount(agentCtx, resolvedId);
+                },
+            };
+        }
+        catch (err) {
+            this.logger.warn(`im-qqbot: preset ${presetId ?? '(default)'} unavailable: ${err instanceof Error ? err.message : String(err)} — using host composition`);
+            return {};
+        }
+    }
+    /** 获取或恢复或创建会话（get → resume → create） */
+    async getOrCreate(scope, peerId, senderId, replyTarget) {
+        const key = this.sessionKey(scope, peerId);
+        const existing = this.sessions.get(key);
+        if (existing) {
+            existing.replyTarget = replyTarget;
+            existing.lastActivity = Date.now();
+            return existing;
+        }
+        const sessionId = SessionId(this.deriveSessionId(key));
+        const route = {
+            provider: this.config.provider || 'deepseek-official',
+            model: this.config.model || 'deepseek-chat',
+        };
+        let agent;
+        let handle;
+        let agentPreset;
+        // 1. 检查进程内是否已有活跃 agent
+        const live = this.agents.get(sessionId);
+        if (live) {
+            agent = live;
+            console.log(`[im-qqbot] reusing live agent: key=${key}`);
+        }
+        else {
+            // 2. 尝试从持久化存储恢复（带 setup hook）
+            try {
+                const composed = await this.composePreset(this.config.preset);
+                agentPreset = composed.agentPreset;
+                const resumed = await this.agents.resume({
+                    resumeSessionId: sessionId,
+                    agentOptions: route,
+                    ...(composed.setup ? { setup: composed.setup } : {}),
+                });
+                agent = resumed.agent;
+                handle = resumed;
+                console.log(`[im-qqbot] resumed session: key=${key} preset=${agentPreset ?? 'none'}`);
+            }
+            catch {
+                // 3. 恢复失败，创建全新 session（带 setup hook）
+                const composed = await this.composePreset(this.config.preset);
+                agentPreset = composed.agentPreset;
+                const created = await this.agents.create({
+                    sessionId,
+                    meta: {
+                        cwd: this.config.cwd || process.cwd(),
+                        ...(agentPreset ? { agentPreset } : {}),
+                    },
+                    agentOptions: route,
+                    ...(composed.setup ? { setup: composed.setup } : {}),
+                });
+                agent = created.agent;
+                handle = created;
+                console.log(`[im-qqbot] created new session: key=${key} preset=${agentPreset ?? 'none'}`);
+            }
+        }
+        const record = {
+            sessionKey: key,
+            sessionId,
+            agent,
+            handle: handle ?? { agent, dispose: async () => { } },
+            replyTarget,
+            scope,
+            peerId,
+            senderId,
+            lastActivity: Date.now(),
+            agentPreset,
+        };
+        this.sessions.set(key, record);
+        return record;
+    }
+    /** 根据 sessionId 查找 record */
+    findBySessionId(sessionId) {
+        for (const record of this.sessions.values()) {
+            if (record.sessionId === sessionId)
+                return record;
+        }
+        return undefined;
+    }
+    /** 根据 agent 查找 record */
+    findByAgent(agent) {
+        for (const record of this.sessions.values()) {
+            if (record.agent === agent)
+                return record;
+        }
+        return undefined;
+    }
+    /** 删除并销毁指定会话 */
+    async remove(scope, peerId) {
+        const key = this.sessionKey(scope, peerId);
+        const record = this.sessions.get(key);
+        if (!record)
+            return;
+        this.sessions.delete(key);
+        record.agent.cancel({ kind: 'user' });
+        await record.handle.dispose().catch(() => { });
+        console.log(`[im-qqbot] session removed: key=${key}`);
+    }
+    /** 定期回收闲置会话 */
+    evictIdle() {
+        const now = Date.now();
+        for (const [key, record] of this.sessions) {
+            if (now - record.lastActivity > this.config.sessionIdleTimeout) {
+                console.log(`[im-qqbot] evicting idle session: key=${key}`);
+                this.sessions.delete(key);
+                record.agent.cancel({ kind: 'user' });
+                void record.handle.dispose().catch(() => { });
+            }
+        }
+    }
+    /** 关闭所有会话并释放资源 */
+    async disposeAll() {
+        if (this.idleTimer) {
+            clearInterval(this.idleTimer);
+            this.idleTimer = null;
+        }
+        const records = [...this.sessions.values()];
+        this.sessions.clear();
+        for (const record of records) {
+            record.agent.cancel({ kind: 'user' });
+        }
+        await Promise.allSettled(records.map((r) => r.handle.dispose()));
+        console.log(`[im-qqbot] all sessions disposed (count=${records.length})`);
+    }
+    /** 当前活跃会话数 */
+    get size() {
+        return this.sessions.size;
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session-manager.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * dsh-im-qqbot 插件内部类型定义
+ */
+/** 会话作用域 */
+export type ChatScope = 'c2c' | 'group';
+/** QQ 回复目标 */
+export interface ReplyTarget {
+    scope: ChatScope;
+    targetId: string;
+    msgId?: string;
+}
+/** QQ 入站消息（简化） */
+export interface QQInboundMessage {
+    content?: string;
+    senderId: string;
+    groupOpenid?: string;
+    replyTarget: ReplyTarget;
+    attachments?: QQAttachment[];
+}
+/** QQ 附件 */
+export interface QQAttachment {
+    contentType: string;
+    filename?: string;
+    url?: string;
+    size?: number;
+}
+/** 插件 Logger 接口 */
+export interface Logger {
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    error(msg: string, ...args: unknown[]): void;
+    debug(msg: string, ...args: unknown[]): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY;AACZ,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AAExC,cAAc;AACd,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kBAAkB;AAClB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;CAC9B;AAED,YAAY;AACZ,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,mBAAmB;AACnB,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC9C"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * dsh-im-qqbot 插件内部类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}