Diagram Design：有证据的视觉解释
Diagram Design 架构：按需参考文档与相互独立的验证约定
追踪请求如何选择语义和布局，并分清外观、几何、动画与元数据检查各自能证明什么。
你将学会
- 加载能解释当前请求的参考文档
- 同一文件承载不同层次的约定
- 固定行为仍需要审阅
开始前需要
- 了解 HTML 与 SVG 基础
- 区分系统关系与视觉布局
选择有用的表达方式，说明简化理由，并在实际覆盖范围内解释检查结果。
先看结论
- 参考文档选择也是创作架构的一部分。
- 几何、元数据与动画检查证明不同的事实。
- 控制器字节匹配不能代替源码审阅。
加载能解释当前请求的参考文档
文档描述的加载模型先暴露简短名称与说明，匹配请求后读取主技能，再按需读取类型或行为参考。简单流程图与品牌化 Mermaid 重绘并不需要同样的上下文。这是一种路由设计，不是在所有宿主中测得的 token 节省结论。
包含系统行为的请求先选语义模式，再选布局家族。导入会增加提取和输出规范参考，可选动画又有自己的约定。共享包因此通过专门文档扩展，而不是把所有例子和规则堆入每个任务都必须读取的一条巨大提示。
同一文件承载不同层次的约定
上游以 HTML 作为创作事实来源，里面包含内联 SVG 和可选结构化属性。可追踪区块模式只显示简短标签，同时把更丰富的标识与父级信息存入元数据。注册表附属文件从这些数据生成，而不是独立手工维护另一份可能冲突的描述。
不同验证器回答不同问题：矩形几何检查特定绘制顺序碰撞，区块检查标识、父级解析与环，动画检查控制器一致性与结构。元数据树正确，图仍可能表达错误；矩形报告干净，也不能证明标签准确或组件关系真实。
固定行为仍需要审阅
可选动画只允许一个经过审阅的控制器，并要求内容与同一提交的模板匹配。架构记录明确指出：同时修改模板和副本，仍可能通过一致性检查。因此源码审阅不可省略；字节一致证明符合那个模板，不代表普遍安全。
默认静态产物适合无需交互也应能理解的文档。若应用需要任意点击处理、实时数据或可导航的三维探索器，那是另一项产品设计，不是这个约定支持的小幅控制器修改。选型前必须明确这些额外需求。
实施步骤
- 1
追踪请求到参考文档的选择路径。
- 2
确认原始产物与派生导出的关系。
- 3
将每个检查器对应到具体保证。
- 4
审阅超出静态或固定动画约定的需求。
可复制示例
请求 -> 主技能 -> 语义模式 -> 视觉类型
+ 输出规范 / 品牌配置 / 导入参考
|
HTML + SVG
|
几何 | 元数据 | 动画检查
|
渲染后人工审阅常见问题
区块注册表能证明图片符合实现吗？
不能。结构检查可以验证标识唯一、父级有效等性质，但与源码及绘制位置的对应关系仍需单独审阅。
每张图可以定制自己的动画脚本吗？
文档约定要求使用准确匹配的已审阅控制器，不允许任意逐图修改。专门交互属于约定之外的需求。
资料来源
- docs/adr/0001-static-by-default-single-pinned-controller.md来源核查 2026-09-08
- docs/adr/0002-semantic-patterns-do-not-expand-the-taxonomy.md来源核查 2026-09-08
- docs/adr/0010-block-registry-metadata-contract.md来源核查 2026-09-08