SuperAPI AI 工具集

excalidraw-diagram

设计与创作

查看项目

更新于 11-07 05:24

技能介绍

Excalidraw Diagram Creator 是一个用于生成 .excalidraw JSON 文件的技能,目标是让图表进行视觉论证,而不仅仅是展示信息。

用途与核心理念 该技能用于创建、编辑、修复 Excalidraw 图表。其核心理念是:图表应当“论证”(ARGUE),而不是“展示”(DISPLAY)。图表不是格式化文本,而是展示文字难以表达的关系、因果与流程的视觉论证;形状本身应当承载含义。技能提出两个检验:同构检验(去掉所有文字后,结构本身是否仍能传达概念)与教育检验(读者能否从图中学到具体内容,而不只是看到标签框)。

深度评估 生成前需先判断所需细节层级:简洁/概念图使用抽象形状,适合解释心智模型或理念;综合/技术图使用具体示例,适合真实系统、协议、架构、教学场景,并必须包含“证据构件”。技术图在绘制前需研究实际规范,如真实 JSON/数据格式、事件名、方法名、API 端点,避免使用泛化占位符。

证据构件 证据构件是证明图表准确并帮助读者学习的真实示例,包括代码片段、数据/JSON 示例、事件/步骤序列、UI 草图、真实输入内容、API/方法名等,需按配色文件中的证据构件配色渲染。

多缩放层级架构 综合图可同时包含三个层级:摘要流程(整体概览)、区块边界(带标签的分组区域)、区块内细节(证据构件与具体示例)。

容器与自由文本 默认使用自由浮动文本,仅在需要视觉分组、箭头连接、形状本身有含义等情况下添加容器;通过字号、字重、颜色建立层级。目标是让少于 30% 的文本元素位于容器内。

设计流程 步骤包括:评估深度、深入理解内容、将概念映射到视觉模式、确保多概念图中每种主要概念使用不同视觉模式、先声明对齐线再生成坐标、生成 JSON,最后必须执行渲染-查看-修复循环进行验证。

大型图表策略 综合或技术图必须分节构建 JSON,不可一次性生成整个文件;使用描述性字符串 ID、按节分配 seed、随构建更新跨节绑定;全部完成后通读检查绑定、间距与 ID 引用,再进入渲染验证。资料明确不建议用编码智能体生成 JSON,也不建议编写 Python 生成脚本。

视觉模式库 包含扇出(一对多)、汇聚(多对一)、树形(层级)、螺旋/循环(持续回路)、云形(抽象状态)、流水线(转换)、并排(对比)、间隔/断裂(分隔)等模式,并建议用线条而非方框作为主要结构元素,如时间线、树形结构、分隔线、流程主轴。

形状语义与颜色 形状按含义选择:标签与说明用自由文本,时间线标记用小椭圆,起点/输入与终点/输出用椭圆,决策用菱形,流程/步骤用矩形,抽象状态用重叠椭圆,层级节点用线条加文本。颜色用于编码信息而非装饰,所有颜色应来自 references/color-palette.md,该文件是形状填充、描边、文本层级与证据构件颜色的唯一来源,可通过编辑该文件定制品牌风格。

设置与依赖 资料提到若用户要求设置该技能(渲染器、依赖等),需参见 README.md;但资料中暂未提供 README.md 的具体安装命令或依赖细节,因此相关步骤暂未提供。