@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/plugin/process-shared-store.test.js

@@ -0,0 +1,60 @@
+import assert from "node:assert/strict";
+import { beforeEach, describe, it } from "node:test";
+import { __resetProcessSharedStoreForTests, currentModuleEpoch, currentRegisterSeq, getOrCreateShared, getSharedMap, nextModuleEpoch, nextRegisterSeq, requestFullTeardownOnce, resetFullTeardownGate, } from "./process-shared-store.js";
+beforeEach(() => {
+    __resetProcessSharedStoreForTests();
+});
+describe("process-shared-store: module epoch / register seq", () => {
+    it("moduleEpoch and registerSeq are monotonic per claim (observability only)", () => {
+        assert.equal(nextModuleEpoch(), 1);
+        assert.equal(nextModuleEpoch(), 2);
+        assert.equal(currentModuleEpoch(), 2);
+        assert.equal(nextRegisterSeq(), 1);
+        assert.equal(nextRegisterSeq(), 2);
+        assert.equal(currentRegisterSeq(), 2);
+    });
+    it("registerSeq is NOT used to decide teardown (must never gate stopAll on 'no later register')", () => {
+        // Registry 代际交替可能在批量 register 的尾端触发 cleanup，而无更晚 register；
+        // 该情形绝不能导出「全量 teardown」结论。这里验证 registerSeq 仅单调计数。
+        const last = nextRegisterSeq();
+        nextRegisterSeq();
+        assert.ok(currentRegisterSeq() > last);
+    });
+});
+describe("process-shared-store: cross-module singleton via getOrCreateShared", () => {
+    it("getOrCreateShared returns the same instance for the same key", () => {
+        const a = getOrCreateShared("x", () => new Map());
+        const b = getOrCreateShared("x", () => new Map());
+        assert.equal(a, b);
+    });
+    it("getSharedMap returns the same map for the same key (old/new module read/write one copy)", () => {
+        const a = getSharedMap("shared-map");
+        const b = getSharedMap("shared-map");
+        assert.equal(a, b);
+        a.set("k", 1);
+        assert.equal(b.get("k"), 1);
+    });
+    it("distinct keys produce distinct instances", () => {
+        const a = getOrCreateShared("k1", () => new Map());
+        const b = getOrCreateShared("k2", () => new Map());
+        assert.notEqual(a, b);
+    });
+});
+describe("process-shared-store: full teardown once-gate (gateway_stop)", () => {
+    it("requestFullTeardownOnce returns true only once until reset", () => {
+        assert.equal(requestFullTeardownOnce(), true);
+        assert.equal(requestFullTeardownOnce(), false);
+        assert.equal(requestFullTeardownOnce(), false);
+    });
+    it("a new register resets the gate so a later stop can teardown again", () => {
+        assert.equal(requestFullTeardownOnce(), true);
+        resetFullTeardownGate();
+        assert.equal(requestFullTeardownOnce(), true);
+    });
+    it("repeated gateway_stop handlers (one per register) collapse to a single teardown", () => {
+        const handlers = [requestFullTeardownOnce, requestFullTeardownOnce, requestFullTeardownOnce];
+        const results = handlers.map((h) => h());
+        assert.deepEqual(results, [true, false, false]);
+    });
+});
+//# sourceMappingURL=process-shared-store.test.js.map

package/dist/src/plugin/process-shared-store.test.js.map

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

package/dist/src/plugin/recommended-system-prompt.d.ts

@@ -0,0 +1,3 @@
+/** 建议复制到 `channels.xg_cwork_im.systemPrompt`。 */
+export declare const XG_IM_RECOMMENDED_CHANNEL_SYSTEM_PROMPT: string;
+//# sourceMappingURL=recommended-system-prompt.d.ts.map

package/dist/src/plugin/recommended-system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommended-system-prompt.d.ts","sourceRoot":"","sources":["../../../src/plugin/recommended-system-prompt.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,eAAO,MAAM,uCAAuC,QAMa,CAAC"}

package/dist/src/plugin/recommended-system-prompt.js

@@ -0,0 +1,8 @@
+/** 建议复制到 `channels.xg_cwork_im.systemPrompt`。 */
+export const XG_IM_RECOMMENDED_CHANNEL_SYSTEM_PROMPT = "当用户要求生成、返回或发送文件（报告、HTML、PDF、图片等）时，必须使用 `xg_cwork_im_send_file` 工具发送，不要用 `MEDIA:<路径>`。" +
+    "步骤：1) 先在当前 Agent workspace 内创建具体文件；2) 确认路径存在且是普通文件而非目录；" +
+    "3) 调用 `xg_cwork_im_send_file`，`path` 传 workspace 相对路径（可带 ./ 或 /workspace/ 前缀），可用 `caption` 附说明、`fileName` 指定展示名。" +
+    "不要传 groupId 或账户（由会话上下文自动决定），不要传 URL、宿主机绝对路径、workspace 外或 .. 路径，也不要复制到 /tmp/openclaw。" +
+    "只有工具返回 `ok:true` 后才能告诉用户文件已发送；返回 `ok:false` 时按 `code` 修正文件或路径后重试，不得谎称已发送。" +
+    "纯文本回复照常直接回复即可；`xg_cwork_im_send_group_message` 只发纯文本、不能发附件。";
+//# sourceMappingURL=recommended-system-prompt.js.map

package/dist/src/plugin/recommended-system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommended-system-prompt.js","sourceRoot":"","sources":["../../../src/plugin/recommended-system-prompt.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,CAAC,MAAM,uCAAuC,GAChD,uFAAuF;IACvF,yDAAyD;IACzD,kHAAkH;IAClH,sFAAsF;IACtF,2EAA2E;IAC3E,6DAA6D,CAAC"}

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

@@ -0,0 +1,433 @@
+/**
+ * XG-IM Channel Plugin — 类型定义
+ */
+import type { OpenClawConfig, ChannelPlugin as SDKChannelPlugin, PluginRuntime } from "openclaw/plugin-sdk/core";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-plugin-common";
+import type { ChannelAccountSnapshot as SDKChannelAccountSnapshot } from "openclaw/plugin-sdk/status-helpers";
+import type { ChannelGatewayContext as SDKChannelGatewayContext } from "openclaw/plugin-sdk/channel-contract";
+import type { RobotMentionAgentContext } from "../session/agent-context-types.js";
+export interface XgImPluginModule {
+    id: string;
+    name: string;
+    description?: string;
+    configSchema?: unknown;
+    register?: (api: OpenClawPluginApi) => void | Promise<void>;
+}
+/** 与 openclaw.plugin.json 中 id: xg_cwork_im 对应 */
+export type XgCworkImPluginModule = XgImPluginModule;
+/**
+ * Auto Model Routing（模型 + 推理等级自动路由）配置。
+ * - enabled=false 或 Agent 不在 allowlist 时，前端 `ai_model: "auto"` 按未指定模型处理。
+ * - 四个模型槽位是 Auto Router 可输出的全部模型。
+ * - thinkingDefaults：指定模型模式下各 model ref 的默认推理等级。
+ */
+export interface AutoModelRoutingConfig {
+    enabled?: boolean;
+    version?: string;
+    simpleModel?: string;
+    standardModel?: string;
+    complexModel?: string;
+    criticalModel?: string;
+    thinkingDefaults?: Record<string, string>;
+    agentAllowlist?: string[];
+}
+/** IM 逻辑 NAS 根到当前 OpenClaw 宿主机真实根目录的映射。 */
+export interface NasVolumeRootMapping {
+    /** 跨机器一致的绝对逻辑根，例如 /data/touqian。 */
+    logicalRoot: string;
+    /** 当前机器的真实 NAS 挂载根；仅插件内部可见，不得发送给 IM 客户端。 */
+    hostRoot: string;
+}
+/** 单个机器人账户配置 */
+export interface XgImAccountConfig {
+    /** 机器人 Key（新字段，优先于 appKey） */
+    robotKey?: string;
+    /** 机器人 appKey，从 IM 后台注册获取（已改名为 robotKey，此字段保留兼容旧配置） */
+    appKey?: string;
+    /** 是否启用当前账户；未设置时继承 channels.xg_cwork_im.enabled。 */
+    enabled?: boolean;
+    /** 对应 OpenClaw 的 Agent ID，默认为 'main' */
+    agentId?: string;
+    /** 账户显示名称 */
+    name?: string;
+    /** 群聊策略：open = 不需要 @，mention = 必须 @ 机器人才触发 */
+    groupPolicy?: "open" | "mention";
+    /** multipart 整文件上传字段名，默认 file（与 `/file/upDownload/uploadWholeFile` 约定一致时可不改） */
+    fileUploadFormField?: string;
+    maxAttachmentBytes?: number;
+    /** 覆盖顶层的入站附件 workspace 子目录（相对 Agent workspace） */
+    inboundMediaWorkspaceSubdir?: string;
+    /**
+     * 覆盖顶层：入站落盘后交给 OpenClaw 的 `MediaPath` 形式。
+     * - `workspaceRelative`（默认）：`./子目录/...`，或配合 `inboundMediaSandboxRootPrefix` 为 `/workspace/子目录/...`。
+     * - `absoluteFileUrl`：宿主机 `file://...`，仅适合无沙箱、同进程读盘场景。
+     */
+    inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl";
+    /**
+     * 沙箱内 Agent workspace 挂载根路径（如 `/workspace`）。
+     * 与 `inboundMediaOpenClawPath: workspaceRelative` 联用时，入站 `MediaPath` 为
+     * `{inboundMediaSandboxRootPrefix}/xg_im_inbound/...`，避免 `./` 被工具按 cwd 解析而报「不可访问」。
+     */
+    inboundMediaSandboxRootPrefix?: string;
+    /**
+     * 可选：本账户在群聊中追加给 Agent 的补充说明（映射为 OpenClaw 入站 `GroupSystemPrompt`）。
+     * 与顶层 `systemPrompt` 的合并规则见 `getXgImConfig`（`accounts.default` 与具体账户覆盖）。
+     */
+    systemPrompt?: string;
+    /** 见 {@link XgImConfig.syncServiceBaseUrl} */
+    syncServiceBaseUrl?: string;
+    /** 见 {@link XgImConfig.projectPromptMaxChars} */
+    projectPromptMaxChars?: number;
+    /** 见 {@link XgImConfig.nasVolumeRootMappings} */
+    nasVolumeRootMappings?: NasVolumeRootMapping[];
+    /** 见 {@link XgImConfig.blockStreaming} */
+    blockStreaming?: boolean;
+    /** 见 {@link XgImConfig.blockStreamingCoalesce} */
+    blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
+    /** 见 {@link XgImConfig.deliverModelFallbackNotice} */
+    deliverModelFallbackNotice?: boolean;
+    /** 见 {@link XgImConfig.deliverSegmentBuffer} */
+    deliverSegmentBuffer?: boolean;
+    /** 见 {@link XgImConfig.deliverPartialSnapshot} */
+    deliverPartialSnapshot?: boolean;
+    /** 见 {@link XgImConfig.deliverAssistantItems} */
+    deliverAssistantItems?: boolean;
+    /** Auto Model Routing（模型 + 推理等级自动路由）；默认关闭。 */
+    autoModelRouting?: AutoModelRoutingConfig;
+    /** 见 {@link XgImConfig.dispatchDriver} */
+    dispatchDriver?: "auto" | "official" | "legacy";
+}
+/** OpenClaw block reply 合并阈值（可选；IM 默认不配） */
+export interface BlockStreamingCoalesceConfig {
+    minChars?: number;
+    maxChars?: number;
+    idleMs?: number;
+}
+export interface XgImConfig extends OpenClawConfig {
+    /** 多账户列表 */
+    accounts?: Record<string, XgImAccountConfig>;
+    /** 机器人 Key（新字段，优先于 appKey，单账户模式） */
+    robotKey?: string;
+    /** 机器人 appKey（单账户模式，已改名为 robotKey，此字段保留兼容旧配置） */
+    appKey?: string;
+    /** 对应 OpenClaw 的 Agent ID（单账户模式） */
+    agentId?: string;
+    /** IM 服务域名，如 https://test.xgjktech.com.cn */
+    baseUrl: string;
+    /** WebSocket 服务域名，如 wss://test.xgjktech.com.cn */
+    wsBaseUrl?: string;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 账户显示名称（单账户模式使用） */
+    name?: string;
+    /** 群聊策略：open = 不需要 @，mention = 必须 @ 机器人才触发 */
+    groupPolicy?: "open" | "mention";
+    /** 允许的发送者 userId 白名单（空表示全部允许） */
+    allowFrom?: string[];
+    /** 是否开启调试日志 */
+    debug?: boolean;
+    /** 最大重连次数（默认 10） */
+    maxConnectionAttempts?: number;
+    /** 初始重连延迟 ms（默认 1000） */
+    initialReconnectDelay?: number;
+    /** 最大重连延迟 ms（默认 60000） */
+    maxReconnectDelay?: number;
+    /** 重连延迟抖动因子 0-1（默认 0.3） */
+    reconnectJitter?: number;
+    /**
+     * 首次 AI 回复超时时间（毫秒）。
+     *
+     * - 未配置时默认 30 分钟（1800_000ms）。
+     * - 仅用于保护「思考中」占位消息，避免长时间不被更新。
+     */
+    firstReplyTimeoutMs?: number;
+    /**
+     * 附件上传地址固定为 `{baseUrl}/file/upDownload/uploadWholeFile`，请求头 `access-token` 与发 IM 相同。
+     * multipart 字段名默认 `file`，可通过 fileUploadFormField 覆盖。
+     */
+    fileUploadFormField?: string;
+    /** 单个附件下载/上传允许的最大字节数，默认 50MB */
+    maxAttachmentBytes?: number;
+    /**
+     * 若配置为非空相对路径（相对于当前 Agent workspace 根目录）：入站附件会先下载到
+     * `{workspace}/{本字段}/{userId}/{YYYY-MM-DD}/{name}_{HHmmssmmm}.ext`，再向 OpenClaw 传入 **workspace 相对路径**（默认 `./子目录/...`，便于沙箱挂载 `/workspace`）或 `file://`（见 `inboundMediaOpenClawPath`）。
+     * 未配置或为空则仍使用 IM 返回的远程 URL。
+     */
+    inboundMediaWorkspaceSubdir?: string;
+    /**
+     * 入站落盘后写入 `MediaPath` 的引用形式；默认与 `workspaceRelative` 等价（未填时）。
+     * Agent 在沙箱中运行时应用 `workspaceRelative`，避免宿主机绝对 `file://` 在沙箱内不可读。
+     */
+    inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl";
+    /** 见 {@link XgImAccountConfig.inboundMediaSandboxRootPrefix} */
+    inboundMediaSandboxRootPrefix?: string;
+    /**
+     * 可选：本通道在群聊中追加给 Agent 的补充说明（映射为 OpenClaw 入站 `GroupSystemPrompt`）。
+     * 多账户时可与 `accounts.<id>.systemPrompt` 及 `accounts.default.systemPrompt` 组合覆盖，见插件内 `getXgImConfig`。
+     */
+    systemPrompt?: string;
+    /**
+     * openclaw-xgkb-sync 管理 API 根地址（如 `http://127.0.0.1:9090`）。
+     * 配置后插件可处理 IM 下发的 `openclawApplySyncMapping` 并登记目录映射。
+     */
+    syncServiceBaseUrl?: string;
+    /** `agentContext.background` 与 `userInfo.background` 单段最大字符数（默认 15000） */
+    projectPromptMaxChars?: number;
+    /**
+     * 当前 OpenClaw 服务所挂载 NAS 的站点编码。
+     * 配置路径为 channels.xg_cwork_im.nasSiteCode，默认 SZ_PRIMARY；该值会随 NAS 工作区结果回传客户端。
+     */
+    nasSiteCode?: string;
+    /** 将 IM 的逻辑 realDir 根映射为当前 OpenClaw 宿主机上的真实根目录。 */
+    nasVolumeRootMappings?: NasVolumeRootMapping[];
+    /** 单个插件进程中所有 Agent 共享的工作区活动请求上限，默认 32。 */
+    workspaceEventMaxConcurrency?: number;
+    /** 工作区活动请求中 FILE_REQUEST 的上限，默认 8。 */
+    workspaceEventMaxFileConcurrency?: number;
+    /** 同一个 agentId 同时执行的工作区请求上限，默认 2。 */
+    workspaceEventPerAgentConcurrency?: number;
+    /** 达到活动请求上限后允许等待的全局请求数，默认 64；设为 0 表示不排队。 */
+    workspaceEventQueueLimit?: number;
+    /**
+     * 是否在 assistant 每个 text 块结束（tool 调用前）通过 HTTP 发送中间正文。
+     * 默认开启；设为 `false` 恢复「整轮结束才 deliver 一次」。
+     */
+    blockStreaming?: boolean;
+    /**
+     * 可选：合并同一 text 块内的流式 token 碎片后再向通道 deliver。
+     * 通道未配时插件注入默认 `minChars:500 idleMs:500`（盖住 agents.defaults 偏大值，也避免旧 1/0 过碎）。
+     */
+    blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
+    /**
+     * 是否向 IM 用户发送 OpenClaw 模型降级运营通知（`↪️ Model Fallback: …`）。
+     * 默认 `false`（不发送）；设为 `true` 时与旧版行为一致。
+     */
+    deliverModelFallbackNotice?: boolean;
+    /**
+     * 是否在 `blockStreaming` 开启时，将同一段 assistant 正文缓冲后在 tool 边界 / 轮次结束再 HTTP。
+     * 默认 `true`：修稿覆盖、流式分块追加合并；设为 `false` 恢复「每次 deliver 即 HTTP + C7 去重」。
+     */
+    deliverSegmentBuffer?: boolean;
+    /**
+     * 是否用 `onPartialReply` 的全量快照作为段内正文的权威来源（在 tool 边界 / 轮末 flush 时覆盖 deliver 拼接文本）。
+     * 默认 `true`：消除段缓冲对「覆盖 vs 追加」的启发式猜测（CO2）；设为 `false` 回退到纯 deliver 段缓冲。
+     * 仅在快照包含缓冲文本时才覆盖，避免流式竞态下截断。
+     */
+    deliverPartialSnapshot?: boolean;
+    /**
+     * 是否改为订阅 OpenClaw `assistant` 流、按「每条 assistant 消息(item)」逐条 HTTP 投递。
+     * 默认 `true`：用 assistant item 的完整 text，避免 block reply 分块拼接丢换行，且不含 commentary；
+     * 设为 `false` 回退到 block reply 段缓冲聚合。
+     */
+    deliverAssistantItems?: boolean;
+    /** Auto Model Routing（模型 + 推理等级自动路由）；默认关闭。 */
+    autoModelRouting?: AutoModelRoutingConfig;
+    /**
+     * dispatch 内核驱动：`auto`（默认）= 宿主支持时用官方 assembled turn
+     * （runtime.channel.inbound.dispatchReply），否则回退 legacy；
+     * `official` 强制官方；`legacy` 强制旧路径（回退开关）。
+     * 也可用环境变量 `XG_CWORK_IM_DISPATCH_DRIVER=official|legacy` 覆盖。
+     */
+    dispatchDriver?: "auto" | "official" | "legacy";
+}
+/** GET /user/login/appkey 的响应 */
+export interface GetTokenResponse {
+    data?: {
+        xgToken: string;
+        empId: string;
+        userName?: string;
+        avatar?: string;
+        corpId?: string;
+        deptList?: unknown[];
+        appCode?: string;
+        telephone?: string;
+        personId?: string;
+    };
+    resultCode?: number;
+    resultMsg?: string | null;
+}
+/** 机器人身份信息（认证成功后缓存） */
+export interface BotIdentity {
+    token: string;
+    userId: string;
+    name: string;
+}
+/** WebSocket 消息通知（cmd = robotMention） */
+export interface WsMessage {
+    cmd: string;
+    params: WsMessageParams;
+    ts: number;
+}
+/**
+ * 与 IM 服务 `MsgFileVO` 对齐的附件项（WebSocket `msgContent.files[]`）。
+ */
+export interface MsgFileVO {
+    /** 远程下载链接，或入站落盘后的 `file://` / workspace 相对引用（如 `./xg_im_inbound/...`） */
+    url: string;
+    /** 文件格式，小写：pdf、png、docx、doc、ppt、txt、md 等 */
+    format?: string;
+    /**
+     * 附件来源（IM 侧人类可读文案，原样展示给 OpenClaw），如「知识库文档」「工作汇报」。
+     * 新增来源类型由 IM 维护，插件不做枚举映射。
+     */
+    source?: string;
+    /** 业务引用 ID（在 source 域内唯一）；七牛等无业务 id 时可为空 */
+    fileId?: string;
+    /** 文件大小（字节） */
+    size?: number;
+    /** 文件名称，如 xxx.pdf */
+    name?: string;
+    /**
+     * IM 侧已解析的正文（如图片 OCR/说明、文档抽取的文本等）。
+     * 非空时插件会拼入入站 `Body`/`RawBody`，一并交给 OpenClaw。
+     */
+    content?: string;
+    /**
+     * 是否将 url 当作文件下载链接落盘到 workspace input。
+     * - `true`：一定下载
+     * - `false`：不下载，url 原样写入 MediaPath（可读内容页/API 链接等）
+     * - 未传或空：有 content 则不下载，否则下载
+     */
+    download?: boolean | string | number;
+}
+/** @deprecated 使用 {@link MsgFileVO} */
+export type WsInboundFileItem = MsgFileVO;
+/** 常见 IM format → MIME，供 OpenClaw 媒体理解；未知格式返回 undefined */
+export declare function imFormatToMimeType(format: string | undefined): string | undefined;
+/**
+ * 入站消息内容体（与 IM WebSocket `params.msgContent` 对齐）。
+ *
+ * - **type=`text`**：纯文本；**text** 建议非空。
+ * - **type=`file`**：带 1..N 个文件，**files** 建议至少 1 项；**text** 可为配文（同时上传多文件 + 一句话）。**files[].content** 可由 IM 填已解析文本（如图/文档），插件会拼入入站正文。
+ * - 语音在 IM 侧已转写为文字时，应以 **type=`text`** 推送转写结果，不再使用 voice。
+ */
+export interface WsMessageContent {
+    /** 文本正文；纯文本消息为主内容；file 消息上为可选配文 */
+    text?: string;
+    /** `text` | `file`（可扩展其它枚举，插件对未知类型按文本兜底） */
+    type: string;
+    /** 多附件；type 为 file 时由 IM 填至少一项 */
+    files?: MsgFileVO[];
+    /**
+     * 透传给 AI 的扩展参数。已知键：
+     * - `ai_model`：单轮模型（`default`/`auto`/具体 model ref）；
+     * - `ai_thinking`：单轮推理强度（`off|minimal|low|medium|high|xhigh|adaptive|max|ultra`）。
+     * 两者均不进入 prompt（由 inbound-display 从 untrusted context 剔除）。
+     */
+    ext?: Record<string, any>;
+}
+/** IM 在 robotMention 上下发的项目上下文（见 docs/im服务接口说明.md） */
+export type { AgentContextKnowledgeBase, NasVolume, RobotMentionAgentContext } from "../session/agent-context-types.js";
+/** robotMention 消息的 params */
+export interface WsMessageParams {
+    msgId: string;
+    groupId: string;
+    /** 项目级上下文：localRoot / NAS 目录 + 可选知识库绑定 + 可选背景，插件合并进 GroupSystemPrompt */
+    agentContext?: RobotMentionAgentContext;
+    /** 发送人信息 */
+    userInfo: {
+        /** 发送人 ID */
+        id: string;
+        /** 发送人显示名 */
+        name: string;
+        /**
+         * 用户背景（IM 服务端拼接：姓名、职位、部门、业务 OpenAPI appKey 等）。
+         * 非空时写入 GroupSystemPrompt 的 `## 当前用户` 段。
+         */
+        background?: string;
+        /**
+         * 当前用户的原始业务 OpenAPI AppKey。
+         * 插件按「最后触发者」覆盖写入该会话的 exec 环境变量 `XG_OPENAPI_APP_KEY`，
+         * 供 skill / 命令以子进程方式调用业务 OpenAPI 时使用（不进入 LLM prompt）。
+         */
+        appKey?: string;
+    };
+    msgContent: WsMessageContent;
+    /** 服务端可能返回 msgSendTime 或 timestamp */
+    msgSendTime?: number;
+    timestamp?: number;
+    /** 被 @ 的人员 ID 列表 */
+    mentions?: string[] | null;
+    /**
+     * 会话类型：`SINGLE` 单聊 | `GROUP` 群聊。
+     * 单聊时插件无需 @ 即触发 AI，且出站 `/im/message/send` 省略 `reply` 字段。
+     * 未传时按群聊逻辑处理（依赖 mentions 或正文 @）。
+     */
+    chatType?: ImChatTypeParam;
+}
+/** IM 下发的 chatType 字符串（大小写不敏感，插件归一化为大写） */
+export type ImChatTypeParam = "SINGLE" | "GROUP" | "single" | "group";
+/** POST /im/message/send 请求体 */
+export interface SendMessageReply {
+    /** 被回复消息ID */
+    targetMsgId: string;
+    /** 被回复消息发送者ID */
+    targetUserId: string;
+    /** 被回复消息发送者显示名 */
+    targetUserName: string;
+    /** 被回复消息摘要 */
+    previewText: string;
+}
+/** IM 发送 FILE 类型消息时的附件项（与发消息接口约定一致） */
+export interface SendMessageFileAttachment {
+    fileId: string;
+    /** 固定为 FILE */
+    fileType: "FILE";
+    /** 小写扩展名，如 md、pdf */
+    format: string;
+    name: string;
+    size: number;
+    /** 固定为 resource */
+    source: "resource";
+}
+export type SendMessageBody = {
+    type: "TEXT" | "RICH_TEXT" | "VOICE";
+    groupId?: string;
+    toUserId?: string;
+    text: string;
+    atUserIds?: string[];
+    /** @deprecated 占位消息合并字段，已废弃，不再发送。 */
+    msgId?: string;
+    /** 客户端消息幂等键：服务端按 clientMsgId + groupId + 最近 10 分钟去重（重试复用同值 → 命中已有消息，不重复投递）。 */
+    clientMsgId?: string;
+    reply?: SendMessageReply;
+} | {
+    type: "FILE";
+    groupId?: string;
+    toUserId?: string;
+    text: string;
+    attachments: SendMessageFileAttachment[];
+    atUserIds?: string[];
+    /** @deprecated 占位消息合并字段，已废弃，不再发送。 */
+    msgId?: string;
+    /** 客户端消息幂等键：服务端按 clientMsgId + groupId + 最近 10 分钟去重（重试复用同值 → 命中已有消息，不重复投递）。 */
+    clientMsgId?: string;
+    reply?: SendMessageReply;
+};
+/** GET /im/message/getLatestMsgListForAI 响应 */
+export interface GetLatestMsgListResponse {
+    data?: WsMessageParams[];
+    resultCode?: number;
+    message?: string;
+}
+export type ChannelLogSink = {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    debug?: (msg: string) => void;
+};
+export type ChannelAccountSnapshot = SDKChannelAccountSnapshot;
+export interface ResolvedAccount {
+    accountId: string;
+    config: XgImConfig;
+    enabled: boolean;
+    configured: boolean;
+    name?: string | null;
+}
+export type GatewayStartContext = SDKChannelGatewayContext<ResolvedAccount>;
+export type XgImChannelPlugin = SDKChannelPlugin<ResolvedAccount & {
+    configured: boolean;
+}>;
+/** PluginRuntime 的类型（内部 API 丰富，用 any 表示） */
+export type { PluginRuntime };
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/plugin/types.js

@@ -0,0 +1,32 @@
+/**
+ * XG-IM Channel Plugin — 类型定义
+ */
+/** 常见 IM format → MIME，供 OpenClaw 媒体理解；未知格式返回 undefined */
+export function imFormatToMimeType(format) {
+    const f = format?.trim().toLowerCase();
+    if (!f)
+        return undefined;
+    const map = {
+        pdf: "application/pdf",
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        gif: "image/gif",
+        webp: "image/webp",
+        doc: "application/msword",
+        docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        ppt: "application/vnd.ms-powerpoint",
+        pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        xls: "application/vnd.ms-excel",
+        xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        txt: "text/plain",
+        md: "text/markdown",
+        csv: "text/csv",
+        zip: "application/zip",
+        mp3: "audio/mpeg",
+        wav: "audio/wav",
+        mp4: "video/mp4",
+    };
+    return map[f];
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugin/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiUH,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IACzD,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,GAAG,GAA2B;QAChC,GAAG,EAAE,iBAAiB;QACtB,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,YAAY;QACjB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,oBAAoB;QACzB,IAAI,EAAE,yEAAyE;QAC/E,GAAG,EAAE,+BAA+B;QACpC,IAAI,EAAE,2EAA2E;QACjF,GAAG,EAAE,0BAA0B;QAC/B,IAAI,EAAE,mEAAmE;QACzE,GAAG,EAAE,YAAY;QACjB,EAAE,EAAE,eAAe;QACnB,GAAG,EAAE,UAAU;QACf,GAAG,EAAE,iBAAiB;QACtB,GAAG,EAAE,YAAY;QACjB,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,WAAW;KACnB,CAAC;IACF,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}