@wecom/wecom-openclaw-plugin 2026.3.26 → 2026.3.30-beta.1

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wecom/wecom-openclaw-plugin",
-  "version": "2026.3.26",
+  "version": "2026.3.30-beta.1",
   "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）以获取可编辑的文本格式

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

@@ -0,0 +1,74 @@
+# smartpage_get_export_result API
+
+查询智能主页导出任务的执行进度。配合 `smartpage_export_task` 使用，通过轮询 `task_id` 获取导出结果。当 `task_done` 为 `true` 时，返回导出内容的本地文件路径。
+
+## 技能定义
+
+```json
+{
+    "name": "smartpage_get_export_result",
+    "description": "查询智能主页导出任务进度。传入 task_id 轮询，当 task_done 为 true 时返回导出内容的本地文件路径 content_filepath，可通过读取该文件获取 Markdown 内容。",
+    "inputSchema": {
+        "properties": {
+            "task_id": {
+                "description": "导出任务 ID，由 smartpage_export_task 返回",
+                "title": "Task ID",
+                "type": "string"
+            }
+        },
+        "required": ["task_id"],
+        "title": "smartpage_get_export_resultArguments",
+        "type": "object"
+    }
+}
+```
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| task_id | string | 是 | 导出任务 ID，由 `smartpage_export_task` 返回 |
+
+## 请求示例
+
+```json
+{
+    "task_id": "TASK_ID"
+}
+```
+
+## 响应示例
+
+任务未完成：
+
+```json
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "task_done": false
+}
+```
+
+任务完成：
+
+```json
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "task_done": true,
+    "content_filepath": "/path/to/exported-content.md"
+}
+```
+
+## 异步轮询机制
+
+1. **调用 smartpage_export_task** 获取 `task_id`
+2. **首次轮询**：传入 `task_id` 调用本接口
+3. **检查响应**：若 `task_done` 为 `false`，继续轮询
+4. **获取内容**：当 `task_done` 为 `true` 时，读取 `content_filepath` 指向的本地文件获取导出内容
+
+## 注意事项
+
+- `content_filepath` 仅在 `task_done` 为 `true` 时返回
+- `content_filepath` 是本地文件路径，使用 Read 工具读取文件内容即可
+- 如果轮询多次仍未完成，建议适当增加轮询间隔

package/skills/wecom-msg/SKILL.md

@@ -99,7 +99,7 @@ metadata:
 **执行流程**：
 1. 确定时间范围（用户指定或默认最近7天）
 2. 通过 **chatid查找规则** 确定目标会话的 `chatid` 和 `chat_type`
-3. 调用 `get_messages` 拉取消息列表
+3. 调用 `get_message` 拉取消息列表
 4. 调用 `wecom-contact-lookup` 的 `get_userlist` 获取通讯录，建立 userid→姓名 映射
 5. **统计非文本消息**：遍历消息列表，统计 `msgtype` 非 `text` 的消息（image/file/voice/video）数量和类型
 6. 展示消息时将 `userid` 替换为可读姓名，格式：

package/skills/wecom-msg/references/api-get-messages.md

@@ -16,15 +16,15 @@
 
 单聊：
 
-使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_messages '{"chat_type": 1, "chatid": "zhangsan", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00"}'`
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_message '{"chat_type": 1, "chatid": "zhangsan", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00"}'`
 
 群聊：
 
-使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_messages '{"chat_type": 2, "chatid": "wrxxxxxxxx", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00"}'`
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_message '{"chat_type": 2, "chatid": "wrxxxxxxxx", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00"}'`
 
 分页请求：
 
-使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_messages '{"chat_type": 1, "chatid": "zhangsan", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00", "cursor": "CURSOR_xxxxxx"}'`
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_message '{"chat_type": 1, "chatid": "zhangsan", "begin_time": "2026-03-17 09:00:00", "end_time": "2026-03-17 18:00:00", "cursor": "CURSOR_xxxxxx"}'`
 
 ## 返回字段
 

package/skills/wecom-schedule/SKILL.md

@@ -49,6 +49,8 @@ metadata:
 
 只需传入需修改的字段，未传字段保持不变。
 
+> ⚠️ **重要**：如果要把全天日程变成普通日程并修改时间，则一定要把 `is_whole_day` 设置为 `0`，否则日程仍会保持全天状态。
+
 使用 `wecom_mcp` tool 调用 `wecom_mcp call schedule update_schedule '{"schedule": {"schedule_id": "SCHEDULE_ID", "summary": "更新后的标题"}}'`
 
 参见 [API 详情](references/api-update-schedule.md)。

package/skills/wecom-schedule/references/api-update-schedule.md

@@ -17,6 +17,8 @@
 | `reminders` | object | ❌ | 提醒与重复设置（见 [reminders 字段参考](ref-reminders.md)） |
 
 > 仅传需修改的字段，其余保持不变。
+>
+> ⚠️ **重要**：如果要把全天日程变成普通日程并修改时间，则一定要把 `is_whole_day` 设置为 `0`，否则日程仍会保持全天状态。
 
 ## 请求示例
 

package/skills/wecom-smartsheet-data/SKILL.md

@@ -51,7 +51,7 @@ description: 企业微信智能表格数据（记录）管理技能。提供智
 
 更新一行或多行记录，单次必须在 500 行内。需提供 record_id（通过 `smartsheet_get_records` 获取）。
 
-使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_update_records '{"docid": "DOCID", "sheet_id": "SHEETID", "records": [{"record_id": "RECORDID", "values": {"任务名称": [{"type": "text", "text": "更新后的内容"}]}}]}'`
+使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_update_records '{"docid": "DOCID", "sheet_id": "SHEETID", "key_type": "CELL_VALUE_KEY_TYPE_FIELD_ID", "records": [{"record_id": "RECORDID", "values": {"FIELDID": [{"type": "text", "text": "更新后的内容"}]}}]}'`
 
 **注意**：创建时间、最后编辑时间、创建人、最后编辑人字段不可更新。
 

package/skills/wecom-smartsheet-schema/SKILL.md

@@ -48,7 +48,7 @@ description: 企业微信智能表格结构管理技能。提供子表（Sheet
 
 修改子表标题。需提供 sheet_id 和新 title。
 
-使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_update_sheet '{"docid": "DOCID", "sheet_id": "SHEETID", "title": "新标题"}'`
+使用 `wecom_mcp` tool 调用 `wecom_mcp call doc smartsheet_update_sheet '{"docid": "DOCID", "properties": {"sheet_id": "SHEETID", "title": "新标题"}}'`
 
 ### smartsheet_delete_sheet