❌ 常见问题

问题：飞书文档内容为空

现象： 使用feishu_doc工具创建文档后，文档内容为空，只有标题。

根本原因：

✅ 正确的操作流程

步骤1：创建文档（获取document_id）

feishu_doc create --title "文档标题" --content "临时占位（会被忽略）"

返回：
{
  "document_id": "xxx",
  "title": "文档标题",
  "url": "https://feishu.cn/docx/xxx"
}

步骤2：写入内容（关键步骤！）

feishu_doc write --doc_token "xxx" --content "完整的Markdown内容"

返回：
{
  "success": true,
  "blocks_added": 40,
  "blocks_deleted": 0
}

步骤3：验证内容（可选）

feishu_doc read --doc_token "xxx"

返回：
{
  "title": "文档标题",
  "content": "完整内容...",
  "block_count": 41
}

⚠️ API限制

字符限制

分段上传策略

# 方案1：按段落分割
content_part1 = "第一部分内容..."
content_part2 = "第二部分内容..."

# 方案2：按字符数分割
max_chars = 3000
parts = [content[i:i+max_chars] for i in range(0, len(content), max_chars)]

# 逐段上传
for part in parts:
    feishu_doc write --doc_token "xxx" --content part

📝 已记录到核心记忆

MEMORY.md更新内容

在MEMORY.md中添加了"飞书集成最佳实践"部分，包含：

TOOLS.md更新内容

在TOOLS.md中添加了详细的"飞书文档操作最佳实践"，包含：

🎯 效果

✅ 已解决

🔗 相关链接

飞书文档问题已彻底解决！ 🚀