从「AI 造了个工具给人用」升级到「AI 自己派单、自己记账、自己汇报、自己治理」。
统一调用格式:wecom-cli <服务> [资源] <方法> --json '<请求体>'
本蓝图所有命令均为本次沙箱实测安装(v1.3.4)并逐一验证得到的真实命令,非文档转述。
| 服务 | 命令前缀 | 能干什么(资源树摘要) |
|---|---|---|
| 授权 | auth | init 初始化机器人 / show 查看授权状态 |
| 消息 | message | send 发文本 · aibot send 机器人发 markdown/图/文件 · aibot sessions list 取最近会话 |
| 待办 | todo | create / list / get / update / finish / delete(批量,最多 20 条) |
| 日程 | calendar | schedules create/get/list/update/cancel · free list 忙闲查询 |
| 智能表格 | smartsheet | create 建表 · records add/list/query/update 记录 CRUD(支持 SQL)· fields/views/charts |
| 表格 | sheet | create · cells set/get/append · ranges get · formulas 等(A1 表示法) |
| 文档 | doc | create(doc/sheet/smartsheet/ppt)· contents get/append/overwrite · members 权限 |
| 智能文档 | smartpage | create · import markdown · blocks/pages 编辑 |
| 会议 | meeting | create/list/get/update/cancel · original get 拉纪要转写 · rooms 查会议室 |
| 微盘 | disk | files upload/download/search/rename · folders create |
| 通讯录 | contact | users search 按关键词搜成员 |
| 邮件 | mail | send / search / get |
| 素材 | media | upload 得 media_id / download |
| 幻灯片 | slide | PPT 编辑(2026/10 新增) |
| 层 | 是什么 | 心源怎么落 |
|---|---|---|
| 脑已有 | 决策(配方引擎 / 定价 / 派工单) | 7.0 的四层咨询链 + 配方引擎 + 定价铁律 + 派工单引擎 |
| 手本次补上 | 执行(发消息 / 建待办 / 写表格 / 派日程) | 企业微信 CLI 的 15 个服务 |
| 制度本次补上 | 治理(权限 / 边界 / 审计) | 机器人身份 + 成员能力授权 + 管理后台审计日志 |
没有「治理」的自理是失控的自动;没有「自理」的治理是空转的规则。7.0 之前只有「脑」,现在「手」和「制度」一次补齐,三条腿才算齐。
7.0 的「派工单引擎」现在生成的是网页工单卡;接 CLI 后自动变成员工在企微里能收到、能点完成的真实待办,并落到日程。
# 建一条今日待办(发长中长 → 自动派「肩以下」档) wecom-cli todo create --json '{ "items": [{ "title": "今日工单 · 染发 王女士 14:00", "description": "染亚麻冷棕 sMA · 肩以下 ¥399 · 升级玫丽盼 2 支", "follower_ids": ["zhangsan"], "deadline": {"type": "datetime", "value": "2026-11-07 14:00:00"} }] }' # 同步落到日程(subject/begin_time/end_time 为必填) wecom-cli calendar schedules create --json '{"subject":"染发 王女士","attendees":[{"userid":"zhangsan"}],"begin_time":"2026-11-07 14:00:00","end_time":"2026-11-07 16:00:00"}' wecom-cli calendar schedules free list --json '{"userids":[{"userid":"zhangsan"}],"begin_time":"2026-11-07 09:00:00","end_time":"2026-11-07 20:00:00"}'
7.0 的三本账(现金流 / 劳动业绩 / 卡金负债)现在在浏览器 localStorage;接 CLI 后自动写进企业微信智能表格,老板/员工随时在企微看,还能出视图和图表。
# 1) 建「心源三本账」智能表格(字段以 --doc 的 OaField 定义为准) wecom-cli smartsheet create --json '{ "name": "心源三本账", "fields": [ {"field_title":"日期","field_type":"text"}, {"field_title":"账本","field_type":"text"}, {"field_title":"金额","field_type":"number"}, {"field_title":"备注","field_type":"text"} ] }' # 返回 docid,如 "dcXXXX" # 2) 写一行账(records 外层要包 values,key 用字段标题;sheet_title 必填) wecom-cli smartsheet records add --json '{ "docid": "dcXXXX", "sheet_title": "三本账明细", "type": "add", "records": [{"values": {"日期":"2026-11-07","账本":"现金流","金额":597,"备注":"王女士染发"}}] }' # 3) 月度盘账用 SQL 查 wecom-cli smartsheet records query --json '{"docid":"dcXXXX","sql":"SELECT * FROM 默认子表"}'
决策看板的「今日营收 / 升单率 / 回本进度」不再等老板手动点开,AI 主动推送到群;客户该补色了,AI 推给店长。
# 机器人主动发 markdown 日报到群(chat_id 用 message aibot sessions list 获取)
wecom-cli message aibot send --json '{
"chat_id": "群会话ID",
"msg_type": "markdown",
"markdown": {"content": "## 今日营收\n- 现金流 +¥597\n- 升单率 68%\n- 回本进度 41%"}
}'
「初心美发终生事业库」落到企微文档 + 微盘,AI 通过 CLI 读写,做到「知识库即工作台」。
# 建文档、追加内容 wecom-cli doc create --json '{"doc_name":"初心美发终生事业库","doc_type":"doc"}' wecom-cli doc contents append --json '{"docid":"dcXXXX","text":"染发美学 · 玫丽盼三系列选品结论..."}' # 微盘上传 / 建文件夹 wecom-cli disk folders create --json '{"folder_name":"玫丽盼订货单"}' wecom-cli disk files upload --json '{"file_path":"/workspace/玫丽盼订货单.pdf","folder_id":"..."}' # 查通讯录(术语表:赵升强 / 刘永睿) wecom-cli contact users search --json '{"keywords":["赵升强"]}'
| 步 | 动作 | 说明 |
|---|---|---|
| 1 | 创建机器人 | 企微管理后台 → 工作台 → 智能机器人 → 新建机器人 |
| 2 | 开启 API 模式 | 机器人编辑页切 API 模式,选「长连接」(内网/实时/可主动推送) |
| 3 | 拿凭证 | 长连接 → BotID + Secret(切勿泄露) |
| 4 | 装 CLI + 授权 | npm i -g @wecom/cli → wecom-cli auth init --manual 输 BotID/Secret |
| 5 | 能力授权 | 机器人编辑页 →「可使用权限」→ 逐个勾选 待办/日程/表格/消息 等能力 |
| 验证项 | 结果 |
|---|---|
| CLI 安装 | ✅ 通过 @wecom/cli 装成功,v1.3.4,仅 2 个包、极轻 |
| 命令结构 | ✅ 通过 15 个服务 + 全部资源树已逐一摸清 |
| 命令格式 | ✅ 通过 --json 请求体格式实测可解析 |
| 真实调用 | ⚠️ 卡在授权 报 AuthError 893201:需先 auth init 登录 |
已为你准备好脚本 心源_wecom_最小闭环.sh:授权 → 建一条待办 → 建智能表格并写一行账 → 查通讯录,四步验证全链路。
# 使用:拿到 BotID/Secret 后执行
bash 心源_wecom_最小闭环.sh
--doc 实测的 TypeScript 声明逐字核对。
| 准备项 | 怎么确认 |
|---|---|
| BotID + Secret | 机器人编辑页 → API 模式 → 长连接 → 复制 BotID、Secret(Secret 只显示一次,先存好) |
| 能力授权 | 机器人编辑页 →「可使用权限」→ 勾选 待办 / 日程 / 智能表格 / 消息 / 文档 / 通讯录(跑哪条闭环勾哪个) |
| CLI 已装 | 命令行输 wecom-cli --version,显示 1.3.4+ 即可 |
# 全局安装(若已装可跳过) npm i -g @wecom/cli wecom-cli --version # 确认 ≥ 1.3.4
验收:输出版本号即通过。
方式 A · 扫码(推荐,有浏览器 / 手机时):
wecom-cli auth init
# 无浏览器环境:把二维码存成图片,手机扫码
wecom-cli auth init --output-qrcode /tmp/qr.png
方式 B · 手动(服务器无扫码条件):
wecom-cli auth init --manual
# 按提示依次输入 BotID 和 Secret
验收:命令行提示「授权成功」,无报错。
wecom-cli auth show
验收:状态不再是 unauthorized。若仍显示未授权,回到 Step 1 重试。
# 3.1 建一条今日待办(把 7.0 派工单引擎的工单落地成真实待办) wecom-cli todo create --json '{ "items": [{ "title": "今日工单 · 染发 王女士 14:00", "description": "染亚麻冷棕 sMA · 肩以下 ¥399 · 升级玫丽盼 2 支", "follower_ids": ["zhangsan"], "deadline": {"type": "datetime", "value": "2026-11-07 14:00:00"} }] }' # 3.2 同步落到日程(subject/begin_time/end_time 为必填) wecom-cli calendar schedules create --json '{ "subject": "染发 王女士", "attendees": [{"userid": "zhangsan"}], "begin_time": "2026-11-07 14:00:00", "end_time": "2026-11-07 16:00:00" }' # 3.3 忙闲查询(排单前查冲突) wecom-cli calendar schedules free list --json '{ "userids": [{"userid": "zhangsan"}], "begin_time": "2026-11-07 09:00:00", "end_time": "2026-11-07 20:00:00" }'
验收:① 返回 items[0].success = true 并带 todo_id;② 返回 schedule_id;③ 员工在企微里收到待办 + 日程。
# 4.1 建「心源三本账」智能表格(返回 docid,记下来) wecom-cli smartsheet create --json '{ "name": "心源三本账", "sheet_title": "三本账明细", "fields": [ {"field_title": "日期", "field_type": "text"}, {"field_title": "账本", "field_type": "text"}, {"field_title": "金额", "field_type": "number"}, {"field_title": "备注", "field_type": "text"} ] }' # 4.2 写一行账(records 外层要包 values,key 用字段标题;sheet_title 必填) wecom-cli smartsheet records add --json '{ "docid": "dcXXXX", "sheet_title": "三本账明细", "type": "add", "records": [{"values": {"日期": "2026-11-07", "账本": "现金流", "金额": 597, "备注": "王女士染发"}}] }' # 4.3 月度盘账(SQL 查) wecom-cli smartsheet records query --json '{"docid": "dcXXXX", "sql": "SELECT * FROM 三本账明细"}'
验收:企微里出现「心源三本账」智能表格,且能看到「现金流 +597」那一行;4.3 能查出该行。
# 5.1 先拿会话 ID(群聊 / 单聊都在这) wecom-cli message aibot sessions list # ↑ 返回 sessions[],复制目标会话的 chat_id # 5.2 机器人主动发 markdown 日报 wecom-cli message aibot send --json '{ "chat_id": "复制到的chat_id", "msg_type": "markdown", "markdown": {"content": "## 今日营收\n- 现金流 +¥597\n- 升单率 68%\n- 回本进度 41%"} }'
验收:目标群 / 会话收到机器人发的 markdown 日报,返回 success = true。
# 6.1 建「初心美发终生事业库」文档(doc_name / doc_type) wecom-cli doc create --json '{"doc_name": "初心美发终生事业库", "doc_type": "doc"}' # 6.2 查通讯录(keywords 是数组) wecom-cli contact users search --json '{"keywords": ["赵升强"]}'
验收:文档创建返回 docid;通讯录搜出「赵升强」成员信息。
不想手动敲,直接跑脚本(已同步修正字段):
bash 心源_wecom_最小闭环.sh
| 报错 / 现象 | 原因 | 解法 |
|---|---|---|
AuthError 893201 | 未授权 | 执行 wecom-cli auth init(Step 1) |
| 待办 / 表格 / 日程等调用报「无权限」 | 该能力未勾选授权 | 机器人编辑页「可使用权限」勾选对应能力 |
| 字段名报错(unknown field) | 命令字段写错 | wecom-cli <服务> <方法> --doc 查真实字段声明 |
| records 写进去是空 / 格式乱 | 漏了 values 包裹 | 按 Step 4.2 的 {"values": {...}} 结构重写 |
| sessions list 是空的 | 机器人还没有任何会话 | 先在企微里给机器人发一条消息,再 list |
| 验收项 | 通过标志 |
|---|---|
| 授权 | auth show 非 unauthorized |
| 派工单 → 待办 | 员工企微收到待办,返回 todo_id |
| 派工单 → 日程 | 返回 schedule_id,企微日程可见 |
| 三本账 → 智能表格 | 表格出现「现金流 +597」行 |
| 主动推送 | 群收到机器人 markdown 日报 |
| 知识库 → 文档 | 文档建成功,返回 docid |
| 决策点 | 选项 |
|---|---|
| 拿凭证 | 你在企微后台建机器人、开 API 模式、拿 BotID+Secret 发我(或扫码),我即刻跑通最小闭环 |
| 先跑哪条闭环 | 建议先跑 ② 三本账→智能表格(价值最直观)或 ① 派工单→待办(最贴 7.0) |
| 长连接 vs 回调 | 心源场景推荐长连接(内网可跑、实时、可主动推送,BotID+Secret 即可) |
口径说明(实事求是):本蓝图所有命令均为 2026-11-07 沙箱实测 @wecom/cli@1.3.4 的真实命令与资源树;参数枚举(如字段类型、时间字段名)以各命令 --doc 输出的 TypeScript 声明为准,接入时按需对齐。能力授权以企微管理后台实际选项为准。