@wecom/wecom-openclaw-plugin 2026.3.25 → 2026.3.30-beta.0

package/dist/src/const.d.ts

@@ -70,3 +70,5 @@ export declare const EVENT_ENTER_CHECK_UPDATE = "event.enter_check_update";
 export declare const CMD_ENTER_EVENT_REPLY = "ww_ai_robot_enter_event";
 /** WSClient scene 参数：企微 OpenClaw 场景 */
 export declare const SCENE_WECOM_OPENCLAW = 1;
+/** 合法的模板卡片 card_type 列表 */
+export declare const VALID_CARD_TYPES: string[];

package/dist/src/interface.d.ts

@@ -33,6 +33,22 @@ export interface MessageState {
     deliverCalled?: boolean;
     /** 流式回复是否已过期（errcode 846608，>6分钟），需降级为主动发送 */
     streamExpired?: boolean;
+    /** 是否已成功发送过模板卡片 */
+    hasTemplateCard?: boolean;
+}
+/** 从文本中提取的模板卡片 */
+export interface ExtractedTemplateCard {
+    /** 原始 JSON 对象（已验证 card_type 合法） */
+    cardJson: Record<string, unknown>;
+    /** card_type 值 */
+    cardType: string;
+}
+/** extractTemplateCards 返回值 */
+export interface TemplateCardExtractionResult {
+    /** 提取到的合法模板卡片列表 */
+    cards: ExtractedTemplateCard[];
+    /** 移除卡片代码块后的剩余文本 */
+    remainingText: string;
 }
 /**
  * WebSocket 请求消息基础格式
@@ -68,20 +84,20 @@ export interface WeComSubscribeRequest extends WeComRequest {
  * 企业微信推送消息格式
  */
 export interface WeComCallbackMessage {
-    cmd: WeComCommand.AIBOT_CALLBACK;
+    cmd: WeComCommand.AIBOT_CALLBACK | "aibot_event_callback";
     headers: {
         req_id: string;
     };
     body: {
         msgid: string;
         aibotid: string;
-        chatid: string;
+        chatid?: string;
         chattype: "single" | "group";
         from: {
             userid: string;
         };
         response_url: string;
-        msgtype: "text" | "image" | "voice" | "video" | "file" | "stream" | "mixed";
+        msgtype: "text" | "image" | "voice" | "video" | "file" | "stream" | "mixed" | "event";
         text?: {
             content: string;
         };
@@ -123,6 +139,22 @@ export interface WeComCallbackMessage {
         stream?: {
             id: string;
         };
+        event?: {
+            eventtype: string;
+            template_card_event?: {
+                card_type?: string;
+                event_key?: string;
+                task_id?: string;
+                selected_items?: {
+                    selected_item?: Array<{
+                        question_key?: string;
+                        option_ids?: {
+                            option_id?: string[];
+                        };
+                    }>;
+                };
+            };
+        };
     };
 }
 /**

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

@@ -0,0 +1,11 @@
+/**
+ * 业务错误码检查拦截器
+ *
+ * 检查 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/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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/msg-media.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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/smartpage-create.d.ts

@@ -0,0 +1,30 @@
+/**
+ * smartpage_create 请求拦截器
+ *
+ * 核心逻辑：
+ * smartpage_create 的 pages 数组中，每个 page 可能包含 page_filepath 字段
+ * （指向本地 markdown 文件），用于避免在命令行传递大段文本内容。
+ * 本拦截器在 beforeCall 阶段遍历 pages 数组，逐个读取 page_filepath
+ * 指向的本地文件内容，填入 page_content 字段，并移除 page_filepath。
+ *
+ * 入参约定：
+ *   wecom_mcp call doc smartpage_create '{
+ *     "title": "主页标题",
+ *     "pages": [
+ *       {"page_title": "页面1", "page_filepath": "/tmp/page1.md", "content_type": "markdown"},
+ *       {"page_title": "页面2", "page_filepath": "/tmp/page2.md", "content_type": "markdown"}
+ *     ]
+ *   }'
+ *
+ * 拦截器行为：
+ *   1. 检测 args.pages 数组
+ *   2. 校验文件大小：单文件不超过 10MB，所有文件总计不超过 20MB
+ *   3. 遍历每个 page，若存在 page_filepath 则读取本地文件内容
+ *   4. 将文件内容填入 page_content 字段，移除 page_filepath
+ *   5. 返回修改后的完整 args
+ *
+ * 传给 MCP Server 的格式：
+ *   { "title": "...", "pages": [{"page_title": "...", "page_content": "...", "content_type": "..."}] }
+ */
+import type { CallInterceptor } from "./types.js";
+export declare const smartpageCreateInterceptor: CallInterceptor;

package/dist/src/mcp/interceptors/smartpage-export.d.ts

@@ -0,0 +1,17 @@
+/**
+ * smartpage_get_export_result 响应拦截器
+ *
+ * 核心逻辑：
+ * MCP Server 返回的 smartpage_get_export_result 响应中，当 task_done=true 时
+ * 会包含 content 字段（markdown 文本内容）。该内容可能很大，直接返回给 LLM
+ * 会消耗大量 token。
+ *
+ * 本拦截器在 afterCall 阶段：
+ * 1. 检测 task_done=true 且存在 content 字段
+ * 2. 将 content 保存到本地文件（使用与 msg-media 一致的媒体目录）
+ * 3. 用 content_path（文件路径）替换 content 字段
+ *
+ * 这样 LLM 只看到轻量的文件路径信息，Skill 可通过文件路径读取完整内容。
+ */
+import type { CallInterceptor } from "./types.js";
+export declare const smartpageExportInterceptor: CallInterceptor;

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

@@ -0,0 +1,56 @@
+/**
+ * MCP call 拦截器类型定义
+ *
+ * 拦截器用于在 tools/call 调用前后注入特殊逻辑，
+ * 如修改超时配置、变换响应结果等，避免在 tool.ts 中堆积 if/else。
+ */
+import type { SendJsonRpcOptions } from "../transport.js";
+/** MCP call 调用的上下文 */
+export interface CallContext {
+    /** MCP 品类，对应 mcpConfig 中的 key，如 doc、contact */
+    category: string;
+    /** 调用的 MCP 方法名 */
+    method: string;
+    /** 调用 MCP 方法的参数 */
+    args: Record<string, unknown>;
+}
+/**
+ * beforeCall 返回的选项
+ *
+ * 扩展 SendJsonRpcOptions，允许拦截器在调用前替换 args（如从本地文件读取请求体）。
+ */
+export interface BeforeCallOptions extends SendJsonRpcOptions {
+    /** 替换后的 args（可选，不返回则使用原 args） */
+    args?: Record<string, unknown>;
+}
+/**
+ * call 拦截器接口
+ *
+ * 每个拦截器通过 match 判断是否对当前调用生效，
+ * 生效时可在调用前（beforeCall）和调用后（afterCall）注入逻辑。
+ */
+export interface CallInterceptor {
+    /** 拦截器名称（用于日志） */
+    name: string;
+    /**
+     * 判断是否对当前调用生效
+     *
+     * 返回 true 时才会执行 beforeCall / afterCall
+     */
+    match(ctx: CallContext): boolean;
+    /**
+     * 在 sendJsonRpc 调用前修改请求选项和参数（可选）
+     *
+     * 如 get_msg_media 需要延长超时时间，
+     * 如 smartpage_create 需要从本地文件读取请求体替换 args。
+     * 返回的选项会与其他拦截器的结果合并（timeoutMs 取最大值，args 后者覆盖前者）。
+     */
+    beforeCall?(ctx: CallContext): BeforeCallOptions | Promise<BeforeCallOptions> | undefined;
+    /**
+     * 在 sendJsonRpc 返回后处理/变换结果（可选）
+     *
+     * 多个拦截器的 afterCall 按注册顺序管道式执行，
+     * 前一个的返回值作为下一个的输入。
+     */
+    afterCall?(ctx: CallContext, result: unknown): Promise<unknown> | unknown;
+}

package/dist/src/message-parser.d.ts

@@ -9,6 +9,7 @@ export interface MessageBody {
     chatid?: string;
     chattype: "single" | "group";
     from: {
+        corpid?: string;
         userid: string;
     };
     response_url?: string;
@@ -56,6 +57,22 @@ export interface MessageBody {
             aeskey?: string;
         };
     };
+    event?: {
+        eventtype?: string;
+        template_card_event?: {
+            card_type?: string;
+            event_key?: string;
+            task_id?: string;
+            selected_items?: {
+                selected_item?: Array<{
+                    question_key?: string;
+                    option_ids?: {
+                        option_id?: string[];
+                    };
+                }>;
+            };
+        };
+    };
 }
 export interface ParsedMessageContent {
     textParts: string[];
@@ -66,7 +83,7 @@ export interface ParsedMessageContent {
     quoteContent: string | undefined;
 }
 /**
- * 解析消息内容（支持单条消息、图文混排和引用消息）
+ * 解析消息内容（支持单条消息、图文混排、事件回调和引用消息）
  * @returns 提取的文本数组、图片URL数组和引用消息内容
  */
 export declare function parseMessageContent(body: MessageBody): ParsedMessageContent;

package/dist/src/template-card-parser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 模板卡片解析器
+ *
+ * 从 LLM 回复文本中提取 markdown JSON 代码块，验证其是否为合法的企业微信模板卡片，
+ * 返回提取到的卡片列表和剩余文本。
+ *
+ * 同时提供 maskTemplateCardBlocks 函数，用于在流式中间帧中隐藏正在构建的卡片代码块，
+ * 避免 JSON 源码暴露给终端用户。
+ */
+import type { TemplateCardExtractionResult } from "./interface.js";
+/**
+ * 从文本中提取模板卡片 JSON 代码块
+ *
+ * 匹配规则：
+ * 1. 匹配所有 ```json ... ``` 或 ``` ... ``` 格式的代码块
+ * 2. 尝试 JSON.parse 解析代码块内容
+ * 3. 检查解析结果中是否包含合法的 card_type 字段
+ * 4. 合法的卡片从原文中移除，不合法的保留
+ *
+ * @param text - LLM 回复的完整文本
+ * @returns 提取结果，包含卡片列表和剩余文本
+ */
+export declare function extractTemplateCards(text: string, log?: (...args: any[]) => void): TemplateCardExtractionResult;
+/**
+ * 遮罩文本中的模板卡片代码块（用于流式中间帧展示）
+ *
+ * 在 LLM 流式输出过程中，累积文本可能包含：
+ * 1. 已闭合的模板卡片 JSON 代码块 → 替换为友好提示文本
+ * 2. 正在构建中的未闭合代码块 → 截断隐藏，避免 JSON 源码暴露
+ *
+ * 此函数仅做文本替换，不做 JSON 解析验证（中间帧性能优先）。
+ * 只要代码块内容中出现 "card_type" 关键词就认为是模板卡片并遮罩。
+ *
+ * @param text - 当前累积文本
+ * @returns 遮罩后的展示文本
+ */
+export declare function maskTemplateCardBlocks(text: string, log?: (...args: any[]) => void): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wecom/wecom-openclaw-plugin",
-  "version": "2026.3.25",
+  "version": "2026.3.30-beta.0",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/skills/wecom-doc-manager/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wecom-doc-manager
-description: 企业微信文档管理技能。提供文档的创建、读取和编辑能力，支持通过 docid 或文档 URL 操作企业微信文档（doc_type=3）和智能表格（doc_type=10）。适用场景：(1) 以 Markdown 格式导出获取文档完整内容（异步轮询） (2) 新建文档或智能表格 (3) 用 Markdown 格式覆写文档内容。当用户需要查看文档内容、创建新文档、编辑文档正文时触发此 Skill。
+description: 企业微信文档管理技能。提供文档和智能主页的创建、读取和编辑能力。支持通过 docid 或文档 URL 操作企业微信文档（doc_type=3）和智能表格（doc_type=10），以及创建智能主页和导出其内容。适用场景：(1) 以 Markdown 格式导出获取文档完整内容（异步轮询） (2) 新建文档或智能表格 (3) 用 Markdown 格式覆写文档内容 (4) 将本地 Markdown 文件创建为智能主页 (5) 异步导出智能主页内容为 Markdown 文件。当用户需要查看文档内容、创建新文档、编辑文档正文、创建智能主页、或获取智能主页内容时触发此 Skill。
 ---
 
 # 企业微信文档管理
@@ -9,11 +9,27 @@ description: 企业微信文档管理技能。提供文档的创建、读取和
 
 > ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
 
-管理企业微信文档的创建、读取和编辑。所有接口支持通过 `docid` 或 `url` 二选一定位文档。
+管理企业微信文档和智能主页的创建、读取和编辑。文档接口支持通过 `docid` 或 `url` 二选一定位文档。
+
+## URL 品类识别与接口路由
+
+企业微信文档有三种品类，**URL 格式不同，读取内容所用的接口也不同**，切勿混用：
+
+| URL 模式 | 品类 | 读取内容接口 |
+|---|---|---|
+| `https://doc.weixin.qq.com/doc/*` | **文档**（doc_type=3） | `get_doc_content` |
+| `https://doc.weixin.qq.com/smartsheet/*` | **智能表格**（doc_type=10） | `get_doc_content` |
+| `https://doc.weixin.qq.com/smartpage/*` | **智能主页** | `smartpage_export_task` → `smartpage_get_export_result` |
+
+**判断规则**：
+- URL 路径以 `/doc/*` 开头 → 文档 → 用 `get_doc_content`
+- URL 路径以 `/smartsheet/*` 开头 → 智能表格 → 用 `get_doc_content`
+- URL 路径以 `/smartpage/*` 开头 → 智能主页 → 用 `smartpage_export_task`
+
 
 ## 调用方式
 
-通过 `wecom_mcp` tool 调用，品类为 `doc`：
+通过 `wecom_mcp` tool 调用，子工具名为 `doc`：
 
 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc <tool_name> '<json_params>'` 调用指定技能
 
@@ -28,6 +44,22 @@ description: 企业微信文档管理技能。提供文档的创建、读取和
 
 当 `errcode` 不为 `0` 时，说明接口调用失败，可重试 1 次；若仍失败，将 `errcode` 和 `errmsg` 展示给用户。
 
+### 特殊错误码
+
+| errcode | errmsg | 含义 | 处理方式 |
+|---------|--------|------|----------|
+| `851002` | `incompatible doc type` | 文档品类与所调用的接口不匹配 | 换用另一种导出方式重试：若当前使用 `get_doc_content` 则改用 `smartpage_export_task`，若当前使用 `smartpage_export_task` 则改用 `get_doc_content` |
+
+## 文档
+
+适用品类：文档（doc_type=3）和智能表格（doc_type=10）
+适用 URL：`/doc/*`、`/smartsheet/*`
+
+适用场景：
+1. 以 Markdown 格式导出获取文档完整内容（异步轮询）
+2. 新建文档（doc_type=3）或智能表格（doc_type=10）
+3. 用 Markdown 格式覆写文档内容
+
 ### get_doc_content
 
 获取文档完整内容数据，只能以 Markdown 格式返回。采用**异步轮询机制**：首次调用无需传 `task_id`，接口返回 `task_id`；若 `task_done` 为 false，需携带该 `task_id` 再次调用，直到 `task_done` 为 true 时返回完整内容。
@@ -57,8 +89,55 @@ description: 企业微信文档管理技能。提供文档的创建、读取和
 
 参见 [API 详情](references/api-edit-doc-content.md)。
 
+## 智能主页
+
+适用品类：智能主页
+适用 URL：`/smartpage/*`
+
+适用场景：
+1. 将本地 Markdown 文件创建为智能主页
+2. 异步导出智能主页内容为 Markdown 文件
+
+### smartpage_create
+
+创建智能主页，支持传入标题和多个子页面。每个子页面可指定标题、内容类型和本地文件路径。响应透传 mcp 回包，返回 docid 和 url。
+
+- 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartpage_create '{"title": "项目概览", "pages": [{"page_title": "需求文档", "content_type": 1, "page_filepath": "/path/to/requirements.md"}]}'`
+
+**注意**：
+- `content_type` **必须与文件实际内容匹配**：`.md` 文件或包含 Markdown 语法的内容必须传 `1`（Markdown），仅纯文本才传 `0`。绝大多数场景应传 `1`
+- docid 仅在创建时返回，需妥善保存
+- 每个子页面的 Markdown 文件大小不得超过 **10MB**，超过会导致创建失败。如果文件过大，需先拆分为多个子页面再创建
+
+参见 [API 详情](references/api-smartpage-create.md)。
+
+### smartpage_export_task
+
+发起智能主页内容导出任务（异步）。传入 docid 和 content_type，返回 task_id。这是异步导出的第一步，需配合 `smartpage_get_export_result` 轮询获取导出结果。
+
+- 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartpage_export_task '{"docid": "DOCID", "content_type": 1}'`
+
+参见 [API 详情](references/api-smartpage-export-task.md)。
+
+### smartpage_get_export_result
+
+查询智能主页导出任务进度。传入 task_id 进行轮询，当 `task_done` 为 `true` 时返回 `content_filepath`（导出内容的本地文件路径）。
+
+- 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartpage_get_export_result '{"task_id": "TASK_ID"}'`
+
+当 `task_done` 为 `true` 时，使用 Read 工具读取 `content_filepath` 指向的文件即可获取导出的 Markdown 内容。
+
+参见 [API 详情](references/api-smartpage-get-export-result.md)。
+
 ## 典型工作流
 
-1. **读取文档** → 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc get_doc_content '{"docid": "DOCID", "type": 2}'`，若 `task_done` 为 false 则携带 `task_id` 继续轮询
+> **关键提示**：读取内容前先看 URL 判断品类。`/doc/` 或 `/smartsheet/` → `get_doc_content`；`/smartpage/` → `smartpage_export_task`。
+
+1. **读取文档/智能表格内容**（URL 含 `/doc/` 或 `/smartsheet/`） → 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc get_doc_content '{"docid": "DOCID", "type": 2}'`，若 `task_done` 为 false 则携带 `task_id` 继续轮询
 2. **创建新文档** → 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc create_doc '{"doc_type": 3, "doc_name": "文档名"}'`，保存返回的 docid
 3. **编辑文档** → 先 get_doc_content 了解当前内容，再 edit_doc_content 覆写
+4. **创建智能主页** → 使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartpage_create '{"title": "标题", "pages": [{"page_title": "子页面", "content_type": 1, "page_filepath": "/path/to/file.md"}]}'`，保存返回的 docid
+5. **获取智能主页内容**（URL 含 `/smartpage/`，异步两步）：
+   - **第一步**：使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartpage_export_task '{"docid": "DOCID", "content_type": 1}'`，获取 `task_id`
+   - **第二步**：使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartpage_get_export_result '{"task_id": "TASK_ID"}'`，若 `task_done` 为 `false` 则继续轮询，直到 `task_done` 为 `true`
+   - **第三步**：使用 Read 工具读取 `content_filepath` 指向的本地文件，获取 Markdown 内容

package/skills/wecom-doc-manager/references/api-smartpage-create.md

@@ -0,0 +1,108 @@
+# smartpage_create API
+
+创建智能主页。支持传入多个子页面，每个子页面可指定标题、内容类型和文件路径。创建成功后返回文档访问链接和 docid。
+
+## 技能定义
+
+```json
+{
+    "name": "smartpage_create",
+    "description": "创建智能主页。支持传入标题和多个子页面配置，每个子页面可指定标题、内容类型（Text/Markdown）和本地文件路径。创建成功后返回 docid 和 url（docid 仅在创建时返回，需妥善保存）。",
+    "inputSchema": {
+        "properties": {
+            "title": {
+                "description": "智能主页标题",
+                "title": "Title",
+                "type": "string"
+            },
+            "pages": {
+                "description": "子页面列表",
+                "title": "Pages",
+                "type": "array",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "page_title": {
+                            "description": "子页面标题",
+                            "title": "Page Title",
+                            "type": "string"
+                        },
+                        "content_type": {
+                            "description": "内容类型。1: Markdown（包含Markdown语法的内容），0: Text（纯文本，不含任何Markdown语法）",
+                            "enum": [0, 1],
+                            "default": 1,
+                            "title": "Content Type",
+                            "type": "integer"
+                        },
+                        "page_filepath": {
+                            "description": "子页面内容对应的本地文件路径",
+                            "title": "Page Filepath",
+                            "type": "string"
+                        }
+                    }
+                }
+            }
+        },
+        "required": ["pages"],
+        "title": "smartpage_createArguments",
+        "type": "object"
+    }
+}
+```
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| title | string | 否 | 智能主页标题 |
+| pages | array | 是 | 子页面列表 |
+| pages[].page_title | string | 否 | 子页面标题 |
+| pages[].content_type | integer | 否 | 内容类型：1-Markdown，0-Text（纯文本）。**默认应传 1**，仅纯文本内容才传 0 |
+| pages[].page_filepath | string | 否 | 子页面内容对应的本地文件路径 |
+
+## ContentType 枚举
+
+| 值 | 含义 | 适用场景 |
+|---|---|---|
+| 1 | Markdown | 文件内容包含 Markdown 语法（标题、列表、链接、代码块等） |
+| 0 | Text（纯文本） | 文件内容为纯文本，不含任何 Markdown 语法 |
+
+
+## 请求示例
+
+```json
+{
+    "title": "项目概览",
+    "pages": [
+        {
+            "page_title": "需求文档",
+            "content_type": 1,
+            "page_filepath": "/path/to/requirements.md"
+        },
+        {
+            "page_title": "设计说明",
+            "content_type": 1,
+            "page_filepath": "/path/to/design.md"
+        }
+    ]
+}
+```
+
+## 响应示例
+
+```json
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "docid": "DOCID",
+    "url": "https://doc.weixin.qq.com/smartpage/a1_xxxxxx"
+}
+```
+
+## 注意事项
+
+- 响应透传 mcp 回包
+- `docid` 仅在创建时返回，后续无法再获取，务必保存
+- `page_filepath` 指向本地文件，需确保文件存在且可读
+- **`content_type` 必须与文件实际内容格式匹配**：`.md` 文件或包含 Markdown 语法的内容必须传 `1`，不要传 `0`
+- 每个子页面的 Markdown 文件大小不得超过 **10MB**，超过会导致创建失败；如果文件过大，需先拆分为多个子页面

package/skills/wecom-doc-manager/references/api-smartpage-export-task.md

@@ -0,0 +1,62 @@
+# smartpage_export_task API
+
+发起智能主页内容导出任务。该接口为异步操作的第一步，调用后返回 `task_id`，需配合 `smartpage_get_export_result` 轮询获取导出结果。
+
+## 技能定义
+
+```json
+{
+    "name": "smartpage_export_task",
+    "description": "发起智能主页内容导出任务（异步）。传入 docid 和 content_type，返回 task_id。需配合 smartpage_get_export_result 轮询查询导出进度，直到任务完成后获取导出文件路径。",
+    "inputSchema": {
+        "properties": {
+            "docid": {
+                "description": "智能主页的 docid，由 smartpage_create 返回",
+                "title": "Doc ID",
+                "type": "string"
+            },
+            "content_type": {
+                "description": "导出内容格式。0: Text，1: Markdown",
+                "enum": [0, 1],
+                "title": "Content Type",
+                "type": "integer"
+            }
+        },
+        "required": ["docid", "content_type"],
+        "title": "smartpage_export_taskArguments",
+        "type": "object"
+    }
+}
+```
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| docid | string | 是 | 智能主页的 docid |
+| content_type | integer | 是 | 导出内容格式：0-Text，1-Markdown |
+
+## 请求示例
+
+```json
+{
+    "docid": "DOCID",
+    "content_type": 1
+}
+```
+
+## 响应示例
+
+```json
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "task_id": "TASK_ID"
+}
+```
+
+## 注意事项
+
+- 这是异步操作的第一步，调用后仅返回 `task_id`
+- 获取到 `task_id` 后，需调用 `smartpage_get_export_result` 轮询导出进度
+- `content_type` 建议使用 `1`（Markdown）以获取可编辑的文本格式