@zaofan/dsh-qqbot 1.5.30 → 1.6.0

package/dist/transport/inbound.d.ts

@@ -1,10 +1,43 @@
 import type { SessionManager } from '../session/index.js';
 import type { ImQQBotConfig } from '../config.js';
 import type { Logger } from '../types.js';
+export interface ResolvedQuote {
+    /** SDK 给的被引用消息索引（msg_idx）—— 本地台账回查用 */
+    refKey?: string;
+    text?: string;
+    entry?: {
+        senderId?: string;
+        content?: string;
+    };
+    attachments?: {
+        contentType?: string;
+        url?: string;
+        filename?: string;
+        asrText?: string;
+    }[];
+}
+/**
+ * 群消息时间头：同一会话**同一分钟内只注入一次**。
+ *
+ * 2026-10-01 主人要求（省 token）：「同一分钟的消息或聚合消息不重复显示时间」。
+ * 原来每轮入站都无条件在最前面加 `[YYYY-MM-DD 周X HH:MM]` —— 同一分钟里连发几轮 / 聚合一波，
+ * 上下文里就堆出好几行一模一样的时间头（每行 ~25 字符，纯浪费）。
+ * 现在同分钟内的后续回合不再重复注入：时间信息不变（最近那条时间头就是当前时间），信息量零损失。
+ *
+ * @param cache 会话 → 上次时间头（进程内缓存，重启自然清空 → 重启后第一条会重新带上）
+ * @returns 要注入的时间行（形如 `[2026-10-01 周四 20:47]`），本次不需注入时返回 null
+ */
+export declare function groupTimeHead(cache: Map<string, string>, scope: string, peerId: string, now?: Date): string | null;
 /**
  * 处理 QQ 入站消息（已经过 SDK 中间件链）
  */
 export declare function handleInbound(rawMsg: unknown, manager: SessionManager, config: ImQQBotConfig, logger: Logger, state?: Record<string, unknown>): Promise<void>;
+export declare function buildQuoteBlock(quote: ResolvedQuote | undefined, stickerDir: string): string;
+/**
+ * Layer 2 成品：引用块 + 紧随其后的 `[当前]`（短标记见 markers.ts）。
+ * ⚠️ 历史行请用 {@link buildQuoteBlock} —— 那边不该出现 `[当前]` 标记。
+ */
+export declare function buildQuotePart(quote: ResolvedQuote | undefined, stickerDir: string): string;
 /**
  * Layer 3: 带发送者标签的用户消息
  * 引用消息功能开启时, 每条入站都带**短消息号**(msgRef, 形如 0913a; 群聊挂发送者标签, 私聊独立一行)

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

@@ -1 +1 @@
-{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../src/transport/inbound.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAa,MAAM,EAA8B,MAAM,aAAa,CAAC;AAoGjF;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAqtBf;AAqPD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,CAgBR"}
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../src/transport/inbound.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAa,MAAM,EAA8B,MAAM,aAAa,CAAC;AA+CjF,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,WAAW,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7F;AAqDD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAQ9H;AAID;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6uBf;AA+ND,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAiC5F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3F;AAgID;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,CAkBR"}

package/dist/transport/inbound.js

@@ -6,12 +6,15 @@ import { traceContextless } from '../features/contextless-store.js';
 import { applyInjectRules } from './inject-rules.js';
 import { inferMediaKind, mediaKindLabel } from './media-kind.js';
 import { replaceBotMention, mentionsOthers } from '../shared/mention-clean.js';
+import { resolveMentionNames } from '../features/chat-ledger.js';
 import { MK, QUOTE_BEGIN_ALL, QUOTE_END_ALL, findFirstMarker, findLastMarker, escapeBlockMarkers, stripBlockMarkers } from './markers.js';
 import { dataRootOf, stickerDirOf } from '../gateway/data-root.js';
 import { registerMsgIndex } from './msg-index.js';
 import { createValueScorer, appendScoreLog, OTHER_MENTION_PENALTY } from '../features/value-score.js';
 import { getStickerStore, computeDHash } from '../features/sticker-store.js';
 import { lookupImagePath, rememberImagePath } from '../features/image-path-cache.js';
+import { extractFaceImageUrls, slimQuoteText } from './quote-text.js';
+import { lookupMsgContent, rememberMsgContent } from './msg-content-cache.js';
 import { recordImageUrl, lookupStickerIdByUrl } from '../features/image-url-ledger.js';
 import { pushQuote } from '../features/quote-cache.js';
 import { computeRelevance, touchAffinity, classifyEmo, getAffinityEntry, memoryStrength } from '../features/local-signals.js';
@@ -24,6 +27,29 @@ import { detectSelfDisclosure, selfDisclosureHint, bumpHint } from '../features/
 import { createLocalEmbedder } from '../features/local-embed.js';
 /** 小传注入节流(同一人 24h 内不重复): uid → 上次注入时间 */
 const memoInjectAt = new Map();
+/** 每会话"上次注入的群时间头"（同分钟不重复注入，省 token） */
+const lastGroupTimeHead = new Map();
+/**
+ * 群消息时间头：同一会话**同一分钟内只注入一次**。
+ *
+ * 2026-10-01 主人要求（省 token）：「同一分钟的消息或聚合消息不重复显示时间」。
+ * 原来每轮入站都无条件在最前面加 `[YYYY-MM-DD 周X HH:MM]` —— 同一分钟里连发几轮 / 聚合一波，
+ * 上下文里就堆出好几行一模一样的时间头（每行 ~25 字符，纯浪费）。
+ * 现在同分钟内的后续回合不再重复注入：时间信息不变（最近那条时间头就是当前时间），信息量零损失。
+ *
+ * @param cache 会话 → 上次时间头（进程内缓存，重启自然清空 → 重启后第一条会重新带上）
+ * @returns 要注入的时间行（形如 `[2026-10-01 周四 20:47]`），本次不需注入时返回 null
+ */
+export function groupTimeHead(cache, scope, peerId, now = new Date()) {
+    const p = (n) => String(n).padStart(2, '0');
+    const wd = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'][now.getDay()];
+    const stamp = `${now.getFullYear()}-${p(now.getMonth() + 1)}-${p(now.getDate())} ${wd} ${p(now.getHours())}:${p(now.getMinutes())}`;
+    const key = `${scope}:${peerId}`;
+    if (cache.get(key) === stamp)
+        return null;
+    cache.set(key, stamp);
+    return `[${stamp}]`;
+}
 // ── 主处理函数 ──
 /**
  * 处理 QQ 入站消息（已经过 SDK 中间件链）
@@ -88,6 +114,32 @@ export async function handleInbound(rawMsg, manager, config, logger, state) {
     catch (e) {
         logger.warn(`im-qqbot: 拼消息前的图片预检失败(不影响主流程): ${e instanceof Error ? e.message : String(e)}`);
     }
+    // 2026-10-01: 登记"这条消息的文本 + 图片本地路径"，供**别人引用它**时还原
+    //   （QQ 引用纯图片给不出图，只能自己记；见 transport/msg-content-cache.ts）
+    //   ⚠️ 位置讲究：必须在上面那次"图片预检"(会 rememberImagePath) **之后** —— 那时查缓存才有本地路径。
+    try {
+        const _mi = String(msg.msgIdx ?? '').trim();
+        if (_mi) {
+            const _imgs = [];
+            for (const _a of (Array.isArray(msg.attachments) ? msg.attachments : [])) {
+                const _url = String(_a?.url ?? '').trim();
+                if (!_url)
+                    continue;
+                // ⚠️ 2026-10-01: 用**两级解析**（内存缓存 → 图库台账反查）——
+                //   台账是落盘的、跨重启/超 TTL 也命中；只查内存缓存的话（TTL 1h），
+                //   稍早的图就记不下本地路径了（主人实测：引用的图明明在图库里，却没转成本地路径）。
+                const _lp = resolveImageLocalPath(_url, stickerDirOf(config));
+                if (_lp && !_imgs.includes(_lp))
+                    _imgs.push(_lp);
+            }
+            const _txt = String(msg.content ?? '').trim();
+            rememberMsgContent(dataRootOf(config), `${scope}:${peerId}`, _mi, {
+                ...(_txt ? { t: _txt.slice(0, 200) } : {}),
+                ...(_imgs.length ? { imgs: _imgs } : {}),
+            });
+        }
+    }
+    catch { /* 台账失败不影响主链 */ }
     let agentBody = assembleAgentBody(msg, mwState, scope, logger, downloaded, refEnabled, msgRef, dataRootOf(config), stickerDirOf(config));
     if (!agentBody)
         return;
@@ -148,11 +200,12 @@ export async function handleInbound(rawMsg, manager, config, logger, state) {
     // 群聊时间戳(原"群守则"拼接位): 守则已迁 systemPrompt.section(session-manager 装配期注册,
     // 每请求进 system, 不再每轮塞 user 历史); 此处改为注入当前系统时间, 让 AI 每轮知道日期/星期/时刻。
     // 2026-09-15 省 token: 去掉"当前时间"四个字(上下文里一看就懂), 一条省 ~4 token。
+    // 2026-10-01 省 token(主人要求): **同一分钟只注入一次** —— 同分钟连发几轮/聚合一波时,
+    //   重复的时间头(每行 ~25 字符)没有信息量, 直接省掉。见 groupTimeHead()。
     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}`;
+        const _head = groupTimeHead(lastGroupTimeHead, scope, peerId, new Date());
+        if (_head)
+            agentBody = `${_head}\n\n${agentBody}`;
     }
     logger.debug(`Processing: scope=${scope} peerId=${peerId} body="${agentBody.slice(0, 200)}"`);
     // ── 获取或创建会话 ──
@@ -788,15 +841,52 @@ export async function handleInbound(rawMsg, manager, config, logger, state) {
  * 组装 agentBody — AI 实际看到的完整上下文
  */
 function assembleAgentBody(msg, state, scope, logger, downloaded, enableRef, msgRef, dataRoot, stickerDir) {
-    const userContent = buildUserContent(msg, state, logger);
+    const userContentRaw = buildUserContent(msg, state, logger);
+    // 2026-10-01 主人实测「别人 @ 别人怎么没转换成昵称，依然是 id」：
+    //   正文里 @ 别人的 `<@openid>` 查**群成员台账**换成 `@昵称`（查不到退化成 @短id）；
+    //   顺手省 token —— `<@07B470BDA5052489D2D0532C2CC2A2EB>`(35 字符) → `@难崩`(3 字符)。
+    const userContent = resolveMentionNames(userContentRaw, stickerDir, scope === 'group' ? msg.groupOpenid : undefined);
     if (!userContent && (!msg.attachments || msg.attachments.length === 0))
         return null;
-    let quotePart = buildQuotePart(state.quote);
+    // ⚠️ 2026-10-01: QQ 引用**纯图片**时 msg_elements 给不出图 —— 先用本地台账补一把（见 msg-content-cache.ts）
+    const quotePeer = `${scope}:${scope === 'group' ? (msg.groupOpenid ?? msg.senderId) : msg.senderId}`;
+    const quote = enrichQuoteFromCache(state.quote, dataRoot, quotePeer);
+    let quotePart = buildQuotePart(quote, stickerDir);
     // 引用消息(2026-09-13): SDK 中间件没解析出 quote 时, 自己从 103/msg_elements 提取被引用原文
     if (!quotePart && enableRef) {
         const quoted = extractQuotedContent(msg);
-        if (quoted)
-            quotePart = `${MK.QUOTE_BEGIN}\n${escapeBlockMarkers(quoted)}\n${MK.QUOTE_END}\n${MK.CURRENT}\n`;
+        // ⚠️ 2026-10-01 主人实测抓到的**漏网之鱼**：这条路（SDK 没解析出 quote 时的兜底）拿到的是
+        //   `msg_elements` 的**原串** —— `=== 消息 1 === [消息内容] … [消息类型] 引用消息 …` 模板串，
+        //   原来没剥壳就直接塞进上下文（还会被 trimQuoteBlock 按"519 字"截断＋缓存，看着莫名其妙）。
+        //   这里跟 buildQuoteBlock 用**同一套清洗**：剥模板壳 + 只留最外层那句 + 表情转可读。
+        const lines = [];
+        const slim = quoted ? slimQuoteText(quoted, 0) : '';
+        if (slim)
+            lines.push(escapeBlockMarkers(slim));
+        // ⚠️ 2026-10-01 补（主人问"多图+文本混合考虑了吗"时发现的缺口）：
+        //   SDK 连 quote 都没解析出来时，**也要查我们自己的内容台账** —— 否则"引用一条图片表情 /
+        //   纯图片消息"永远是空的（QQ 那边只给一个空表情标签，没有任何媒体标识）。
+        //   被引用消息的索引藏在 `message_scene.ext` 的 `ref_msg_idx=` 里。
+        //   台账天然支持**多图 + 文本混合**（imgs 是数组，逐张出行）。
+        const _ext = Array.isArray(msg.message_scene?.ext) ? msg.message_scene.ext : [];
+        const _refRaw = _ext.find((x) => typeof x === 'string' && x.startsWith('ref_msg_idx='));
+        const refIdx = typeof _refRaw === 'string' ? _refRaw.slice('ref_msg_idx='.length).trim() : '';
+        if (refIdx) {
+            const hit = lookupMsgContent(dataRoot, quotePeer, refIdx);
+            if (hit) {
+                if (!slim && hit.t)
+                    lines.push(escapeBlockMarkers(slimQuoteText(hit.t, 0)));
+                for (const p of hit.imgs ?? []) {
+                    const line = describeQuoteAttachment({ contentType: 'image/*', url: p }, stickerDir);
+                    if (line)
+                        lines.push(line);
+                }
+            }
+        }
+        // ⚠️ 2026-10-01：这里**不再自带** `[当前]` —— 它由 Layer 5(buildAgentBody) 统一输出，
+        //   否则群聊带引用时会出现两个 `[当前]`，引用块被夹在中间（主人实测："引用被塞到当前外面"）。
+        if (lines.length > 0)
+            quotePart = `${MK.QUOTE_BEGIN}\n${lines.join('\n')}\n${MK.QUOTE_END}\n`;
     }
     // ⚠️ 2026-09-13 主人要求(省 token): 引用原文只给**前 QUOTE_KEEP 字**,
     //   完整原文进本地缓存(每会话最多 10 条) → AI 需要时用 `quote_view` 工具取。
@@ -806,7 +896,7 @@ function assembleAgentBody(msg, state, scope, logger, downloaded, enableRef, msg
     const batchDispatch = state.batchDispatch === true;
     const aggregated = state.aggregated === true;
     const userMessage = buildUserMessage(userContent, quotePart, msg.senderId, msg.senderName, isGroup, wasMentioned, msgRef);
-    const dynamicCtx = buildDynamicCtx(msg, state, downloaded);
+    const dynamicCtx = buildDynamicCtx(msg, downloaded);
     const base = dynamicCtx ? `${dynamicCtx}${userMessage}` : userMessage;
     // ⚠️ 2026-09-10 去重(主人: "图片链接重复两次"): 聚合/冷却重新派发时, 同一条消息会**既被
     //   mediaHistoryBuffer 记进历史、又作为当前消息出现** → 同一条消息(含媒体 URL)在上下文里出现
@@ -913,13 +1003,121 @@ function cleanTextForScore(raw) {
 }
 /**
  * Layer 2: 引用消息块
+ *
+ * ⚠️ 2026-10-01 修（主人实测：群里有人**引用一张表情包**回话，AI 完全不知道引用的是哪张图 → 答非所问）：
+ *   两个叠在一起的坑：
+ *     ① 原判空只看 `text`/`entry.content` —— 对方引用纯图（自己没有文字）时整块引用**直接消失**；
+ *     ② 即使非空，SDK 的 `quote-ref` 中间件把附件**降级成占位文本**（`[image]` / `[image: a.png]`，
+ *        见 `@tencent-connect/qqbot-nodejs/src/middleware/quote-ref.ts` 的 `buildText`）——
+ *        **URL 被丢掉了**，模型对着 4 个字干瞪眼。
+ *   好在 `quote.attachments[].url` 一直都在手边（SDK 已解析，只是没人用）。
+ *   → 现在把被引用消息的附件**内联进引用块**，图片给「**本地路径优先、URL 兜底**」的可读目标
+ *     （本地路径模型能用视觉工具直接读图；QQ 链接又长又会过期），语音给 ASR 转写，文件给文件名+URL。
+ */
+/**
+ * 用本地台账补齐 QQ 没给全的被引用内容（2026-10-01 主人实测：引用**纯图片**看不到是哪张图）。
+ *   QQ 引用纯图时 msg_elements 可能只给个文件名、甚至什么都不给 → 按 SDK 给的 refKey（= 被引用消息的 msg_idx）
+ *   回查我们**入站时**记下的台账（见 msg-content-cache.ts），补出图片**本地路径**（AI 能直接读）。
+ *   已经够了（有正文 + 有附件）就直接原样返回，零开销。
  */
-function buildQuotePart(quote) {
-    if (!quote?.text && !quote?.entry?.content)
+function enrichQuoteFromCache(q, dataRoot, peerKey) {
+    if (!q)
+        return q;
+    const refKey = String(q.refKey ?? '').trim();
+    if (!refKey)
+        return q;
+    const rawText = String(q.text ?? q.entry?.content ?? '').trim();
+    const hasText = Boolean(rawText) && !isPlaceholderQuoteText(rawText);
+    const hasAtt = Array.isArray(q.attachments) && q.attachments.length > 0;
+    if (hasText && hasAtt)
+        return q;
+    const hit = lookupMsgContent(dataRoot, peerKey, refKey);
+    if (!hit)
+        return q;
+    const out = { ...q };
+    if (!hasText && hit.t)
+        out.text = hit.t;
+    if (!hasAtt && hit.imgs && hit.imgs.length) {
+        // 走"本机路径"分支：describeQuoteAttachment 会原样给出路径（图库/缓存查不到也不会坏）
+        out.attachments = hit.imgs.map((p) => ({ contentType: 'image/*', url: p }));
+    }
+    return out;
+}
+export function buildQuoteBlock(quote, stickerDir) {
+    const atts = Array.isArray(quote?.attachments) ? quote.attachments : [];
+    const rawText = String(quote?.text ?? quote?.entry?.content ?? '').trim();
+    // 2026-10-01: 表情消息（图片表情 / 收藏表情）在 msg_elements 里只给一个 `<faceType=…,ext="base64">` ——
+    //   先把 ext 里**可能藏着**的图片 URL 挖出来当附件用；实测常见形态 ext=`{"text":""}` 是空的，
+    //   那种只能靠"那条消息入站时登记的台账"回查（见 msg-content-cache.ts / enrichQuoteFromCache）。
+    const faceImgs = extractFaceImageUrls(rawText);
+    // SDK 由附件拼出的占位文本（纯 `[image]` / `[voice: xx]`…）在有附件行时不必重复一遍
+    const text = (atts.length > 0 || faceImgs.length > 0) && isPlaceholderQuoteText(rawText) ? '' : rawText;
+    if (!text && atts.length === 0 && faceImgs.length === 0)
         return '';
-    const quoteText = escapeBlockMarkers(quote.text || quote.entry?.content || 'Original content unavailable');
-    // 短标记(2026-09-15 省 token): [引]…[/引][当前] —— 见 markers.ts
-    return `${MK.QUOTE_BEGIN}\n${quoteText}\n${MK.QUOTE_END}\n${MK.CURRENT}\n`;
+    const lines = [];
+    // 2026-10-01: 剥掉 QQ 的引用模板壳（`=== 消息 N === [消息内容]…[消息类型] 引用消息 …`）并压平，
+    //   只去噪声不限长 —— 限长交给调用方（当前消息走 trimQuoteBlock 的 60 字+缓存，历史行走媒体历史那边）
+    if (text) {
+        // 表情标签在这里转成 `【表情: 微笑】`（原样是 `<faceType=6,faceId="0",ext="…">`，谁也看不懂）
+        const slim = slimQuoteText(text, 0);
+        if (slim)
+            lines.push(escapeBlockMarkers(slim));
+    }
+    for (const a of atts) {
+        const line = describeQuoteAttachment(a, stickerDir);
+        if (line)
+            lines.push(line);
+    }
+    // 表情标签 ext 里挖到的图片 URL（图片表情的其它端形态）→ 同样给一行"被引用的图片"
+    for (const u of faceImgs) {
+        const line = describeQuoteAttachment({ contentType: 'image/*', url: u }, stickerDir);
+        if (line)
+            lines.push(line);
+    }
+    if (lines.length === 0)
+        return '';
+    // 排版(2026-10-01 专家团共识): 引用内容整体退 2 格 —— 视觉上从属, 不再和正文同权重
+    const indented = lines.map((l) => '  ' + l).join('\n');
+    return `${MK.QUOTE_BEGIN}\n${indented}\n${MK.QUOTE_END}`;
+}
+/**
+ * Layer 2 成品：引用块 + 紧随其后的 `[当前]`（短标记见 markers.ts）。
+ * ⚠️ 历史行请用 {@link buildQuoteBlock} —— 那边不该出现 `[当前]` 标记。
+ */
+export function buildQuotePart(quote, stickerDir) {
+    const blk = buildQuoteBlock(quote, stickerDir);
+    // ⚠️ 2026-10-01：`[当前]` 由 Layer 5 统一输出 —— 引用块与正文都属于当前消息，
+    //   引用块自己再带一个会让 `[当前]` 重复、引用块看起来"在当前消息之外"（主人实测）。
+    return blk ? `${blk}\n` : '';
+}
+/** SDK 的附件占位文本（整段只有 `[image]`/`[video: x]`/`[voice: x]`/`[file: x]` 这类行） */
+function isPlaceholderQuoteText(t) {
+    if (!t)
+        return true;
+    return t.split('\n').every((l) => /^\[(image|video|voice|file)(:\s*[^\]]*)?\]$/i.test(l.trim()));
+}
+/** 被引用消息的附件 → 一行可读描述（图片优先给**本地路径**，模型能直接读图） */
+function describeQuoteAttachment(a, stickerDir) {
+    const ct = String(a?.contentType ?? '').toLowerCase();
+    const name = String(a?.filename ?? '').trim();
+    const url = String(a?.url ?? '').trim();
+    const ext = (name.split('.').pop() ?? '').toLowerCase();
+    const isImg = ct.startsWith('image/') || /^(jpe?g|png|gif|webp|bmp)$/.test(ext);
+    const isVoice = ct.startsWith('audio/') || ct.includes('voice') || /^(silk|amr|ogg|mp3|wav|m4a|aac|opus)$/.test(ext);
+    const isVideo = ct.startsWith('video/') || /^(mp4|webm|mov|m4v)$/.test(ext);
+    if (isVoice) {
+        const asr = String(a?.asrText ?? '').trim();
+        return asr ? `🎵 被引用的语音转写: ${asr}` : `🎵 被引用的语音${name ? ': ' + name : ''}`;
+    }
+    if (isImg) {
+        // 与历史图片瘦身同一条解析链(缓存 → 图库台账 → 当前真实路径); 命中就给本地路径, 否则保留 QQ 原链
+        const local = url ? resolveImageLocalPath(url, stickerDir) : undefined;
+        const target = local ?? url;
+        return target ? `📷 被引用的图片: ${target}` : `📷 被引用的图片${name ? ': ' + name : ''}`;
+    }
+    if (isVideo)
+        return `🎬 被引用的视频${name ? ': ' + name : ''}${url ? ' → ' + url : ''}`;
+    return `📎 被引用的文件${name ? ': ' + name : ''}${url ? ' → ' + url : ''}`;
 }
 /**
  * (转义实现已搬到 `markers.ts` 的 `escapeBlockMarkers` —— 新旧两套标记一起转义, 见那里的注释)
@@ -972,6 +1170,9 @@ function localizeHistoryImages(text, stickerDir) {
  *   截断切错位置、外层的 `[Quoted message ends]` 反而留在后面。
  *   现在: ①取**第一个 begin + 最后一个 end**(认外层) ②引用原文里的标记先转义(见 escapeQuoteMarkers)。
  */
+/** 引用块里的"附件行"（`📷 被引用的图片: …` 等）—— 截断豁免标记，别被 60 字上限挤掉
+ *  ⚠️ 别写成字符类 `[📷🎵🎬📎]` —— emoji 是代理对，在字符类里会被拆成单个 UTF-16 码元，匹配不上。 */
+const QUOTE_ATT_LINE_RE = /^\s*(?:📷|🎵|🎬|📎)\s*被引用的/;
 function trimQuoteBlock(quotePart, dataRoot, msg, logger) {
     if (!quotePart)
         return quotePart;
@@ -981,13 +1182,19 @@ function trimQuoteBlock(quotePart, dataRoot, msg, logger) {
     if (!b || !e || e.idx <= b.idx)
         return quotePart;
     const full = quotePart.slice(b.idx + b.len, e.idx).trim();
-    if (full.length <= QUOTE_KEEP)
+    // ⚠️ 2026-10-01: 附件行**不参与 60 字截断** —— 那是"被引用的是哪张图"的唯一线索,
+    //   被前面的文字挤掉就等于白修(见 buildQuotePart 的注释)。
+    const allLines = full.split('\n');
+    const attLines = allLines.filter((l) => QUOTE_ATT_LINE_RE.test(l.trim()));
+    const textPart = allLines.filter((l) => !QUOTE_ATT_LINE_RE.test(l.trim())).join('\n').trim();
+    // 文字部分没超长 → 整块原样返回（附件行照旧留着，也不必打"已缓存"提示）
+    if (textPart.length <= QUOTE_KEEP)
         return quotePart;
     const key = `${msg.kind === 'group' ? 'group' : 'c2c'}:${(msg.kind === 'group' ? msg.groupOpenid : undefined) ?? msg.senderId}`;
     try {
         const hit = pushQuote(dataRoot, key, full, msg.senderName);
-        const head = full.slice(0, QUOTE_KEEP).replace(/\s+/g, ' ');
-        logger.debug(`[引用] 原文 ${full.length} 字 → 只给前 ${QUOTE_KEEP} 字(缓存 #${hit.id})`);
+        const head = [textPart.slice(0, QUOTE_KEEP).replace(/\s+/g, ' '), ...attLines].filter(Boolean).join('\n');
+        logger.debug(`[引用] 原文 ${full.length} 字 → 只给前 ${QUOTE_KEEP} 字(缓存 #${hit.id}); 附件行 ${attLines.length} 条不截断`);
         return `${quotePart.slice(0, b.idx)}${quotePart.slice(b.idx, b.idx + b.len)}\n${head}…[引用#${hit.id}: 全文 ${full.length} 字已缓存, 需要时用 quote_view 查]\n${quotePart.slice(e.idx)}`;
     }
     catch {
@@ -1032,12 +1239,14 @@ export function buildUserMessage(userContent, quotePart, senderId, senderName, i
     const idPart = wasMentioned ? ` (${senderId})` : '';
     const refPart = msgRef ? ` #${msgRef}` : '';
     const senderTag = `[${displayName}${idPart}${refPart}]`;
-    return `${quotePart}${senderTag} ${userContent}${mentionTag}`;
+    // 排版: 多行正文才缩进(单行保持原样, 不徒增视觉噪声)
+    const body = userContent.includes('\n') ? userContent.split('\n').map((l) => '  ' + l).join('\n') : userContent;
+    return `${quotePart}${senderTag} ${body}${mentionTag}`;
 }
 /**
  * Layer 4: 媒体元数据上下文
  */
-function buildDynamicCtx(msg, state, downloaded) {
+function buildDynamicCtx(msg, downloaded) {
     const lines = [];
     if (!msg.attachments || msg.attachments.length === 0)
         return '';
@@ -1078,14 +1287,6 @@ function buildDynamicCtx(msg, state, downloaded) {
     }
     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';
 }
 /**
@@ -1109,7 +1310,10 @@ function buildAgentBody(base, history, isGroup, wasMentioned, batchDispatch = fa
         // 2026-09-12 token 瘦身(主人定): 历史行默认**只给昵称**; 只有"当时 @ 过 bot 的那条"带 openid ——
         // 32 位 openid 每行占 20+ token, limit=20 时每轮白烧 ~640; 要 id 时用 session_list / 台账反查。
         const mentioned = h.mentioned === true;
-        return mentioned && h.senderId ? `[${name} (${h.senderId})] ${h.content}` : `[${name}] ${h.content}`;
+        // 排版: 多行 content 退 2 格 —— 让"一条消息"视觉成块
+        const raw = String(h.content ?? '');
+        const c = raw.includes('\n') ? raw.split('\n').map((l) => '  ' + l).join('\n') : raw;
+        return mentioned && h.senderId ? `[${name} (${h.senderId})] ${c}` : `[${name}] ${c}`;
     });
     return [
         aggregated ? '[系统提示] 以下是上次回复前群友所发(非对你的回应), 通读后综合回应。' : '',