用途:为架构决策记录(ADR)创建 ASCII 架构图,使用 graph-easy 渲染纯文本图形,无需图片渲染。适用于编写涉及架构变更的新 ADR、描述迁移/集成/系统变更、用户要求可视化决策、或审查更新已有 ADR 图。
主要能力:支持节点、边、标签边、双向边、分组容器、自定义标签等 DSL 语法;支持 flow 方向(south 用于架构与决策,east 用于流水线与序列);支持节点样式(圆角、双边框、粗边框、点线边框)与边样式(实线、点线、粗线);要求每张图带 emoji 标题,节点内禁止图形 emoji 以保证对齐。
使用方式:先做预检,确认 graph-easy 可用:echo "[Test] -> [OK]" | graph-easy --as=boxart &>/dev/null && echo "✓ graph-easy ready"。渲染命令必须使用 boxart:graph-easy --as=boxart << 'EOF' ... EOF,不要用 --as=ascii。嵌入 ADR 时,每张图必须附带可折叠的 <details> 块保存 graph-easy 源码。
限制:每张图建议不超过 7-10 个节点,超出应拆分;节点内不要放图形 emoji,否则破坏边框对齐;边标签保持 1-3 个词;缺少 graph { label: "emoji ..."; } 的图会被预检拦截。具体安装步骤与完整符号参考暂未提供。