飞书文档读写 (feishu-doc)

解决什么问题

AI 助手无法直接读写飞书文档——不能帮你查文档内容、不能帮你写周报、不能操作知识库。

工具名

feishu_doc，通过 action 参数区分动作。

URL → Token

https://xxx.feishu.cn/docx/ABC123def → doc_token = ABC123def

核心操作

读文档

{ "action": "read", "doc_token": "xxx" }

返回纯文本 + block 统计。如有表格/图片需进一步用 list_blocks。

写文档（全量替换）

{ "action": "write", "doc_token": "xxx", "content": "# Markdown内容" }

支持 Markdown 标题/列表/代码块/引用/链接/图片。不支持 Markdown 表格。

追加内容

{ "action": "append", "doc_token": "xxx", "content": "追加内容" }

创建文档

{ "action": "create", "title": "新文档" }

可加 folder_token 指定目录。

列出所有 Block

{ "action": "list_blocks", "doc_token": "xxx" }

获取完整结构化数据（表格、图片等）。

更新单个 Block

{ "action": "update_block", "doc_token": "xxx", "block_id": "xxx", "content": "新文本" }

删除 Block

{ "action": "delete_block", "doc_token": "xxx", "block_id": "xxx" }

读取流程

1. 先 read → 查看返回的 block_types
2. 如果有 Table/Image → 再 list_blocks 拿完整数据

前置条件

• 飞书应用已配置 appId + appSecret
• 所需权限：docx:document, docx:document:readonly, docx:document.block:convert, drive:drive
• 文档需授权给应用（或设为可阅读）