架构与流程图快速绘制工具

为工程师解决什么问题

在技术文档、设计评审或沟通方案时，绘制清晰、规范的架构图与流程图是刚需。但手动调整 SVG 坐标、处理箭头与文字重叠、确保跨组件风格一致，这些细碎工作耗时且容易出错。通用绘图工具往往无法直接输出可用于技术博客的内联图表，或生成的 Mermaid 代码不符合文档标准。

技能如何工作

该技能提供两种核心绘图路径，并内置了严格的工程规范：

1. 内联可视化 (推荐)

• 操作：通过调用 read_me 加载预设的 CSS 变量与设计模块，然后使用 show_widget 直接在对话中渲染 SVG 或 HTML 图表。
• 优势：所见即所得，图表即交互。通过 diagram 模块统一颜色、字体和间距，确保视觉一致性。
• 适用场景：系统架构图、微服务拓扑、业务流程图（泳道）、数据流图等，适合需要立即展示并讨论的场景。

2. Mermaid 代码块

• 操作：输出符合标准的 Mermaid 语法代码。
• 优势：易于嵌入 Markdown 文档（如 GitHub、Obsidian），并可通过渲染引擎在最终文档中显示。
• 适用场景：时序图、状态机图、ER图，或任何需要版本化存储图表源码的场景。

关键设计规范与防坑指南

技能并非简单绘图，而是强调生成符合工程标准的图表：

• Token 高效：提倡使用 CSS 类与 SVG <defs> 复用，而非逐元素内联样式，可显著减少生成 token 量。
• 箭头清晰：内置箭头 marker 定义规范，确保 refX/refY 精准对齐，且 markerWidth/markerHeight 不小于视口，防止裁切错乱。
• 防重叠：通过 “箭头尖端禁区” 与 “白底衬底” 机制，强制避免箭头覆盖文字，保证标注可读性。
• 布局分层：为架构图提供 层级分组框（虚线框） 与层间箭头间距规范，引导清晰的分层布局。

适用边界与注意事项

使用前务必明确能力范围：

• 支持：架构图、流程图、时序图、状态机、ER图、甘特图等矢量图表。
• 不支持：饼图、柱状图、折线图（应使用 chart 模块）、思维导图、3D 图、地图、直接生成 PNG 等。遇到此类请求，应主动说明并提供替代方案。
• 最佳实践：绘制复杂系统时，建议拆分为多张图，每张图聚焦一个视角，并配合文字说明。单张图节点数建议控制在 20 个以内，以保证清晰度。