用途:用于飞书(Feishu)云文档的读写操作,当用户提到飞书文档、云文档或 docx 链接时激活。所有操作通过单一工具 feishu_doc 配合 action 参数完成。
Token 提取:从链接 https://xxx.feishu.cn/docx/ABC123def 中取 doc_token = ABC123def。
主要能力与用法: 读取:{"action": "read", "doc_token": "ABC123def"},返回标题、纯文本内容与块统计;若响应含 hint 字段,说明存在表格、图片等结构化内容,需改用 list_blocks。 写入(整体替换):{"action": "write", "doc_token": "ABC123def", "content": "# Title\n\nMarkdown content..."},用 Markdown 替换整篇文档,支持标题、列表、代码块、引用、链接、图片( 自动上传)、粗体/斜体/删除线。限制:不支持 Markdown 表格。 追加:{"action": "append", "doc_token": "ABC123def", "content": "Additional content"},将 Markdown 追加到文档末尾。 创建:{"action": "create", "title": "New Document"},可加 folder_token 指定文件夹。 列出块:{"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": "New text"}。 删除块:{"action": "delete_block", "doc_token": "ABC123def", "block_id": "doxcnXXX"}。
读取流程:先用 read 获取纯文本与统计,检查响应中的 block_types 是否含 Table、Image、Code 等,若有结构化内容再用 list_blocks 取完整数据。
配置:channels.feishu.tools.doc 设为 true(默认 true)。注意 feishu_wiki 依赖此工具,wiki 页面内容通过 feishu_doc 读写。
所需权限:docx:document、docx:document:readonly、docx:document.block:convert、drive:drive。