@wecom/wecom-openclaw-plugin 2026.7.2 → 2026.8.17-beta.1

package/skills/wecomcli-todo/references/todo-update.md

@@ -0,0 +1,114 @@
+# 修改待办 — `wecom-cli todo update`
+
+批量更新待办的标题、描述、分派人名单或截止时间。
+
+## 调用方式
+
+使用 wecom-cli 工具按照下面格式调用
+
+```
+wecom-cli todo update --json '<JSON 参数>'
+```
+
+## 参数
+
+外层为对象，待更新的待办放在 `items` 数组中（支持批量）：
+
+| 字段 | 类型 | 必填 | 语义 |
+|---|---|---|---|
+| `items` | array | 是 | 更新条目数组，每项结构见下，单次最多 20 条；超出需分批 |
+
+`items[]` 元素结构（仅传需修改的字段，未传字段保持不变）：
+
+| 字段 | 类型 | 必填 | 默认值 | 语义 |
+|---|---|---|---|---|
+| `todo_id` | string | 是 | — | 待办 ID（前缀 `td`） |
+| `title` | string | 否 | — | 新的短标题 |
+| `description` | string | 否 | — | 新的详细描述 |
+| `followers` | array | 否 | — | **全量替换**后的分派人列表，最多 50 人；用户给姓名时使用 `wecomcli-contact` 技能获取 `userid`（前缀 `wo`） |
+| `deadline` | object | 否 | — | 新的截止时间；结构见 SKILL.md `deadline` 对象规范。**传空对象 `{}` 表示清空已设置的截止时间**；不传字段则保持原值 |
+| `remind_at_deadline` | boolean | 否 | `false` | 提醒时机，须与 `deadline` 同传：`true`=截止时刻提醒（仅 `datetime`）；`false`/不传=按后台默认提前时间提醒（**非关闭提醒**）。脱离 `deadline` 单独传无效 |
+
+`followers` 对象结构：
+
+| 子字段 | 类型 | 必填 | 语义 |
+|---|---|---|---|
+| `userid` | string | 是 | 分派人 `userid`，前缀 `wo` |
+
+> 入参的 `followers` 子对象**只接收 `userid`**。`wecom-cli todo list` / `wecom-cli todo get` 返回的 `followers` 还含 `user_name` / `user_status` / `update_time`，转入更新入参时全部剥掉，只保留 `userid`。
+
+> `followers` 是全量替换，不是增量添加。只新增或移除部分参与人时，先从 `todo list` / `todo get` 取得现有名单，在本地合并或删减，再把所有应保留的参与人重新传入。
+
+> 用户说"把我也加进去"、"分派给我和某某"时，`followers` 里同样要带上当前用户自己的 `userid`。
+
+### 修改截止时间与提醒
+
+- `remind_at_deadline` 必须与 `deadline` 一起传，语义与 create 完全一致；**只传 `remind_at_deadline`、不带 `deadline` 不会生效**，不要这么做。
+- 用户只改**截止时间/到期时间**时，填写新的 `deadline`，不要传 `remind_at_deadline`（即按后台默认提前时间提醒）。
+- 用户要求把待办改成"某时间提醒 / 定时提醒 / 截止时提醒"且给出具体时刻时，将该时刻作为新的 `deadline.type=datetime`，并传 `remind_at_deadline=true`；只给日期时不传 `remind_at_deadline=true`。
+- **`remind_at_deadline=false` 或不传 ≠ 关闭提醒**，而是按后台默认提前时间提醒。**update 入参没有关闭提醒的开关**（`remind_at_deadline` 只切换提醒时机；是否真正提醒由后台判断）：用户要"取消提醒 / 关掉提醒 / 别提醒了"时，直接告知目前不支持关闭待办提醒；若用户坚持完全不提醒，唯一办法是连同截止时间一起清空（`deadline: {}`，会一并删掉截止时间），须先向用户确认再操作。
+- 用户要求"某时间截止，并提前 X 提醒"时，`deadline` 永远填用户说的**截止时间**，不要填提前后的提醒时刻。当前入参不能直接设置"提前 X"；更新后用返回的 `extra_info` 判断系统提醒时间是否刚好满足 X。
+
+### 示例入参
+
+更新标题、截止时间并设置截止时提醒：
+
+```json
+{
+  "items": [
+    {
+      "todo_id": "td_xxx",
+      "title": "调整后的周会材料",
+      "deadline": {
+        "type": "datetime",
+        "value": "2026-05-13 09:00:00"
+      },
+      "remind_at_deadline": true
+    }
+  ]
+}
+```
+
+清空截止时间、清空分派人：
+
+```json
+{
+  "items": [
+    {
+      "todo_id": "td_xxx",
+      "deadline": {},
+      "followers": []
+    }
+  ]
+}
+```
+
+## 返回
+
+外层为对象，结果在 `items` 数组中，与入参 `items` 一一对应：
+
+| 字段 | 类型 | 语义 |
+|---|---|---|
+| `items` | array | 更新结果数组 |
+
+`items[]` 元素结构：
+
+| 字段 | 类型 | 语义 |
+|---|---|---|
+| `success` | boolean | 是否更新成功 |
+| `todo_id` | string | 待办 ID |
+| `extra_info` | string | 提醒时刻只读信息，可能不提醒 |
+| `errmsg` | string | 失败原因，仅 `success=false` 时存在 |
+
+## 使用规则
+
+- **如果上下文没有对应待办 ID**：**必须**先阅读 `references/todo-list.md`，在待办列表中找到需要修改的待办。
+- **避免冗余更新**：如果用户只是把待办**已经记录过的内容又复述了一遍**（例如标题已经等于用户这次说的内容），这是确认而不是修改，**不要发起 `update`**，直接回复"这条已经记好了"即可。尤其**不要把 `description` 更新成与 `title` 相同的内容**——description 只用于承载标题之外的补充信息，没有新增信息就不要写。
+- **补全信息先查上下文**：用户要求"写清楚点"、补充参与人/时间/链接/单号时，先从当前会话、待办详情和可用的聊天/记忆检索结果中找；能确定就更新，找不到或有歧义时再一次性向用户确认，避免直接让用户重发。
+- **仅改部分字段**：未传的字段保持原值；若要清空 `followers`，传空数组 `[]`；若要清空 `deadline`，传空对象 `{}`。**没有关闭提醒的入参**：`remind_at_deadline=false`/不传只是改成默认提前提醒，不会关闭提醒（详见「修改截止时间与提醒」）
+- **本次更新传了 `remind_at_deadline=true` 或用户提到提醒诉求** 且更新成功时，**必须**在最终回复中附上提醒说明（注意 `remind_at_deadline` 只对 datetime 生效）：
+  - 用户要求"提前 X 提醒"时，核对 `extra_info` 是否为用户要求的提前提醒时间（即截止时间提前 X 后的时刻）；匹配则说明已满足，不匹配或无 `extra_info` 则按固定话术说明：`目前不支持直接创建您需要的提醒时间，已为您设置截止时间为 XX，请到企业微信待办功能中手动修改提醒时间。`（XX 填本次 `deadline.value`）。
+  - 用户要求"截止时/到点提醒"时，只有 `deadline.type=datetime` 才应传 `remind_at_deadline=true`；若 `extra_info` 不等于 `deadline.value` 或缺失，仍需引导到企业微信待办功能中修改提醒时间。
+  - 返回里有 `extra_info`（且非"提前 X 提醒"场景）→ 引用 `extra_info` 里的时刻告诉用户届时会自动提醒。
+  - 返回里没有 `extra_info`（且非"提前 X 提醒"场景）→ 说明返回未确认提醒时间，引导用户到企业微信待办应用中检查/修改提醒时间。
+  - 不要另建定时任务来模拟待办提醒，避免重复提醒。仅改 `deadline` 但未要求提醒时，无需额外提醒说明。

package/dist/src/mcp/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * MCP 模块统一导出
- */
-export { createWeComMcpTool } from "./tool.js";
-export { sendJsonRpc, clearCategoryCache, clearAccountCache, resolveCurrentAccountId, McpRpcError, McpHttpError, type McpToolInfo } from "./transport.js";
-export { cleanSchemaForGemini } from "./schema.js";

package/dist/src/mcp/index.js

@@ -1,10 +0,0 @@
-/**
- * MCP 模块统一导出
- */
-export { createWeComMcpTool } from "./tool.js";
-export { sendJsonRpc, clearCategoryCache, clearAccountCache, resolveCurrentAccountId, McpRpcError, McpHttpError } from "./transport.js";
-export { cleanSchemaForGemini } from "./schema.js";
-// 注意：parseSessionKeyChat 已废弃不再导出。
-//   OpenClaw core 构建 sessionKey 时会把 chatId 小写化，
-//   企业微信接口（如 aibot_send_biz_msg）是大小写敏感的，反解结果不可用。
-//   chatId 请通过 state-manager 的 getSessionChatInfo(sessionKey) 获取。

package/dist/src/mcp/interceptors/biz-error.d.ts

@@ -1,11 +0,0 @@
-/**
- * 业务错误码检查拦截器
- *
- * 检查 tools/call 返回结果中是否包含需要清理缓存的业务错误码。
- * MCP Server 可能在正常的 JSON-RPC 响应中返回业务层错误，
- * 这些错误被包裹在 result.content[].text 中，需要解析后判断。
- *
- * 此拦截器对所有 call 调用生效。
- */
-import type { CallInterceptor } from "./types.js";
-export declare const bizErrorInterceptor: CallInterceptor;

package/dist/src/mcp/interceptors/biz-error.js

@@ -1,69 +0,0 @@
-/**
- * 业务错误码检查拦截器
- *
- * 检查 tools/call 返回结果中是否包含需要清理缓存的业务错误码。
- * MCP Server 可能在正常的 JSON-RPC 响应中返回业务层错误，
- * 这些错误被包裹在 result.content[].text 中，需要解析后判断。
- *
- * 此拦截器对所有 call 调用生效。
- */
-import { clearCategoryCache } from "../transport.js";
-// ============================================================================
-// 常量
-// ============================================================================
-/**
- * 需要触发缓存清理的业务错误码集合
- *
- * 这些错误码出现在 MCP 工具调用返回的 content 文本中（业务层面），
- * 与 JSON-RPC 层面的错误码不同，需要在此处额外检测。
- *
- * - 850001/ 851014: 机器人授权过期/ 重置，需清理缓存以便下次重新拉取配置
- */
-const BIZ_CACHE_CLEAR_ERROR_CODES = new Set([850001, 851014]);
-// ============================================================================
-// 拦截器实现
-// ============================================================================
-export const bizErrorInterceptor = {
-    name: "biz-error",
-    /** 对所有 call 调用生效 */
-    match: () => true,
-    /** 检查返回结果中的业务错误码，必要时清理缓存 */
-    afterCall(ctx, result) {
-        checkBizErrorAndClearCache(result, ctx);
-        // 不修改 result，透传给下一个拦截器
-        return result;
-    },
-};
-// ============================================================================
-// 内部实现
-// ============================================================================
-/**
- * 检查 tools/call 的返回结果中是否包含需要清理缓存的业务错误码
- */
-function checkBizErrorAndClearCache(result, ctx) {
-    if (!result || typeof result !== "object")
-        return;
-    const { content } = result;
-    if (!Array.isArray(content))
-        return;
-    for (const item of content) {
-        if (item.type !== "text" || !item.text)
-            continue;
-        try {
-            const parsed = JSON.parse(item.text);
-            if (typeof parsed.errcode === "number" && BIZ_CACHE_CLEAR_ERROR_CODES.has(parsed.errcode)) {
-                const accountId = ctx.accountId;
-                if (!accountId) {
-                    console.warn(`[mcp] 检测到业务错误码 ${parsed.errcode} (category="${ctx.category}")，但 ctx.accountId 为空，跳过缓存清理`);
-                    return;
-                }
-                console.log(`[mcp] 检测到业务错误码 ${parsed.errcode} (accountId="${accountId}", category="${ctx.category}")，清理缓存`);
-                clearCategoryCache(accountId, ctx.category);
-                return;
-            }
-        }
-        catch {
-            // text 不是 JSON 格式，跳过
-        }
-    }
-}

package/dist/src/mcp/interceptors/doc-auth-error.d.ts

@@ -1,10 +0,0 @@
-/**
- * 文档授权错误拦截器
- *
- * 当 category=doc 的 MCP 调用返回 errcode=851013/851014/851008（文档授权错误）时：
- * 1. 通过 aibot_send_biz_msg 命令向用户发送授权引导卡片
- * 2. 拦截 help_message 内容，不将其传递给 LLM
- * 3. 返回简化响应，告知 LLM 授权卡片已发送、无需再做处理
- */
-import type { CallInterceptor } from "./types.js";
-export declare const docAuthErrorInterceptor: CallInterceptor;

package/dist/src/mcp/interceptors/doc-auth-error.js

@@ -1,171 +0,0 @@
-/**
- * 文档授权错误拦截器
- *
- * 当 category=doc 的 MCP 调用返回 errcode=851013/851014/851008（文档授权错误）时：
- * 1. 通过 aibot_send_biz_msg 命令向用户发送授权引导卡片
- * 2. 拦截 help_message 内容，不将其传递给 LLM
- * 3. 返回简化响应，告知 LLM 授权卡片已发送、无需再做处理
- */
-import { generateReqId } from "@wecom/aibot-node-sdk";
-import { getWeComWebSocket } from "../../state-manager.js";
-import { resolveCurrentAccountId } from "../transport.js";
-import { withTimeout } from "../../timeout.js";
-import { AIBOT_SEND_BIZ_MSG_CMD, BIZ_MSG_SEND_TIMEOUT_MS } from "../../const.js";
-// ============================================================================
-// 常量
-// ============================================================================
-/** 需要拦截的文档授权错误码集合 */
-/* https://doc.weixin.qq.com/sheet/e3_AFcARgbdAFwCNU0pwubawRtGzcd6z?scode=AJEAIQdfAAoEpqtRfRAMEA4QYkACk&tab=BB08J2 */
-const DOC_AUTH_ERROR_CODES = new Set([851013, 851014, 851008]);
-/**
- * 业务消息类型枚举（对应 AiBotBizMsgType）
- * - 1: 文档权限
- */
-const AIBOT_BIZ_MSG_TYPE_DOC_READ_AUTH = 1;
-/**
- * 聊天类型枚举（对应 AiBotBizMsgChatType）
- * - 1: 单聊
- * - 2: 群聊
- */
-const AIBOT_BIZ_MSG_CHAT_TYPE_SINGLE = 1;
-const AIBOT_BIZ_MSG_CHAT_TYPE_GROUP = 2;
-// ============================================================================
-// 拦截器实现
-// ============================================================================
-export const docAuthErrorInterceptor = {
-    name: "doc-auth-error",
-    /** 仅对 doc 品类生效 */
-    match: (ctx) => ctx.category === "doc",
-    /** 检测文档授权错误，发送授权引导卡片并拦截原始响应 */
-    async afterCall(ctx, result) {
-        return interceptDocAuthError(ctx, result);
-    },
-};
-// ============================================================================
-// 内部实现
-// ============================================================================
-/**
- * 从 MCP 返回结果中解析业务 JSON
- */
-function parseBizData(result) {
-    if (!result || typeof result !== "object")
-        return null;
-    const { content } = result;
-    if (!Array.isArray(content))
-        return null;
-    const textItem = content.find((c) => c.type === "text" && typeof c.text === "string");
-    if (!textItem)
-        return null;
-    try {
-        return JSON.parse(textItem.text);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 通过 WSClient 发送 aibot_send_biz_msg 命令
- *
- * 按照 WwOpenWsSendAiBotBizMsgReq proto 定义构造请求体：
- *   - chat_id:   会话标识
- *   - userid:    发送者 userid
- *   - biz_type:  业务消息类型（AiBotBizMsgType）
- *   - chat_type: 聊天类型（AiBotBizMsgChatType，1=单聊，2=群聊）
- */
-async function sendBizMsg(params) {
-    const accountId = params.accountId || resolveCurrentAccountId();
-    const wsClient = getWeComWebSocket(accountId);
-    if (!wsClient) {
-        console.warn(`[mcp] doc-auth-error: WSClient 未连接 (accountId="${accountId}")，无法发送授权卡片`);
-        return;
-    }
-    const reqId = generateReqId("biz_msg");
-    // 构造 WwOpenWsSendAiBotBizMsgReqBody
-    const body = {
-        biz_type: AIBOT_BIZ_MSG_TYPE_DOC_READ_AUTH,
-    };
-    if (params.chatId) {
-        body.chat_id = params.chatId;
-    }
-    if (params.userid) {
-        body.userid = params.userid;
-    }
-    if (params.chatType) {
-        body.chat_type = params.chatType === "group"
-            ? AIBOT_BIZ_MSG_CHAT_TYPE_GROUP
-            : AIBOT_BIZ_MSG_CHAT_TYPE_SINGLE;
-    }
-    console.log(`[mcp] doc-auth-error: 发送 aibot_send_biz_msg, body=${JSON.stringify(body)}`);
-    try {
-        await withTimeout(wsClient.reply({ headers: { req_id: reqId } }, body, AIBOT_SEND_BIZ_MSG_CMD), BIZ_MSG_SEND_TIMEOUT_MS, `aibot_send_biz_msg timed out after ${BIZ_MSG_SEND_TIMEOUT_MS}ms`);
-        console.log(`[mcp] doc-auth-error: 授权卡片发送成功 (chatId="${params.chatId}", userid="${params.userid}", chatType="${params.chatType}")`);
-    }
-    catch (err) {
-        console.error(`[mcp] doc-auth-error: 授权卡片发送失败: ${err instanceof Error ? err.message : JSON.stringify(err)}`);
-    }
-}
-/**
- * 拦截文档授权错误
- *
- * 检测 errcode=851013/851014/851008 时：
- * 1. 通过 aibot_send_biz_msg 发送授权引导卡片（携带 chat_id、userid、chat_type）
- * 2. 返回简化响应，告知 LLM 授权卡片已直接发送给用户
- *
- * 数据来源链路（chatId 全程保留原始大小写，单一事实来源）：
- *
- *   aibot_msg_callback.body.chatid  (原始大小写)
- *     ↓
- *   monitor.ts:processWeComMessageNow
- *     → setSessionChatInfo(route.sessionKey, { chatId, chatType })  ← 以 sessionKey 为键
- *     ↓
- *   OpenClaw core 调用工具工厂，传入 ctx.sessionKey
- *     ↓
- *   index.ts:registerTool
- *     → getSessionChatInfo(ctx.sessionKey) 精确取回 { chatId, chatType }
- *     → createWeComMcpTool({ chatId, chatType })
- *     ↓
- *   tool.ts:handleCall 将其注入 CallContext
- *     ↓
- *   本拦截器直接使用 ctx.chatId / ctx.chatType （无需反解 sessionKey、无需兜底）
- *
- * ⚠️ 切勿使用 parseSessionKeyChat(ctx.sessionKey) 反向解析 chatId：
- *    OpenClaw core 构建 sessionKey 时会将 peer.id 强制小写化，
- *    企业微信 aibot_send_biz_msg 的 chat_id 是大小写敏感的，
- *    小写后会收到 errcode=93006 (invalid chatid)。
- */
-async function interceptDocAuthError(ctx, result) {
-    const bizData = parseBizData(result);
-    if (!bizData)
-        return result;
-    const errcode = bizData.errcode;
-    if (typeof errcode !== "number" || !DOC_AUTH_ERROR_CODES.has(errcode)) {
-        return result;
-    }
-    console.log(`[mcp] doc-auth-error: 检测到文档授权错误 errcode=${errcode}, ` +
-        `method=${ctx.method}, category=${ctx.category}`);
-    // chatId / chatType 已由 monitor.ts → state-manager → index.ts 透传到 ctx，
-    // 这里直接使用即可，原始大小写保留不变。
-    const { requesterUserId: userid, chatId, chatType, accountId } = ctx;
-    if (!chatId || !chatType) {
-        console.warn(`[mcp] doc-auth-error: ctx 缺少 chatId/chatType（可能会话信息未记录），` +
-            `userid="${userid}", chatId="${chatId}", chatType="${chatType}"，跳过发送授权卡片`);
-    }
-    else {
-        console.log(`[mcp] doc-auth-error: 发送授权卡片参数: userid="${userid}", chatId="${chatId}", chatType="${chatType}"`);
-        await sendBizMsg({ chatId, userid, chatType, accountId });
-    }
-    // 构造简化响应：不将 help_message 传递给 LLM，
-    // 告知 LLM 授权提示已直接发送给用户，无需再做任何操作
-    const simplifiedResult = {
-        errcode,
-        errmsg: bizData.errmsg ?? "authorization error",
-        _biz_msg_sent: true,
-        _user_hint: "文档授权提示卡片已直接发送给用户，无需再向用户转述任何授权相关的信息。请告知用户：已发送授权引导，请按照提示完成授权后重试。",
-    };
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify(simplifiedResult),
-            }],
-    };
-}

package/dist/src/mcp/interceptors/index.d.ts

@@ -1,35 +0,0 @@
-/**
- * MCP call 拦截器注册表与调度入口
- *
- * 所有 call 拦截器在此注册，按注册顺序执行。
- * 新增拦截器只需：
- *   1. 在 interceptors/ 目录下新建文件，实现 CallInterceptor 接口
- *   2. 在下方 interceptors 数组中注册
- *
- * tool.ts 的 handleCall 无需任何改动。
- */
-import type { CallContext } from "./types.js";
-import type { SendJsonRpcOptions } from "../transport.js";
-export type { CallContext, CallInterceptor, BeforeCallOptions } from "./types.js";
-/** resolveBeforeCall 的返回值 */
-export interface ResolvedBeforeCall {
-    /** 合并后的 sendJsonRpc 选项（如超时时间） */
-    options?: SendJsonRpcOptions;
-    /** 替换后的 args（如从本地文件读取的请求体） */
-    args?: Record<string, unknown>;
-}
-/**
- * 收集匹配的 beforeCall 配置，合并后返回
- *
- * 合并策略：
- * - timeoutMs: 取所有拦截器返回值中的最大值
- * - args: 后注册的拦截器覆盖前者（一般同一调用只有一个拦截器会返回 args）
- */
-export declare function resolveBeforeCall(ctx: CallContext): Promise<ResolvedBeforeCall>;
-/**
- * 依次执行匹配的 afterCall 拦截器，管道式传递 result
- *
- * 前一个拦截器的返回值作为下一个拦截器的输入。
- * 拦截器若不需要修改 result，应原样返回。
- */
-export declare function runAfterCall(ctx: CallContext, result: unknown): Promise<unknown>;

package/dist/src/mcp/interceptors/index.js

@@ -1,70 +0,0 @@
-/**
- * MCP call 拦截器注册表与调度入口
- *
- * 所有 call 拦截器在此注册，按注册顺序执行。
- * 新增拦截器只需：
- *   1. 在 interceptors/ 目录下新建文件，实现 CallInterceptor 接口
- *   2. 在下方 interceptors 数组中注册
- *
- * tool.ts 的 handleCall 无需任何改动。
- */
-import { bizErrorInterceptor } from "./biz-error.js";
-import { docAuthErrorInterceptor } from "./doc-auth-error.js";
-import { mediaInterceptor } from "./msg-media.js";
-import { smartpageCreateInterceptor } from "./smartpage-create.js";
-import { smartpageExportInterceptor } from "./smartpage-export.js";
-import { smartsheetUploadInterceptor } from "./smartsheet-upload.js";
-// ============================================================================
-// 拦截器注册表（按注册顺序执行）
-// ============================================================================
-const interceptors = [
-    bizErrorInterceptor, // 业务错误码检查（所有 call 生效）
-    docAuthErrorInterceptor, // 文档授权错误拦截（category=doc, errcode=851013/851014/851008）
-    mediaInterceptor, // get_msg_media base64 拦截
-    smartpageCreateInterceptor, // smartpage_create 本地文件读取
-    smartpageExportInterceptor, // smartpage_get_export_result content → 本地文件
-    smartsheetUploadInterceptor, // smartsheet_add_records / update_records 本地文件上传
-];
-/**
- * 收集匹配的 beforeCall 配置，合并后返回
- *
- * 合并策略：
- * - timeoutMs: 取所有拦截器返回值中的最大值
- * - args: 后注册的拦截器覆盖前者（一般同一调用只有一个拦截器会返回 args）
- */
-export async function resolveBeforeCall(ctx) {
-    let mergedTimeoutMs;
-    let mergedArgs;
-    for (const interceptor of interceptors) {
-        if (!interceptor.match(ctx) || !interceptor.beforeCall)
-            continue;
-        const opts = await interceptor.beforeCall(ctx);
-        if (opts?.timeoutMs !== undefined) {
-            mergedTimeoutMs = mergedTimeoutMs === undefined
-                ? opts.timeoutMs
-                : Math.max(mergedTimeoutMs, opts.timeoutMs);
-        }
-        if (opts?.args !== undefined) {
-            mergedArgs = opts.args;
-        }
-    }
-    return {
-        options: mergedTimeoutMs !== undefined ? { timeoutMs: mergedTimeoutMs } : undefined,
-        args: mergedArgs,
-    };
-}
-/**
- * 依次执行匹配的 afterCall 拦截器，管道式传递 result
- *
- * 前一个拦截器的返回值作为下一个拦截器的输入。
- * 拦截器若不需要修改 result，应原样返回。
- */
-export async function runAfterCall(ctx, result) {
-    let current = result;
-    for (const interceptor of interceptors) {
-        if (!interceptor.match(ctx) || !interceptor.afterCall)
-            continue;
-        current = await interceptor.afterCall(ctx, current);
-    }
-    return current;
-}

package/dist/src/mcp/interceptors/msg-media.d.ts

@@ -1,11 +0,0 @@
-/**
- * get_msg_media 响应拦截器
- *
- * 核心逻辑：
- * 1. beforeCall: 设置延长的超时时间（120s），因为 base64 数据可达 ~27MB
- * 2. afterCall: 从 MCP result 的 content[].text 中提取 base64_data，
- *    解码为 Buffer 并通过 saveMediaBuffer 保存到本地媒体目录，
- *    替换响应中的 base64_data 为 local_path，避免大模型被 base64 数据消耗 token
- */
-import type { CallInterceptor } from "./types.js";
-export declare const mediaInterceptor: CallInterceptor;

package/dist/src/mcp/interceptors/msg-media.js

@@ -1,133 +0,0 @@
-/**
- * get_msg_media 响应拦截器
- *
- * 核心逻辑：
- * 1. beforeCall: 设置延长的超时时间（120s），因为 base64 数据可达 ~27MB
- * 2. afterCall: 从 MCP result 的 content[].text 中提取 base64_data，
- *    解码为 Buffer 并通过 saveMediaBuffer 保存到本地媒体目录，
- *    替换响应中的 base64_data 为 local_path，避免大模型被 base64 数据消耗 token
- */
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-import { MEDIA_DOWNLOAD_TIMEOUT_MS } from "../transport.js";
-import { getWeComRuntime } from "../../runtime.js";
-import { detectMime } from "../../openclaw-compat.js";
-// ============================================================================
-// 拦截器实现
-// ============================================================================
-export const mediaInterceptor = {
-    name: "media",
-    /** 仅对 get_msg_media 方法生效 */
-    match: (ctx) => ctx.method === "get_msg_media",
-    /** 设置延长的超时时间 */
-    beforeCall() {
-        return { timeoutMs: MEDIA_DOWNLOAD_TIMEOUT_MS };
-    },
-    /** 拦截响应：base64 → 本地文件 */
-    async afterCall(ctx, result) {
-        return interceptMediaResponse(result);
-    },
-};
-// ============================================================================
-// 内部实现
-// ============================================================================
-/**
- * 拦截 get_msg_media 的 MCP 响应
- *
- * 1. 从 MCP result 的 content[].text 中提取业务 JSON
- * 2. 提取 media_item.base64_data，解码为 Buffer
- * 3. 通过 openclaw SDK 的 saveMediaBuffer 保存到本地媒体目录
- * 4. 替换响应：移除 base64_data，加入 local_path
- *
- * 这样大模型只看到轻量的文件路径信息，不会被 base64 数据消耗 token。
- */
-async function interceptMediaResponse(result) {
-    const t0 = performance.now();
-    // 1. 提取 MCP result 中的 content 数组
-    const content = result?.content;
-    if (!Array.isArray(content))
-        return result;
-    const textItem = content.find((c) => c.type === "text" && typeof c.text === "string");
-    if (!textItem)
-        return result;
-    // 2. 解析业务 JSON
-    let bizData;
-    try {
-        bizData = JSON.parse(textItem.text);
-    }
-    catch {
-        // 非 JSON 格式，原样返回
-        return result;
-    }
-    // 3. 校验业务响应：errcode !== 0 或无 media_item 时原样返回
-    if (bizData.errcode !== 0)
-        return result;
-    const mediaItem = bizData.media_item;
-    if (!mediaItem || typeof mediaItem.base64_data !== "string")
-        return result;
-    const base64Data = mediaItem.base64_data;
-    const mediaName = mediaItem.name;
-    const mediaType = mediaItem.type;
-    const mediaId = mediaItem.media_id;
-    const tParsed = performance.now();
-    // 4. 解码 base64 → Buffer
-    const buffer = Buffer.from(base64Data, "base64");
-    const tDecoded = performance.now();
-    // 5. 检测 contentType，并通过 saveMediaBuffer 保存到本地媒体目录
-    const contentType = await detectMime({ buffer, filePath: mediaName }) ?? "application/octet-stream";
-    const tMimeDetected = performance.now();
-    // 企业微信聊天记录附件可达 20MB（文件消息上限），
-    // 而 saveMediaBuffer 默认 maxBytes 为 5MB（针对 outbound 场景），
-    // 此处显式放宽到 20MB 以支持大文件下载。
-    const INBOUND_MAX_BYTES = 20 * 1024 * 1024; // 20MB
-    const core = getWeComRuntime();
-    const saved = await core.channel.media.saveMediaBuffer(buffer, contentType, "inbound", INBOUND_MAX_BYTES, // maxBytes: 放宽到 20MB，匹配企业微信文件消息上限
-    mediaName);
-    // 5.1 补偿：核心库 EXT_BY_MIME 可能缺少某些格式映射（如 audio/amr），
-    //     导致保存的文件没有后缀。此处检测并修复。
-    const MIME_EXT_PATCH = {
-        "audio/amr": ".amr",
-    };
-    const patchExt = MIME_EXT_PATCH[contentType];
-    if (patchExt && !path.extname(saved.path)) {
-        const newPath = saved.path + patchExt;
-        try {
-            await fs.rename(saved.path, newPath);
-            saved.path = newPath;
-        }
-        catch {
-            // rename 失败不影响主流程，文件仍可用
-        }
-    }
-    const tSaved = performance.now();
-    // 6. 构造精简响应，移除 base64_data，加入本地路径
-    const newBizData = {
-        errcode: 0,
-        errmsg: "ok",
-        media_item: {
-            media_id: mediaId,
-            name: mediaName ?? saved.path.split("/").pop(),
-            type: mediaType,
-            local_path: saved.path,
-            size: buffer.length,
-            content_type: saved.contentType,
-        },
-    };
-    const tEnd = performance.now();
-    // 耗时日志：各环节耗时（ms）
-    console.log(`[mcp] get_msg_media 拦截成功: media_id=${mediaId ?? "unknown"}, ` +
-        `type=${mediaType ?? "unknown"}, size=${buffer.length}, saved=${saved.path}\n` +
-        `  ⏱ 耗时明细 (总 ${(tEnd - t0).toFixed(1)}ms):\n` +
-        `    解析响应 JSON:   ${(tParsed - t0).toFixed(1)}ms\n` +
-        `    base64 解码:     ${(tDecoded - tParsed).toFixed(1)}ms  (${(base64Data.length / 1024).toFixed(0)}KB base64 → ${(buffer.length / 1024).toFixed(0)}KB buffer)\n` +
-        `    MIME 检测:       ${(tMimeDetected - tDecoded).toFixed(1)}ms  (${contentType})\n` +
-        `    saveMediaBuffer: ${(tSaved - tMimeDetected).toFixed(1)}ms\n` +
-        `    构造响应:        ${(tEnd - tSaved).toFixed(1)}ms`);
-    // 7. 返回修改后的 MCP result 结构
-    return {
-        content: [{
-                type: "text",
-                text: JSON.stringify(newBizData),
-            }],
-    };
-}