{"skill":{"slug":"feishu-doc-long-content","displayName":"feishu-doc-long-content","summary":"Create Feishu Docs by first creating an empty doc, then write content in chunks under 800 bytes to avoid truncation or errors.","description":"# feishu-doc-long-content\n\n> 飞书文档长内容写入实战经验，解决 content 超长截断问题\n\n## 问题背景\n\n飞书文档工具 `feishu_doc` 的 `write` / `create` action 对单次 `content` 长度有限制（约 1KB），超出后会：\n- 直接返回 400 错误\n- 或部分写入后截断（显示空白）\n\n## 核心要点\n\n### 1. create 只是创建空白文档\n\n```json\n{\n  \"action\": \"create\",\n  \"title\": \"新文档\"\n}\n```\n返回 `doc_id`，但文档内容是空的。\n\n### 2. 必须用 write 写入内容\n\n```json\n{\n  \"action\": \"write\",\n  \"doc_token\": \"ABC123\",\n  \"content\": \"# 标题\\n内容...\"\n}\n```\n\n### 3. content 必须控制在 1KB 以内\n\n经验值：\n- **< 800 字节**：安全写入\n- **800-1500 字节**：可能失败\n- **> 1500 字节**：基本失败\n\n### 4. 长内容解决方案\n\n**方案A：拆分章节**\n将内容拆成多个小文档，每个 < 800 字节：\n```\n文档1：第1-2章\n文档2：第3-4章\n文档3：第5-6章\n文档4：第7-8章\n```\n\n**方案B：多次 append**\n创建文档后，分多次 append（但 append 也有累积限制）\n\n**方案C：先存本地文件**\n将内容写入本地 md 文件，让用户自己查看或转换\n\n## 正确流程\n\n```json\n// 1. 创建文档\n{ \"action\": \"create\", \"title\": \"笔记 Ch1\" }\n// → { \"doc_id\": \"ABC123\", \"url\": \"...\" }\n\n// 2. 写入内容（控制 < 800 字节）\n{ \"action\": \"write\", \"doc_token\": \"ABC123\", \"content\": \"精简版内容...\" }\n\n// 3. 验证\n{ \"action\": \"read\", \"doc_token\": \"ABC123\" }\n```\n\n## 常见错误\n\n| 错误表现 | 原因 | 解决方案 |\n|---------|------|---------|\n| 文档创建后空白 | create 后没写 content | 用 write 写入 |\n| write 返回成功但内容截断 | content 超过 1KB | 拆分内容 |\n| write 返回 400 错误 | content 过长 | 精简内容或拆分 |\n\n## 判断内容长度\n\n在写入前估算：\n- 纯文本：约 1 字符 = 1 字节\n- Markdown：约 1 字符 = 1 字节（含格式符）\n- 经验：800 字符约等于 800 字节（中文英文混合时略大）\n\n## 最佳实践\n\n1. **先在本地写 md 文件**，确认内容完整\n2. **写入飞书前精简**，移除冗余格式和重复内容\n3. **分章节输出**，每章一个文档\n4. **写入后立即验证**，用 read 检查 block_count\n\n---\n\n*经验来源：2026-02-25 初级会计实务笔记输出实战*\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":973,"installsAllTime":1,"installsCurrent":1,"stars":0,"versions":1},"createdAt":1772001011314,"updatedAt":1778491636632},"latestVersion":{"version":"1.0.0","createdAt":1772001011314,"changelog":"- Initial release describing solutions for Feishu Doc content length limitations.\n- Explains the <1KB content constraint for write/create actions and common failure modes.\n- Details recommended practices: content splitting, incremental write, and local file fallback.\n- Provides workflow and error troubleshooting table for document creation and content insertion.\n- Offers tips for estimating safe content size and maintaining document integrity.","license":null},"metadata":null,"owner":{"handle":"josephyb97","userId":"s17dkjgw9j4nq05b4885rtz99583nsbr","displayName":"Josephyb97","image":"https://avatars.githubusercontent.com/u/59716535?v=4"},"moderation":null}