Markdown 导入技能

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

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

核心特性

1. 三阶段并发管道：顺序创建块 → 并发处理图表/表格 → 失败回退
2. Mermaid/PlantUML → 飞书画板：mermaid/plantuml/puml 代码块自动转换为飞书画板
3. 图表故障容错：语法错误自动降级为代码块展示，服务端错误自动重试（默认最多 10 次，可用 --diagram-retries 调整）
4. 大表格智能处理：行 > 9 时创建 9 行初始表 + insert_table_row API 追加到同一 block（视觉连贯，每行约 1 次 API 往返；verbose 模式 ≥ 5 行打印进度）；列 > 9 按列组拆分保留首列作为标识。单元格内容填充已走 batch_update 批量加速（v1.29+，#159）：阶段二预热 cellMap 后按批（single-group cell 每批 ≤ 30 个）一次性写入，失败再降级为 per-cell；典型 4×6×8 表从 ~70s 降到 ~3s（25-30x）
5. 表格列宽：默认按内容启发式（中文 14px / 英文 8px，最小 80px，最大 400px）。可通过紧邻表格上方注释 <!-- feishu-colwidth: 80,200,*,30% -->（单位 px / 百分比 / * 走 auto）或 CLI flag --table-column-width=auto|fixed|N1,N2,... 全局覆盖；注释优先级高于 flag
6. API 限流自动重试：画板创建和图表导入遇到 HTTP 429 时自动重试，读取服务端 x-ogw-ratelimit-reset 响应头精确计算退避时间，采用指数退避策略，默认最多重试 10 次
7. 并发控制：图表和表格分别使用独立的 worker 池（默认图表 5、表格 3 并发）
8. 表格单元格图片真嵌入（#164）：Markdown 表格单元格内的本地/网络图片，会在表格填充完成后（阶段 2.5）真正嵌入为单元格内的 Image 子块，而非丢失或退化为文字。细节：纯图片单元格不会把图片说明（alt）串成多余的标题文字；嵌入失败或单元格对不齐的图片计入统计 cell_image_failed 并打印，不静默丢弃；上传失败的空图块会被清理并补占位文本。仅 doc import 走真嵌入，doc add/content-update 等非导入场景的单元格图片降级为 [图片: 说明] 占位文本。JSON 输出新增 cell_image_total/success/failed

核心概念