===========================================
原子动作 028 - 写入飞书文档
===========================================

【这个动作是干啥的】
把内容写入飞书文档，支持分块写入避免 400 错误。

【输入是啥】
- Markdown 内容（要写入的文本）
- 飞书文档 Token（从 URL 提取，如 GeG0dywMxof8dLx1tcUckSFNndh）

【输出是啥】
- 写入成功/失败（true/false）
- 写入的 blocks 数量

【什么时候用】
- 创建飞书文档时
- 更新飞书文档时
- 内容超过 200 blocks 时（必须分块）

【注意事项】
- ⚠️ 单次写入≤200 blocks（避免 400 错误）
- ✅ 分块大小：30-50 blocks 最安全
- ✅ 第 1 块用 write 模式（覆盖）
- ✅ 后续块用 append 模式（追加）
- ✅ 400 错误时自动减小分块重试
- 🆕 **每次更新后必须更新版本记录表**（新增一行）
- 🆕 **文档头部版本号必须同步更新**（V1.2 → V1.3）
- 🆕 **增量更新原则：不覆盖历史，只追加新内容**

【对应阿福的 MD 文件】
atomic-actions/03-delivery/ATOM-FEISHU-028-写入飞书文档.md

【举个例子】
场景 1：创建文档
你：把 28 个原子动作表格写入飞书文档
阿福：1. 估算 402 blocks（超过 200）
     2. 分 3 块：181 + 178 + 43
     3. 第 1 块 write（标题 + 数据层 + 呈现层）
     4. 第 2 块 append（交付层 + 分析层 + IO 层 + 工具层）
     5. 第 3 块 append（更新日志 + 使用说明）
     6. 返回：✅ 写入成功，共 402 blocks

场景 2：增量更新 🆕
你：添加 SKILL-TTS-001 和 SKILL-SYNC-001
阿福：1. 读取当前版本：V1.2
     2. 生成新版本：V1.3
     3. 写入新内容（Skills 章节）
     4. 更新版本记录表（新增 V1.3 行）
     5. 更新时间：2026-03-07 15:42
     6. 更新人：阿福
     7. 返回：✅ 版本已更新 V1.2 → V1.3

【核心原则】
> 飞书长文档必须分块写入！

【失败案例】
❌ 一次性写入 402 blocks → 400 错误 → 文档空白

【成功案例】
✅ 分 3 块写入（181 + 178 + 43）→ 成功 → 文档完整

===========================================
创建时间：2026-03-07 13:55
最后更新：**2026-03-07 15:57**（新增版本记录更新流程）
===========================================
