需要为视频、课程、文章或幻灯片制作「论证型」图表时，用…

当用户想用图表说明概念、流程、对比或因果（用于视频/课程/文章/演示/文档）时，按统一视觉规范生成 Excalidraw 文件并渲染成高分辨率 PNG 与可缩放 SVG。

适用场景

解决思路

1. 坚持核心原则：图表要「论证」而非「展示」——每张图必须展示纯文字无法传达的关系、变换与因果，让读者的理解向前推进。
2. 按使用场景确定默认画布与字号：YouTube 视频/短片用 1920x1080（16:9）、正文至少 24pt、每张图一个 slide；课程/在线课用 1920x1080（网页嵌入可用 1600x900）；博客/文档用自由尺寸（常用 1200x800）、18pt 以上即可、比例灵活；演示幻灯片用 1920x1080；技术架构图交给自动 bounding box（渲染器自动裁剪）。
3. 上下文不明确时一律默认 1920x1080 + 24pt（最万能的格式，兼容视频、slide、文档）；只有用户明确说「用于文章/文档」时才放宽尺寸和移动端可读性约束。
4. 上色前先读 references/color-palette.md，使用以 L'Accélérateur IA 蓝 #0061FF 为锚的品牌色板作为唯一颜色来源。
5. 设计第 1 步：澄清概念与上下文。若对话中不明显就询问：想说明什么概念？用在什么场景（视频、课程、文章、slide）？要简单/概念图还是技术/细节图？并区分两个层级：简单/概念图用抽象形状、高层关系、少文字；技术/细节图用具体示例、真实工具名、真实数据流。
6. 设计第 2 步：理解关系。在概念中识别——变换（A→B，什么变了、怎么变）、关系（层级、依赖、顺序、并行）、比较（前/后、有/无、方案 A vs B）、流（输入→处理→输出）。
7. 设计第 3 步：把关系映射到视觉模式，按需选择：Fan-Out（1→N，一个元素拆成多个）、Convergence（N→1，多个元素汇合）、Pipeline（A→B→C，顺序流程）、Arbre/树（层级、父子、分类）、Cycle/循环（迭代过程、反馈回路）、Side-by-Side（并排对比：前/后、A vs B）、Matrice/矩阵（两轴二维分类）、Timeline/时间线（按时间的阶段）、Couches/分层（抽象层堆叠）。
8. 设计第 4 步：同一次产出包含多张图时保证多样性——变换视觉模式、变换主色调、交替复杂度（简单→复杂→简单）。
9. 设计第 5 步：勾勒布局。参考尺寸：Hero 主元素 300x150px、一级元素 180x90px、二级元素 120x60px、小标记 60x40px。间距：主元素周围留 200px+，二级元素之间 80-100px，任意元素之间至少 40px。
10. 设计第 6 步：生成合法的 .excalidraw JSON 文件，元素写法参考 references/element-templates.md 中的模板。
11. 执行容器纪律：控制在 30% 以下的文字放进 shape 里——层级由排版创造，容器只用于划定边界，不用来装所有文字。概念→形状对应：标签/描述用自由文本（无形状）；时间线标记用小圆（10-20px）；触发/输入用椭圆；决策/条件用菱形；流程/动作用矩形；抽象状态用叠加椭圆；层级节点用线条+文字。
12. 统一设置美学参数：roughness: 0、opacity: 100、fontSize: 24、fontFamily: 5、textAlign: "center"、strokeWidth: 2。始终干净锐利，绝不用「sketch/rough」手绘风；fontSize 默认至少 24（静态文章/文档可降到 18，绝不再低）；fontFamily 必须是 5（Excalifont，Excalidraw 默认手写风），绝不用 fontFamily: 3（Cascadia monospace）；strokeWidth 标准 2、强调时 3。
13. 大图（超过 15 个元素）分节构建：用可读的字符串 ID（如 "input-webhook"、"process-filter"）；按节给 seed 分命名空间；逐节生成、验证后再组装；绝不试图一次性生成整张图。
14. 输出阶段 A（设计）：先确定保存位置——若存在 YouTube 项目（output/YYYY-MM-DD_sujet/ 目录）则存到 output/YYYY-MM-DD_sujet/diagrams/；若在做课程/文章则询问目录（通常是 <projet>/assets/diagrams/ 或 <projet>/images/）；否则提议当前目录下的 ./diagrams/。然后找出所有需要的视觉时机，提出要创建的图表（数量、类型、位置），等待用户确认。
15. 输出阶段 B（生成）：在「分组模式」与「分文件模式」间选择。分组模式（推荐用于视频/幻灯片系列）：把同一次交付的所有图垂直堆叠进单个 diagrams.excalidraw，便于在一个文件里滚动、复制粘贴、保持风格一致；渲染出长竖版画布（如 5 张 slide 为 1920 x ~6000），剪辑时从矢量 SVG 中逐张裁切。分文件模式（推荐用于课程/文章）：每张图各存为 diagram-<nom>.excalidraw 并独立渲染 PNG/SVG，便于逐个插入 markdown、文档或 slide deck。模式由上下文决定，含糊时询问用户。
16. 分组模式的规则：slide 之间垂直 gap 至少 800px（视频剪辑必须如此，才能在 DaVinci、Final Cut、After Effects、Premiere 中放大单个 slide 而不串入相邻 slide；非视频的文档/文章可降到 200px）；每张 slide 左上角加不显眼的标签 ── Slide N — Titre ──；每两张 slide 之间在 gap 中点画一条贯穿画布宽度的水平点线（strokeStyle: "dotted"、strokeColor: "#CCCCCC"、strokeWidth: 2），用于区分边界。堆叠公式：CANVAS_W = 1920，SLIDE_H = 1080，GAP = 800（视频）或 200（文档/文章），第 N 张 slide 的 y_offset = N * (SLIDE_H + GAP)。
17. 输出阶段 C（渲染）：用脚本把一个 .excalidraw 渲染成 PNG + SVG。macOS/Linux 运行：python3 "${CLAUDE_PLUGIN_ROOT}/skills/illustre/references/render_excalidraw.py" "<chemin/vers/le-fichier.excalidraw>"；Windows 上 python3 不保证存在，改用 python 或 py。脚本产出 <fichier>.png（2x device pixel ratio 高分辨率，可直接使用）和 <fichier>.svg（矢量，可无损导入 DaVinci Resolve、Final Cut Pro、After Effects、InDesign、Figma）。渲染器自动计算 bounding box，最终 PNG/SVG 尺寸精确贴合元素（外加 80px padding）。
18. 渲染前置条件（只需装一次）：macOS/Linux 执行 python3 -m pip install --user playwright && python3 -m playwright install chromium；Windows 需要 Git for Windows（保证 Bash 工具可用）且 Python 在 PATH 上，执行 python -m pip install --user playwright && python -m playwright install chromium。
19. 了解渲染器技术实现：它把 Excalidraw JSON 直接转成 SVG（矩形、椭圆、菱形、线、带 arrowhead 的箭头、居中多行文本），再用 Playwright 以 device_scale_factor=2 截图；不依赖 Excalidraw CDN（其 UMD build 已不再发布）。
20. 输出阶段 D（验证）：逐张展示生成的图表，并核对清单——目标格式（手机看 YouTube、课程屏幕、文章尺寸）下可读吗？对比度足够吗？文本语言正确吗（原文默认法语，可替换为目标语言）？有被截断或溢出的文字吗？关系/箭头清晰吗？能在 3-5 秒内理解吗？必要时提出调整。
21. 输出阶段 E（展示）：列出生成的文件及路径和简短描述，格式如：Diagrammes generes dans <repertoire>/ : - diagram-[nom-1].excalidraw + .png + .svg — [简短描述]。
22. 遵守硬性规则：始终使用 L'Accélérateur IA 色板（除非用户明确要求相反）；始终按要求语言生成文本（原文默认法语，除非明确要求相反）；始终 fontFamily: 5，绝不用 3；始终 roughness: 0，绝不用 sketch/rough 风格；始终同时渲染 PNG 和 SVG；绝不制作需要超过 5 秒才能理解的图；每张图主要元素绝不超过 7 个，超出就拆分；1920x1080（16:9）是万能默认，只有上下文明确需要（静态文章、自定义网页嵌入）才放宽。

适用边界 · 注意事项

• 需要照片级写实、3D 渲染或复杂插画时——Excalidraw 手绘风与自动裁剪不适合这类视觉。
• 没有 Python + Playwright 环境且无法安装时，只能产出 .excalidraw 源文件，无法自动渲染出 PNG/SVG。
• 对排版有严格品牌/出版级要求（如 CMYK 印刷精度）时，此流程的自动 bounding box 与内置字体不保证满足。