Routing rules, in order:

1. User named a format (Mermaid / Excalidraw / 标准Excalidraw / 动画图 / Canvas / .canvas) → obey it.
2. Output is to be embedded into an existing document → Mermaid.
3. Diagram must link to or embed vault notes, or the user wants to keep rearranging it by hand → Canvas.
4. Standalone diagram file, or needs styling control beyond what Mermaid offers → Excalidraw.
5. Still ambiguous → Mermaid (cheapest, most portable), and offer to regenerate as Excalidraw or Canvas.

Then read exactly one reference:

• references/mermaid.md
• references/excalidraw.md
• references/canvas.md

Step 2 — Pick the diagram type

Applies to every backend. Match content structure, don't default to "flowchart" reflexively.

Backend coverage: Mermaid does 流程图/思维导图/层级图/关系图/对比图/序列图/状态图 natively; 时间线/矩阵/自由布局 are better in Excalidraw or Canvas.

Step 3 — Universal design rules

These hold for all three backends. Backend-specific mechanics are in the references.

Text

• 禁止 Emoji — 图表文本中不使用任何 Emoji。需要视觉标记就用形状（圆/方/箭头）或颜色区分。
• 引号替换 — 文本中的 " 写成 『』，() 写成 「」。三种格式的解析器都会被裸引号/括号绊倒。
• 节点文字简短 — 每个节点 ≤ 2 行；长内容拆成子节点，或（Canvas）改用 file 节点指向笔记。
• 首次出现的英文术语加中文注释（如「检索增强生成 (RAG)」），与 vault 文档规范一致。

Layout

• 间距 — 元素之间留足空隙，宁可稀疏不要重叠；具体数值见各 backend 参考。
• 留白 — 内容不贴边，画布四周留 50-80px padding。
• 标题居中于图表整体宽度，不是固定在 x=0。
• 层次清晰 — 用颜色和形状区分信息层级，不要一片同色。

Semantic color palette

统一语义色板（Open Color 体系），三种 backend 共用同一套语义，只是写法不同：

分层区域背景（大矩形，opacity 30）：#dbe4ff 前端/UI 层 · #e5dbff 逻辑/处理层 · #d3f9d8 数据/工具层。

对比度硬规则： 白底文字不浅于 #757575；浅色填充上用同色系深色变体（浅绿底配 #2f9e44，不配 #69db7c）；深色填充上用白字。

Step 4 — Save to the right place

文件名优先中文，便于检索。

Step 5 — Report back

生成后告诉用户：

1. 文件路径（可点击）
2. 打开方式（Obsidian / excalidraw.com / excalidraw-animate，见各 backend 参考）
3. 设计选择说明 —— 选了哪种 backend 和图表类型、为什么
4. 是否需要调整

Shared quality checklist

• Backend 选择与用途匹配（嵌文档→Mermaid，独立图→Excalidraw，可交互→Canvas）
• 图表类型与内容结构匹配
• 无 Emoji
• 引号/括号已替换为 『』 / 「」
• 颜色语义一致，对比度达标
• 元素无重叠，画布有留白
• 保存路径符合上表约定
• Backend 专属检查项（见对应参考文档末尾的 checklist）

Files

上游来源：Mermaid / Excalidraw / Canvas 三套规则原属 axtonliu/axton-obsidian-visual-skills，Python builder 为本仓库自建。