用途:根据结构化 JSON(FigureSpec)确定性地生成出版物级架构图、工作流/流水线图、审计级联图与系统拓扑图,输出为可编辑的 SVG 矢量图。适用场景包括节点位置、连接与分组在语义上重要的结构化图形,以及需要后续手工或程序化编辑、且要求同一规格始终产出同一 SVG 的图形。不适用于数据柱状/折线/散点图、自然或定性插画,简单状态机/流程图应改用更轻量的 mermaid 方案。
主要能力:确定性渲染(固定渲染器版本与字体下,同一 JSON 输出同一 SVG);输出为纯文本 SVG,可后期编辑;渲染器强制校验 schema,对格式错误给出明确报错;支持 rect/rounded/circle/ellipse/diamond 的边裁剪;支持 CJK 多行标签与中文宽度估算;完全本地运行,无网络、无 API 密钥。
使用方式:先定位渲染器(优先 $CLAUDE_SKILL_DIR/scripts/figure_renderer.py,其次兼容路径 .aris/tools/、tools/ 等),随后执行: python3 "$FIGURE_RENDERER" validate <spec.json> python3 "$FIGURE_RENDERER" render <spec.json> --output <out.svg> python3 "$FIGURE_RENDERER" schema 可用 rsvg-convert -f pdf figures/fig_arch.svg -o figures/fig_arch.pdf 转为 PDF 供 LaTeX 使用。工作流程为:明确图目标 → 编写 FigureSpec JSON(画布尺寸参考单栏约 500×350、双栏约 900×500、高拓扑约 700×700;节点含 id、label、x、y,可选 width、height、shape、fill、stroke、text_color、font_size;边含 from、to,可选 label、style、color、curve)→ 校验并渲染 → 目视检查重叠、可读性、边清晰度、分组对齐与配色区分度,如有问题改 JSON 而非 SVG 并重渲染。
限制:分组仅用于框住同级节点,不支持嵌套分组,也不表示包含层级;避免长对角线跨越多行;同一角色应保持统一字号。渲染器版本或字体变化时确定性仅在固定条件下成立。其他收费、平台与效果信息暂未提供。