SuperAPI AI 工具集

svg-figure

设计与创作

查看项目

更新于 10-16 09:34

技能介绍

svg-figure 是面向 SVG 示意图、流程图、系统图、解剖插图等的编写约定,核心目标是保证元素一致性:文字对齐到方框边界、箭头末端指向目标、连线按 z 序位于形状下方。其输出可被 scientific-figure 技能组合为分区,并由 figure-qa 的 SVG 分支校验。

适用场景:手写 SVG 或使用 Inkscape 等编辑器且需满足 figure-qa 预期;用非 Python 工具生成 SVG;阅读外部协作者手写的 SVG 布局语法;调试非 svg-primitives 产出的 figure-qa 问题;绘制由方框、箭头、标签组成的示意图(数据绘图应改用 plot-styling)。

不适用:编写 Python 应改用 svg-primitives;数据图用 plot-styling;图像基底用 ai-full-figure;需要重复图标元素用 transparent-icons。

主要约定:设置显式 width/height 与匹配 viewBox,使用户单位等于毫米;文字用 text-anchor="middle" 与 dominant-baseline="middle" 居中于方框质心,正文字号建议 ≥ 约 1.8(约 5pt);箭头用 line 或 path 加 marker,通过 refX 让端点即视觉尖端;连线先绘制、形状后绘制以形成遮挡;配色可选用色盲安全调色板 okabe-ito、tol-bright,近灰用于辅助线。

推荐路径为程序化生成:示例 examples/schematic_from_primitives.py 使用 Canvas、LabeledBox、Arrow.connect、Annotation,运行命令为: cd plugins/figures/skills uv run --with drawsvg --with svgpathtools --with Pillow --with fonttools --with cairosvg --with lxml python svg-figure/examples/schematic_from_primitives.py

绘制完成后可通过 figure-qa 的 check_svg.py(配合 lxml、svgelements、shapely)检查字号、调色板与几何。若需交付给 Illustrator 或 Affinity Designer 编辑,可运行 scripts/editor_prep.py 执行标记烘焙、文字锚点解析、嵌套 viewport 展平、SVG data URI 内联、字体归一化等机械处理,该脚本幂等且适用于任意 SVG。具体收费、价格与平台信息暂未提供。