一句话的事：你把企业微信文档或智能表格的链接发过来，AI 自动读取内容、交叉分析、生成可视化报告。不用导出 Excel，不用手动整理。下面是已经跑通的路径，以及踩过的坑。
企微的文档锁在企业内部，外面的程序读不了。机器人就是那张门禁卡——它替 AI 证明「这次访问是企业授权的」，企微才放行。
"分析这张表"
带着企业身份
核实身份+权限
表格/文档内容
出洞察、出报告
打个比方：企微文档是公司保险柜里的文件，AI 是请来的顾问。顾问不能自己翻保险柜，但你可以给他一张你名下的门禁卡（机器人），他刷卡进去帮你取文件。卡必须是你发的——只有卡的主人能决定它的权限。
全程不需要导出 Excel，不需要手动整理。普通用户只管说需求，剩下交给 AI。
把企微文档 / 智能表格链接直接发给 AI
机器人刷卡进去，把数据完整读出来
自动交叉对比、找异常、发现机会
生成可视化 HTML / 导出 Excel / 直接给结论
不是纸上谈兵。下面两个案例都基于同一张真实的企微智能表格（85 条客户线索），附上了原始文档和生成结果，点开即可对照。
给开发同学的底层命令。普通用户不必关心，直接跟 AI 说需求即可。
# ── 智能表格 SmartSheet ── wecom-cli doc smartsheet_get_sheet # 获取子表列表 wecom-cli doc smartsheet_get_fields # 读取字段定义 wecom-cli doc smartsheet_get_records # 读取全部记录 wecom-cli doc smartsheet_update_records # 更新记录（仅自建表） wecom-cli doc smartsheet_add_records # 新增记录（仅自建表） # ── 电子表格 Sheet ── wecom-cli doc sheet_get_info # 获取工作表信息 wecom-cli doc sheet_get_cell_data # 读取单元格 wecom-cli doc sheet_set_cell_value # 写入单元格 wecom-cli doc sheet_set_range_value # 批量写入范围 # ── 文档 Doc ── wecom-cli doc get_content # 读取文档内容 wecom-cli doc insert_text # 插入文本 wecom-cli doc insert_table # 插入表格 wecom-cli doc replace_text # 查找替换 # ── 鉴权 ── wecom-cli auth show # 查看当前授权状态
实际用的时候踩过的坑，提前知道能省不少时间。
某天调接口突然报"机器人使用权限已过期"。不是你代码的问题，是企微那边过期了。而且只有机器人的创建者能重新授权，别人扫码会被拒。
851003：别人建的表写不进去想往智能表里填日期，怎么都写不进去。一开始以为是日期格式问题，试了 3 种格式都不行——最后测了一下，连普通的数字字段也写不了。真相是企微的硬规则：机器人只能写自己创建的文档，别人建的表只有只读权限。
智能表的日期字段（DATE_TIME）只接受数字或字符串，传 {timestamp: xxx} 这种 dict 会直接报类型错误，纯毫秒时间戳报 2640027。这俩错误码都不直白，难分清是格式还是权限。
曾误导用户去"文档分享设置里把机器人加为协作者"，结果翻遍也没找到。不是不会操作，是企微根本没设计这个入口——机器人不会出现在协作者列表里。这条指引本身就是错的。
比如"二级行业"字段，有人填"通用saas"、有人填"通用SaaS"、有人填"saas"——系统当三个不同值统计，结果就偏了。项目阶段也有大量空行。