把飞书数据流变成可重跑工作流 — 文档、Base、日历与群组#

会跑一条命令不等于能上生产。本节用两个高频工作流，把版本检查、字段映射、分页、幂等、写前预演和写后校验串起来。

0. 一句话先讲明白#

一个可靠的 CLI 工作流至少有五段：

1. 固定版本与身份；
2. 先读 schema 和源数据；
3. 把转换逻辑留在本地、把业务 ID 留在状态中；
4. 写前 --dry-run，写后再读取校验；
5. 把 JSON 结果与退出码一起纳入自动化断言。

下面的 token、ID、标题都使用公开占位符。复制时替换成你自己的资源，不要把真实 token 写进仓库。

1. 工作流一：文档 → 多维表格索引#

目标：读取一份飞书文档，把标题、来源 token 和同步状态写入 Base。真正的正文解析和字段映射发生在本地，CLI 只负责可靠地读写飞书。