用途:当用户要求画图、流程图、架构图、可视化,或在解释含三个以上组件、多步骤流程、决策树、架构对比时主动使用。简单列表、表格或快速问答场景可跳过;需要严谨 UML、品牌图标应改用 drawio,图表即代码用 mermaid/plantuml,无限画布白板用 tldraw。
主要能力:生成 .excalidraw JSON 文件并导出为 PNG/SVG。导出方式两种:Kroki API(curl,零安装,仅 SVG);excalidraw-brute-export-cli(本地基于 Firefox,支持 PNG 与 SVG)。不支持 PDF。
使用方式:Option A 检查 curl 即可,无需额外安装,SVG 经 https://kroki.io 渲染。Option B 需要执行 npm install -g excalidraw-brute-export-cli 与 npx playwright install firefox;macOS 需一次性打补丁(将 Control+O、Control+Shift+E 改为 Meta 对应键),Windows/Linux 无需补丁。工作流为检查依赖、选择视觉隐喻、生成 JSON、导出、校验渲染、按用户反馈迭代、报告输出路径。
设计原则:默认 roughness:0、fontFamily:2、fillStyle:"solid";优先用文字而非给每个标签加框;遵循字号层级(标题 28、分节 24、标签 20、描述 16、注释 14)与 60-30-10 配色规则;箭头样式区分主流程、异步响应与弱依赖。元素需设置唯一 seed、描述性 id,boundElements 为空时用 null,points 从 [0,0] 起。文本须显式设置 strokeColor 否则可能不可见;箭头标签宽度须按文字宽度而非箭头长度。
适用场景:流程图、架构图、时序图、思维导图、泳道图等。限制:不支持 image、frame、embeddable;本地导出用 Firefox 而非 Chromium;社区图标库须为纯矢量项;导出需校验渲染结果。