AI 造 AI 工作台 · 终局蓝图

企业微信 CLI × 心源 7.0
接入蓝图 —— 让工作台长出「手」

从「AI 造了个工具给人用」升级到「AI 自己派单、自己记账、自己汇报、自己治理」。

版本 v2 · 2026-11-07 CLI 实测版本 1.3.4 对应 三杯配方单 7.0 作者 · 心源(刘永睿)
一句话结论(先看这条):企业微信 CLI 已经让 AI 有了「手」——它能以机器人身份,直接读写企业微信的消息、待办、日程、智能表格、文档、会议、微盘、通讯录、邮件。心源 7.0 现在是「单机版」工作台,接了它,就变成「长在真实协作系统上、能自己跑」的工作台。这正是你说的「自理 + 治理」两条腿同时落地。

一CLI 到底长什么样神经末梢级 · 实测确认

统一调用格式:wecom-cli <服务> [资源] <方法> --json '<请求体>'

本蓝图所有命令均为本次沙箱实测安装(v1.3.4)并逐一验证得到的真实命令,非文档转述。

服务命令前缀能干什么(资源树摘要)
授权authinit 初始化机器人 / show 查看授权状态
消息messagesend 发文本 · aibot send 机器人发 markdown/图/文件 · aibot sessions list 取最近会话
待办todocreate / list / get / update / finish / delete(批量,最多 20 条)
日程calendarschedules create/get/list/update/cancel · free list 忙闲查询
智能表格smartsheetcreate 建表 · records add/list/query/update 记录 CRUD(支持 SQL)· fields/views/charts
表格sheetcreate · cells set/get/append · ranges get · formulas 等(A1 表示法)
文档doccreate(doc/sheet/smartsheet/ppt)· contents get/append/overwrite · members 权限
智能文档smartpagecreate · import markdown · blocks/pages 编辑
会议meetingcreate/list/get/update/cancel · original get 拉纪要转写 · rooms 查会议室
微盘diskfiles upload/download/search/rename · folders create
通讯录contactusers search 按关键词搜成员
邮件mailsend / search / get
素材mediaupload 得 media_id / download
幻灯片slidePPT 编辑(2026/10 新增)
三条关键机制(比命令本身更重要):
① 机器人身份代理——CLI 以机器人身份代替成员调用,每个能力都要成员单独授权,权限边界天生清晰(治理的根);
② 双向通信——既能被动回,也能主动推,AI 异步结果实时送达(自理的根);
③ CLI / MCP / Skill 三层——CLI 是命令、MCP 是协议、Skill 是写给 LLM 的「说明书」,AI 能自己学会用工具(AI 造 AI 的根)。

二终局架构:脑 · 手 · 制度自理 + 治理,缺一不可

层是什么心源怎么落
脑已有决策(配方引擎 / 定价 / 派工单)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 才能读写该能力数据。想跑「派工单→待办」,先授权「待办」能力;想跑「三本账→智能表格」,先授权「智能表格」能力。这是「治理」的落地——权限是显式的、可收回的、有边界的。

五本次实测结果实事求是

验证项结果
CLI 安装✅ 通过 @wecom/cli 装成功,v1.3.4,仅 2 个包、极轻
命令结构✅ 通过 15 个服务 + 全部资源树已逐一摸清
命令格式✅ 通过 --json 请求体格式实测可解析
真实调用⚠️ 卡在授权 报 AuthError 893201:需先 auth init 登录
结论:链路已通到「授权」这一环。CLI 本体、命令格式、能力边界全部验证无误,唯一缺的是你的机器人凭证(BotID + Secret,或扫码)。拿到凭证,最小闭环即可一键跑通。

六一键跑通脚本拿到凭证即执行

已为你准备好脚本 心源_wecom_最小闭环.sh:授权 → 建一条待办 → 建智能表格并写一行账 → 查通讯录,四步验证全链路。

# 使用:拿到 BotID/Secret 后执行
bash 心源_wecom_最小闭环.sh

七接凭证后的完整跑通步骤拿到 BotID + Secret 后 · 照此逐条执行

本页是执行手册,不是概念说明。拿到 BotID + Secret(长连接)后,从 Step 0 到 Step 6 逐条照做,每步都写了验收标准;卡住就翻报错排查表。所有命令字段均已按 --doc 实测的 TypeScript 声明逐字核对。

准备三样东西(动手前确认)

准备项怎么确认
BotID + Secret机器人编辑页 → API 模式 → 长连接 → 复制 BotID、Secret(Secret 只显示一次,先存好)
能力授权机器人编辑页 →「可使用权限」→ 勾选 待办 / 日程 / 智能表格 / 消息 / 文档 / 通讯录(跑哪条闭环勾哪个)
CLI 已装命令行输 wecom-cli --version,显示 1.3.4+ 即可

Step 0 · 安装 CLI

# 全局安装(若已装可跳过)
npm i -g @wecom/cli
wecom-cli --version   # 确认 ≥ 1.3.4

验收:输出版本号即通过。

Step 1 · 授权(二选一)

方式 A · 扫码(推荐,有浏览器 / 手机时):

wecom-cli auth init
# 无浏览器环境:把二维码存成图片,手机扫码
wecom-cli auth init --output-qrcode /tmp/qr.png

方式 B · 手动(服务器无扫码条件):

wecom-cli auth init --manual
# 按提示依次输入 BotID 和 Secret

验收:命令行提示「授权成功」,无报错。

Step 2 · 验证授权

wecom-cli auth show

验收:状态不再是 unauthorized。若仍显示未授权,回到 Step 1 重试。

Step 3 · 闭环① 派工单 → 待办 + 日程

# 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;③ 员工在企微里收到待办 + 日程。

Step 4 · 闭环② 三本账 → 智能表格

# 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 能查出该行。

Step 5 · 闭环③ 主动推送 → 消息

# 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。

Step 6 · 闭环④ 知识库 → 文档 + 通讯录

# 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
跑通后下一步:把这 6 步的调用逻辑接进 7.0 的「派工单引擎 / 三本账 / 决策看板」,让 AI 在网页里点「生成工单 / 记一笔」时自动触发对应 CLI 命令——那时「AI 造的工作台」才算真正「长出了手、自己会跑」。

八待你拍板下一步

决策点选项
拿凭证你在企微后台建机器人、开 API 模式、拿 BotID+Secret 发我(或扫码),我即刻跑通最小闭环
先跑哪条闭环建议先跑 ② 三本账→智能表格(价值最直观)或 ① 派工单→待办(最贴 7.0)
长连接 vs 回调心源场景推荐长连接(内网可跑、实时、可主动推送,BotID+Secret 即可)

口径说明(实事求是):本蓝图所有命令均为 2026-11-07 沙箱实测 @wecom/cli@1.3.4 的真实命令与资源树;参数枚举(如字段类型、时间字段名)以各命令 --doc 输出的 TypeScript 声明为准,接入时按需对齐。能力授权以企微管理后台实际选项为准。