@sunnoy/wecom 2.2.1 → 2.4.0

package/README.md

@@ -150,6 +150,7 @@ npm test
         "mentionPatterns": ["@"]
       },
       "workspaceTemplate": "/path/to/template-dir",
+      "mediaLocalRoots": ["/tmp/openclaw"],
       "agent": {
         "corpId": "wwxxxxxxxxxxxxxxxx",
         "corpSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
@@ -180,7 +181,8 @@ npm test
 | `channels.wecom.secret` | string | 是 | 企业微信 AI 机器人 Secret |
 | `channels.wecom.websocketUrl` | string | 否 | WS 地址，默认 `wss://openws.work.weixin.qq.com` |
 | `channels.wecom.sendThinkingMessage` | boolean | 否 | 是否先发送 `<think></think>` 占位，默认 `true` |
-| `channels.wecom.welcomeMessage` | string | 否 | 进入会话欢迎语 |
+| `channels.wecom.welcomeMessage` | string | 否 | 进入会话欢迎语（非空时固定使用该字符串） |
+| `channels.wecom.welcomeMessagesFile` | string | 否 | 欢迎语列表文件路径。支持：`{ "messages": [ ... ] }` 或顶层数组；每条欢迎语可为**一行一个字符串的数组**（推荐，易读），或单条字符串（可含 `\\n`）。相对路径基于 OpenClaw 状态目录（`~/.openclaw` 或 `OPENCLAW_STATE_DIR`）。未设置 `welcomeMessage` 时从该文件随机选取；**修改文件后无需重启服务**（按 mtime 自动重读） |
 | `channels.wecom.adminUsers` | string[] | 否 | 管理员用户 ID，可绕过命令白名单 |
 | `channels.wecom.defaultAccount` | string | 否 | 多账号模式默认账号 |
 
@@ -207,6 +209,7 @@ npm test
 | `channels.wecom.groupChat.requireMention` | boolean | 否 | 群聊是否要求 @ 才响应，默认 `true` |
 | `channels.wecom.groupChat.mentionPatterns` | string[] | 否 | 群聊触发前缀，默认 `["@"]` |
 | `channels.wecom.workspaceTemplate` | string | 否 | 动态 Agent 工作区模板目录 |
+| `channels.wecom.mediaLocalRoots` | string[] | 否 | 额外允许被动回复读取的宿主机目录列表。用于放行 `MEDIA:/abs/path` 或 `FILE:/abs/path` 指向的本地文件；默认只允许当前 Agent workspace 和浏览器产物目录。多账号模式下也可配置在 `channels.wecom.<accountId>.mediaLocalRoots`。修改后需重启 Gateway 生效 |
 
 ### 增强出站配置
 
@@ -246,6 +249,7 @@ Agent 增强出站不需要 `token`、`encodingAesKey`、回调 URL；只有需
         "botId": "aib-support-xxx",
         "secret": "secret-support-xxx",
         "dmPolicy": "pairing",
+        "mediaLocalRoots": ["/tmp/openclaw"],
         "agent": {
           "corpId": "wwxxxxxxxxxxxxxxxx",
           "corpSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
@@ -376,6 +380,15 @@ Webhook 只负责群通知。
 - 最终回复 `finish=true` 时可附带图片 `msg_item`
 - 若最终回复包含 WS 不支持的媒体（文件等），会先文本提示再通过 Agent API 补发
 
+本插件会自动解析模型输出中的 `MEDIA:` / `FILE:` 指令，并在回复完成后上传对应文件：
+
+- 图片使用 `MEDIA:/abs/path`
+- PDF、音频、视频、压缩包、Office 文档等非图片文件使用 `FILE:/abs/path`
+- 沙箱内当前工作区文件可直接写成 `MEDIA:/workspace/...` 或 `FILE:/workspace/...`
+- 浏览器生成的文件默认允许从 OpenClaw 状态目录下的浏览器媒体目录读取
+- 宿主机其他目录默认不放行；如果需要回复 `/tmp/openclaw/report.pdf` 这类文件，请把其父目录加入 `channels.wecom.mediaLocalRoots`，多账号模式可配在 `channels.wecom.<accountId>.mediaLocalRoots`
+- 更新 `mediaLocalRoots` 后需重启 Gateway 生效
+
 ### 主动发送与后备策略
 
 主动发送分层：
@@ -556,6 +569,29 @@ openclaw pairing approve wecom <code>
 - WS 断连后的 pending 回复通过 Agent API 补发
 - WS 文本主动发送失败时，尝试回退到 Agent
 
+### Q: 回复本地文件时提示“没有权限访问路径”怎么办？
+
+先确认文件路径是否在允许目录里：
+
+- 当前 Agent 工作区文件默认允许，可直接用 `FILE:/workspace/...` 或 `MEDIA:/workspace/...`
+- 浏览器生成的文件默认允许
+- 宿主机其他目录需要把父目录加入 `channels.wecom.mediaLocalRoots`
+- 多账号模式如果只想对某个账号生效，可配置 `channels.wecom.<accountId>.mediaLocalRoots`
+
+例如：
+
+```json
+{
+  "channels": {
+    "wecom": {
+      "mediaLocalRoots": ["/tmp/openclaw"]
+    }
+  }
+}
+```
+
+修改后重启 Gateway。`v2.2.1+` 已支持把 `mediaLocalRoots` 并入被动回复文件允许目录。
+
 ### Q: `60020 not allow to access from your ip` 是什么问题？
 
 企业微信自建应用 API 的可信 IP 限制。把当前服务器出口 IP 加入企业微信应用的可信 IP 白名单即可。

package/index.js

@@ -1,7 +1,8 @@
-import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
 import { logger } from "./logger.js";
 import { wecomChannelPlugin } from "./wecom/channel-plugin.js";
 import { createWeComMcpTool } from "./wecom/mcp-tool.js";
+import { createImageStudioTool } from "./wecom/image-studio-tool.js";
+import { resolveQwenImageToolsConfig, wecomPluginConfigSchema } from "./wecom/plugin-config.js";
 import { setOpenclawConfig, setRuntime } from "./wecom/state.js";
 import { buildReplyMediaGuidance } from "./wecom/ws-monitor.js";
 import { listAccountIds, resolveAccount } from "./wecom/accounts.js";
@@ -11,7 +12,7 @@ const plugin = {
   id: "wecom",
   name: "Enterprise WeChat",
   description: "Enterprise WeChat AI Bot channel plugin for OpenClaw",
-  configSchema: emptyPluginConfigSchema(),
+  configSchema: wecomPluginConfigSchema,
   register(api) {
     logger.info("Registering WeCom WS plugin");
     setRuntime(api.runtime);
@@ -19,6 +20,14 @@ const plugin = {
     api.registerChannel({ plugin: wecomChannelPlugin });
     api.registerTool(createWeComMcpTool(), { name: "wecom_mcp" });
 
+    const qwenImageToolsConfig = resolveQwenImageToolsConfig(api.pluginConfig);
+    if (qwenImageToolsConfig.enabled) {
+      api.registerTool(createImageStudioTool(qwenImageToolsConfig), { name: "image_studio" });
+      logger.info(
+        `[image_studio] Registered with provider "${qwenImageToolsConfig.provider}" using qwen(generate=${qwenImageToolsConfig.models.qwen.generate}, edit=${qwenImageToolsConfig.models.qwen.edit}) wan(generate=${qwenImageToolsConfig.models.wan.generate}, edit=${qwenImageToolsConfig.models.wan.edit})`,
+      );
+    }
+
     // Register HTTP callback endpoints for all accounts that have callback config
     for (const accountId of listAccountIds(api.config)) {
       const account = resolveAccount(api.config, accountId);

package/openclaw.plugin.json

@@ -8,7 +8,143 @@
   "configSchema": {
     "type": "object",
     "additionalProperties": true,
-    "properties": {}
+    "properties": {
+      "qwenImageTools": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": {
+            "type": "boolean"
+          },
+          "provider": {
+            "type": "string"
+          },
+          "route": {
+            "type": "string",
+            "enum": [
+              "auto",
+              "qwen",
+              "wan"
+            ]
+          },
+          "endpoint": {
+            "type": "string"
+          },
+          "endpoints": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "qwen": {
+                "type": "string"
+              },
+              "wan": {
+                "type": "string"
+              },
+              "task": {
+                "type": "string"
+              }
+            }
+          },
+          "timeoutMs": {
+            "type": "integer",
+            "minimum": 1000
+          },
+          "models": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "generate": {
+                "type": "string"
+              },
+              "edit": {
+                "type": "string"
+              },
+              "qwen": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "generate": {
+                    "type": "string"
+                  },
+                  "edit": {
+                    "type": "string"
+                  }
+                }
+              },
+              "wan": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "generate": {
+                    "type": "string"
+                  },
+                  "edit": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          },
+          "defaults": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "size": {
+                "type": "string"
+              },
+              "aspect": {
+                "type": "string",
+                "enum": [
+                  "landscape",
+                  "square",
+                  "portrait"
+                ]
+              },
+              "n": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "watermark": {
+                "type": "boolean"
+              },
+              "promptExtend": {
+                "type": "boolean"
+              },
+              "qwen": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "landscape": {
+                    "type": "string"
+                  },
+                  "square": {
+                    "type": "string"
+                  },
+                  "portrait": {
+                    "type": "string"
+                  }
+                }
+              },
+              "wan": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "landscape": {
+                    "type": "string"
+                  },
+                  "square": {
+                    "type": "string"
+                  },
+                  "portrait": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
   },
   "channels": [
     "wecom"

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@sunnoy/wecom",
-    "version": "2.2.1",
+    "version": "2.4.0",
     "description": "Enterprise WeChat AI Bot channel plugin for OpenClaw",
     "type": "module",
     "main": "index.js",
@@ -8,7 +8,6 @@
         "index.js",
         "wecom",
         "dynamic-agent.js",
-
         "logger.js",
         "README.md",
         "LICENSE",
@@ -60,7 +59,7 @@
     "author": "",
     "license": "ISC",
     "dependencies": {
-        "@wecom/aibot-node-sdk": "^1.0.2",
+        "@wecom/aibot-node-sdk": "^1.0.3",
         "file-type": "^21.3.0"
     }
 }

package/skills/wecom-msg/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: wecom-msg
+description: 企业微信消息技能。提供会话列表查询、消息记录拉取（支持文本/图片/文件/语音/视频）、多媒体文件获取和文本消息发送能力。当用户需要“查看消息”、”看聊天记录”、”发消息给某人”、”最近有什么消息”、”给群里发消息”、”看看发了什么图片/文件”时触发。
+---
+
+# 企业微信消息技能
+
+> `wecom_mcp` 是一个 MCP tool，所有操作通过调用该 tool 完成。
+
+> ⚠️ **前置条件**：首次调用 `wecom_mcp` 前，必须按 `wecom-preflight` 技能执行前置条件检查，确保工具已加入白名单。
+
+> ⚠️ **路径与停止规则**：
+> - 如果要读取本 skill，必须直接使用 `<available_skills>` 或 `skillsSnapshot` 中给出的精确绝对路径。
+> - 不要猜测或改写为 `/data/openclaw/skills/wecom-*`、`/workspace/.openclaw/skills/...`、`/root/.openclaw/workspace-*/.openclaw/skills/...`，也不要用 `exec` + `ls/find` 探路。
+> - 若 `wecom_mcp` 返回 `errcode: 846609` 或 `unsupported mcp biz type`，表示当前 bot 未开通 `msg` category，不是路径、白名单或 sandbox 问题；立即停止继续 `read`、`list`、`find`、memory fallback 探索，直接告知用户当前机器人未开通消息能力。
+
+通过 `wecom_mcp call msg <接口名> '<json入参>'` 与企业微信消息系统交互。
+
+## 接口列表
+
+### 1. 获取会话列表
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_msg_chat_list '{"begin_time": "2026-03-11 00:00:00", "end_time": "2026-03-17 23:59:59"}'`
+
+按时间范围查询有消息的会话列表，支持分页。详情见 `references/api-get-msg-chat-list.md`。
+
+### 2. 拉取聊天记录
+
+使用 `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"}'`
+
+根据会话类型和会话 ID 拉取指定时间范围内的消息记录，支持分页。详情见 `references/api-get-messages.md`。
+
+### 3. 发送文本消息
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg send_message '{"chat_type": 1, "chatid": "zhangsan", "msgtype": "text", "text": {"content": "hello world"}}'`
+
+向单聊或群聊发送文本消息。详情见 `references/api-send-message.md`。
+
+## 核心规则
+
+### 时间范围
+
+- 所有时间参数使用 `YYYY-MM-DD HH:mm:ss` 格式。
+- 用户未指定时间时，默认使用最近 7 天。
+- `get_messages` 只支持当前时刻往前 7 天内的数据。
+- 如果用户给出的开始时间早于 7 天窗口，要主动调整到有效范围并明确告知。
+
+### 会话定位
+
+- 当用户直接提供 `chatid` 时，直接使用。
+- 当用户提供人名或群名而不是 ID 时，先调用 `get_msg_chat_list` 获取候选会话，再按 `chat_name` 在本地筛选。
+- 精确匹配唯一结果时可直接使用。
+- 模糊匹配多个结果时，必须先向用户展示候选项，不要擅自决定。
+- 没有匹配结果时，要明确告知未找到对应会话。
+- `get_msg_chat_list` 返回里没有 `chat_type`，若用户明确说“群”“群聊”“项目群”等，优先用 `chat_type=2`；否则默认 `chat_type=1`。
+
+### 消息展示
+
+- `get_messages` 当前只按文档约定处理文本消息；遇到非文本字段时，不要编造内容，按原始结构说明。
+- 展示消息时优先把 `userid` 转成可读姓名。
+- 如需做 `userid -> 姓名/别名` 映射，调用 `wecom-contact-lookup` 的 `get_userlist`，并在本地建立映射。
+- 若无法映射，保留 `userid` 原样展示。
+
+### 发送规则
+
+- `send_message` 仅用于发送文本消息。
+- 用户要求发送图片、PDF、视频、语音或其它文件时，不要误用 `wecom_mcp msg send_message`；应改用本插件原生的 `MEDIA:` / `FILE:` 路径投递能力。
+- 发送消息前必须先做一次面向用户的确认，至少确认发送对象和发送内容。
+- 用户确认前，不要执行 `send_message`。
+
+## 典型工作流
+
+### 查看最近有哪些会话
+
+1. 确定时间范围。
+2. 调用 `get_msg_chat_list`。
+3. 按“会话名称 + 最后消息时间 + 消息数量”整理结果。
+4. 若 `has_more=true`，提示用户还可以继续翻页。
+
+### 查看某个聊天对象的记录
+
+1. 确定时间范围。
+2. 如需，先通过 `get_msg_chat_list` 定位 `chatid`。
+3. 调用 `get_messages`。
+4. 如需，调用 `wecom-contact-lookup` 获取通讯录，把 `userid` 映射为姓名/别名。
+5. 按时间顺序展示消息。
+6. 若 `next_cursor` 非空，提示还有更多消息可继续查看。
+
+### 给某人或某个群发文本
+
+1. 如需，先定位 `chatid` 与 `chat_type`。
+2. 向用户确认发送对象和文本内容。
+3. 用户确认后，调用 `send_message`。
+4. 返回发送结果。
+
+### 看完消息后代发回复
+
+1. 先执行“查看聊天记录”流程。
+2. 从上下文中提取待回复对象和回复内容。
+3. 再执行“给某人或某个群发文本”流程。
+
+## 错误处理
+
+- 若返回 `tool not allowed`、`unknown tool: wecom_mcp`、`permission denied`，说明问题在宿主机工具放行，不要继续试探，按 `wecom-preflight` 规则处理。
+- 若返回 `unsupported mcp biz type` 或 `errcode: 846609`，说明当前 bot 未开通 `msg` category，不要继续尝试其它 category。
+- 若返回 API 业务错误，直接展示 `errcode` 和 `errmsg`，必要时最多重试 1 次。
+- 若查询结果为空，要明确告知“当前时间范围内没有找到消息/会话”，不要编造。
+
+## 快速参考
+
+| 接口 | 用途 | 关键输入 | 关键输出 |
+|------|------|----------|----------|
+| `get_msg_chat_list` | 查询时间范围内有消息的会话列表 | `begin_time`, `end_time`, `cursor?` | `chats`, `has_more`, `next_cursor` |
+| `get_messages` | 拉取指定会话消息 | `chat_type`, `chatid`, `begin_time`, `end_time`, `cursor?` | `messages`, `next_cursor` |
+| `send_message` | 发送文本消息 | `chat_type`, `chatid`, `msgtype=text`, `text.content` | `errcode`, `errmsg` |

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

@@ -0,0 +1,74 @@
+# `get_messages` API
+
+根据会话类型和会话 ID 拉取指定时间范围内的消息记录。
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `chat_type` | integer | 是 | 会话类型，`1` 表示单聊，`2` 表示群聊 |
+| `chatid` | string | 是 | 会话 ID。单聊时通常为 userid，群聊时为群 ID |
+| `begin_time` | string | 是 | 拉取开始时间，格式：`YYYY-MM-DD HH:mm:ss`，仅支持最近 7 天内 |
+| `end_time` | string | 是 | 拉取结束时间，格式：`YYYY-MM-DD HH:mm:ss`，必须大于等于 `begin_time` |
+| `cursor` | string | 否 | 分页游标。首次请求不传，后续传上次响应的 `next_cursor` |
+
+## 请求示例
+
+单聊：
+
+```text
+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"}'
+```
+
+群聊：
+
+```text
+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"}'
+```
+
+分页：
+
+```text
+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"}'
+```
+
+## 返回字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `errcode` | integer | 返回码，`0` 表示成功 |
+| `errmsg` | string | 错误信息 |
+| `messages` | array | 消息列表 |
+| `messages[].userid` | string | 发送者 userid |
+| `messages[].send_time` | string | 发送时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `messages[].msgtype` | string | 消息类型 |
+| `messages[].text.content` | string | 文本消息内容；仅在 `msgtype=text` 时存在 |
+| `next_cursor` | string | 下一页游标；为空表示已拉取完毕 |
+
+## 响应示例
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok",
+  "messages": [
+    {
+      "userid": "zhangsan",
+      "send_time": "2026-03-17 09:30:00",
+      "msgtype": "text",
+      "text": {
+        "content": "你好"
+      }
+    },
+    {
+      "userid": "lisi",
+      "send_time": "2026-03-17 09:35:00",
+      "msgtype": "text",
+      "text": {
+        "content": "你好，有什么可以帮助你的？"
+      }
+    }
+  ],
+  "next_cursor": "CURSOR_xxxxxx"
+}
+```

package/skills/wecom-msg/references/api-get-msg-chat-list.md

@@ -0,0 +1,64 @@
+# `get_msg_chat_list` API
+
+获取指定时间范围内有消息的会话列表，支持分页查询。
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `begin_time` | string | 是 | 拉取开始时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `end_time` | string | 是 | 拉取结束时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `cursor` | string | 否 | 分页游标。首次请求不传，后续传上次响应的 `next_cursor` |
+
+## 请求示例
+
+使用 `wecom_mcp` tool 调用：
+
+```text
+wecom_mcp call msg get_msg_chat_list '{"begin_time":"2026-03-11 00:00:00","end_time":"2026-03-17 23:59:59"}'
+```
+
+分页请求：
+
+```text
+wecom_mcp call msg get_msg_chat_list '{"begin_time":"2026-03-11 00:00:00","end_time":"2026-03-17 23:59:59","cursor":"NEXT_CURSOR"}'
+```
+
+## 返回字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `errcode` | integer | 返回码，`0` 表示成功 |
+| `errmsg` | string | 错误信息 |
+| `chats` | array | 会话列表 |
+| `chats[].chat_id` | string | 会话 ID |
+| `chats[].chat_name` | string | 会话名称 |
+| `chats[].last_msg_time` | string | 最后一条消息时间，格式：`YYYY-MM-DD HH:mm:ss` |
+| `chats[].msg_count` | integer | 消息数量 |
+| `has_more` | boolean | 是否还有更多数据 |
+| `next_cursor` | string | 下一页游标 |
+
+## 响应示例
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok",
+  "chats": [
+    {
+      "chat_id": "zhangsan",
+      "chat_name": "张三",
+      "last_msg_time": "2026-03-17 15:30:45",
+      "msg_count": 128
+    },
+    {
+      "chat_id": "wr123456",
+      "chat_name": "项目讨论群",
+      "last_msg_time": "2026-03-16 09:12:33",
+      "msg_count": 56
+    }
+  ],
+  "has_more": true,
+  "next_cursor": "NEXT_CURSOR"
+}
+```

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

@@ -0,0 +1,44 @@
+# get_msg_media API
+
+获取消息文件内容。根据文件 ID 自动下载文件到本地，返回本地文件路径、文件名称、类型、大小及内容类型。
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `media_id` | string | ✅ | 文件 ID，长度 1~256 |
+
+## 请求示例
+
+使用 `wecom_mcp` tool 调用 `wecom_mcp call msg get_msg_media '{"media_id": "MEDIAID_xxxxxx"}'`
+
+## 返回字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `errcode` | Integer | 返回码，`0` 表示成功 |
+| `errmsg` | String | 错误信息 |
+| `media_item` | Object | 文件内容 |
+| `media_item.media_id` | String | 文件 ID |
+| `media_item.name` | String | 文件名称 |
+| `media_item.type` | String | 文件类型，`image`-图片，`voice`-语音，`video`-视频，`file`-普通文件 |
+| `media_item.local_path` | String | 文件下载后的本地路径 |
+| `media_item.size` | Integer | 文件大小（字节） |
+| `media_item.content_type` | String | 文件 MIME 类型，如 `image/png`、`application/pdf` 等 |
+
+## 响应示例
+
+```json
+{
+    "errcode": 0,
+    "errmsg": "ok",
+    "media_item": {
+        "media_id": "MEDIAID_xxxxxx",
+        "name": "screenshot.png",
+        "type": "image",
+        "local_path": "xxx/yyy/screenshot.png",
+        "size": 102400,
+        "content_type": "image/png"
+    }
+}
+```

package/skills/wecom-msg/references/api-send-message.md

@@ -0,0 +1,49 @@
+# `send_message` API
+
+向单聊或群聊发送文本消息。
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `chat_type` | integer | 是 | 会话类型，`1` 表示单聊，`2` 表示群聊 |
+| `chatid` | string | 是 | 会话 ID。单聊时通常为 userid，群聊时为群 ID |
+| `msgtype` | string | 是 | 消息类型。当前只应使用 `text` |
+| `text` | object | 是 | 文本消息体 |
+| `text.content` | string | 是 | 文本内容，受企业微信消息长度限制 |
+
+## 请求示例
+
+单聊：
+
+```text
+wecom_mcp call msg send_message '{"chat_type":1,"chatid":"zhangsan","msgtype":"text","text":{"content":"hello world"}}'
+```
+
+群聊：
+
+```text
+wecom_mcp call msg send_message '{"chat_type":2,"chatid":"wrxxxxxxxx","msgtype":"text","text":{"content":"大家好"}}'
+```
+
+## 返回字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `errcode` | integer | 返回码，`0` 表示成功 |
+| `errmsg` | string | 错误信息 |
+
+## 响应示例
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok"
+}
+```
+
+## 使用约束
+
+- 在当前插件里，这个接口只应用于文本消息。
+- 发图片、PDF、视频、语音或其它文件时，不要误用这个接口；应改用插件原生的 `MEDIA:` / `FILE:` 路径投递能力。
+- 执行发送前必须先征得用户确认，避免误发。