feishu-whiteboard-pro

name	feishu-whiteboard-pro
version	1.1.0
description	创建、修改、换肤和评审真正经过设计的可编辑飞书白板。适用于信息图、流程图、系统图、 时间线、决策板、海报和可视化讲解：先锁定内容事实与设计简报，再按白板媒介构图，机械检查 SVG，查看真实渲染，并在重要交付前做独立终审；避免等大卡片网格和凭空补造关系。飞书写入 使用扣子平台授权，授权暂不可用时仍交付本地 SVG + PNG。
dependency	{"python":["requests==2.31.0"]}

飞书白板大师

产出写进飞书文档、可继续编辑的 SVG 白板。媒介刻意受限：单一字体、原生矩形/圆/连接线， 无渐变、滤镜、透明度和动效。质量来自事实、构图、层级、节奏、对比和留白。

共通契约

• 用户简报优先。 明确的品牌、配色、参考、密度和风格要求胜过默认偏好。
• 修改要保留，重设计才替换。 修复不改事实、关系、拓扑和视觉身份；换肤不重排信息。
• 每条线都是事实。 不为版面完整而发明箭头、数字、引语、分类、负责人、状态或因果关系； 自拟演示内容必须明确标为示例。
• 机械检查与审美判断分开。 脚本负责可测缺陷，评审负责事实忠实度、阅读路径和五轴设计。
• 检查有上限。 看一次、批量修、确认一次；之后只清剩余确定性错误，不无限抛光。

先路由，再加载

每次构建或修改都读 RULES.md，然后只加载一条工作流：

请求	工作流
新白板或替换整套构图	references/create.md
修复、重构、换肤、简化已有白板	references/revise.md
评审、诊断、决定是否可交付	references/critique.md

按需再读：重构读 COMPOSITION.md；选色只读 CATALOG.md 和选中的一个模板；评审读 CRITIQUE.md；只有锚点都不合适才读 templates/GENERATE.md。

授权与运行环境

扣子以用户本人身份写入飞书，运行时自动注入 COZE_FEISHU_WHITEBOARD_<后缀>；代码不碰 OAuth，不需要自建应用或填写密钥。凭证只存在于扣子「调试/预览」的技能运行时。

写飞书前运行：

python3 scripts/feishu_write.py --check

READY 才发布。NOT_READY 时把脚本指引原样转达用户；不要改用 lark-cli，不要自造授权 链接。授权不可用不阻塞本地设计、检查和 SVG + PNG 交付。详见 CREDENTIALS.md。

构建与检查

1. 按所选 workflow 写内容/事实契约和设计简报。开放或高风险任务才给三个廉价黑白 wireframe；明确小任务直接做。

2. 有匹配拓扑时从 examples/*.svg 起步，但重新检查旧箭头和 meta 文案。

3. 运行确定性检查：

   node scripts/fit-check.mjs <dir>/diagram.svg
   

4. 渲染并真正查看紧边本地图：

   npx -y @larksuite/whiteboard-cli@^0.2.11 \
     -i <dir>/diagram.svg -o <dir>/diagram.png -f svg
   

5. 批量修一轮并确认一轮。重要交付在平台支持子 agent 时使用 agents/whiteboard-finish-reviewer.md；否则按同一输入/输出契约做一次结构化自评。

发布与交付

用户要求写入飞书且 --check 为 READY 时运行：

python3 scripts/feishu_write.py --svg <dir>/diagram.svg --title "标题" --image <dir>/board.png

返回文档链接和白板 token。board.png 是飞书补白后的方形核对图，只用于验证实板；文字颜色 以实时文档为准。

最终交付飞书文档链接（发布成功时）+ diagram.svg + 紧边 diagram.png。授权不可用时交付 后两者，并说明只差哪一步授权。

文件

• RULES.md：媒介硬规则与真值约束。
• references/：创建、修改、评审工作流，每次只读一条。
• COMPOSITION.md：构图原型、字号、间距、反套路。
• CRITIQUE.md：事实门、五轴设计和终审流程。
• CATALOG.md、templates/：精选 palette 与可选生成规则。
• agents/whiteboard-finish-reviewer.md：只读终审契约。
• scripts/fit-check.mjs：确定性检查及 JSON 输出。
• scripts/feishu_write.py：用户身份写入飞书并导出核对图。
• CREDENTIALS.md：扣子平台授权说明。

来源与许可

MIT，详见 LICENSE。配色与媒介规则改编自 beautiful-feishu-whiteboard（© Zara Zhang，MIT）； 构图、评审、检查和管线层为原创新增，设计判断机制受 impeccable / frontend-design 启发。