@xgjktech/xg_cwork_im 1.19.26 → 1.19.27

package/dist/src/inbound-display.js

@@ -0,0 +1,170 @@
+/**
+ * 入站消息：附件筛选、展示正文、@ 判定、MediaPath(s)、UntrustedContext、回复元数据。
+ */
+import { attachmentDisplayName, formatInboundAttachmentDescriptor, formatInboundAttachmentMetaLine, trimAttachmentRefId, trimAttachmentSource, } from "./inbound-attachment-meta.js";
+import { parseFileDownloadFlag, shouldDownloadInboundFile } from "./inbound-file-download.js";
+/** 仍为远程 IM 下载地址（未落盘或落盘失败） */
+export function isRemoteAttachmentUrl(url) {
+    const u = url.trim();
+    return /^https?:\/\//i.test(u);
+}
+export function collectFileItems(msgContent) {
+    return (msgContent?.files ?? []).filter((f) => f.url?.trim() || f.content?.trim());
+}
+export function buildInboundDisplayText(msgContent, fileItems) {
+    let rawText = msgContent?.text ?? "";
+    if (fileItems.length > 0) {
+        const lines = fileItems.map((f) => {
+            const label = formatInboundAttachmentDescriptor(f);
+            const ref = f.url?.trim();
+            const archiveFiles = f.archiveExtractedFiles;
+            if (archiveFiles && ref) {
+                const fileList = archiveFiles.map((p) => `    - ${p}`).join("\n");
+                return `- ${label}（压缩包，已解压 → \`${ref}\`）\n${fileList}`;
+            }
+            if (ref) {
+                return `- ${label} → \`${ref}\``;
+            }
+            return `- ${label}`;
+        });
+        const block = `**附件（${fileItems.length}）**\n${lines.join("\n")}`;
+        rawText = rawText.trim() ? `${rawText.trim()}\n\n${block}` : block;
+        const parsedParts = fileItems
+            .map((f) => {
+            const c = f.content?.trim();
+            if (!c)
+                return null;
+            const name = attachmentDisplayName(f);
+            const meta = formatInboundAttachmentMetaLine(f);
+            const metaBlock = meta ? `\n\n${meta}` : "";
+            return `### ${name}${metaBlock}\n\n${c}`;
+        })
+            .filter((x) => x != null);
+        if (parsedParts.length > 0) {
+            const parsedBlock = `**附件解析内容**\n\n${parsedParts.join("\n\n")}`;
+            rawText = `${rawText.trim()}\n\n${parsedBlock}`;
+        }
+        const hasLocalRefs = fileItems.some((f) => {
+            const ref = f.url?.trim();
+            return ref && !isRemoteAttachmentUrl(ref);
+        });
+        const hasRemoteUrlRefs = fileItems.some((f) => {
+            const ref = f.url?.trim();
+            return ref && isRemoteAttachmentUrl(ref);
+        });
+        if (hasLocalRefs) {
+            rawText =
+                `${rawText.trim()}\n\n` +
+                    "**附件已下载到本地**\n" +
+                    "处理附件时请使用上文与 MediaPath 中的路径；勿改用原始 IM URL。";
+        }
+        if (hasRemoteUrlRefs) {
+            const hasDownloadDegraded = fileItems.some((f) => shouldDownloadInboundFile(f) && f.url?.trim() && isRemoteAttachmentUrl(f.url));
+            const hasExplicitContentLink = fileItems.some((f) => f.url?.trim() &&
+                isRemoteAttachmentUrl(f.url) &&
+                parseFileDownloadFlag(f.download) === false);
+            if (hasDownloadDegraded) {
+                rawText =
+                    `${rawText.trim()}\n\n` +
+                        "**附件落盘失败（超时或体积限制）**\n" +
+                        "请通过 MediaPath 与上文中的完整 URL 交由 OpenClaw 读取（如 http 工具/read），勿当作本地路径。";
+            }
+            else {
+                const linkNote = hasExplicitContentLink
+                    ? "**可读链接（未落盘）**\n请直接通过 MediaPath 或上文完整 URL 读取内容（如 mdContent 页面），不要当作本地文件路径。"
+                    : "**附件 URL 使用约束**\n处理远程附件时必须逐字原样使用消息与 MediaPath 中的完整 URL；禁止修改、删除或重排任何 query 参数。";
+                rawText = `${rawText.trim()}\n\n${linkNote}`;
+            }
+        }
+    }
+    return rawText;
+}
+function normalizeMentionIds(mentions) {
+    if (!Array.isArray(mentions))
+        return [];
+    return mentions.map((id) => String(id));
+}
+export function isActuallyMentioned(msg, params, bot, rawTextForLegacy) {
+    const mentionIds = normalizeMentionIds(params.mentions);
+    const botUserId = String(bot.userId);
+    const isMentioned = mentionIds.includes(botUserId) || mentionIds.includes("all");
+    const isLegacyMentioned = msg.cmd === "robotMention" &&
+        (!params.mentions || params.mentions.length === 0) &&
+        new RegExp(`@${bot.name}\\b`).test(rawTextForLegacy);
+    return isMentioned || isLegacyMentioned;
+}
+export function mediaFieldsFromFileItems(fileItems) {
+    const urlItems = fileItems.filter((f) => f.url?.trim());
+    if (urlItems.length === 0)
+        return {};
+    if (urlItems.length === 1) {
+        return {
+            MediaPath: urlItems[0].url,
+        };
+    }
+    return {
+        MediaPaths: urlItems.map((f) => f.url),
+    };
+}
+/** 从 ext 中移除已由 agentContext / GroupSystemPrompt 处理的键，避免重复注入 */
+export function extForUntrustedContext(msgExt) {
+    if (!msgExt || typeof msgExt !== "object")
+        return undefined;
+    const copy = { ...msgExt };
+    delete copy.openclaw;
+    delete copy.agentContext;
+    /** 传输元数据，由单轮模型/推理覆盖（pending + before_model_resolve / thinkingLevelOverride）消费，勿进 UntrustedContext */
+    delete copy.ai_model;
+    delete copy.ai_thinking;
+    return Object.keys(copy).length > 0 ? copy : undefined;
+}
+export function buildUntrustedContext(msgExt, fileItems) {
+    const parts = [];
+    const extRest = extForUntrustedContext(msgExt);
+    if (extRest)
+        parts.push(JSON.stringify(extRest));
+    if (fileItems.length > 0) {
+        const summary = fileItems.map((f) => ({
+            name: f.name ?? null,
+            format: f.format ?? null,
+            source: trimAttachmentSource(f) ?? null,
+            refId: trimAttachmentRefId(f) ?? null,
+            size: f.size ?? null,
+            download: parseFileDownloadFlag(f.download) ?? null,
+            downloaded: Boolean(f.url?.trim() && !isRemoteAttachmentUrl(f.url)),
+            contentChars: f.content?.trim() ? f.content.trim().length : null,
+        }));
+        parts.push(`xg_cwork_im.attachments: ${JSON.stringify(summary)}`);
+    }
+    return parts.length > 0 ? parts : undefined;
+}
+/** 结构化附件列表，写入 inboundCtx.XgImAttachments */
+export function buildInboundAttachmentsPayload(fileItems) {
+    if (fileItems.length === 0)
+        return undefined;
+    return fileItems.map((f) => {
+        const ref = f.url?.trim();
+        const downloaded = Boolean(ref && !isRemoteAttachmentUrl(ref));
+        const downloadDegraded = Boolean(ref && isRemoteAttachmentUrl(ref) && shouldDownloadInboundFile(f));
+        return {
+            name: f.name?.trim() || undefined,
+            source: trimAttachmentSource(f),
+            refId: trimAttachmentRefId(f),
+            format: f.format?.trim() || undefined,
+            mediaRef: ref || undefined,
+            download: parseFileDownloadFlag(f.download),
+            downloaded,
+            downloadDegraded,
+            hasContent: Boolean(f.content?.trim()),
+        };
+    });
+}
+export function buildTargetReplyMeta(params) {
+    return {
+        targetMsgId: params.msgId,
+        targetUserId: params.userInfo?.id ?? "",
+        targetUserName: params.userInfo?.name ?? "未知用户",
+        previewText: params.msgContent?.text ?? "",
+    };
+}
+//# sourceMappingURL=inbound-display.js.map

package/dist/src/inbound-display.js.map

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

package/dist/src/inbound-file-download.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 入站附件是否落盘：由 IM files[].download 与 content 决定。
+ */
+import type { MsgFileVO } from "./types.js";
+/** 解析 IM 下发的 download（boolean / 字符串 / 数字） */
+export declare function parseFileDownloadFlag(download: unknown): boolean | undefined;
+/**
+ * 是否应将带 url 的附件下载到本地 input。
+ *
+ * - download=true：一定下载
+ * - download=false：不下载，保留 url 给 OpenClaw
+ * - download 未传/为空：有 content 则不下载，否则下载
+ */
+export declare function shouldDownloadInboundFile(item: MsgFileVO): boolean;
+//# sourceMappingURL=inbound-file-download.d.ts.map

package/dist/src/inbound-file-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-file-download.d.ts","sourceRoot":"","sources":["../../src/inbound-file-download.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,6CAA6C;AAC7C,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAe5E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAUlE"}

package/dist/src/inbound-file-download.js

@@ -0,0 +1,48 @@
+/**
+ * 入站附件是否落盘：由 IM files[].download 与 content 决定。
+ */
+/** 解析 IM 下发的 download（boolean / 字符串 / 数字） */
+export function parseFileDownloadFlag(download) {
+    if (download === undefined || download === null)
+        return undefined;
+    if (typeof download === "boolean")
+        return download;
+    if (typeof download === "number") {
+        if (download === 1)
+            return true;
+        if (download === 0)
+            return false;
+        return undefined;
+    }
+    if (typeof download === "string") {
+        const t = download.trim().toLowerCase();
+        if (!t)
+            return undefined;
+        if (t === "true" || t === "1" || t === "yes")
+            return true;
+        if (t === "false" || t === "0" || t === "no")
+            return false;
+    }
+    return undefined;
+}
+/**
+ * 是否应将带 url 的附件下载到本地 input。
+ *
+ * - download=true：一定下载
+ * - download=false：不下载，保留 url 给 OpenClaw
+ * - download 未传/为空：有 content 则不下载，否则下载
+ */
+export function shouldDownloadInboundFile(item) {
+    const url = item.url?.trim();
+    if (!url)
+        return false;
+    const flag = parseFileDownloadFlag(item.download);
+    if (flag === true)
+        return true;
+    if (flag === false)
+        return false;
+    if (item.content?.trim())
+        return false;
+    return true;
+}
+//# sourceMappingURL=inbound-file-download.js.map

package/dist/src/inbound-file-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-file-download.js","sourceRoot":"","sources":["../../src/inbound-file-download.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,6CAA6C;AAC7C,MAAM,UAAU,qBAAqB,CAAC,QAAiB;IACnD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,IAAI,OAAO,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACjC,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACzB,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QAC1D,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;IAC/D,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAe;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAEvB,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAEjC,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/src/inbound-input-media.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 入站带 URL 的附件：落盘到项目 input 或默认 xg-cwork-im/input，并将本地路径写入 MediaPath。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { Log } from "./auth.js";
+import type { RobotMentionAgentContext } from "./agent-context-types.js";
+import type { MsgFileVO, XgImConfig } from "./types.js";
+/** agentContext 指定项目根时，其下的入站附件子目录名 */
+export declare const AGENT_CONTEXT_INPUT_DIR = "input";
+/** 未指定 agentContext 时，相对 workspace 的默认入站目录 */
+export declare const DEFAULT_INBOUND_INPUT_REL = "xg-cwork-im/input";
+export declare function hasInboundUrlDownloads(fileItems: MsgFileVO[]): boolean;
+export interface InboundInputHostLayout {
+    /** 宿主机绝对路径：…/input（其下再按 userId/日期 分目录） */
+    inputHostDir: string;
+    /** 用于生成 OpenClaw MediaPath；文件若在 workspace 外则可能为 undefined */
+    workspaceRoot?: string;
+}
+/**
+ * 解析入站附件落盘根目录（input 文件夹的宿主绝对路径）。
+ */
+export declare function resolveInboundInputHostLayout(args: {
+    cfg: OpenClawConfig;
+    agentId: string;
+    agentContext?: RobotMentionAgentContext;
+    workspaceHostRoot?: string;
+    log?: Log;
+}): InboundInputHostLayout | undefined;
+/**
+ * 将带 URL 的入站附件下载到 input 目录；无 URL 的项原样保留。失败项保留原 URL。
+ */
+export declare function saveInboundFilesToInputDir(args: {
+    rt: unknown;
+    cfg: OpenClawConfig;
+    config: XgImConfig;
+    agentId: string;
+    agentContext?: RobotMentionAgentContext;
+    workspaceHostRoot?: string;
+    senderUserId: string | undefined;
+    fileItems: MsgFileVO[];
+    log?: Log;
+}): Promise<MsgFileVO[]>;
+//# sourceMappingURL=inbound-input-media.d.ts.map

package/dist/src/inbound-input-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-input-media.d.ts","sourceRoot":"","sources":["../../src/inbound-input-media.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAYzE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,sCAAsC;AACtC,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAmB7D,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,OAAO,CAEtE;AAED,MAAM,WAAW,sBAAsB;IACnC,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,GAAG,CAAC;CACb,GAAG,sBAAsB,GAAG,SAAS,CAoCrC;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACnD,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,GAAG,CAAC;CACb,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAyKvB"}

package/dist/src/inbound-input-media.js

@@ -0,0 +1,230 @@
+/**
+ * 入站带 URL 的附件：落盘到项目 input 或默认 xg-cwork-im/input，并将本地路径写入 MediaPath。
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveAgentWorkspaceDir } from "openclaw/plugin-sdk/memory-core-host-engine-foundation";
+import { resolveLocalAbsolutePath } from "./project-path-normalize.js";
+import { buildInboundStoredFilename, ensureAgentWorkspaceFromRuntime, formatDateFolderLocal, openClawMediaRefForSavedFile, resolveAgentWorkspaceDirFromRuntime, } from "./inbound-media-local.js";
+import { shouldDownloadInboundFile } from "./inbound-file-download.js";
+import { downloadMediaBuffer, resolveMaxAttachmentBytes } from "./resource-file.js";
+import { archiveExtractDirPath, extractArchive, isArchiveFile } from "./inbound-archive.js";
+/** agentContext 指定项目根时，其下的入站附件子目录名 */
+export const AGENT_CONTEXT_INPUT_DIR = "input";
+/** 未指定 agentContext 时，相对 workspace 的默认入站目录 */
+export const DEFAULT_INBOUND_INPUT_REL = "xg-cwork-im/input";
+function sanitizeUserIdForPath(id) {
+    const t = id.trim();
+    if (/^-?\d+$/.test(t) && t.length <= 32)
+        return t;
+    const safe = t.replace(/[^\w.-]/g, "_").replace(/_+/g, "_").replace(/^_|_$/g, "");
+    return safe.slice(0, 64) || "unknown";
+}
+function mediaRefMode(ref) {
+    const t = ref.trim();
+    if (!t)
+        return "other";
+    if (t.startsWith("file://"))
+        return "fileUrl";
+    if (/^https?:\/\//i.test(t))
+        return "httpUrl";
+    if (t.startsWith("/"))
+        return "prefixed";
+    if (t.startsWith("./"))
+        return "relative";
+    return "other";
+}
+export function hasInboundUrlDownloads(fileItems) {
+    return fileItems.some((f) => shouldDownloadInboundFile(f));
+}
+/**
+ * 解析入站附件落盘根目录（input 文件夹的宿主绝对路径）。
+ */
+export function resolveInboundInputHostLayout(args) {
+    const { cfg, agentId, agentContext, workspaceHostRoot, log } = args;
+    if (agentContext?.localRoot) {
+        try {
+            if (agentContext.localRoot.kind === "workspace_relative") {
+                const host = workspaceHostRoot?.trim() ||
+                    resolveAgentWorkspaceDir(cfg, agentId);
+                const projectAbs = resolveLocalAbsolutePath(agentContext.localRoot, host);
+                return {
+                    inputHostDir: path.join(projectAbs, AGENT_CONTEXT_INPUT_DIR),
+                    workspaceRoot: path.resolve(host.trim()),
+                };
+            }
+            const projectAbs = resolveLocalAbsolutePath(agentContext.localRoot, undefined);
+            return {
+                inputHostDir: path.join(projectAbs, AGENT_CONTEXT_INPUT_DIR),
+                workspaceRoot: undefined,
+            };
+        }
+        catch (e) {
+            log?.warn?.(`[cwork_im:inbound-input] agentContext path resolve failed: ${String(e)}`);
+            return undefined;
+        }
+    }
+    try {
+        const workspaceRoot = resolveAgentWorkspaceDir(cfg, agentId);
+        return {
+            inputHostDir: path.join(workspaceRoot, ...DEFAULT_INBOUND_INPUT_REL.split("/")),
+            workspaceRoot: path.resolve(workspaceRoot),
+        };
+    }
+    catch (e) {
+        log?.warn?.(`[cwork_im:inbound-input] resolveAgentWorkspaceDir failed: ${String(e)}`);
+        return undefined;
+    }
+}
+/**
+ * 将带 URL 的入站附件下载到 input 目录；无 URL 的项原样保留。失败项保留原 URL。
+ */
+export async function saveInboundFilesToInputDir(args) {
+    const { rt, cfg, config, agentId, agentContext, workspaceHostRoot, senderUserId, fileItems, log } = args;
+    if (!hasInboundUrlDownloads(fileItems))
+        return fileItems;
+    let layout = resolveInboundInputHostLayout({
+        cfg,
+        agentId,
+        agentContext,
+        workspaceHostRoot,
+        log,
+    });
+    if (!layout) {
+        if (agentContext) {
+            log?.warn?.("[cwork_im:inbound-input] agentContext present but input dir unresolved; keep remote URLs");
+            return fileItems;
+        }
+        const fallbackRoot = resolveAgentWorkspaceDirFromRuntime(rt, cfg);
+        if (fallbackRoot) {
+            layout = {
+                inputHostDir: path.join(fallbackRoot, ...DEFAULT_INBOUND_INPUT_REL.split("/")),
+                workspaceRoot: fallbackRoot,
+            };
+            log?.warn?.("[cwork_im:inbound-input] using runtime workspace fallback (no agentId-aware root)");
+        }
+    }
+    if (!layout) {
+        log?.warn?.("[cwork_im:inbound-input] cannot resolve input dir; keep remote URLs");
+        return fileItems;
+    }
+    await ensureAgentWorkspaceFromRuntime(rt, cfg);
+    const { inputHostDir, workspaceRoot } = layout;
+    const maxBytes = resolveMaxAttachmentBytes(config);
+    const userSeg = sanitizeUserIdForPath(senderUserId ?? "unknown");
+    const pathStyle = config.inboundMediaOpenClawPath ?? "workspaceRelative";
+    // 仅在显式配置 inboundMediaSandboxRootPrefix 时，才把 workspace 相对路径改写为绝对前缀路径。
+    // 未配置时保持 ./相对路径，避免不同运行时下 /workspace 前缀与工具允许目录不一致。
+    // host_absolute 时 workspaceRoot 为 undefined，走 absoluteFileUrl 分支，前缀无效。
+    const sandboxPrefix = config.inboundMediaSandboxRootPrefix?.trim() || "";
+    log?.info?.(`[cwork_im:inbound-input] begin files=${fileItems.length} inputHostDir=${inputHostDir} workspaceRoot=${workspaceRoot ?? "(none)"} agentContext=${agentContext ? "yes" : "no"} style=${pathStyle} sandboxPrefix=${sandboxPrefix || "(none)"}`);
+    const out = [];
+    for (const item of fileItems) {
+        const srcUrl = item.url?.trim();
+        if (!srcUrl) {
+            out.push(item);
+            continue;
+        }
+        if (!shouldDownloadInboundFile(item)) {
+            log?.info?.(`[cwork_im:inbound-input] skip download (download=false or content present) source=${item.source?.trim() ?? "(none)"} refId=${item.fileId ?? "(none)"} url=${srcUrl.slice(0, 80)}`);
+            out.push(item);
+            continue;
+        }
+        const now = new Date();
+        const dateFolder = formatDateFolderLocal(now);
+        const localName = buildInboundStoredFilename(item.name?.trim() || "file", now);
+        const dir = path.join(inputHostDir, userSeg, dateFolder);
+        const absPath = path.join(dir, localName);
+        try {
+            await mkdir(dir, { recursive: true });
+            const { buffer } = await downloadMediaBuffer(srcUrl, maxBytes, log);
+            await writeFile(absPath, buffer);
+            let finalUrl;
+            let archiveExtractedFiles;
+            if (isArchiveFile(localName)) {
+                const extractDir = archiveExtractDirPath(absPath);
+                try {
+                    const extracted = await extractArchive(absPath, extractDir);
+                    const wsRoot = workspaceRoot?.trim();
+                    if (wsRoot) {
+                        finalUrl = openClawMediaRefForSavedFile({
+                            workspaceRoot: wsRoot,
+                            absPath: extractDir,
+                            style: pathStyle,
+                            sandboxRootPrefix: sandboxPrefix,
+                            log,
+                        });
+                    }
+                    else {
+                        finalUrl = openClawMediaRefForSavedFile({
+                            workspaceRoot: inputHostDir,
+                            absPath: extractDir,
+                            style: "absoluteFileUrl",
+                            log,
+                        });
+                    }
+                    archiveExtractedFiles = extracted;
+                    log?.info?.(`[cwork_im:inbound-input] extracted archive ${localName} → ${extractDir} files=${extracted.length}`);
+                }
+                catch (extractErr) {
+                    log?.warn?.(`[cwork_im:inbound-input] archive extraction failed, fallback to raw file: ${String(extractErr)}`);
+                    const wsRoot = workspaceRoot?.trim();
+                    if (wsRoot) {
+                        finalUrl = openClawMediaRefForSavedFile({
+                            workspaceRoot: wsRoot,
+                            absPath,
+                            style: pathStyle,
+                            sandboxRootPrefix: sandboxPrefix,
+                            log,
+                        });
+                    }
+                    else {
+                        finalUrl = openClawMediaRefForSavedFile({
+                            workspaceRoot: inputHostDir,
+                            absPath,
+                            style: "absoluteFileUrl",
+                            log,
+                        });
+                    }
+                }
+            }
+            else {
+                const wsRoot = workspaceRoot?.trim();
+                if (wsRoot) {
+                    finalUrl = openClawMediaRefForSavedFile({
+                        workspaceRoot: wsRoot,
+                        absPath,
+                        style: pathStyle,
+                        sandboxRootPrefix: sandboxPrefix,
+                        log,
+                    });
+                }
+                else {
+                    finalUrl = openClawMediaRefForSavedFile({
+                        workspaceRoot: inputHostDir,
+                        absPath,
+                        style: "absoluteFileUrl",
+                        log,
+                    });
+                }
+            }
+            log?.info?.(`[cwork_im:inbound-input] saved ${localName} bytes=${buffer.length} abs=${absPath} openclawRef=${finalUrl} refMode=${mediaRefMode(finalUrl)} style=${pathStyle} sandboxPrefix=${sandboxPrefix || "(none)"} workspaceRoot=${workspaceRoot?.trim() ?? "(none)"} archiveExtracted=${archiveExtractedFiles?.length ?? 0}`);
+            const outputItem = {
+                ...item,
+                url: finalUrl,
+                size: buffer.length,
+                name: localName,
+            };
+            if (archiveExtractedFiles) {
+                outputItem.archiveExtractedFiles = archiveExtractedFiles;
+            }
+            out.push(outputItem);
+        }
+        catch (e) {
+            log?.warn?.(`[cwork_im:inbound-input] download/save failed, degrade to OpenClaw URL (MediaPath): ${String(e)} ref=${srcUrl.slice(0, 80)}`);
+            out.push(item);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=inbound-input-media.js.map

package/dist/src/inbound-input-media.js.map

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

package/dist/src/inbound-media-local.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 入站附件：可选落盘到当前 Agent workspace 下指定子目录（相对路径）。
+ *
+ * 目录约定：{subdir}/{userId}/{YYYY-MM-DD}/{stem}_{HHmmssmmm}{ext}
+ * 时间取写入时的本地时区。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { Log } from "./auth.js";
+import type { MsgFileVO, XgImConfig } from "./types.js";
+/** 校验：非空、相对路径、不含 `..` 段 */
+export declare function normalizeInboundWorkspaceSubdir(subdir: string): string | null;
+export declare function resolveAgentWorkspaceDirFromRuntime(rt: unknown, cfg: OpenClawConfig): string | undefined;
+export declare function ensureAgentWorkspaceFromRuntime(rt: unknown, cfg: OpenClawConfig): Promise<void>;
+export declare function formatDateFolderLocal(d: Date): string;
+/** `HHmmss` + 三位毫秒，如 `120459237` */
+export declare function formatInboundTimeSuffix(d: Date): string;
+/**
+ * 将落盘绝对路径转为 OpenClaw / 沙箱可用的 workspace 相对引用（POSIX 风格，带 `./` 前缀）。
+ * 若文件不在 workspaceRoot 之下则返回 null（调用方应回退 file:// 或报错）。
+ */
+export declare function absPathToWorkspaceRelativeOpenClawRef(workspaceRoot: string, absPath: string): string | null;
+/**
+ * 沙箱内常用挂载点（如 `/workspace`）+ 相对 workspace 的路径，供 read 等工具按「绝对路径」解析。
+ * 若未配置 sandboxRootPrefix，则仍用 `./xg_im_inbound/...`（相对当前 cwd，部分沙箱工具会误判为不可访问）。
+ */
+export declare function sandboxWorkspaceMediaRef(workspaceRoot: string, absPath: string, sandboxRootPrefix: string): string | null;
+export declare function openClawMediaRefForSavedFile(args: {
+    workspaceRoot: string;
+    absPath: string;
+    style: "workspaceRelative" | "absoluteFileUrl" | undefined;
+    /** 非空且 style 为 workspaceRelative 时，用 `/workspace/...` 形式代替 `./...` */
+    sandboxRootPrefix?: string;
+    log?: Log;
+}): string;
+/** `report_120459237.pdf` */
+export declare function buildInboundStoredFilename(originalFilename: string, at: Date): string;
+/**
+ * 将入站附件下载到 workspace 下子目录；失败项保留原 URL。
+ */
+export declare function saveInboundFilesToWorkspace(args: {
+    rt: unknown;
+    cfg: OpenClawConfig;
+    config: XgImConfig;
+    workspaceSubdir: string;
+    senderUserId: string | undefined;
+    fileItems: MsgFileVO[];
+    log?: Log;
+}): Promise<MsgFileVO[]>;
+//# sourceMappingURL=inbound-media-local.d.ts.map

package/dist/src/inbound-media-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-media-local.d.ts","sourceRoot":"","sources":["../../src/inbound-media-local.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,2BAA2B;AAC3B,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7E;AAED,wBAAgB,mCAAmC,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAWxG;AAED,wBAAsB,+BAA+B,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CASrG;AASD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAKrD;AAED,oCAAoC;AACpC,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAMvD;AAcD;;;GAGG;AACH,wBAAgB,qCAAqC,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3G;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,GAC1B,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAC3D,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,GAAG,CAAC;CACb,GAAG,MAAM,CAgBT;AAED,6BAA6B;AAC7B,wBAAgB,0BAA0B,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,GAAG,MAAM,CAMrF;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACpD,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,GAAG,CAAC;CACb,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAsEvB"}