用途:当用户需要为博客或文档配图、绘制流程图、状态机或 deploy pipeline 时使用。所有图形均以 inline SVG 实现,不引入 mermaid、d3、excalidraw 等外部库,理由是更可控、零依赖、可手改。
主要能力:一是 SVG 插图集,把一篇文档所需的多张图放在同一页,每张图用独立 <svg> 块,读者可通过检查元素复制 outerHTML 单独取出;二是流程图,由节点(盒子)、边(箭头)、状态颜色(pass/fail)组成,节点可点击展开“这步运行什么”的详情面板,典型场景包括 deploy pipeline、状态机、决策树。
使用方式:插图集使用基本图元 rect、circle、path、text,viewBox 取整除值(如 0 0 240 160),节点对齐 20px 网格,文本用 text-anchor="middle" 与 dominant-baseline="middle" 居中,配色使用 var(--clay) 等 baseline 变量。流程图提供模板 ../../templates/flowchart.html,为 11 节点的 deploy pipeline 骨架,含 process、decision、terminal 三种节点形状,success(实线)与 fail(虚线)双路径,键盘可达的节点点击展开详情面板,以及内嵌节点详情 JSON;修改时替换 SVG 节点坐标与文本、调整 path 的 d 走线、替换 script 中的 detail data。节点点击展开由一段 JS 实现,遍历 .node[data-detail] 绑定 onclick,切换对应 aside 的 hidden。
共同原则:始终使用 inline SVG;失败路径用 stroke-dasharray="6 4" 加 --danger 颜色在视觉上区分;必须显示图例;节点形状有语义,长方形为 process、菱形为 decision、圆角胶囊为 terminal、圆形为 state。
限制:资料未提供该技能的安装命令、收费方式、平台支持与效果数据,暂未提供。