lightclawbot 1.0.0 → 1.0.2

package/dist/src/history/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * LightClaw — History Module Types
+ *
+ * 集中定义历史消息相关的类型，供 history/ 模块内部和外部统一使用。
+ */
+/** 文件附件信息（从消息文本中提取） */
+export interface FileAttachmentInfo {
+    /** 原始文件名 */
+    name: string;
+    /** MIME 类型 */
+    mimeType?: string;
+    /** 文件大小描述（如 "3.0KB"） */
+    size?: string;
+    /** 文件路径或 URI */
+    uri?: string;
+}
+/** Cron 来源信息（标记消息来自哪个 cron 任务） */
+export interface CronInfo {
+    /** cron job ID */
+    jobId: string;
+    /** 任务名称（如 "每2分钟喝水提醒"） */
+    name?: string;
+    /** 本次运行的 session ID */
+    runSessionId?: string;
+}
+/** 标准化后返回给前端的历史消息 */
+export interface HistoryMessage {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    timestamp?: number;
+    /** 消息中包含的工具调用（可选） */
+    toolCalls?: Array<{
+        name: string;
+        args?: string;
+    }>;
+    /** 消息中包含的工具结果（可选） */
+    toolResult?: {
+        toolCallId?: string;
+        name?: string;
+        output?: string;
+    };
+    /** AI 的思考过程（可选） */
+    thinking?: string;
+    /** 消息中包含的文件附件（可选） */
+    files?: FileAttachmentInfo[];
+    /** 压缩标记 */
+    isCompaction?: boolean;
+    /** 如果是 cron 消息，标识来源信息 */
+    cronInfo?: CronInfo;
+}
+/** sessions.json 中每个条目的结构 */
+export interface SessionStoreEntry {
+    sessionId: string;
+    sessionFile?: string;
+    updatedAt?: number;
+    label?: string;
+    displayName?: string;
+    channel?: string;
+    chatType?: string;
+}
+/** 会话类型 */
+export type SessionType = "direct" | "cron-base" | "cron-run";
+/** Cron 会话信息 */
+export interface CronSessionInfo {
+    /** session key (e.g. "agent:main:cron:xxx:run:yyy") */
+    sessionKey: string;
+    /** session ID (即 JSONL 文件名前缀) */
+    sessionId: string;
+    /** cron job ID */
+    cronJobId: string;
+    /** 任务名称 (从 label 提取，如 "每2分钟喝水提醒") */
+    cronName?: string;
+    /** 最后更新时间 */
+    updatedAt?: number;
+}
+/** 列出 session 时的条目类型（含 cron 类型标识） */
+export interface SessionListEntry {
+    sessionKey: string;
+    sessionId: string;
+    updatedAt?: number;
+    label?: string;
+    displayName?: string;
+    channel?: string;
+    /** 会话类型 */
+    sessionType: SessionType;
+    /** cron job ID (仅 cron 类型) */
+    cronJobId?: string;
+}
+export interface ReadHistoryOptions {
+    /** 最大返回条数，默认 200 */
+    limit?: number;
+    /** Agent ID，默认 "main" */
+    agentId?: string;
+    /** 只返回 user/assistant 消息（过滤 system/tool），默认 false */
+    chatOnly?: boolean;
+}
+export interface ReadHistoryWithCronOptions extends ReadHistoryOptions {
+    /** 是否包含 cron 消息，默认 true */
+    includeCron?: boolean;
+    /** 只包含指定 cron job ID 的消息 */
+    cronJobIds?: string[];
+}
+export interface ReadHistoryTailOptions extends ReadHistoryOptions {
+    /** 从末尾读取的最大字节数，默认 1MB */
+    maxBytes?: number;
+}
+/** 原始 JSONL 行中 message.content 可能的结构 */
+export type ContentEntry = {
+    type?: string;
+    text?: string;
+    thinking?: string;
+    thinkingSignature?: string;
+    name?: string;
+    id?: string;
+    toolCallId?: string;
+    tool_call_id?: string;
+    toolName?: string;
+    tool_name?: string;
+    input?: unknown;
+    arguments?: unknown;
+    args?: unknown;
+    output?: unknown;
+    result?: unknown;
+    content?: unknown;
+    tool_use_id?: string;
+    data?: string;
+    uri?: string;
+    mimeType?: string;
+    mime_type?: string;
+    fileName?: string;
+    file_name?: string;
+    filename?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/history/types.d.ts.map

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

package/dist/src/history/types.js

@@ -0,0 +1,7 @@
+/**
+ * LightClaw — History Module Types
+ *
+ * 集中定义历史消息相关的类型，供 history/ 模块内部和外部统一使用。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/history/types.js.map

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

package/dist/src/inbound.d.ts

@@ -0,0 +1,18 @@
+/**
+ * LightClaw — 入站消息处理
+ *
+ * 接收用户消息 → 文件处理 → 路由 → AI 分发 → 回复
+ */
+import type { GatewayContext, QueuedMessage, PrivateMessageData, FileAttachment } from "./types.js";
+/** emit / sendReply / sendFiles 等 socket 操作的抽象接口 */
+export interface SocketEmitter {
+    emit: (data: PrivateMessageData) => boolean;
+    sendReply: (targetId: string, text: string, replyToMsgId?: string) => boolean;
+    sendFiles: (targetId: string, text: string, files: FileAttachment[], replyToMsgId?: string) => boolean;
+    botClientId: string;
+}
+/**
+ * 创建入站消息处理器
+ */
+export declare function createInboundHandler(account: GatewayContext["account"], emitter: SocketEmitter, log?: GatewayContext["log"]): (msg: QueuedMessage) => Promise<void>;
+//# sourceMappingURL=inbound.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../src/inbound.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AAQpB,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC;IAC5C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACvG,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,EAClC,OAAO,EAAE,aAAa,EACtB,GAAG,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,IAEb,KAAK,aAAa,KAAG,OAAO,CAAC,IAAI,CAAC,CAyUjD"}

package/dist/src/inbound.js

@@ -0,0 +1,332 @@
+/**
+ * LightClaw — 入站消息处理
+ *
+ * 接收用户消息 → 文件处理 → 路由 → AI 分发 → 回复
+ */
+import { getAssistantRuntime } from "./runtime.js";
+import { CHANNEL_KEY, REPLY_TIMEOUT, MEDIA_MAX_BYTES } from "./config.js";
+import { createReplyPrefixOptions } from "openclaw/plugin-sdk";
+import { generateMsgId } from "./dedup.js";
+import { parseDataUrl, formatFileSize, mediaUrlsToFiles } from "./media.js";
+import { uploadFileToCos, downloadFileFromCos, getFileDownloadUrl } from "./file-storage.js";
+/**
+ * 创建入站消息处理器
+ */
+export function createInboundHandler(account, emitter, log) {
+    return async (msg) => {
+        const pluginRuntime = getAssistantRuntime();
+        const currentCfg = pluginRuntime.config.loadConfig();
+        // 1. 确定地址和会话 Key
+        const fromAddress = `${CHANNEL_KEY}:dm:${msg.senderId}`;
+        // 2. 路由解析
+        const route = pluginRuntime.channel.routing.resolveAgentRoute({
+            cfg: currentCfg,
+            channel: CHANNEL_KEY,
+            accountId: account.accountId,
+            peer: { kind: "direct", id: msg.senderId },
+        });
+        // 3. 权限检查
+        const commandAuthorized = checkAuth(account.allowFrom, account.dmPolicy, msg.senderId);
+        // 4. 处理文件附件（files[] → 本地存储）
+        const localMediaPaths = [];
+        const localMediaTypes = [];
+        // 每个文件对应的公网可访问 URL（COS 地址），用于 session 历史持久化
+        const publicMediaUrls = [];
+        const ctxAttachments = [];
+        let attachmentDescription = "";
+        for (const file of msg.files) {
+            try {
+                let buffer;
+                let mimeType;
+                // 记录文件的 COS 公网 URL，优先用于 session 存储
+                let cosPublicUrl;
+                const parsed = file.bytes ? parseDataUrl(file.bytes) : null;
+                if (parsed) {
+                    // data URL 格式：直接解析
+                    buffer = parsed.buffer;
+                    mimeType = parsed.mimeType;
+                }
+                else if (file.uri) {
+                    // 远程 URI（COS 地址），下载获取内容
+                    log?.info(`[${CHANNEL_KEY}] File has URI, downloading from COS: ${file.uri}`);
+                    const downloaded = await downloadFileFromCos(file.uri, { apiKey: account.apiKey });
+                    buffer = downloaded.buffer;
+                    mimeType = downloaded.contentType || file.mimeType;
+                    // 保留原始 COS 公网 URL，用于 session 历史中持久化引用
+                    cosPublicUrl = file.uri.startsWith("http")
+                        ? file.uri
+                        : getFileDownloadUrl(file.uri);
+                }
+                else {
+                    log?.warn(`[${CHANNEL_KEY}] File has no bytes or uri: ${file.name}, skipping`);
+                    continue;
+                }
+                const saved = await pluginRuntime.channel.media.saveMediaBuffer(buffer, mimeType, "inbound", MEDIA_MAX_BYTES, file.name);
+                const savedMime = saved.contentType || mimeType;
+                localMediaPaths.push(saved.path);
+                localMediaTypes.push(savedMime);
+                // 如果文件来自 COS，使用公网 URL；否则尝试上传到 COS 获取公网 URL
+                if (cosPublicUrl) {
+                    publicMediaUrls.push(cosPublicUrl);
+                }
+                else {
+                    // data URL 来源的文件：上传到 COS 以获取公网 URL
+                    try {
+                        const uploadResult = await uploadFileToCos(saved.path, { apiKey: account.apiKey });
+                        publicMediaUrls.push(uploadResult.url || `file://${saved.path}`);
+                        log?.info(`[${CHANNEL_KEY}] Uploaded inbound file to COS: ${saved.path} → ${uploadResult.url}`);
+                    }
+                    catch (uploadErr) {
+                        log?.warn(`[${CHANNEL_KEY}] Failed to upload inbound file to COS, falling back to local path: ${uploadErr}`);
+                        publicMediaUrls.push(`file://${saved.path}`);
+                    }
+                }
+                // Attachments 中使用公网 URL，确保 session 历史中的地址可被前端访问
+                const attachmentUrl = publicMediaUrls[publicMediaUrls.length - 1];
+                ctxAttachments.push({
+                    name: file.name,
+                    mimeType: savedMime,
+                    url: attachmentUrl,
+                });
+                attachmentDescription += `\n用户发送了文件: ${file.name} (${formatFileSize(saved.size)})`;
+                log?.info(`[${CHANNEL_KEY}] File saved: ${saved.path} (${savedMime}, ${formatFileSize(saved.size)}), publicUrl: ${attachmentUrl}`);
+            }
+            catch (err) {
+                log?.error(`[${CHANNEL_KEY}] File processing failed for ${file.name}: ${err}`);
+            }
+        }
+        // 5. 构建消息体
+        const userText = msg.text + attachmentDescription;
+        const agentBody = account.systemPrompt
+            ? `${account.systemPrompt}\n\n${userText}`
+            : userText;
+        // 6. 构建入站上下文
+        // MediaPaths 保持本地路径（AI 模型 vision 需要从本地读取文件内容）
+        // MediaUrls 使用公网 COS URL（session 历史持久化，前端可直接访问）
+        const mediaFields = {};
+        if (localMediaPaths.length > 0) {
+            mediaFields.MediaPaths = localMediaPaths;
+            mediaFields.MediaPath = localMediaPaths[0];
+            mediaFields.MediaTypes = localMediaTypes;
+            mediaFields.MediaType = localMediaTypes[0];
+            mediaFields.MediaUrls = publicMediaUrls;
+            mediaFields.MediaUrl = publicMediaUrls[0];
+        }
+        const ctxPayload = pluginRuntime.channel.reply.finalizeInboundContext({
+            Body: userText,
+            BodyForAgent: agentBody,
+            RawBody: msg.text,
+            CommandBody: msg.text,
+            From: fromAddress,
+            To: `${CHANNEL_KEY}:${account.accountId}`,
+            Channel: CHANNEL_KEY,
+            ChatType: "direct",
+            SessionKey: route?.sessionKey ?? fromAddress,
+            AccountId: route?.accountId ?? account.accountId,
+            SenderId: msg.senderId,
+            SenderName: msg.senderId,
+            Provider: CHANNEL_KEY,
+            Surface: CHANNEL_KEY,
+            MessageSid: msg.messageId,
+            Timestamp: msg.timestamp,
+            OriginatingChannel: CHANNEL_KEY,
+            OriginatingTo: fromAddress,
+            CommandAuthorized: commandAuthorized,
+            OwnerAllowFrom: commandAuthorized ? [msg.senderId, fromAddress] : undefined,
+            AgentId: route?.agentId,
+            Attachments: ctxAttachments.length > 0 ? ctxAttachments : undefined,
+            ...mediaFields,
+        });
+        log?.info(`[${CHANNEL_KEY}] Inbound context: ${JSON.stringify(ctxPayload)}`);
+        const targetId = msg.senderId;
+        log?.info(`[${CHANNEL_KEY}] Processing: from=${msg.senderId} text="${(msg.text || "(仅文件)").slice(0, 60)}" files=${msg.files.length}`);
+        // 6.5 更新 session 的 last route，使 cron 定时任务能找到 lightclawbot 的投递目标
+        const storePath = pluginRuntime.channel.session.resolveStorePath(route.agentId);
+        const deliveryCtx = {
+            channel: CHANNEL_KEY,
+            to: fromAddress,
+            accountId: route.accountId ?? account.accountId,
+        };
+        // 写入 per-channel-peer session
+        if (route?.sessionKey) {
+            pluginRuntime.channel.session.updateLastRoute({
+                storePath,
+                sessionKey: route.sessionKey,
+                deliveryContext: deliveryCtx,
+            }).catch((err) => {
+                log?.error(`[${CHANNEL_KEY}] Failed to update last route (session): ${err}`);
+            });
+        }
+        // 写入 main session（兜底）
+        if (route?.mainSessionKey && route.mainSessionKey !== route.sessionKey) {
+            pluginRuntime.channel.session.updateLastRoute({
+                storePath,
+                sessionKey: route.mainSessionKey,
+                deliveryContext: deliveryCtx,
+            }).catch((err) => {
+                log?.error(`[${CHANNEL_KEY}] Failed to update last route (main): ${err}`);
+            });
+        }
+        // 7. 创建 replyPrefixOptions
+        const { onModelSelected, ...prefixOptions } = createReplyPrefixOptions({
+            cfg: currentCfg,
+            agentId: route.agentId,
+            channel: CHANNEL_KEY,
+            accountId: account.accountId,
+        });
+        // 8. 分发给 AI 引擎
+        let hasResponse = false;
+        let idleSent = false;
+        let timeoutId = null;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+                if (!hasResponse)
+                    reject(new Error("AI reply timeout"));
+            }, REPLY_TIMEOUT);
+        });
+        // 同一条消息的流式回复（typing_start / stream_chunk / typing_stop）共用同一个 msgId
+        const replyMsgId = generateMsgId();
+        const dispatchPromise = pluginRuntime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+            ctx: ctxPayload,
+            cfg: currentCfg,
+            dispatcherOptions: {
+                ...prefixOptions,
+                deliver: async (payload, info) => {
+                    hasResponse = true;
+                    log?.info(`[${CHANNEL_KEY}] Deliver: ${JSON.stringify(payload)}。info: ${JSON.stringify(info)}`);
+                    if (timeoutId) {
+                        clearTimeout(timeoutId);
+                        timeoutId = null;
+                    }
+                    const replyText = payload.text ?? payload.body ?? "";
+                    const mediaList = payload.mediaUrls?.length
+                        ? payload.mediaUrls
+                        : payload.mediaUrl ? [payload.mediaUrl] : [];
+                    // 流式中间块
+                    if (info.kind === "block") {
+                        if (replyText.trim()) {
+                            emitter.emit({
+                                msgId: replyMsgId,
+                                from: emitter.botClientId,
+                                to: targetId,
+                                content: replyText,
+                                timestamp: Date.now(),
+                                replyToMsgId: msg.messageId,
+                                kind: "stream_chunk",
+                            });
+                        }
+                        return;
+                    }
+                    if (!replyText && !mediaList.length)
+                        return;
+                    // 发送媒体文件 — 同时上传到 COS 获取公网 URL
+                    if (mediaList.length > 0) {
+                        const files = await mediaUrlsToFiles(mediaList, log);
+                        // 尝试将文件上传到 COS 获取公网链接
+                        const publicUrls = [];
+                        const storageConfig = {
+                            apiKey: account.apiKey,
+                        };
+                        for (const mediaUrl of mediaList) {
+                            try {
+                                // 本地文件路径（file:// 或绝对路径）
+                                const localPath = mediaUrl.startsWith("file://")
+                                    ? mediaUrl.slice(7)
+                                    : mediaUrl;
+                                if (localPath.startsWith("/") || localPath.match(/^[A-Za-z]:\\/)) {
+                                    const { existsSync } = await import("node:fs");
+                                    if (existsSync(localPath)) {
+                                        const result = await uploadFileToCos(localPath, storageConfig);
+                                        publicUrls.push(result.url || '');
+                                        log?.info(`[${CHANNEL_KEY}] Uploaded to COS: ${localPath} → ${result.url}`);
+                                    }
+                                }
+                            }
+                            catch (uploadErr) {
+                                log?.warn(`[${CHANNEL_KEY}] COS upload failed for ${mediaUrl}: ${uploadErr}`);
+                            }
+                        }
+                        // 将公网 URL 追加到回复文本中
+                        let enrichedText = replyText;
+                        if (publicUrls.length > 0) {
+                            const urlSection = publicUrls
+                                .map((url, i) => `📎 文件下载链接${publicUrls.length > 1 ? ` (${i + 1})` : ""}: ${url}`)
+                                .join("\n");
+                            enrichedText = enrichedText
+                                ? `${enrichedText}\n\n${urlSection}`
+                                : urlSection;
+                        }
+                        if (files.length > 0) {
+                            emitter.sendFiles(targetId, enrichedText, files, msg.messageId);
+                            return;
+                        }
+                        // 文件无法直接发送，但有公网 URL，用文本方式发送链接
+                        if (enrichedText.trim()) {
+                            emitter.sendReply(targetId, enrichedText, msg.messageId);
+                            return;
+                        }
+                    }
+                    // 发送文本回复
+                    if (replyText.trim()) {
+                        emitter.sendReply(targetId, replyText, msg.messageId);
+                    }
+                },
+                onReplyStart: () => {
+                    emitter.emit({
+                        msgId: replyMsgId,
+                        from: emitter.botClientId,
+                        to: targetId,
+                        content: "",
+                        timestamp: Date.now(),
+                        kind: "typing_start",
+                    });
+                },
+                onIdle: () => {
+                    if (idleSent)
+                        return;
+                    idleSent = true;
+                    emitter.emit({
+                        msgId: replyMsgId,
+                        from: emitter.botClientId,
+                        to: targetId,
+                        content: "",
+                        timestamp: Date.now(),
+                        replyToMsgId: msg.messageId,
+                        kind: "typing_stop",
+                    });
+                },
+                onError: (err, info) => {
+                    log?.error(`[${CHANNEL_KEY}] ${info.kind} reply failed: ${String(err)}`);
+                },
+            },
+            replyOptions: { onModelSelected, disableBlockStreaming: false },
+        });
+        try {
+            await Promise.race([dispatchPromise, timeoutPromise]);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            log?.error(`[${CHANNEL_KEY}] Dispatch error: ${errMsg}`);
+            emitter.sendReply(targetId, `抱歉，处理您的消息时出现了问题: ${errMsg}`, msg.messageId);
+        }
+        finally {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                timeoutId = null;
+            }
+        }
+    };
+}
+// ============================================================
+// 权限检查
+// ============================================================
+function checkAuth(allowFrom, dmPolicy, senderId) {
+    if (dmPolicy === "disabled")
+        return false;
+    if (dmPolicy === "open")
+        return true;
+    if (!allowFrom || allowFrom.length === 0)
+        return false;
+    return allowFrom.includes("*") || allowFrom.some((id) => id.toLowerCase() === senderId.toLowerCase());
+}
+//# sourceMappingURL=inbound.js.map

package/dist/src/inbound.js.map

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

package/dist/src/media.d.ts

@@ -0,0 +1,12 @@
+/**
+ * LightClaw — 媒体文件处理工具
+ */
+import type { FileAttachment, GatewayContext } from "./types.js";
+export declare function parseDataUrl(dataUrl: string): {
+    buffer: Buffer;
+    mimeType: string;
+} | null;
+export declare function formatFileSize(bytes: number): string;
+export declare function guessMimeByExt(ext: string): string;
+export declare function mediaUrlsToFiles(urls: string[], log?: GatewayContext["log"]): Promise<FileAttachment[]>;
+//# sourceMappingURL=media.d.ts.map

package/dist/src/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/media.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIzF;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAMD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASlD;AAMD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,GAC1B,OAAO,CAAC,cAAc,EAAE,CAAC,CAyC3B"}

package/dist/src/media.js

@@ -0,0 +1,87 @@
+/**
+ * LightClaw — 媒体文件处理工具
+ */
+import * as path from "node:path";
+// ============================================================
+// 解析 data URL → Buffer
+// ============================================================
+export function parseDataUrl(dataUrl) {
+    const match = dataUrl.match(/^data:([^;]+);base64,(.+)$/);
+    if (!match)
+        return null;
+    return { mimeType: match[1], buffer: Buffer.from(match[2], "base64") };
+}
+// ============================================================
+// 格式化文件大小
+// ============================================================
+export function formatFileSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)}GB`;
+}
+// ============================================================
+// MIME 类型猜测
+// ============================================================
+export function guessMimeByExt(ext) {
+    const map = {
+        ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg",
+        ".gif": "image/gif", ".webp": "image/webp", ".svg": "image/svg+xml",
+        ".mp3": "audio/mpeg", ".wav": "audio/wav", ".ogg": "audio/ogg",
+        ".mp4": "video/mp4", ".webm": "video/webm",
+        ".pdf": "application/pdf", ".txt": "text/plain",
+    };
+    return map[ext] || "application/octet-stream";
+}
+// ============================================================
+// 将 AI 引擎返回的 mediaUrl 列表转为 files[] 格式
+// ============================================================
+export async function mediaUrlsToFiles(urls, log) {
+    const files = [];
+    const { readFileSync, existsSync } = await import("node:fs");
+    for (const url of urls) {
+        try {
+            let buffer;
+            let mimeType;
+            let name;
+            if (url.startsWith("data:")) {
+                const parsed = parseDataUrl(url);
+                if (!parsed)
+                    continue;
+                buffer = parsed.buffer;
+                mimeType = parsed.mimeType;
+                name = "file";
+            }
+            else if (url.startsWith("http://") || url.startsWith("https://")) {
+                const resp = await fetch(url);
+                if (!resp.ok)
+                    continue;
+                buffer = Buffer.from(await resp.arrayBuffer());
+                mimeType = resp.headers.get("content-type") || "application/octet-stream";
+                name = url.split("/").pop()?.split("?")[0] || "file";
+            }
+            else if (existsSync(url)) {
+                buffer = readFileSync(url);
+                const ext = path.extname(url).toLowerCase();
+                mimeType = guessMimeByExt(ext);
+                name = path.basename(url);
+            }
+            else {
+                continue;
+            }
+            files.push({
+                name,
+                mimeType,
+                bytes: `data:${mimeType};base64,${buffer.toString("base64")}`,
+            });
+        }
+        catch (err) {
+            log?.warn?.(`[mediaUrlsToFiles] Failed to convert ${url}: ${err}`);
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=media.js.map

package/dist/src/media.js.map

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