feishu-cli-import

Installation
SKILL.md

Markdown 导入技能

从本地 Markdown 文件创建或更新飞书云文档。支持 Mermaid/PlantUML 图表转飞书画板、大表格智能处理(行 > 9 单 block API 追加;列 > 9 拆分保留首列)

CRITICAL: 每次创建新文档后,必须立即执行以下两步:

  1. 授予 full_access 权限:feishu-cli perm add <document_id> --doc-type docx --member-type email --member-id user@example.com --perm full_access --notification
  2. 转移文档所有权:feishu-cli perm transfer-owner <document_id> --doc-type docx --member-type email --member-id user@example.com --notification

详见下方"执行流程 → 创建新文档"。

核心特性

  1. 三阶段并发管道:顺序创建块 → 并发处理图表/表格 → 失败回退
  2. Mermaid/PlantUML → 飞书画板mermaid/plantuml/puml 代码块自动转换为飞书画板
  3. 图表故障容错:语法错误自动降级为代码块展示,服务端错误自动重试(最多 20 次)
  4. 大表格智能处理:行 > 9 时创建 9 行初始表 + insert_table_row API 追加到同一 block(视觉连贯,每行约 1 次 API 往返;verbose 模式 ≥ 5 行打印进度);列 > 9 按列组拆分保留首列作为标识
  5. 表格列宽自动计算:根据内容智能计算列宽(中英文区分,最小 80px,最大 400px)
  6. API 限流自动重试:画板创建和图表导入遇到 HTTP 429 时自动重试,读取服务端 x-ogw-ratelimit-reset 响应头精确计算退避时间,采用指数退避策略,默认最多重试 20 次
  7. 并发控制:图表和表格分别使用独立的 worker 池(默认图表 5、表格 3 并发)
Related skills
Installs
565
GitHub Stars
957
First Seen
Feb 8, 2026