beautiful-feishu-whiteboard

精美飞书白板

一套设计系统技能：包含 35 种配色风格，以及经过验证的飞书 SVG 白板媒介硬性规则，助你打造精美、符合品牌风格且_可编辑_的白板。

这不是自动布局的图表生成器。由你来编排布局。模板提供配色和氛围；RULES.md 则列出该媒介的硬性限制。你制作的白板是文档中真正可编辑的飞书白板，而不是截图。

适用场景

• 用户想要飞书 / Lark 白板、信息图、图表、海报或可视化解说，并希望成品美观、符合品牌风格或具有特定美学。
• 用户指定了某种风格，或提到了某个模板。
• 用户提供了内容（“用白板解释 X”“把这个内容做成白板”），并希望它在飞书中以可视化、可编辑的形式呈现。

步骤 0：前置条件（开始前检查）

运行 scripts/preflight.sh，或手动检查：

• Node 20 或更高版本。
• lark-cli（npm 包 @larksuite/cli），已安装并完成身份验证。如果尚未安装： 执行 npm install -g @larksuite/cli，然后运行 lark-cli config init（扫描二维码），再运行 lark-cli auth login。
• @larksuite/whiteboard-cli，通过 npx 使用，会自动下载，无需安装。
• 一个飞书 / Lark 账号。白板会写入用户自己的租户。

如果尚未安装 lark-cli 或未完成身份验证，请准确告知用户如何安装并完成身份验证，然后停止操作。没有它就无法编写白板。

如何开展对话

1. 了解白板需求。 弄清楚用户想在白板上展示什么：内容、用途和受众。如果不清楚，先简短提问，再开始制作。
2. 询问风格偏好。 询问用户想要哪种视觉风格，例如活泼或专业，是否偏好某种颜色或氛围，或想匹配哪个品牌。如果用户没有偏好，可以主动帮他们选择。如果用户已经说明了风格，直接进入下一步。
3. 选择风格。 使用 CATALOG.md，根据内容类型、用户要求的氛围和正式程度，从 35 种风格中选出一种。目录列出了每种风格的配色特征，因此只能根据目录选择——不要打开多个 design.md 文件进行比较。用一句话告诉用户你选择了哪种风格，以及原因。
4. 开始制作。 阅读 RULES.md 和且仅阅读所选的 templates/<slug>/design.md，然后：
   • 在逻辑合理的画布中绘制 SVG，宽度约为 1600 到 1700，并使用对应配色，且只能使用原生形状（rect、rounded rect、circle、ellipse、连接线、文本）。选择最易于阅读的方式排布内容。每个标签都必须是 <text>；绝不要设置 font-family。
   • 白板上只能放内容，不能放背后的指令。 不要把用户的提示词、范围说明、来源引用、所选风格名称，或任何类似“……摘要 / 来源…… / 风格……”的元信息行放到画布上——那看起来像作业标题。这类背景信息应放在聊天回复中。（参见 RULES.md 中的“Never echo the user's instructions”规则。）
   • 渲染后查看图像并修正问题：修复文字溢出、边距或内边距过小、数字贴边、意外重叠和裁切问题。重复渲染、查看和修正，直到版面干净利落。（命令和完整检查清单见 RULES.md。）修复时，应直接对 .svg 文件进行小幅定点修改（移动框、加宽面板、重新换行标签），不要每轮都重新生成整个 SVG；还要把一次查看中发现的问题汇总到一轮编辑中，再重新渲染，而不是每修一处就渲染一次。
   • 将白板写入飞书文档，使其成为可编辑白板；然后查看实时白板图像，并修复任何剩余的布局问题。
5. 交付。 同时向用户提供飞书文档链接和渲染后的图像，让他们无需打开文档也能查看。然后告诉用户，他们随时可以切换为其他风格，你会用新的配色重新渲染相同内容。

文件

• RULES.md：硬性规则，以及准确的制作、写入和验证命令。务必阅读。
• CATALOG.md：列出所有风格、各自的氛围、正式程度和适用场景。用它来选择风格。
• templates/<slug>/design.md：每种风格各有一个文件，介绍配色方案及其用法。
• scripts/preflight.sh：依赖项和身份验证检查。