feishu-cli-import
Installation
SKILL.md
Markdown 导入技能
从本地 Markdown 文件创建或更新飞书云文档。支持 Mermaid/PlantUML 图表转飞书画板、大表格智能处理(行 > 9 单 block API 追加;列 > 9 拆分保留首列)。
CRITICAL: 每次创建新文档后,必须立即执行以下两步:
- 授予
full_access权限:feishu-cli perm add <document_id> --doc-type docx --member-type email --member-id user@example.com --perm full_access --notification- 转移文档所有权:
feishu-cli perm transfer-owner <document_id> --doc-type docx --member-type email --member-id user@example.com --notification详见下方"执行流程 → 创建新文档"。
核心特性
- 三阶段并发管道:顺序创建块 → 并发处理图表/表格 → 失败回退
- Mermaid/PlantUML → 飞书画板:
mermaid/plantuml/puml代码块自动转换为飞书画板 - 图表故障容错:语法错误自动降级为代码块展示,服务端错误自动重试(最多 20 次)
- 大表格智能处理:行 > 9 时创建 9 行初始表 +
insert_table_rowAPI 追加到同一 block(视觉连贯,每行约 1 次 API 往返;verbose 模式 ≥ 5 行打印进度);列 > 9 按列组拆分保留首列作为标识 - 表格列宽自动计算:根据内容智能计算列宽(中英文区分,最小 80px,最大 400px)
- API 限流自动重试:画板创建和图表导入遇到 HTTP 429 时自动重试,读取服务端
x-ogw-ratelimit-reset响应头精确计算退避时间,采用指数退避策略,默认最多重试 20 次 - 并发控制:图表和表格分别使用独立的 worker 池(默认图表 5、表格 3 并发)
Related skills