@zaofan/dsh-qqbot 0.6.0

package/dist/transport/inbound.js

@@ -0,0 +1,292 @@
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import { clearGroupHistory } from '../features/history-store.js';
+import { applyInjectRules } from './inject-rules.js';
+// ── 主处理函数 ──
+/**
+ * 处理 QQ 入站消息（已经过 SDK 中间件链）
+ */
+export async function handleInbound(rawMsg, manager, config, logger, state) {
+    const msg = rawMsg;
+    const mwState = (state ?? {});
+    const scope = msg.kind === 'group' ? 'group' : 'c2c';
+    const peerId = scope === 'group' ? (msg.groupOpenid ?? msg.senderId) : msg.senderId;
+    const replyTarget = {
+        scope,
+        targetId: peerId,
+        msgId: msg.messageId,
+    };
+    // ── 读取中间件已下载的文件（attachmentProcessor 写入 state.downloadedFiles） ──
+    const downloaded = mwState.downloadedFiles ?? [];
+    // ── 组装 agentBody（对齐 openclaw-qqbot body-assembler） ──
+    let agentBody = assembleAgentBody(msg, mwState, scope, logger, downloaded);
+    if (!agentBody)
+        return;
+    // 条件注入规则(配置化): 消息含图/链接/自定义条件时追加 [系统提示]。
+    // 含内置读图兜底(未配置 hasImage 规则时自动生效, 行为与旧写死版一致)。
+    // ⚠️ 本地手改功能（曾被重编译冲掉），改完务必保持 src 与部署 dist 同步。
+    agentBody = applyInjectRules(agentBody, msg, config.injectRules, logger);
+    // 群聊时间戳(原"群守则"拼接位): 守则已迁 systemPrompt.section(session-manager 装配期注册,
+    // 每请求进 system, 不再每轮塞 user 历史); 此处改为注入当前系统时间, 让 AI 每轮知道日期/星期/时刻。
+    if (scope === 'group') {
+        const _now = new Date();
+        const _p = (n) => String(n).padStart(2, '0');
+        const _wd = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'][_now.getDay()];
+        agentBody = `[当前时间 ${_now.getFullYear()}-${_p(_now.getMonth() + 1)}-${_p(_now.getDate())} ${_wd} ${_p(_now.getHours())}:${_p(_now.getMinutes())}]\n\n${agentBody}`;
+    }
+    logger.info(`Processing: scope=${scope} peerId=${peerId} body="${agentBody.slice(0, 200)}"`);
+    // ── 获取或创建会话 ──
+    let record;
+    try {
+        record = await manager.getOrCreate(scope, peerId, msg.senderId, replyTarget);
+    }
+    catch (err) {
+        logger.error(`ERROR creating session: ${err instanceof Error ? err.message : String(err)}`);
+        return;
+    }
+    // ── 工具自愈：setup 竞态漏装时补注册通道工具(幂等,几乎零开销) ──
+    try {
+        await manager.ensureChannelTools(record);
+    }
+    catch (err) {
+        logger.debug(`ensureChannelTools error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // ── qqChannel 上下文自愈: 恢复会话可能没 provide, 工具按本实例路由图库/定时需要它(幂等) ──
+    try {
+        await manager.ensureChannelContext(record);
+    }
+    catch (err) {
+        logger.debug(`ensureChannelContext error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // ── 守则/身份 context 注册自愈(幂等; 重启恢复会话也覆盖, 保证 systemPrompt.context 注入生效) ──
+    try {
+        await manager.ensureGroupRules(record);
+    }
+    catch (err) {
+        logger.debug(`ensureGroupRules error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // ── 构建 UserMessage → followup ──
+    const content = [{ type: 'text', text: agentBody }];
+    const message = createUserMessage({
+        content,
+        source: { kind: 'user' },
+    });
+    record.agent.followup(message);
+    logger.info(`→ followup sent: key=${scope}:${peerId}`);
+    // 群消息回复后清空历史缓存（避免下次 @ 时重复组包，对齐 openclaw-qqbot dispatch）
+    if (scope === 'group') {
+        clearGroupHistory(config.appId, msg.groupOpenid ?? msg.senderId);
+    }
+}
+// ══════════════════════════════════════════════════════════════
+// Body Assembly（对齐 openclaw-qqbot 5 层组装）
+// ══════════════════════════════════════════════════════════════
+/**
+ * 组装 agentBody — AI 实际看到的完整上下文
+ */
+function assembleAgentBody(msg, state, scope, logger, downloaded) {
+    const userContent = buildUserContent(msg, state, logger);
+    if (!userContent && (!msg.attachments || msg.attachments.length === 0))
+        return null;
+    const quotePart = buildQuotePart(state.quote);
+    const isGroup = scope === 'group';
+    const wasMentioned = state.mention?.wasMentioned ?? false;
+    const batchDispatch = state.batchDispatch === true;
+    const userMessage = buildUserMessage(userContent, quotePart, msg.senderId, msg.senderName, isGroup, wasMentioned);
+    const dynamicCtx = buildDynamicCtx(msg, state, downloaded);
+    const base = dynamicCtx ? `${dynamicCtx}${userMessage}` : userMessage;
+    const agentBody = buildAgentBody(base, state.history, isGroup, wasMentioned, batchDispatch);
+    return agentBody;
+}
+/**
+ * Layer 1: 用户文本内容 + 语音 + 附件
+ */
+function buildUserContent(msg, state, logger) {
+    const parts = [];
+    const text = (msg.content ?? '').trim();
+    if (text) {
+        parts.push(text);
+    }
+    const voiceTexts = extractVoiceTexts(msg.attachments, state.processedAttachments, logger);
+    if (voiceTexts.length > 0) {
+        for (const vt of voiceTexts) {
+            const durationTag = vt.duration ? ` (${vt.duration}s)` : '';
+            parts.push(`[Voice message${durationTag}] ${vt.text}`);
+        }
+    }
+    const otherAttachments = describeAttachments(msg.attachments, state.processedAttachments);
+    if (otherAttachments) {
+        parts.push(otherAttachments);
+    }
+    return parts.join('\n');
+}
+/**
+ * Layer 2: 引用消息块
+ */
+function buildQuotePart(quote) {
+    if (!quote?.text && !quote?.entry?.content)
+        return '';
+    const quoteText = quote.text || quote.entry?.content || 'Original content unavailable';
+    return `[Quoted message begins]\n${quoteText}\n[Quoted message ends]\n[Current message]\n`;
+}
+/**
+ * Layer 3: 带发送者标签的用户消息
+ */
+function buildUserMessage(userContent, quotePart, senderId, senderName, isGroup, wasMentioned) {
+    if (!isGroup) {
+        return `${quotePart}${userContent}`;
+    }
+    const mentionTag = wasMentioned ? ' (@you)' : '';
+    const displayName = senderName ?? shortSenderId(senderId);
+    const senderTag = `[${displayName} (${senderId})]`;
+    return `${quotePart}${senderTag} ${userContent}${mentionTag}`;
+}
+/**
+ * Layer 4: 媒体元数据上下文
+ */
+function buildDynamicCtx(msg, state, downloaded) {
+    const lines = [];
+    if (!msg.attachments || msg.attachments.length === 0)
+        return '';
+    const images = msg.attachments.filter(a => a.content_type === 'image');
+    if (images.length > 0) {
+        const urls = images.map(a => a.url).filter(Boolean);
+        if (urls.length > 0) {
+            lines.push(`- Images: ${urls.join(', ')}`);
+        }
+    }
+    const voices = msg.attachments.filter(a => a.content_type === 'voice');
+    if (voices.length > 0) {
+        const asrTexts = voices.map(a => a.asr_refer_text).filter(Boolean);
+        if (asrTexts.length > 0) {
+            lines.push(`- ASR: ${asrTexts.join(' | ')}`);
+        }
+        else {
+            // 无 ASR 识别结果时才带链接（纯文本模型无法消费音频，链接无意义）
+            const urls = voices.map(a => a.url).filter(Boolean);
+            if (urls.length > 0) {
+                lines.push(`- Voice: ${urls.join(', ')}`);
+            }
+        }
+    }
+    const videos = msg.attachments.filter(a => a.content_type === 'video');
+    if (videos.length > 0) {
+        lines.push(`- Videos: ${videos.map(a => a.filename).join(', ')}`);
+    }
+    const files = msg.attachments.filter(a => a.content_type === 'file');
+    if (files.length > 0) {
+        for (const file of files) {
+            const d = downloaded.find(x => x.filename === file.filename);
+            if (d) {
+                lines.push(`- File: ${file.filename} → ${d.displayPath}`);
+            }
+            else {
+                lines.push(`- File: ${file.filename} (${formatFileSize(file.size)})`);
+            }
+        }
+    }
+    // 兜底：把所有带 URL 的附件链接暴露给 AI（未归类为 image 的也带上），方便桥接工具直接看图/附件
+    const otherUrls = msg.attachments
+        .filter(a => a.content_type !== 'image' && !!a.url)
+        .map(a => a.url);
+    if (otherUrls.length > 0) {
+        lines.push(`- Attachment URLs: ${otherUrls.join(', ')}`);
+    }
+    if (lines.length === 0)
+        return '';
+    const quoteAttachments = state.quote?.attachments;
+    if (quoteAttachments && quoteAttachments.length > 0) {
+        lines.push('[Reference attachments]');
+        for (const qa of quoteAttachments) {
+            const label = qa.asrText ? `Voice: ${qa.asrText}` : (qa.filename ?? qa.contentType ?? 'attachment');
+            lines.push(`  - ${label}`);
+        }
+    }
+    return lines.join('\n') + '\n\n';
+}
+/**
+ * Layer 5: 最终 agentBody 拼合
+ */
+function buildAgentBody(base, history, isGroup, wasMentioned, batchDispatch = false) {
+    // 群内：真实 @ 或冷却派发(batchDispatch)时，把累积的群历史打包给 AI（后者不打假 @you 标签）
+    const includeHistory = isGroup && (wasMentioned || batchDispatch) && !!history && history.length > 0;
+    if (!includeHistory) {
+        return base;
+    }
+    const historyLines = history.map(h => {
+        const name = h.senderName ?? shortSenderId(h.senderId);
+        return `[${name} (${h.senderId})] ${h.content}`;
+    });
+    return [
+        '[Chat history begins]',
+        ...historyLines,
+        '',
+        '[Chat history ends]',
+        '[Current message]',
+        base,
+    ].join('\n');
+}
+function extractVoiceTexts(attachments, processed, _logger) {
+    const results = [];
+    if (processed) {
+        for (const pa of processed) {
+            if (pa.type === 'voice' && pa.voiceText) {
+                results.push({
+                    text: pa.voiceText,
+                    duration: pa.duration,
+                    source: pa.voiceSource ?? 'stt',
+                });
+            }
+        }
+    }
+    if (results.length === 0 && attachments) {
+        for (const att of attachments) {
+            if (att.content_type === 'voice' && att.asr_refer_text) {
+                results.push({
+                    text: att.asr_refer_text.trim(),
+                    source: 'asr',
+                });
+            }
+        }
+    }
+    return results;
+}
+function describeAttachments(attachments, _processed) {
+    if (!attachments || attachments.length === 0)
+        return '';
+    const parts = [];
+    for (const att of attachments) {
+        switch (att.content_type) {
+            case 'voice':
+                break;
+            case 'image': {
+                const dim = att.width && att.height ? ` ${att.width}×${att.height}` : '';
+                parts.push(`[Image: ${att.filename}${dim}]`);
+                break;
+            }
+            case 'video':
+                parts.push(`[Video: ${att.filename}]`);
+                break;
+            case 'file':
+                parts.push(`[File: ${att.filename} (${formatFileSize(att.size)})]`);
+                break;
+            default:
+                parts.push(`[Attachment: ${att.filename ?? att.content_type}${att.url ? ` -> ${att.url}` : ''}]`);
+                break;
+        }
+    }
+    return parts.join('\n');
+}
+function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+/** 发送者短标识长度（openid 前 N 位，无昵称时兜底） */
+const SENDER_SHORT_ID_LEN = 8;
+/** 无昵称时用 openid 前 N 位作为匿名标识 */
+function shortSenderId(senderId) {
+    return senderId.slice(0, SENDER_SHORT_ID_LEN);
+}
+//# sourceMappingURL=inbound.js.map

package/dist/transport/inbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.js","sourceRoot":"","sources":["../../src/transport/inbound.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAKzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AA6DrD,cAAc;AAEd;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAe,EACf,OAAuB,EACvB,MAAqB,EACrB,MAAc,EACd,KAA+B;IAE/B,MAAM,GAAG,GAAG,MAA0B,CAAC;IACvC,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE,CAAoB,CAAC;IAEjD,MAAM,KAAK,GAAc,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAChE,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IAEpF,MAAM,WAAW,GAAgB;QAC/B,KAAK;QACL,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,GAAG,CAAC,SAAS;KACrB,CAAC;IAEF,kEAAkE;IAClE,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC;IAEjD,uDAAuD;IACvD,IAAI,SAAS,GAAG,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAE3E,IAAI,CAAC,SAAS;QAAE,OAAO;IAEvB,wCAAwC;IACxC,4CAA4C;IAC5C,6CAA6C;IAC7C,SAAS,GAAG,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAEzE,qEAAqE;IACrE,gEAAgE;IAChE,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,SAAS,GAAG,SAAS,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,SAAS,EAAE,CAAC;IACrK,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,qBAAqB,KAAK,WAAW,MAAM,UAAU,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAE7F,gBAAgB;IAChB,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC/E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5F,OAAO;IACT,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,+DAA+D;IAC/D,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,wEAAwE;IACxE,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,kCAAkC;IAClC,MAAM,OAAO,GAAmB,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAE7E,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,OAAO;QACP,MAAM,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE;KAClC,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,IAAI,CAAC,wBAAwB,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC;IAEvD,wDAAwD;IACxD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,iBAAiB,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,yCAAyC;AACzC,iEAAiE;AAEjE;;GAEG;AACH,SAAS,iBAAiB,CACxB,GAAqB,EACrB,KAAsB,EACtB,KAAgB,EAChB,MAAc,EACd,UAA4B;IAE5B,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAEzD,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpF,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAG,KAAK,KAAK,OAAO,CAAC;IAClC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,EAAE,YAAY,IAAI,KAAK,CAAC;IAC1D,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;IACnD,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IAElH,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAE3D,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IACtE,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IAE5F,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,GAAqB,EAAE,KAAsB,EAAE,MAAc;IACrF,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAC1F,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,WAAW,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,iBAAiB,WAAW,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC1F,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,KAAqB;IAC3C,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO;QAAE,OAAO,EAAE,CAAC;IAEtD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,IAAI,8BAA8B,CAAC;IAEvF,OAAO,4BAA4B,SAAS,8CAA8C,CAAC;AAC7F,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,WAAmB,EACnB,SAAiB,EACjB,QAAgB,EAChB,UAA8B,EAC9B,OAAgB,EAChB,YAAqB;IAErB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,SAAS,GAAG,WAAW,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,WAAW,GAAG,UAAU,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,WAAW,KAAK,QAAQ,IAAI,CAAC;IACnD,OAAO,GAAG,SAAS,GAAG,SAAS,IAAI,WAAW,GAAG,UAAU,EAAE,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,GAAqB,EAAE,KAAsB,EAAE,UAA4B;IAClG,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhE,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,OAAO,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,OAAO,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,UAAU,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,qCAAqC;YACrC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,OAAO,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC;IACrE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7D,IAAI,CAAC,EAAE,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,KAAK,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;SAClD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,sBAAsB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,gBAAgB,GAAG,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC;IAClD,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtC,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,WAAW,IAAI,YAAY,CAAC,CAAC;YACpG,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CACrB,IAAY,EACZ,OAAmC,EACnC,OAAgB,EAChB,YAAqB,EACrB,aAAa,GAAG,KAAK;IAErB,6DAA6D;IAC7D,MAAM,cAAc,GAAG,OAAO,IAAI,CAAC,YAAY,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACrG,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACnC,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,IAAI,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACvD,OAAO,IAAI,IAAI,KAAK,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,uBAAuB;QACvB,GAAG,YAAY;QACf,EAAE;QACF,qBAAqB;QACrB,mBAAmB;QACnB,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAYD,SAAS,iBAAiB,CACxB,WAA6B,EAC7B,SAAiC,EACjC,OAAgB;IAEhB,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC;gBACxC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,EAAE,CAAC,SAAS;oBAClB,QAAQ,EAAE,EAAE,CAAC,QAAQ;oBACrB,MAAM,EAAE,EAAE,CAAC,WAAW,IAAI,KAAK;iBAChC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,YAAY,KAAK,OAAO,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;oBAC/B,MAAM,EAAE,KAAK;iBACd,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAA6B,EAC7B,UAAkC;IAElC,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAExD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,QAAQ,GAAG,CAAC,YAAY,EAAE,CAAC;YACzB,KAAK,OAAO;gBACV,MAAM;YACR,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,QAAQ,GAAG,GAAG,GAAG,CAAC,CAAC;gBAC7C,MAAM;YACR,CAAC;YACD,KAAK,OAAO;gBACV,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACvC,MAAM;YACR,KAAK,MAAM;gBACT,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,QAAQ,KAAK,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpE,MAAM;YACR;gBACE,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBAClG,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,GAAG,CAAC;IACrC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC;AAED,oCAAoC;AACpC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,+BAA+B;AAC/B,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAChD,CAAC"}

package/dist/transport/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 传输层
+ *
+ * 协议对接：QQ 消息入站 / 出站 / Markdown 切分。
+ */
+export { handleInbound } from './inbound.js';
+export { createOutboundHandler } from './outbound.js';
+export { OutboundBuffer, type QQBotSender } from './outbound-buffer.js';
+export { chunkMarkdownText } from './chunker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,10 @@
+/**
+ * 传输层
+ *
+ * 协议对接：QQ 消息入站 / 出站 / Markdown 切分。
+ */
+export { handleInbound } from './inbound.js';
+export { createOutboundHandler } from './outbound.js';
+export { OutboundBuffer } from './outbound-buffer.js';
+export { chunkMarkdownText } from './chunker.js';
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAoB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/transport/inject-rules.d.ts

@@ -0,0 +1,24 @@
+/**
+ * inject-rules.ts — 条件注入规则引擎(配置化)
+ *
+ * 用户可配: 当入站消息满足条件(含图片/含链接/正文匹配正则或关键词)时,
+ * 在 agentBody 末尾追加一行 "[系统提示] <prompt>" 自定义指令。
+ * 取代原先 inbound.ts 写死的"读图提示", 并作为内置兜底规则保留默认行为。
+ *
+ * ⚠️ 本地手改功能(fork 新增, 配置见 config.injectRules):
+ *    维护清单见工作区根《插件改动维护注意事项.md》。
+ */
+import type { InjectRuleConfig } from '../config.js';
+import type { Logger, RawAttachment } from '../types.js';
+/** 消息最小形状(只读所需) */
+interface RuleMsg {
+    content?: string;
+    attachments?: RawAttachment[];
+}
+/**
+ * 对组装好的 agentBody 应用全部启用的注入规则, 返回新 body。
+ * 规则数组里没有任何 enabled 的 hasImage 规则时, 自动追加内置读图兜底(默认行为与旧版一致)。
+ */
+export declare function applyInjectRules(body: string, msg: RuleMsg, rules: InjectRuleConfig[] | undefined, logger?: Logger): string;
+export {};
+//# sourceMappingURL=inject-rules.d.ts.map

package/dist/transport/inject-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-rules.d.ts","sourceRoot":"","sources":["../../src/transport/inject-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKzD,mBAAmB;AACnB,UAAU,OAAO;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;CAC/B;AAiDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,EAAE,GAAG,SAAS,EACrC,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAmBR"}

package/dist/transport/inject-rules.js

@@ -0,0 +1,72 @@
+/** 单轮累计注入预算(字符), 防爆上下文 */
+const BUDGET_CHARS = 1500;
+/** 原写死读图提示(内置兜底规则: 用户未配任何 enabled 的 hasImage 规则时自动追加) */
+const LEGACY_IMAGE_RULE = {
+    id: 'builtin-image',
+    enabled: true,
+    conditions: {
+        hasImage: true,
+        hasLink: false,
+        contentRegex: '',
+        contentKeywords: [],
+        matchScope: 'any',
+    },
+    prompt: '上方消息包含图片链接(URL)，请直接把该URL传给桥接视觉工具（modlens_read_image / analyze_image）看图并描述内容，不要只复述链接。',
+};
+/** 消息是否含附件图片(URL 兜底: content_type 是 MIME 如 image/jpeg) */
+function hasImage(msg) {
+    return (msg.attachments ?? []).some(a => (a.url && String(a.content_type ?? '').toLowerCase().includes('image')) || (a.url && /\.(jpe?g|png|gif|webp|bmp)(\?|$)/i.test(a.url)));
+}
+/** 消息正文是否含 http(s) 链接 */
+function hasLink(text) {
+    return /https?:\/\/|www\./i.test(text);
+}
+/** 单条规则命中判定(正则编译失败降级 false) */
+function matchRule(rule, text, msg, logger) {
+    const c = rule.conditions;
+    const parts = [];
+    if (c.hasImage)
+        parts.push(hasImage(msg));
+    if (c.hasLink)
+        parts.push(hasLink(text));
+    if (c.contentRegex) {
+        try {
+            parts.push(new RegExp(c.contentRegex, 'i').test(text));
+        }
+        catch (err) {
+            logger?.warn?.(`[inject-rules] 正则编译失败 rule=${rule.id}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (c.contentKeywords.length > 0) {
+        const tl = text.toLowerCase();
+        parts.push(c.contentKeywords.some(k => k && tl.includes(k.toLowerCase())));
+    }
+    if (parts.length === 0)
+        return false; // 无条件=永不触发
+    return c.matchScope === 'all' ? parts.every(Boolean) : parts.some(Boolean);
+}
+/**
+ * 对组装好的 agentBody 应用全部启用的注入规则, 返回新 body。
+ * 规则数组里没有任何 enabled 的 hasImage 规则时, 自动追加内置读图兜底(默认行为与旧版一致)。
+ */
+export function applyInjectRules(body, msg, rules, logger) {
+    const text = (msg.content ?? '') || '';
+    const enabled = (rules ?? []).filter(r => r.enabled);
+    const hasUserImageRule = enabled.some(r => r.conditions.hasImage);
+    const active = hasUserImageRule ? enabled : [...enabled, LEGACY_IMAGE_RULE];
+    let budget = BUDGET_CHARS;
+    let out = body;
+    for (const rule of active) {
+        if (budget <= 0) {
+            logger?.warn?.('[inject-rules] 预算耗尽, 停止注入');
+            break;
+        }
+        if (!matchRule(rule, text, msg, logger))
+            continue;
+        const inj = `[系统提示] ${rule.prompt}`;
+        out += `\n\n${inj}`;
+        budget -= inj.length;
+    }
+    return out;
+}
+//# sourceMappingURL=inject-rules.js.map

package/dist/transport/inject-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-rules.js","sourceRoot":"","sources":["../../src/transport/inject-rules.ts"],"names":[],"mappings":"AAaA,0BAA0B;AAC1B,MAAM,YAAY,GAAG,IAAI,CAAC;AAQ1B,yDAAyD;AACzD,MAAM,iBAAiB,GAAqB;IAC1C,EAAE,EAAE,eAAe;IACnB,OAAO,EAAE,IAAI;IACb,UAAU,EAAE;QACV,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,EAAE;QAChB,eAAe,EAAE,EAAE;QACnB,UAAU,EAAE,KAAK;KAClB;IACD,MAAM,EAAE,sFAAsF;CAC/F,CAAC;AAEF,0DAA0D;AAC1D,SAAS,QAAQ,CAAC,GAAY;IAC5B,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACtC,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,mCAAmC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CACtI,CAAC;AACJ,CAAC;AAED,yBAAyB;AACzB,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,+BAA+B;AAC/B,SAAS,SAAS,CAAC,IAAsB,EAAE,IAAY,EAAE,GAAY,EAAE,MAAe;IACpF,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;IAC1B,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,IAAI,CAAC,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,EAAE,IAAI,EAAE,CAAC,8BAA8B,IAAI,CAAC,EAAE,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/G,CAAC;IACH,CAAC;IACD,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,WAAW;IACjD,OAAO,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,GAAY,EACZ,KAAqC,EACrC,MAAe;IAEf,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAE5E,IAAI,MAAM,GAAG,YAAY,CAAC;IAC1B,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAChB,MAAM,EAAE,IAAI,EAAE,CAAC,2BAA2B,CAAC,CAAC;YAC5C,MAAM;QACR,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC;YAAE,SAAS;QAClD,MAAM,GAAG,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QACpC,GAAG,IAAI,OAAO,GAAG,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;IACvB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/transport/outbound-buffer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * OutboundBuffer — 出站文本缓冲
+ *
+ * 收集流式 chunk，流式优先投递（StreamingWriter），降级为静态发送。
+ * 独立文件便于单测。
+ */
+import type { SessionRecord } from '../session/index.js';
+import type { Logger, ReplyTarget } from '../types.js';
+/** QQ 流式会话（openStream 返回） */
+export interface StreamSessionLike {
+    update(content: string): Promise<unknown>;
+    complete(): Promise<unknown>;
+}
+/** QQ Bot 发送接口 */
+export interface QQBotSender {
+    sendMarkdown(target: ReplyTarget, content: string): Promise<unknown>;
+    openStream(target: ReplyTarget): StreamSessionLike;
+    /** 发送富媒体(图片/语音/视频/文件)；url/localPath 二选一；返回新消息 id(若可得) */
+    sendMedia(target: ReplyTarget, kind: 'image' | 'video' | 'voice' | 'file', source: {
+        url?: string;
+        localPath?: string;
+    }): Promise<{
+        id?: string;
+    }>;
+    /** 撤本 bot 最近发给该 peer 的消息；成功返回 true */
+    recallLast(target: ReplyTarget): Promise<boolean>;
+    /** 撤本 bot 发给该 peer 的最近第 index 条(index=1 最近一条, 2 倒数第二条...)；成功返回 true */
+    recallByIndex(target: ReplyTarget, index: number): Promise<boolean>;
+}
+/**
+ * 富媒体感知发送一段完整文本：
+ *  1) 若整段为 [RECALL] 指令(去掉指令后无实质内容) → 触发 bot.recallLast
+ *  2) 否则解析 [MEDIA:kind|src]，媒体段逐个 bot.sendMedia，文本段照常分块 sendMarkdown
+ *  富媒体指令与 [RECALL] 从展示文本中剔除；任一失败不抛(逐项记录由调用方/logger)。
+ */
+export declare function sendRichOutbound(bot: QQBotSender, target: ReplyTarget, text: string, limit: number, cwd: string | undefined, logError?: (msg: string) => void): Promise<void>;
+export declare class OutboundBuffer {
+    private readonly record;
+    private readonly bot;
+    private readonly limit;
+    private readonly logger;
+    private readonly cwd;
+    private buffer;
+    private flushing;
+    private readonly writer;
+    constructor(record: SessionRecord, bot: QQBotSender, limit: number, logger: Logger, streamingEnabled: boolean, cwd?: string | undefined);
+    /** 追加文本增量 */
+    append(text: string): void;
+    /** 获取当前累积文本 */
+    get text(): string;
+    /** 发送所有累积文本：流式优先，降级静态 */
+    flush(): Promise<void>;
+    /** 取消（异常/丢弃），中止流式并清空缓冲 */
+    cancel(): void;
+}
+//# sourceMappingURL=outbound-buffer.d.ts.map

package/dist/transport/outbound-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-buffer.d.ts","sourceRoot":"","sources":["../../src/transport/outbound-buffer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAevD,6BAA6B;AAC7B,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAAC;IACnD,yDAAyD;IACzD,SAAS,CACP,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,EAC1C,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5B,sCAAsC;IACtC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,uEAAuE;IACvE,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC/B,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAVtB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAG7B,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAC/B,gBAAgB,EAAE,OAAO,EACR,GAAG,GAAE,MAAM,GAAG,SAAqB;IAOtD,aAAa;IACN,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,eAAe;IACf,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,yBAAyB;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BnC,0BAA0B;IACnB,MAAM,IAAI,IAAI;CAItB"}

package/dist/transport/outbound-buffer.js

@@ -0,0 +1,131 @@
+import { chunkMarkdownText } from './chunker.js';
+import { StreamingWriter } from './streaming-writer.js';
+import { containsRecall, collectRecallIndices, parseOutbound, stripDirectives, resolveSource, } from './rich-media.js';
+import { stickerPerTurnCtx } from '../features/sticker-gate.js';
+/** 流式输出节流间隔(ms)：连续 chunk 累积后停顿该间隔才推送 */
+const STREAM_THROTTLE_MS = 200;
+/**
+ * 富媒体感知发送一段完整文本：
+ *  1) 若整段为 [RECALL] 指令(去掉指令后无实质内容) → 触发 bot.recallLast
+ *  2) 否则解析 [MEDIA:kind|src]，媒体段逐个 bot.sendMedia，文本段照常分块 sendMarkdown
+ *  富媒体指令与 [RECALL] 从展示文本中剔除；任一失败不抛(逐项记录由调用方/logger)。
+ */
+export async function sendRichOutbound(bot, target, text, limit, cwd, logError) {
+    const hasRecall = containsRecall(text);
+    const displayable = stripDirectives(text);
+    // 只要含 [RECALL(:N)] 就执行，一条回复里多个 [RECALL] 逐个撤(可一次撤多条)；
+    // 纯召回(去掉指令后无正文)且全未撤到 → 记录并停；否则继续发正文(正文已清所有指令，不会外显)
+    if (hasRecall) {
+        const indices = collectRecallIndices(text);
+        let any = false;
+        for (const idx of indices) {
+            if (await bot.recallByIndex(target, idx))
+                any = true;
+        }
+        if (!any && !displayable.trim()) {
+            logError?.('im-qqbot: [RECALL] 无可撤回消息或已超时');
+            return;
+        }
+    }
+    else if (!displayable.trim()) {
+        return;
+    }
+    // 用原始 text 解析(保留 [MEDIA])：媒体段单独发送，文本段各自剔除残留 [RECALL]
+    const segments = parseOutbound(text);
+    // P1 表情包闸门: perTurn(每轮最多 N 张)。每轮=一次 sendRichOutbound(一轮 assistant 回复文本)。
+    // 非表情包图(URL/库外文件/音视频)不计；真实闸门(禁群/频率/预算/去重/活性)在 sender.sendMedia 单点。
+    const perTurn = stickerPerTurnCtx(cwd);
+    let turnStickerSent = 0;
+    for (const seg of segments) {
+        if (seg.type === 'media') {
+            const isStickerSeg = perTurn.isSticker(seg.kind, seg.source);
+            if (isStickerSeg && perTurn.perTurnMax > 0 && turnStickerSent >= perTurn.perTurnMax) {
+                // 本轮已达每轮上限：吞掉后续表情包图(不打扰正文/不回执, 防 LLM 换图重试刷闸)
+                logError?.(`im-qqbot: 表情包闸门: 本轮已达每轮上限 ${perTurn.perTurnMax} 张, 已忽略后续表情包`);
+                continue;
+            }
+            const src = resolveSource(seg.source, cwd);
+            const sourceOpt = src.kind === 'url' ? { url: src.url } : { localPath: src.path };
+            try {
+                await bot.sendMedia(target, seg.kind, sourceOpt);
+                if (isStickerSeg)
+                    turnStickerSent += 1;
+            }
+            catch (err) {
+                if (err instanceof Error && err.name === 'StickerGateDenied') {
+                    logError?.(`im-qqbot: 表情包闸门拦截: ${err.message}`);
+                }
+                else {
+                    logError?.(`im-qqbot: 富媒体发送失败(${seg.kind}): ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        else {
+            const clean = stripDirectives(seg.text);
+            if (!clean.trim())
+                continue;
+            for (const chunk of chunkMarkdownText(clean, limit)) {
+                if (chunk.trim())
+                    await bot.sendMarkdown(target, chunk);
+            }
+        }
+    }
+}
+export class OutboundBuffer {
+    record;
+    bot;
+    limit;
+    logger;
+    cwd;
+    buffer = '';
+    flushing = false;
+    writer;
+    constructor(record, bot, limit, logger, streamingEnabled, cwd = undefined) {
+        this.record = record;
+        this.bot = bot;
+        this.limit = limit;
+        this.logger = logger;
+        this.cwd = cwd;
+        this.writer = streamingEnabled
+            ? new StreamingWriter({ bot, target: record.replyTarget, logger, throttleMs: STREAM_THROTTLE_MS })
+            : null;
+    }
+    /** 追加文本增量 */
+    append(text) {
+        this.buffer += text;
+        this.writer?.append(text);
+    }
+    /** 获取当前累积文本 */
+    get text() {
+        return this.buffer;
+    }
+    /** 发送所有累积文本：流式优先，降级静态 */
+    async flush() {
+        if (this.flushing || !this.buffer.trim())
+            return;
+        this.flushing = true;
+        try {
+            if (this.writer) {
+                await this.writer.finish();
+                // 流式成功（未降级）→ 直接返回
+                if (!this.writer.shouldFallback)
+                    return;
+            }
+            // 降级：静态发送（writer 不存在 or 流式失败）→ 富媒体感知发送
+            await sendRichOutbound(this.bot, this.record.replyTarget, this.buffer, this.limit, this.cwd, (m) => this.logger.error(m));
+        }
+        catch (err) {
+            this.logger.error(`im-qqbot: flush failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            this.buffer = '';
+            this.flushing = false;
+        }
+    }
+    /** 取消（异常/丢弃），中止流式并清空缓冲 */
+    cancel() {
+        this.writer?.abort();
+        this.buffer = '';
+    }
+}
+//# sourceMappingURL=outbound-buffer.js.map