riba2534/feishu-cli

feishu-cli-board

飞书画板全能操作 · 5 种画图路径任选其一： (A) Mermaid/PlantUML 服务端渲染（思维导图/时序图/类图/饼图/流程图/甘特图，整图作为一个节点，飞书自动排版） (B) Mermaid 本地引擎 whiteboard-cli（绕开 par/参与方数等服务端限制，每个节点可点击编辑） (C) SVG 自由作图（任意视觉：飞轮/鱼骨/Dashboard/海报/插画/架构图等，每个 SVG 元素 → 1 个原生节点可单独编辑） → 使用 scripts/svg_to_board.py 把 SVG 翻译为飞书原生节点 (D) 简单 SVG 单节点装饰（图标/印章/小元素，2KB 以内 SVG） (E) 精排架构图（手写节点 JSON，绝对坐标 + 配色 + 连线 ID 引用） 当用户请求"画图/画板/whiteboard/画架构图/画流程图/画飞轮/画鱼骨/画路线图/画 Dashboard/画插画/画海报/ AI 自由作图/SVG 落画板/克隆画板/上传图片到画板/可视化/节点图/精排"时使用。 特别地，当用户反馈"右下角半截楼""z_index 错乱""节点翻倍""复杂图渲染不全""mermaid 服务端失败" 务必读 references/pitfalls.md 排障。 写类（add-board/create-notes/update/delete/clone/svg-import/upload-image/import）使用 App Token（默认 Bot 身份）， 无需登录；即使用户已 auth login，写类命令仍保持 App 身份不切换。 读类（image/nodes/export-code/svg-export/lint）登录后自动用 User Token，未登录回落 App Token。 svg-export 导出整板 SVG 视觉快照（POST /export，base64 解码），对任意画板有效（不限 svg 节点）， 配合 svg_to_board.py / board import 可实现「导出 → 编辑 → 回写」闭环。