SuperAPI AI 工具集

d2-diagram

数据与分析

查看项目

更新于 10-16 09:33

技能介绍

用途:本技能面向“交付物是 D2 文本”的图表场景,写作重点是 id、标签、容器与连接,TALA 负责排版。适合架构、系统、数据模型、部署网络、类图与调用流程,也适合放入 README、PR 评论或 --help 文本。

主要能力:使用 TALA 布局引擎(D2 0.9 起开源并内置)生成白板风格正交排布,支持每容器 direction、容器宽高、near 与 top/left 固定。提供 d2 validate、d2 fmt 做语法与格式检查,assets/d2-facts.mjs 从 SVG 读回实际绘制的形状与连接,可与事实表比对,检查重复名、缺失/反向/臆造边、重叠、顺序与列宽。

必要用法:先运行 d2 layout,输出须含 tala (bundled)。渲染命令如 d2 --layout=tala arch.d2 arch.txt、d2 --layout=tala --ascii-mode standard arch.d2 arch.txt、d2 --layout=tala arch.d2 arch.svg、d2 --layout=tala arch.d2 arch.png。校验用 d2 validate arch.d2 与 d2 fmt --check arch.d2。事实比对用 node assets/d2-facts.mjs arch.d2 --expect arch.facts.json。宽度用 LC_ALL=C.UTF-8 wc -L arch.txt 测量。安装:curl -fsSL https://d2lang.com/install.sh | sh -s --,或 brew install d2、go install github.com/d2lang/d2@latest。

限制:validate 只查语法,不报图画错误,跨容器连接须写完整路径(根级 edge.gateway -> cluster.orders,容器内用 .); 仅限容器内一层。未在范围内的 id 会新建空形状,造成静默错误。D2 无 return/async 箭头,终端渲染丢样式,序列图顺序靠标签。sql_table 列级边只能报为表级。TALA 对流动图不如 ELK,30 个以上形状建议拆文件。种子选项不能写入文件;不同种子常无变化。PNG 阅读是唯一能看清标签、形状与箭头起点的步骤。其余细节资料未提供。