feishu-cli-import

SKILL.md

Markdown 导入技能

从本地 Markdown 文件创建飞书云文档，或把 Markdown 追加导入到已有文档。支持 Mermaid/PlantUML 图表转飞书画板、大表格智能处理（行 > 9 单 block API 追加；列 > 9 拆分保留首列）。

Owner 规则：创建新文档后如需交付给用户，先解析 FEISHU_OWNER_EMAIL 或配置文件 owner_email。只在解析到 owner 时授予 full_access；只在 transfer_ownership=true 时转移所有权。不要把示例邮箱当成真实接收人。

核心特性

三阶段并发管道：顺序创建块 → 并发处理图表/表格 → 失败回退

Mermaid/PlantUML → 飞书画板：mermaid/plantuml/puml 代码块自动转换为飞书画板

图表故障容错：语法错误自动降级为代码块展示，服务端错误自动重试（默认最多 10 次，可用 --diagram-retries 调整）

大表格智能处理：行 > 9 时创建 9 行初始表 + insert_table_row API 追加到同一 block（视觉连贯，每行约 1 次 API 往返；verbose 模式 ≥ 5 行打印进度）；列 > 9 按列组拆分保留首列作为标识

表格列宽自动计算：根据内容智能计算列宽（中英文区分，最小 80px，最大 400px）

API 限流自动重试：画板创建和图表导入遇到 HTTP 429 时自动重试，读取服务端 x-ogw-ratelimit-reset 响应头精确计算退避时间，采用指数退避策略，默认最多重试 10 次

并发控制：图表和表格分别使用独立的 worker 池（默认图表 5、表格 3 并发）

核心概念

Markdown 作为中间态：本地文档与飞书云文档之间通过 Markdown 格式进行转换。