wecode-ai 企业微信在线表格管理
wecom-cli是企业微信提供的命令行程序，所有操作通过执行wecom-cli命令完成。
资源型技能，负责在线表格（/sheet/*）的新建、内容读写以及子工作表管理。
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>'
接口路由表
硬规则：第二列是
references/xxx.md链接的，命中这一行后先read对应 references 文件，再构造命令。写入/读取子表数据前，先用sheet_get_info拿到目标子表的sheet_id。
| 用户意图 | 参考位置 |
|---|---|
| 读取在线表格完整内容（Markdown 概览） | 见下方「读取完整内容」 |
| 读取在线表格基础信息与子表列表 | 见下方「读取基础信息」 |
| 从零新建在线表格（空白） | 见下方「新建在线表格」 |
| 修改在线表格指定区域内容 | references/sheet-update-range-data.md |
| 在线表格末尾追加一行数据 | references/sheet-append-data.md |
| 添加在线表格子工作表 | references/sheet-add-sub.md |
| 删除在线表格子工作表 | references/sheet-delete-sub.md |
接口详述
新建在线表格
从零新建一篇企微在线表格：空白。创建成功后返回 docid 和 url。
命令
wecom-cli doc create_doc '<JSON 参数>'
参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
doc_type |
int | 是 | — | 固定传 4（在线表格） |
doc_name |
string | 是 | — | 表格标题 |
注意事项
- 本接口仅创建空白在线表格，不支持携带初始内容；如需写入数据，请在创建后先用
sheet_get_info拿到子表sheet_id，再通过sheet_update_range_data/sheet_append_data写入。
读取完整内容
获取在线表格的完整内容数据，统一以 Markdown 格式返回。采用异步轮询机制：首次调用无需传 task_id，接口返回 task_id；若 task_done 为 false，需携带该 task_id 再次调用，直到 task_done 为 true 时返回完整内容。适合快速概览或读取整篇表格内容。
命令
wecom-cli doc get_doc_content '<JSON 参数>'
参数
| 字段 | 类型 | 必填 | 默认值 | 语义 |
|---|---|---|---|---|
docid |
string | 与 url 二选一 |
— | 在线表格的 docid |
url |
string | 与 docid 二选一 |
— | 在线表格的访问链接 |
type |
int | 是 | — | 内容返回格式，固定传 2（Markdown） |
task_id |
string | 否 | — | 任务 ID，首次不传，轮询时填上次返回的 task_id |
返回
| 字段 | 类型 | 说明 |
|---|---|---|
content |
string | task_done 为 true 时返回的完整 Markdown 内容 |
task_id |
string | 任务 ID，未完成时用于下次轮询 |
task_done |
bool | 任务是否完成，false 时需携带 task_id 继续轮询 |
使用规则
- 首次调用不传
task_id；若task_done为false，记录task_id后携带其再次调用，直到task_done为true取content。
读取基础信息
读取在线表格的基础信息，包括工作表列表、文档名称与访问链接。所有后续需要 sheet_id 的接口（sheet_update_range_data / sheet_append_data / sheet_delete_sub等）的 sheet_id 都从本接口返回的 sheets[] 中取。
命令
wecom-cli doc sheet_get_info '<JSON 参数>'
参数
| 字段 | 类型 | 必填 | 默认值 | 语义 |
|---|---|---|---|---|
docid |
string | 与 url 二选一 |
— | 在线表格的 docid |
url |
string | 与 docid 二选一 |
— | 在线表格的访问链接 |
返回
| 字段 | 类型 | 说明 |
|---|---|---|
sheets |
array | 工作表列表；每项含 sheet_id / title / row_count / column_count / data_range 等基础信息 |
url |
string | 文档访问链接 |
name |
string | 文档名称 |
使用规则
docid与url二选一，至少传其一。- 读 → 写 链路：当需要往具体子表写内容（
sheet_update_range_data/sheet_append_data）时，应先用get_doc_content读取并识别出各子表的标题与具体数据，再调用本接口拿到sheets[]中每个子表的sheet_id与行列数（row_count/column_count）；通过子表标题与title匹配确定目标sheet_id，并结合行列数核对写入区域范围，从而打通「读 → 写」的完整链路。
跨技能依赖
| 依赖技能 | 典型协作场景 | 数据流向 |
|---|---|---|
wecomcli-contact |
表格里需要写入人员信息时按姓名查 userid | get_userlist 查到 userid → 本 skill 写入 |
wecomcli-msg |
用户要求把在线表格链接发给某人/某群 | 本 skill 新建后返回 url → wecomcli-msg 发送链接 |