用途：通过飞书官方开放 API 读取并提取飞书（Lark）文档内容，适合需要把飞书文档、表格内容接入到自动化流程或数据处理管道的场景。
主要能力：支持 docx 新文档（完整内容、块、元数据与结构）、旧版 doc（基础元数据与有限内容）、Sheets（完整表格数据与工作表导航）、Slides（基础元数据，内容提取需额外权限）。输出为结构化 JSON，包含文档元数据、内容块与层级关系；可访问文本、表格、图片、标题、列表等块，支持父子块层级、复杂块文本抽取、表格行列解析、图片 URL 与元数据、内外链解析。支持的块类型包括 text、heading1/2/3、bullet/ordered、table、image、quote、code、equation、divider、page。具备错误诊断、权限校验、token 校验、重试与限流处理，访问令牌缓存以减少 API 调用，凭证不写入日志。
使用方式：先在 ./reference/feishu_config.json 配置 app_id 和 app_secret，并赋予脚本执行权限：chmod +x scripts/read_doc.sh、chmod +x scripts/get_blocks.sh。读取文档需文档 token（形如 https://example.feishu.cn/docx/DOC_TOKEN）。常用命令：./scripts/read_doc.sh "your_doc_token_here"；./scripts/read_doc.sh "docx_token" "doc"；./scripts/read_doc.sh "sheet_token" "sheet"；./scripts/get_blocks.sh "docx_token"；./scripts/get_blocks.sh "docx_token" "block_id"；./scripts/get_blocks.sh "docx_token" "" "true"；python scripts/get_feishu_doc_blocks.py --doc-token "docx_token" --include-children；python scripts/read_feishu_doc.py --doc-token "docx_token" --extract-text-only。所需 API 权限：docx:document:readonly、doc:document:readonly、sheets:spreadsheet:readonly。
限制：需在飞书开放平台创建应用并授权，文档须对应用可见或已共享；访问令牌有效期 2 小时；部分块类型需额外权限；Slides 内容提取需额外权限。常见错误包括 403（权限或共享设置）、404（token 或文档不存在）、令牌过期、99991663/99991664/99991668 等。安全建议：凭据不入版本库，配置文件建议 chmod 600，使用最小权限，开发与生产使用不同应用。