飞书文档阅读技能 从飞书云文档或知识库读取内容，转换为 Markdown 格式后进行分析和展示。 前置条件 已完成认证（ feishu-cli auth login ） 需要 docx:document 或 wiki:wiki:readonly 权限 核心概念 Markdown 作为中间态 ：本地文档与飞书云文档之间通过 Markdown 格式进行转换，中间文件存储在 /tmp 目录中。 使用方法 /feishu-read < document_id
/feishu-read < node_token
/feishu-read < url
执行流程 解析参数 判断 URL 类型： /docx/ → 普通文档，使用 doc export /wiki/ → 知识库文档，使用 wiki export 如果是 Token，根据格式判断类型 导出为 Markdown（含图片下载） 普通文档 : feishu-cli doc export < document_id
--output /tmp/feishu_doc.md --download-images --assets-dir /tmp/feishu_assets 知识库文档 : feishu-cli wiki export < node_token
--output /tmp/feishu_wiki.md --download-images --assets-dir /tmp/feishu_assets 重要 ：务必使用 --download-images 参数下载文档中的图片到本地，否则只能看到 feishu://media/
引用，无法理解图片内容。 可选参数 ： --front-matter ：在 Markdown 顶部添加 YAML front matter（含标题和文档 ID） --highlight ：保留文本颜色和背景色（输出为 HTML 标签） --expand-mentions ：展开 @用户为友好格式（默认开启，需要 contact:user.base:readonly 权限） 读取文本内容 使用 Read 工具读取导出的 Markdown 文件 分析文档结构和文本内容 读取并理解图片内容 检查 --assets-dir 指定的目录是否有下载的图片 使用 Read 工具逐个读取图片文件 （Claude 支持多模态，可直接理解图片内容） 将图片内容整合到文档分析中
列出下载的图片
ls /tmp/feishu_assets/
使用 Read 工具查看图片
Read /tmp/feishu_assets/image_1.png
Read /tmp/feishu_assets/image_2.png
报告结果
提供文档摘要（包含图片内容描述）
保留 Markdown 文件和图片供用户进一步操作
输出格式
向用户报告：
文档标题
文档结构概要（标题层级）
内容摘要（关键信息）
图片内容描述（如有图片）
Markdown 文件路径（供后续使用）
图片文件路径（如有下载）
支持的 URL 格式
URL 格式
类型
命令
https://xxx.feishu.cn/docx/
读取普通文档
/feishu-read < document_id
/feishu-read https://xxx.feishu.cn/docx/ < document_id
读取知识库文档
/feishu-read < node_token
/feishu-read https://xxx.feishu.cn/wiki/ < node_token
导出格式说明 导出的 Markdown 支持以下飞书特有块类型的转换： 飞书块类型 Markdown 表现 Callout 高亮块 [!NOTE] 、 [!WARNING] 等 6 种 GitHub-style alert 块级/行内公式 $formula$ （LaTeX 格式） 画板 (Board) 画板/Whiteboard 链接 ISV 块 (Mermaid) 画板链接 QuoteContainer
引用语法（支持嵌套） AddOns/SyncedBlock 透明展开子块内容 Iframe