架构图维护规则
状态:已实现
最后复核:2026-08-15
长期讨论:GitHub Discussions
同名 .excalidraw 是权威可编辑源,.svg 是派生预览。每张图独立使用一个基础文件名,并始终成对提交;不使用 .excalidraw.svg、PNG、PDF 或单个超大画布。
用 Excalidraw 打开 .excalidraw 源文件。修改后以 SVG、light mode(浅色模式)、白色背景重新导出;编辑器支持时嵌入字体。不得手工修改 SVG 来替代源文件更新。
Markdown 使用相对路径内嵌预览并在下一行链接编辑源:

[编辑源:example.excalidraw](diagrams/example.excalidraw)
同一 PR 必须同步更新 source 与 SVG。QA 应解析 .excalidraw JSON 和 SVG XML,检查文件配对及 Markdown 相对链接,并实际渲染每张 SVG,验证中文、文字裁切或重叠、箭头端点、连线、图例、背景、对比度和页面宽度下的可读性。