飞书文档写入最佳实践

适用场景：新建知识库文档、写入 >50 block 的内容、知识图谱/索引页/读书笔记等复杂文档

⚠️ 核心原则

1. 永远用 write 写新文档，不用 insert/append

   • insert/append 在大文档上会触发 ordering conflict（血泪教训：铁路文档死 5 次、读书笔记 conflict）
   • write 全量替换新文档 = 零 conflict

2. 不要先 feishu_doc create 再 feishu_wiki create

   • 这样会建出两个文档（一个云盘、一个知识库），需要手动清理
   • 正确做法：只用 feishu_wiki create，它本身就会建空文档

3. 内容在本地完全组装好，再一次性写入

   • 不要边想边写边调 API
   • 先把全部 markdown 准备好，然后一个 write 搞定