用途:为领域同行绘制可核验的准确技术图,包括架构图、系统图、流程图和框图。读者是同行,瓶颈在项目结构而非领域知识,因此须给出精确名称、机制和关系。
两条路线:D2 路线把 assets/editorial-theme.d2 放在源码旁并 import,只写语义结构,先运行 d2 fmt,再执行 bash scripts/render_d2.sh <file>.d2 <file>.svg;直接 SVG 路线从 assets/direct-svg-template.svg 起步替换节点与连线,用 python3 scripts/validate_svg.py --target-width 720 --tokens assets/editorial-tokens.json <file>.svg 校验。脚本从技能目录运行。
内容规则:组件用代码、配置或运行系统中的确切名称标注,名称不表意时在第二行补角色;连线标注经过的内容、触发条件或机制;数量、时间戳、计数、限定语留给正文。
选路:内联进自带字体和颜色令牌的 HTML 用直接 SVG;作为独立文件并已安装 d2 用 D2;需编辑现有 SVG、用户要 SVG 源码或需 D2 无法表达的几何时用直接 SVG;未安装 d2 则用直接 SVG,不静默安装。
交付宽度:画布不超过交付宽度(默认 720px),最小标签在缩放后仍须不小于 12px。校验失败时依次尝试 D2_LAYOUT=tala、direction: down、缩短标签或分图,最后才压缩间距。
验证顺序:渲染(标签可读、无裁切、连线不穿内容)、含义(节点、边、方向、分组、注释齐全且未杜撰)、可核验性、沟通性、最小性。成功渲染不等于图可读或正确,需检视 SVG 或用 PNG 证明。
限制:D2 默认主题非风格契约;D2 嵌入式字体无 Hangul,独立文件需通过 D2_FONT_MONO 传入支持韩文的 TTF;自动布局不佳时不得加标题、图例、间隔节点或装饰容器,应改几何、改方向或用直接 SVG。其他细节资料未提供。