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 格式错误：无效元素结构会导致渲染失败，建议遵循模板规范

核心用法

Excalidraw Diagram Generator 是一个本地运行的图表渲染工具，接受 Excalidraw 格式的 JSON 数据，输出手绘风格的 PNG 图片。核心工作流包含三步：生成符合规范的 JSON 元素数组 → 保存到 /tmp/*.excalidraw 文件 → 调用 render.js 脚本渲染为 PNG。

该 skill 支持矩形、椭圆、菱形、箭头、线条、文本等基础元素，并提供智能箭头绑定机制——只需指定 from 和 to 指向元素 ID，渲染器自动计算边缘交点，无需手动坐标计算。支持手绘风格（roughness:1）或 clean 风格（roughness:0），内置丰富的配色方案。

显著优点

• 本地安全：纯本地文件操作，无网络外发，渲染过程不依赖外部 API
• 智能绑定：箭头自动吸附形状边缘，大幅简化流程图绘制
• 即开即用：输出标准 PNG，可直接嵌入聊天、Google Docs 或下载使用
• 风格独特：Excalidraw 的手绘美学在技术文档和演示中辨识度高
• 来源可信：openclaw 组织维护，T2 级别信任，依赖均为知名 npm 包

潜在缺点与局限性

• 输入敏感：JSON 缺乏 Schema 验证，异常输入可能导致渲染失败
• 无交互性：输出为静态 PNG，无法像原生 Excalidraw 那样在线编辑
• 字体依赖：首次使用需通过 setup.sh 下载字体文件（CDN 来源）
• 功能边界：不支持 Excalidraw 的全部高级特性（如库导入、实时协作）

适合人群

技术文档作者、产品经理、开发者、架构师——需要快速生成架构图、流程图、系统拓扑图，并直接嵌入文档或聊天场景的用户。

常规风险

• 低：输入 JSON 未经严格校验，理论上存在构造恶意输入导致拒绝服务的可能
• 信息级：缺少 LICENSE 文件，授权条款不明确
• 建议对输入文件大小和元素数量设置上限，生产环境建议启用运行时监控