openclaw-plugin-yuanbao 2.13.4 → 2.13.5

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-declare const _default: import("openclaw/plugin-sdk/channel-entry-contract").BundledChannelEntryContract<import("openclaw/plugin-sdk").ChannelPlugin>;
+declare const _default: import("openclaw/plugin-sdk/channel-entry-contract").BundledChannelEntryContract<import("openclaw/plugin-sdk/channel-plugin-common").ChannelPlugin>;
 export default _default;

package/dist/setup-entry.d.ts

@@ -1,2 +1,2 @@
-declare const _default: import("openclaw/plugin-sdk/channel-entry-contract").BundledChannelSetupEntryContract<import("openclaw/plugin-sdk").ChannelPlugin>;
+declare const _default: import("openclaw/plugin-sdk/channel-entry-contract").BundledChannelSetupEntryContract<import("openclaw/plugin-sdk/channel-plugin-common").ChannelPlugin>;
 export default _default;

package/dist/src/business/commands/log-upload/cos-upload.js

@@ -2,6 +2,7 @@ import { randomBytes } from "node:crypto";
 import { readFile } from "node:fs/promises";
 import { basename } from "node:path";
 import { apiGetUploadInfo } from "../../../access/api.js";
+import { createCosClient } from "../../../infra/cos.js";
 import { createLog } from "../../../logger.js";
 const DEFAULT_RECORD_API_URL = "https://yuanbao.tencent.com/e/api/clawLogUpload";
 function resolveRecordApiUrl(config) {
@@ -14,46 +15,8 @@ function resolveRecordApiUrl(config) {
 function generateFileId() {
     return randomBytes(16).toString("hex");
 }
-/**
- * Upload Buffer data to Tencent Cloud COS.
- *
- * Same COS upload implementation as uploadBufferToCos in media.ts.
- * Initializes COS SDK with temp credentials from genUploadInfo, then calls putObject.
- * Uses dynamic import for cos-nodejs-sdk-v5, compatible with both CJS and ESM.
- */
 async function uploadBufferToCos(config, data) {
-    let COS;
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        COS = require("cos-nodejs-sdk-v5");
-        if (COS?.default) {
-            COS = COS.default;
-        }
-    }
-    catch {
-        try {
-            const pkg = await import("cos-nodejs-sdk-v5");
-            COS = pkg.default ?? pkg;
-        }
-        catch {
-            throw new Error("缺少依赖 cos-nodejs-sdk-v5，请运行 pnpm add cos-nodejs-sdk-v5");
-        }
-    }
-    const COSConstructor = COS;
-    const cos = new COSConstructor({
-        FileParallelLimit: 10,
-        getAuthorization(_, callback) {
-            callback({
-                TmpSecretId: config.encryptTmpSecretId,
-                TmpSecretKey: config.encryptTmpSecretKey,
-                SecurityToken: config.encryptToken,
-                StartTime: config.startTime,
-                ExpiredTime: config.expiredTime,
-                ScopeLimit: true,
-            });
-        },
-        UseAccelerate: true,
-    });
+    const cos = createCosClient(config);
     await cos.putObject({
         Bucket: config.bucketName,
         Region: config.region,

package/dist/src/business/commands/upgrade/utils.d.ts

@@ -17,7 +17,7 @@ export declare function getLatestStableVersion(): Promise<string | null>;
  */
 export declare function isPublishedVersionOnNpm(version: string): Promise<boolean>;
 /**
- * Parse `openclaw plugins list` output and return the installed version of the specified plugin.
+ * Query `openclaw plugins inspect --json` and return the installed version of the specified plugin.
  * Returns null if plugin is not installed or parsing fails.
  */
 export declare function readInstalledVersion(pluginId: string): Promise<string | null>;

package/dist/src/business/commands/upgrade/utils.js

@@ -123,30 +123,33 @@ export async function isPublishedVersionOnNpm(version) {
     }
 }
 /**
- * Parse `openclaw plugins list` output and return the installed version of the specified plugin.
+ * Query `openclaw plugins inspect --json` and return the installed version of the specified plugin.
  * Returns null if plugin is not installed or parsing fails.
  */
 export async function readInstalledVersion(pluginId) {
     log.info("读取已安装版本", { pluginId });
-    const result = await runOpenClawCommand(["plugins", "list"]);
+    const result = await runOpenClawCommand(["plugins", "inspect", pluginId, "--json"]);
     if (!result.ok) {
-        log.warn("openclaw plugins list 执行失败", {
+        log.warn("openclaw plugins inspect 执行失败", {
             summary: result.error,
             ...(result.stderr ? { stderr: result.stderr } : {}),
         });
         return null;
     }
-    for (const line of (result.stdout ?? "").split("\n")) {
-        if (line.toLowerCase().includes(pluginId.toLowerCase())) {
-            const match = line.match(/(\d+\.\d+\.\d+(?:-[\w.]+)?)/);
-            if (match) {
-                log.info("已安装版本", { pluginId, version: match[1] });
-                return match[1];
-            }
+    try {
+        const data = JSON.parse(result.stdout ?? "");
+        const version = data.plugin?.version;
+        if (version && isValidVersion(version)) {
+            log.info("已安装版本", { pluginId, version });
+            return version;
         }
+        log.warn("未检测到已安装版本", { pluginId, raw: result.stdout });
+        return null;
+    }
+    catch (e) {
+        log.warn("解析 inspect JSON 失败", { pluginId, summary: firstLine(e) });
+        return null;
     }
-    log.warn("未检测到已安装版本", { pluginId });
-    return null;
 }
 /**
  * Snapshot `channels.yuanbao` config, outputting a JSON string usable with `config set ... --strict-json`.

package/dist/src/business/messaging/chat-history.d.ts

@@ -26,10 +26,15 @@ export type MediaHistoryEntry = {
 };
 /** Group chat message history Map, keyed by groupCode */
 export declare const chatHistories: Map<string, GroupHistoryEntry[]>;
-/** Media history LRU, keyed by groupCode, not cleared by clearHistoryEntriesIfEnabled */
+/** Media history LRU, keyed by chatKey. Not cleared by clearHistoryEntriesIfEnabled. */
 export declare const chatMediaHistories: Map<string, MediaHistoryEntry[]>;
+/**
+ * Derive a chat-level cache key for media history.
+ * Format follows prepare-sender convention: `group:{groupCode}` / `direct:{fromAccount}`.
+ */
+export declare function deriveChatKey(isGroup: boolean, groupCode?: string, fromAccount?: string): string;
 /**
  * Write media entry to standalone LRU, evicting oldest entries when exceeding limit.
  * Decoupled from text `chatHistories` to prevent media loss when text history is cleared after @bot.
  */
-export declare function recordMediaHistory(groupCode: string, entry: MediaHistoryEntry): void;
+export declare function recordMediaHistory(chatKey: string, entry: MediaHistoryEntry): void;

package/dist/src/business/messaging/chat-history.js

@@ -8,24 +8,34 @@
  */
 /** Group chat message history Map, keyed by groupCode */
 export const chatHistories = new Map();
-const MEDIA_HISTORY_MAX_PER_GROUP = 50;
-/** Media history LRU, keyed by groupCode, not cleared by clearHistoryEntriesIfEnabled */
+const MEDIA_HISTORY_MAX_PER_CHAT = 50;
+/** Media history LRU, keyed by chatKey. Not cleared by clearHistoryEntriesIfEnabled. */
 export const chatMediaHistories = new Map();
+/**
+ * Derive a chat-level cache key for media history.
+ * Format follows prepare-sender convention: `group:{groupCode}` / `direct:{fromAccount}`.
+ */
+export function deriveChatKey(isGroup, groupCode, fromAccount) {
+    if (isGroup && groupCode) {
+        return `group:${groupCode}`;
+    }
+    return `direct:${fromAccount ?? "unknown"}`;
+}
 /**
  * Write media entry to standalone LRU, evicting oldest entries when exceeding limit.
  * Decoupled from text `chatHistories` to prevent media loss when text history is cleared after @bot.
  */
-export function recordMediaHistory(groupCode, entry) {
+export function recordMediaHistory(chatKey, entry) {
     if (entry.medias.length === 0) {
         return;
     }
-    let list = chatMediaHistories.get(groupCode);
+    let list = chatMediaHistories.get(chatKey);
     if (!list) {
         list = [];
-        chatMediaHistories.set(groupCode, list);
+        chatMediaHistories.set(chatKey, list);
     }
     list.push(entry);
-    if (list.length > MEDIA_HISTORY_MAX_PER_GROUP) {
-        list.splice(0, list.length - MEDIA_HISTORY_MAX_PER_GROUP);
+    if (list.length > MEDIA_HISTORY_MAX_PER_CHAT) {
+        list.splice(0, list.length - MEDIA_HISTORY_MAX_PER_CHAT);
     }
 }

package/dist/src/business/messaging/extract.test.js

@@ -20,9 +20,10 @@ void test("extractTextFromMsgBody 处理混合消息体", () => {
         {
             msg_type: "TIMImageElem",
             msg_content: {
+                uuid: "shot.jpeg",
                 image_info_array: [
-                    { type: 1, url: "https://example.com/img.png" },
-                    { type: 2, url: "https://example.com/medium.png" },
+                    { type: 1, width: 800, height: 600, url: "https://example.com/img.png" },
+                    { type: 2, width: 400, height: 300, url: "https://example.com/medium.png" },
                 ],
             },
         },
@@ -30,9 +31,10 @@ void test("extractTextFromMsgBody 处理混合消息体", () => {
     ]);
     assert.ok(result.rawBody.includes("hello"));
     assert.ok(result.rawBody.includes("world"));
-    assert.ok(result.rawBody.includes("[image1]"));
+    assert.ok(result.rawBody.includes("[image:shot_400_300.jpeg]"), `rawBody was: ${result.rawBody}`);
     assert.equal(result.medias.length, 1);
     assert.equal(result.medias[0].url, "https://example.com/medium.png");
+    assert.equal(result.medias[0].mediaName, "shot_400_300.jpeg");
 });
 void test("extractTextFromMsgBody 处理 @Bot 消息", () => {
     const ctx = makeMockCtx("bot-001");

package/dist/src/business/messaging/handlers/file.js

@@ -4,6 +4,7 @@
  * File message: on input, extracts file URL and filename to media list and returns file identifier;
  * on output, constructs file message body.
  */
+import { sanitizeMediaFilename } from "../../utils/media.js";
 export const fileHandler = {
     msgType: "TIMFileElem",
     /**
@@ -14,10 +15,10 @@ export const fileHandler = {
         const fileUrl = elem.msg_content?.url;
         const fileName = elem.msg_content?.file_name;
         if (fileUrl) {
-            resData.medias.push({ mediaType: "file", url: fileUrl, mediaName: fileName });
-            return fileName
-                ? `[${fileName}]`
-                : `[file${resData.medias.filter(m => m.mediaType === "file").length}]`;
+            const fileCount = resData.medias.filter(m => m.mediaType === "file").length + 1;
+            const displayName = sanitizeMediaFilename(fileName, `file${fileCount}`);
+            resData.medias.push({ mediaType: "file", url: fileUrl, mediaName: displayName });
+            return `[file:${displayName}]`;
         }
         return "[file]";
     },

package/dist/src/business/messaging/handlers/image.d.ts

@@ -1,8 +1,8 @@
 /**
  * TIMImageElem message handler.
  *
- * Image message: on input, extracts image URL to media list and returns [imageN] placeholder;
- * on output, constructs image message body.
+ * Image message: on input, extracts image URL to media list and returns
+ * [image:{name}_{w}_{h}.{ext}] placeholder; on output, constructs image message body.
  */
 import type { MessageElemHandler } from "./types.js";
 export declare const imageHandler: MessageElemHandler;

package/dist/src/business/messaging/handlers/image.js

@@ -1,24 +1,43 @@
 /**
  * TIMImageElem message handler.
  *
- * Image message: on input, extracts image URL to media list and returns [imageN] placeholder;
- * on output, constructs image message body.
+ * Image message: on input, extracts image URL to media list and returns
+ * [image:{name}_{w}_{h}.{ext}] placeholder; on output, constructs image message body.
  */
+import { sanitizeMediaFilename } from "../../utils/media.js";
+/**
+ * Build a descriptive filename for an image from its uuid and dimensions.
+ * e.g. uuid="c9a1b3f8784898.jpeg", w=720, h=1793 → "c9a1b3f8784898_720_1793.jpeg"
+ * Falls back to plain uuid (no dimensions available) or "image{N}" (no uuid).
+ */
+function buildImageMediaName(uuid, w, h, fallbackIndex) {
+    const fallback = `image${fallbackIndex}`;
+    if (!uuid) {
+        return fallback;
+    }
+    const dotIdx = uuid.lastIndexOf(".");
+    const stem = dotIdx > 0 ? uuid.slice(0, dotIdx) : uuid;
+    const ext = dotIdx > 0 ? uuid.slice(dotIdx) : "";
+    const raw = w && h ? `${stem}_${w}_${h}${ext}` : uuid;
+    return sanitizeMediaFilename(raw, fallback);
+}
 export const imageHandler = {
     msgType: "TIMImageElem",
     /**
      * Extract image URL and record to media list.
-     * Returns [imageN] placeholder (1-indexed); undefined if no URL.
+     * Returns [image:{mediaName}] placeholder; undefined if no URL.
+     * mediaName encodes uuid + selected resolution (width x height).
      */
     extract(_ctx, elem, resData) {
-        // Get url from first element in image_info_array (original image, type=1)
         const imageInfoArray = elem.msg_content?.image_info_array;
-        // Use medium-size image for download
+        // Prefer medium-size image (index 1) for download; fall back to original (index 0)
         const imageInfo = imageInfoArray?.[1] || imageInfoArray?.[0];
         if (imageInfo?.url) {
-            resData.medias.push({ mediaType: "image", url: imageInfo.url });
-            // Image index starts from 1, corresponding to [image1][image2]
-            return `[image${resData.medias.filter(m => m.mediaType === "image").length}]`;
+            const uuid = elem.msg_content?.uuid ?? "";
+            const imageCount = resData.medias.filter(m => m.mediaType === "image").length;
+            const mediaName = buildImageMediaName(uuid, imageInfo.width, imageInfo.height, imageCount + 1);
+            resData.medias.push({ mediaType: "image", url: imageInfo.url, mediaName });
+            return `[image:${mediaName}]`;
         }
         return undefined;
     },

package/dist/src/business/messaging/handlers/image.test.js

@@ -24,18 +24,51 @@ void test("imageHandler extract extracts image URL to media list", () => {
     const elem = {
         msg_type: "TIMImageElem",
         msg_content: {
+            uuid: "abc123.jpeg",
             image_info_array: [
-                { type: 1, url: "https://example.com/original.png" },
-                { type: 2, url: "https://example.com/medium.png" },
+                { type: 1, width: 735, height: 1830, url: "https://example.com/original.png" },
+                { type: 2, width: 720, height: 1793, url: "https://example.com/medium.png" },
             ],
         },
     };
     const result = imageHandler.extract(ctx, elem, resData);
-    assert.equal(result, "[image1]");
+    assert.equal(result, "[image:abc123_720_1793.jpeg]");
     assert.equal(resData.medias.length, 1);
     // Prefers medium image (index 1)
     assert.equal(resData.medias[0].url, "https://example.com/medium.png");
     assert.equal(resData.medias[0].mediaType, "image");
+    assert.equal(resData.medias[0].mediaName, "abc123_720_1793.jpeg");
+});
+void test("imageHandler extract falls back to plain uuid when no dimensions", () => {
+    const ctx = makeMockCtx();
+    const resData = makeResData();
+    const elem = {
+        msg_type: "TIMImageElem",
+        msg_content: {
+            uuid: "photo.jpg",
+            image_info_array: [
+                { type: 1, url: "https://example.com/photo.jpg" },
+            ],
+        },
+    };
+    const result = imageHandler.extract(ctx, elem, resData);
+    assert.equal(result, "[image:photo.jpg]");
+    assert.equal(resData.medias[0].mediaName, "photo.jpg");
+});
+void test("imageHandler extract falls back to image{N} when no uuid", () => {
+    const ctx = makeMockCtx();
+    const resData = makeResData();
+    const elem = {
+        msg_type: "TIMImageElem",
+        msg_content: {
+            image_info_array: [
+                { type: 1, width: 100, height: 200, url: "https://example.com/img.png" },
+            ],
+        },
+    };
+    const result = imageHandler.extract(ctx, elem, resData);
+    assert.equal(result, "[image:image1]");
+    assert.equal(resData.medias[0].mediaName, "image1");
 });
 void test("imageHandler extract returns undefined when no URL", () => {
     const ctx = makeMockCtx();

package/dist/src/business/messaging/quote.d.ts

@@ -1,22 +1,31 @@
 /**
- * Quote message parsing module.
- *
- * Extracts quoted messages from cloud_custom_data and formats them as context text.
+ * Quote message business logic: parsing, media desc resolution, and formatting.
  */
 import type { QuoteInfo } from "../../types.js";
 /**
- * Parse quote info from cloud_custom_data JSON string.
- * Returns undefined if no quote exists or parsing fails.
+ * Parse quote info from cloud_custom_data JSON string and resolve its desc.
+ *
+ * For media-type quotes (image/file/video/voice) whose desc is empty,
+ * resolves actual filenames from the media history LRU. Falls back to a
+ * generic label (e.g. "[image]") when LRU data is unavailable.
+ *
+ * @param chatKey — used for LRU lookup; pass deriveChatKey() result.
+ * @returns undefined if no quote exists, parsing fails, or the quote carries
+ *          no useful information (empty desc AND not a recognized media type).
+ */
+export declare function parseQuoteFromCloudCustomData(cloudCustomData: string | undefined, chatKey?: string): QuoteInfo | undefined;
+/**
+ * Resolve a descriptive desc for a media-type quote.
+ * Looks up actual filenames from the media history LRU; falls back to
+ * a generic label (e.g. "[image]") when LRU data is unavailable.
  */
-export declare function parseQuoteFromCloudCustomData(cloudCustomData?: string): QuoteInfo | undefined;
+export declare function resolveMediaQuoteDesc(type: number, quoteId: string | undefined, chatKey: string | undefined): string;
 /**
- * Format quoted message into context text that can be appended to user messages.
+ * Format quoted message into context text for AI consumption.
  *
- * Generated format:
  * ```
- * [Quoted message from <sender_nickname>]:
- * <desc (truncated to QUOTE_DESC_MAX_LENGTH)>
- * ---
+ * > [Quoted message from <sender_nickname>]:
+ * ><desc>
  * ```
  */
 export declare function formatQuoteContext(quote: QuoteInfo): string;

package/dist/src/business/messaging/quote.js

@@ -1,23 +1,42 @@
 /**
- * Quote message parsing module.
- *
- * Extracts quoted messages from cloud_custom_data and formats them as context text.
+ * Quote message business logic: parsing, media desc resolution, and formatting.
  */
-// IM client message_type enum (client-defined)
-var ImClientMessageTypeEnum;
-(function (ImClientMessageTypeEnum) {
-    ImClientMessageTypeEnum[ImClientMessageTypeEnum["MT_UNKNOW"] = 0] = "MT_UNKNOW";
-    ImClientMessageTypeEnum[ImClientMessageTypeEnum["MT_TEXT"] = 1] = "MT_TEXT";
-    ImClientMessageTypeEnum[ImClientMessageTypeEnum["MT_PIC"] = 2] = "MT_PIC";
-    ImClientMessageTypeEnum[ImClientMessageTypeEnum["MT_FILE"] = 3] = "MT_FILE";
-    ImClientMessageTypeEnum[ImClientMessageTypeEnum["MT_VIDEO"] = 4] = "MT_VIDEO";
-    ImClientMessageTypeEnum[ImClientMessageTypeEnum["MT_AUDIO"] = 5] = "MT_AUDIO";
-})(ImClientMessageTypeEnum || (ImClientMessageTypeEnum = {}));
+import { chatMediaHistories } from "./chat-history.js";
+/** IM client message_type enum (matches Tencent IM protocol definitions). */
+var ImClientMessageType;
+(function (ImClientMessageType) {
+    ImClientMessageType[ImClientMessageType["MT_UNKNOWN"] = 0] = "MT_UNKNOWN";
+    ImClientMessageType[ImClientMessageType["MT_TEXT"] = 1] = "MT_TEXT";
+    ImClientMessageType[ImClientMessageType["MT_PIC"] = 2] = "MT_PIC";
+    ImClientMessageType[ImClientMessageType["MT_FILE"] = 3] = "MT_FILE";
+    ImClientMessageType[ImClientMessageType["MT_VIDEO"] = 4] = "MT_VIDEO";
+    ImClientMessageType[ImClientMessageType["MT_AUDIO"] = 5] = "MT_AUDIO";
+})(ImClientMessageType || (ImClientMessageType = {}));
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+/** Map from IM message_type code to display label. */
+const TYPE_LABEL = {
+    [ImClientMessageType.MT_PIC]: "image",
+    [ImClientMessageType.MT_FILE]: "file",
+    [ImClientMessageType.MT_VIDEO]: "video",
+    [ImClientMessageType.MT_AUDIO]: "voice",
+};
+function isMediaQuoteType(type) {
+    return type in TYPE_LABEL;
+}
 /**
- * Parse quote info from cloud_custom_data JSON string.
- * Returns undefined if no quote exists or parsing fails.
+ * Parse quote info from cloud_custom_data JSON string and resolve its desc.
+ *
+ * For media-type quotes (image/file/video/voice) whose desc is empty,
+ * resolves actual filenames from the media history LRU. Falls back to a
+ * generic label (e.g. "[image]") when LRU data is unavailable.
+ *
+ * @param chatKey — used for LRU lookup; pass deriveChatKey() result.
+ * @returns undefined if no quote exists, parsing fails, or the quote carries
+ *          no useful information (empty desc AND not a recognized media type).
  */
-export function parseQuoteFromCloudCustomData(cloudCustomData) {
+export function parseQuoteFromCloudCustomData(cloudCustomData, chatKey) {
     if (!cloudCustomData) {
         return undefined;
     }
@@ -27,30 +46,52 @@ export function parseQuoteFromCloudCustomData(cloudCustomData) {
             return undefined;
         }
         const { quote } = parsed;
-        // Support image quotes
-        if (Number(quote.type) === ImClientMessageTypeEnum.MT_PIC) {
-            quote.desc = quote.desc?.trim() || "[image]";
+        if (quote.desc?.trim()) {
+            return quote;
         }
-        // At least need quote description content to be meaningful
-        if (!quote.desc?.trim()) {
+        const type = Number(quote.type);
+        if (!isMediaQuoteType(type)) {
             return undefined;
         }
+        quote.desc = resolveMediaQuoteDesc(type, quote.id, chatKey);
         return quote;
     }
     catch {
         return undefined;
     }
 }
-/** Max character length for quote summary */
+// ---------------------------------------------------------------------------
+// Media desc resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a descriptive desc for a media-type quote.
+ * Looks up actual filenames from the media history LRU; falls back to
+ * a generic label (e.g. "[image]") when LRU data is unavailable.
+ */
+export function resolveMediaQuoteDesc(type, quoteId, chatKey) {
+    const label = TYPE_LABEL[type] ?? "media";
+    if (quoteId && chatKey) {
+        const entry = (chatMediaHistories.get(chatKey) ?? [])
+            .findLast(e => e.messageId === quoteId);
+        const tags = (entry?.medias ?? [])
+            .filter(m => m.url)
+            .map(m => `[${label}:${m.mediaName || label}]`);
+        if (tags.length > 0) {
+            return tags.join("");
+        }
+    }
+    return `[${label}]`;
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
 const QUOTE_DESC_MAX_LENGTH = 500;
 /**
- * Format quoted message into context text that can be appended to user messages.
+ * Format quoted message into context text for AI consumption.
  *
- * Generated format:
  * ```
- * [Quoted message from <sender_nickname>]:
- * <desc (truncated to QUOTE_DESC_MAX_LENGTH)>
- * ---
+ * > [Quoted message from <sender_nickname>]:
+ * ><desc>
  * ```
  */
 export function formatQuoteContext(quote) {
@@ -62,7 +103,6 @@ export function formatQuoteContext(quote) {
         senderPart = ` from ${quote.sender_id}`;
     }
     let desc = quote.desc?.trim() || "";
-    // Truncate long quotes to avoid excessive context usage
     if (desc.length > QUOTE_DESC_MAX_LENGTH) {
         desc = `${desc.slice(0, QUOTE_DESC_MAX_LENGTH)}...(truncated)`;
     }

package/dist/src/business/messaging/quote.test.d.ts

@@ -1,4 +1,4 @@
 /**
- * Unit tests for quote.ts: parseQuoteFromCloudCustomData and formatQuoteContext.
+ * Unit tests for quote.ts: parseQuoteFromCloudCustomData, resolveMediaQuoteDesc, formatQuoteContext.
  */
 export {};

package/dist/src/business/messaging/quote.test.js

@@ -1,9 +1,10 @@
 /**
- * Unit tests for quote.ts: parseQuoteFromCloudCustomData and formatQuoteContext.
+ * Unit tests for quote.ts: parseQuoteFromCloudCustomData, resolveMediaQuoteDesc, formatQuoteContext.
  */
 import assert from "node:assert/strict";
 import test from "node:test";
-import { parseQuoteFromCloudCustomData, formatQuoteContext } from "./quote.js";
+import { chatMediaHistories } from "./chat-history.js";
+import { parseQuoteFromCloudCustomData, resolveMediaQuoteDesc, formatQuoteContext } from "./quote.js";
 void test("parseQuoteFromCloudCustomData 解析有效引用", () => {
     const data = JSON.stringify({
         quote: {
@@ -26,23 +27,68 @@ void test("parseQuoteFromCloudCustomData 无 quote 字段返回 undefined", () =
     assert.equal(parseQuoteFromCloudCustomData(JSON.stringify({})), undefined);
     assert.equal(parseQuoteFromCloudCustomData(JSON.stringify({ other: "data" })), undefined);
 });
-void test("parseQuoteFromCloudCustomData 空 desc 返回 undefined", () => {
+void test("parseQuoteFromCloudCustomData 空 desc 且非媒体类型返回 undefined", () => {
     const data = JSON.stringify({ quote: { desc: "", sender_id: "user-1" } });
     assert.equal(parseQuoteFromCloudCustomData(data), undefined);
     const data2 = JSON.stringify({ quote: { desc: "   ", sender_id: "user-1" } });
     assert.equal(parseQuoteFromCloudCustomData(data2), undefined);
 });
-void test("parseQuoteFromCloudCustomData 图片引用使用 [image] 占位符", () => {
+void test("parseQuoteFromCloudCustomData 空 desc 的媒体类型引用不被丢弃且 desc 被兜底填充", () => {
+    const expected = { 2: "[image]", 3: "[file]", 4: "[video]", 5: "[voice]" };
+    for (const type of [2, 3, 4, 5]) {
+        const data = JSON.stringify({ quote: { type, desc: "", sender_id: "user-1", id: "msg-1" } });
+        const result = parseQuoteFromCloudCustomData(data);
+        assert.ok(result, `type ${type} should not be dropped`);
+        assert.equal(result.type, type);
+        assert.equal(result.desc, expected[type], `type ${type} desc should be ${expected[type]}`);
+    }
+});
+void test("parseQuoteFromCloudCustomData 有 desc 时保留原始 desc", () => {
     const data = JSON.stringify({
-        quote: { type: 2, desc: "", sender_id: "user-1" },
+        quote: { type: 3, desc: "report.pdf", sender_id: "user-1" },
     });
     const result = parseQuoteFromCloudCustomData(data);
     assert.ok(result);
-    assert.equal(result.desc, "[image]");
+    assert.equal(result.desc, "report.pdf");
 });
 void test("parseQuoteFromCloudCustomData 非法 JSON 返回 undefined", () => {
     assert.equal(parseQuoteFromCloudCustomData("{invalid json}"), undefined);
 });
+// ---------------------------------------------------------------------------
+// resolveMediaQuoteDesc
+// ---------------------------------------------------------------------------
+void test("resolveMediaQuoteDesc 从 LRU 获取多图文件名", () => {
+    chatMediaHistories.set("test-session", [
+        {
+            sender: "u1", messageId: "msg-1", timestamp: Date.now(),
+            medias: [
+                { url: "https://a.com/1.jpg", mediaName: "a_720_1793.jpeg" },
+                { url: "https://a.com/2.jpg", mediaName: "b_400_300.png" },
+            ],
+        },
+    ]);
+    const result = resolveMediaQuoteDesc(2, "msg-1", "test-session");
+    assert.equal(result, "[image:a_720_1793.jpeg][image:b_400_300.png]");
+    chatMediaHistories.delete("test-session");
+});
+void test("resolveMediaQuoteDesc LRU 无数据时降级为通用标签", () => {
+    assert.equal(resolveMediaQuoteDesc(2, "nonexistent", "empty-session"), "[image]");
+    assert.equal(resolveMediaQuoteDesc(3, undefined, "any"), "[file]");
+    assert.equal(resolveMediaQuoteDesc(4, "x", "y"), "[video]");
+    assert.equal(resolveMediaQuoteDesc(5, "x", "y"), "[voice]");
+});
+void test("resolveMediaQuoteDesc 未知类型返回 [media] 兜底", () => {
+    assert.equal(resolveMediaQuoteDesc(99, "msg-1", "session"), "[media]");
+});
+void test("parseQuoteFromCloudCustomData chatKey=undefined 时媒体引用 desc 兜底到 [label]", () => {
+    const data = JSON.stringify({ quote: { type: 2, desc: "", sender_id: "user-1", id: "msg-1" } });
+    const result = parseQuoteFromCloudCustomData(data, undefined);
+    assert.ok(result);
+    assert.equal(result.desc, "[image]");
+});
+// ---------------------------------------------------------------------------
+// formatQuoteContext
+// ---------------------------------------------------------------------------
 void test("formatQuoteContext 格式化引用消息", () => {
     const result = formatQuoteContext({
         desc: "被引用的消息内容",

package/dist/src/business/pipeline/middlewares/dispatch-reply.js

@@ -149,7 +149,8 @@ export const dispatchReply = {
                 replyOptions: {
                     abortSignal: ctx.abortSignal,
                     disableBlockStreaming: account.disableBlockStreaming,
-                    sourceReplyDeliveryMode: "automatic",
+                    // 4.27 后支持的新参数
+                    ...{ sourceReplyDeliveryMode: "automatic" },
                     onModelSelected,
                     onAgentRunStart: () => {
                         heartbeat.emit(WS_HEARTBEAT.RUNNING);