wecode-ai 企业微信智能文档管理
wecom-cli是企业微信提供的命令行程序，所有操作通过执行wecom-cli命令完成。
资源型技能，负责智能文档（原名智能主页，/smartpage/*）的创建与内容导出。
Wegent 本地与云端运行
- 当前
SKILL.md所在目录的../..是插件根目录。首次调用前，macOS/Linux 运行sh "<插件根目录>/scripts/ensure-wecom-ready.sh"；Windows 运行powershell -NoProfile -ExecutionPolicy Bypass -File "<插件根目录>\scripts\ensure-wecom-ready.ps1"。 - 下文的
wecom-cli ...是逻辑命令。实际执行时，macOS/Linux 使用sh "<插件根目录>/scripts/run-wecom-cli.sh" ...；Windows 使用powershell -NoProfile -ExecutionPolicy Bypass -File "<插件根目录>\scripts\run-wecom-cli.ps1" ...。 - 本地未授权时通过 Wegent 原生连接在官方浏览器页面扫码。Bot ID 和 Secret 由私有适配器同步，云端使用托管连接，无需再次扫码；云端禁止运行安装、
init或读取本地认证配置。认证失效时返回来源设备重新连接。不要要求用户在对话中粘贴凭据。
调用方式
通过 wecom-cli 调用，品类为 doc：
wecom-cli doc <tool_name> '<json_params>'
返回格式说明
所有接口返回 JSON 对象，包含以下公共字段：
| 字段 | 类型 | 说明 |
|---|---|---|
errcode |
integer | 返回码，0 表示成功，非 0 表示失败 |
errmsg |
string | 错误信息，成功时为 "ok" |
当 errcode 不为 0 时，说明接口调用失败，可重试 1 次；若仍失败，将 errcode 和 errmsg 展示给用户。
特殊错误码
| errcode | errmsg | 含义 | 处理方式 |
|---|---|---|---|
851002 |
incompatible doc type |
文档品类与所调用的接口不匹配 | 确认目标 URL 为 /smartpage/*；若不是，请跳转到对应品类的 skill |
接口详述
创建智能文档
创建智能文档（原名智能主页），支持传入标题和多个子页面。每个子页面可指定标题、内容类型和本地文件路径。创建成功返回 docid 和 url。
特殊语法：此命令必须使用
+smartpage_create（带+前缀），加号不可省略；该+仅适用于此命令，不要泛化到其他doc子命令。
命令
wecom-cli doc +smartpage_create '<JSON 参数>'
参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
title |
string | 否 | — | 智能文档标题 |
pages |
array | 是 | — | 子页面列表 |
pages[].page_title |
string | 否 | — | 子页面标题 |
pages[].content_type |
int | 否 | 1 | 内容类型：1-Markdown，0-Text（纯文本） |
pages[].page_filepath |
string | 否 | — | 子页面内容对应的本地文件路径 |
注意事项
content_type必须与文件实际内容匹配：.md文件或包含 Markdown 语法的内容必须传1，仅纯文本才传0。绝大多数场景应传1。docid仅在创建时返回，需妥善保存。- 每个子页面的 Markdown 文件大小不得超过 10MB，超过会导致创建失败；如文件过大，需先拆分为多个子页面再创建。
- 智能文档还支持背景块（
<card>）、分栏（<grid>）等扩展语法，详见 references/smartpage-create.md。
导出智能文档内容
获取智能文档的完整内容，导出为 Markdown。采用异步两步操作：先用 smartpage_export_task 提交导出任务拿到 task_id，再用 smartpage_get_export_result 轮询任务，直到 task_done 为 true 时返回 content。
第一步：提交导出任务
# 通过 docid
wecom-cli doc smartpage_export_task '{"docid": "DOCID", "content_type": 1}'
# 通过 url
wecom-cli doc smartpage_export_task '{"url": "https://doc.weixin.qq.com/smartpage/xxx", "content_type": 1}'
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
docid |
string | 与 url 二选一 |
— | 智能文档的 docid |
url |
string | 与 docid 二选一 |
— | 智能文档的访问链接 |
content_type |
int | 是 | — | 导出内容格式，目前仅支持 1（Markdown） |
第二步：轮询导出结果
wecom-cli doc smartpage_get_export_result '{"task_id": "TASK_ID"}'
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
task_id |
string | 是 | — | 由 smartpage_export_task 返回的任务 ID |
使用规则
- 第一步获取
task_id后，携带其调用第二步；若task_done为false则继续轮询，直到task_done为true，返回的content字段即为完整 Markdown 内容。
参见 API 详情。
跨技能依赖
| 依赖技能 | 典型协作场景 | 数据流向 |
|---|---|---|
wecomcli-msg |
用户要求把智能文档链接发给某人/某群 | 本 skill 创建后返回 url → wecomcli-msg 发送链接 |