SuperAPI AI 工具集

d2

写作与研究

查看项目

更新于 10-15 22:38

技能介绍

用途:本技能用于编写、生成、审查和改进 D2 图表代码。D2 是声明式图表脚本语言,文本编译为 SVG(文档 https://d2lang.com,在线编辑器 https://play.d2lang.com)。

主要能力:先按需求选择图形类型——系统组件用容器加连线,请求流程用 shape: sequence_diagram,流程与判定用形状加有向连接,数据库用 shape: sql_table,类关系用 shape: class,C4 用容器加 shape: c4-person 与主题 303,状态机用形状加带标签连接,渐进展示用 steps,多视图用 layers 或 scenarios,指标看板用 grid-rows 与 grid-columns。支持形状与样式(fill、stroke、stroke-dash、3d、double-border、multiple、animated 等)、箭头形状(含 cf-* 基数表示)、全局 glob 样式、classes 复用样式、vars 变量替换、Markdown 与 LaTeX 文本、预设主题(如 0、200、300、302、303)与明暗双主题、dagre 与 elk 布局。

使用方式:先确定图类型,草拟代码;必须调用 d2_inspect 并据其输出手工绘制 ASCII 预览(不要用 d2_render(ascii=true),D2 的 ASCII 渲染有已知问题),确认结构后再执行 d2_render(d2_code=..., skip_fonts=true) 渲染 SVG;出错时用 d2_validate 获取行列错误;保存时先写 .d2 源文件再渲染 SVG。skip_fonts 默认 true,除用户明确要求内嵌字体外不要覆盖。动画图使用 animate_interval 参数。

适用场景:技术架构说明、接口时序、数据库设计、类结构、C4 视图、状态流转与演示型分步图。

限制:默认布局为 dagre,不要自行设置 elk(在 WASM 中极慢);不要跳过 ASCII 预览直接出 SVG;本资料未提供安装命令、收费与价格信息。