tikz-figure-code

# TikZ Figure Code — 写对 + 编辑安全的工程基础 这是**确定性地基**：怎么写出编译干净、不重叠、改一处不崩的 TikZ 代码。 它**不**管"画什么图才美"——那是设计/编排层（见 [thesis-figure-skill](../thesis-figure-skill/SKILL.md)）的事。 本技能管的是：无论画什么，代码本身得**写对、扛得住编辑**。 > 一句话定位：thesis-figure-skill 决定**画什么**，本技能保证**怎么写不出错**。 ## 为什么需要它（问题的根） 模型写 TikZ 的默认习惯是**"坐标凭感觉"**——`\node at (5.2, 3.1)`、`\fill rectangle (x0,y0)(x1,y1)`， 一格一格手摆。这是**业余写法**，导致两类必然的痛： 1. **盲写**：你写到第 800 行时不知道渲染出来什么样，碰撞/溢出/箭头不贴框只能编译后看图才发现 → 被迫进昂贵的"渲染→审查→修"循环。 2. **编辑即崩**：同一个间距/中心被手抄在多处（zone 边界、内容中心、箭头坐标、底栏…）。改一个 stage 宽度要同步 5 处，漏一处就崩——**而静态 checker 抓不到**（实测：一个加宽 hero 的编辑把 zone 压重叠、边框切穿内容，validator + overlap-checker 全报 0 硬 bug，只有看图才发现）。 **解法不是加更多检测，是换写法。** 专家写 TikZ 是**写一张约束图**（相对定位 + fit + matrix）， 让布局引擎算位置——碰撞按构造不可能发生，图**correct by construction**，不是 correct-after-review。 证据：`references/examples/` 里同一张 5-stage pipeline，绝对坐标版 (BAD) 和按构造版 (GOOD) 渲染**视觉等价**；但施加同一个最自然的编辑（加宽 hero / 加长 label），BAD 崩、GOOD 自动重排。 见 `proof-edit-safety-hero-widen.png`。 ## 核心原则：LAYOUT BY CONSTRUCTION，不是 BY COORDINATE **作用域**：按构造纪律施加在**宏观骨架层**（模块/zone 彼此怎么放、怎么连）。 **嵌入 viz 内部**（热力图一格格、柱状图）可以继续局部手画——它自包含、坐标错了不级联—— 但要用 `\begin{scope}[shift={(parent.center)}]` 挂到父节点 anchor，让它随父节点移动。 ## 5 条 idiom（必须照做——散文指南传不了布局技能，照抄这些代码） ### ① 布局节奏只放一处 同一个间距/行高/列宽**只定义一次**，到处引用。永不把同一个数字抄在多处。 ```latex \newlength{\stagew}\setlength{\stagew}{4.5cm} % 改一处，全图跟着变 \def\gap{0.5cm} \tikzset{node distance=\gap} ``` ### ② 模块用相对定位摆，不用绝对 `at (x,y)` 第一个锚定，其余 `right=of` / `below=of` 前一个。间距活在 `node distance` 一处。 ```latex \node[zone] (s1) a...