⚡

飞书文档工具Skill feishu-doc

飞书文档工具是一个用于自动化读写和管理飞书云文档的API接口工具。它支持读取文档内容、写入或替换文档、追加内容、创建新文档、以及精细化的区块操作（如列出、获取、更新、删除文档中的表格、图片等结构化区块）。该工具通过解析文档令牌（doc_token）和指定操作（action）参数，实现对飞书文档的全面程序化控制，适用于文档自动化处理、内容批量更新、数据提取与整合等场景。关键词：飞书文档 API，文档自动化，云文档管理，内容读写，区块操作，飞书集成，办公自动化。

后端开发 6 次安装 416 次浏览 更新于 2/24/2026

name: feishu-doc description: | 飞书文档读写操作。当用户提及飞书文档、云文档或docx链接时激活。

飞书文档工具

单一工具 feishu_doc，通过action参数处理所有文档操作。

令牌提取

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

操作

读取文档

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

返回：标题、纯文本内容、区块统计。检查 hint 字段 - 如果存在，则表示有结构化内容（表格、图片），需要调用 list_blocks。

写入文档（全部替换）

{ "action": "write", "doc_token": "ABC123def", "content": "# 标题

Markdown内容..." }

用Markdown内容替换整个文档。支持：标题、列表、代码块、引用、链接、图片（![](url) 自动上传）、粗体/斜体/删除线。

限制： 不支持Markdown表格。

追加内容

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

将Markdown内容追加到文档末尾。

创建文档

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

指定文件夹：

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

列出区块

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

返回完整的区块数据，包括表格、图片。使用此操作读取结构化内容。

获取单个区块

{ "action": "get_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }

更新区块文本

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

删除区块

{ "action": "delete_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }

读取工作流

  1. 从 action: "read" 开始 - 获取纯文本和统计信息
  2. 检查响应中的 block_types，查看是否存在表格、图片、代码等
  3. 如果存在结构化内容，使用 action: "list_blocks" 获取完整数据

配置

channels:
  feishu:
    tools:
      doc: true # 默认: true

注意： feishu_wiki 依赖此工具 - 知识库页面内容通过 feishu_doc 读写。

权限

所需权限：docx:document, docx:document:readonly, docx:document.block:convert, drive:drive