excalidraw

核心用法

ec-excalidraw 是一款将 Excalidraw JSON 数据渲染为手绘风格 PNG 图片的 Agent Skill。用户通过结构化 JSON 描述图表元素（矩形、椭圆、菱形、箭头、文本等），Skill 自动调用 Node.js 渲染脚本生成最终图片。核心工作流为：生成 JSON → 保存临时文件 → 执行渲染 → 按场景交付（聊天直接发送 PNG、Google Docs 嵌入图片、或按需导出 .excalidraw 源文件）。

该 Skill 支持智能箭头绑定系统，通过 from//to 字段自动计算形状边缘交点，无需手动坐标计算；同时提供 absolutePoints` 实现多段折线路由。样式系统丰富，支持 hachure 斜线填充、cross-hatch 交叉线、solid 实色填充，以及 0-2 级 roughness 粗糙度调节，可输出从精致到极度手绘感的多样视觉效果。

显著优点

1. 零设计门槛：用户仅需描述结构，无需掌握设计工具即可生成专业级手绘图表
2. 多场景适配：自动识别聊天/文档/源文件导出等不同上下文，智能选择交付方式
3. 智能布局引擎：箭头自动绑定形状边缘，支持复杂路由，大幅降低坐标计算负担
4. 视觉一致性：内置配色方案和字体规范（Virgil 手绘体、Cascadia Code 等宽体），确保输出美观统一
5. 完全离线处理：渲染全程本地执行，图表数据零外传，隐私风险极低

潜在缺点与局限性

• 学习成本：需掌握 Excalidraw JSON 元素结构和坐标系统，对非技术用户有一定门槛
• 无交互编辑：生成后无法直接修改，需重新生成 JSON 再渲染
• 字体依赖：首次使用需下载外部字体文件，网络受限环境可能失败
• 复杂布局受限：自动绑定系统对极复杂拓扑（如大量交叉线）的优化能力有限
• 输出格式单一：仅支持 PNG，无 SVG 矢量输出选项

适合的目标群体

• 技术文档撰写者：快速生成系统架构图、流程图嵌入文档
• 产品经理：制作低保真原型图、用户流程图
• 开发者：绘制算法流程、数据结构示意图
• 教育工作者：制作课件插图、思维导图
• 远程协作团队：在 Slack/Discord/Telegram 中快速分享可视化概念

使用风险

• Node.js 依赖：需确保运行环境已安装 Node.js 及 npm 依赖
• 字体下载失败：setup.sh 中的外部字体下载可能因网络问题中断
• 临时文件管理：大量生成时 /tmp 目录可能累积文件，需注意磁盘空间
• JSON 格式错误：无效元素结构会导致渲染失败，建议遵循模板规范