Shapezo：用结构化内容架构重塑立交桥工程文档

重型土木工程的文档管理常年困在一个老问题上：用非结构化的散文去描述高度结构化的实体。一座立交桥本质上是一张关系图谱——结构、跨度、桥墩、支座、梁线、桥面浇筑、施工阶段、交通导改、检查节点、施工日历，每一样都与其他要素存在明确关联。把这些信息塞进一堆PDF文件夹，等于把图谱扔掉，然后在每个报告周期里靠人力重新推演一遍。

Shapezo 给出的思路是：先建模资产，再渲染叙述。知识以带有显式 schema 的类型化对象形式存储，项目叙事则成为模型的构建产物。这套架构的核心不是某个具体工具链，而是一种内容纪律。

立交桥对象模型

Shapezo 的立交桥模型刻意保持精简，四类实体几乎覆盖所有立体交叉项目。

结构族描述每座桥梁的类型、跨度布置、桥墩与基础系统、桥面系统及总长。线形族描述结构之间的连接方式：匝道线、主线桩号、纵断面，以及每条线承载的交通流向。阶段族描述时间维度：施工阶段、各阶段开放与封闭的交通流向、绕行路线，以及约束工期的时间窗口。

叙述族是 Shapezo 的独特部分，其中两个字段决定了下游一切。第一个是「叙述形态」，从固定枚举中四选一：跟随司机穿越各层级的「旅程型」、跟随单个桥墩从基础到支座垫石的「建造型」、将社区影响与项目收益并列呈现的「权衡型」，以及说明结构为谁提供何种服务的「服役记录型」。第二个字段指定叙述允许深入展开的一到两个「锚点细节」——如钢筋网片、挂篮、支座垫板或梁段拼接。其余内容一律停留在摘要深度。正是这一约束，让生成的叙述保持可读，而非事无巨细。

显式 schema（explicit schema）指预先定义好字段名、数据类型、取值范围与相互关系的结构化数据契约，类似数据库的表结构声明。与自由文本不同，schema 要求每个对象在入库时就必须符合既定形态：桥梁总长必须是数值，叙述形态只能取自预设枚举，锚点细节必须指向模型中真实存在的实体路径。这样做的好处是模型可被机器校验、可被模板安全引用，也让跨项目复用与长期版本对比成为可能。代价是前期需要投入建模纪律——哪些信息值得成为字段、哪些应归入摘要深度，必须提前想清楚，否则 schema 会退化为无意义的容器。

从模型渲染叙述

渲染器为每种叙述形态配一个模板。每个模板是有序的章节序列，每个章节的槽位绑定到模型中的具体路径，没有任何自由发挥的空间。

如果某个必填槽位没有数据，该章节会渲染出一个可见的占位标记，而不是悄悄消失——缺口在评审阶段暴露，而不是等到公开发布时才发现。一个交通组织章节回来是空的，这条就是评审意见，而不是公开会议上的意外。

由于输出对给定模型是确定性的，差异比较就变得有意义。阶段模型的改动会在评审中呈现为干净的叙述差异，而施工知识的变化恰恰最应该在这样的差异中被审视。同一结构在两个报告周期之间的差异，只反映结构实际发生的变化，把进度报告从回忆变成了对比。

确定性渲染指在给定输入模型与模板的情况下，渲染器每次产出的叙述文本完全一致，不含随机成分或人工临场发挥。这是差异比较（diff）能够成立的前提：只有当两次输出的差异全部来源于模型本身的变化时，版本对比才有诊断价值。若渲染过程引入自由撰写成分，差异中就会混入措辞波动，评审者将无法区分「结构真的变了」与「只是换了个说法」。确定性渲染把文档从一次性的写作成品，转变为模型状态的忠实投影，使版本管理、审计与进度追踪都建立在可比数据之上。

资产管线即契约

图像被当作带有契约的构建输入，而非装饰。每座结构声明三个槽位：总体印象、结构细节、后果呈现。管线在入库时强制几何与体积约束：宽高比锁定16:9，分辨率锁定1280×720，文件体积上限200KB，且永远不允许烧录文字或人物。

体积上限比听起来更重要。现场记录常常在工区边缘的平板上打开，走蜂窝网络，而信号差的区域恰恰因为结构物本身遮挡所致。200KB 的预算让包含三个场景的完整记录控制在1MB以内。

以顶推施工的「总体印象」资产为例：一个画面同时捕捉到顶推鼻、支座垫石、被跨越的铁路调车场和桥台顶推反力架，一张图传达了六张地面照片难以互相关联的信息。

顶推施工（incremental launching）是桥梁上跨既有设施时常用的一种架设方法：在桥台后方逐段浇筑或拼装梁体，然后用千斤顶将已完成的梁段沿纵向顶推前行，逐次就位，直至整跨落位。其显著特点是作业面集中、对被跨越对象（如铁路调车场、道路）干扰小。对本节讨论的资产槽位而言，顶推场景天然要求一张画面同时呈现鼻梁、反力架、支承垫石与被跨越设施，因为这几类要素在时间和空间上高度耦合，任何单点照片都难以独立说明问题，这正是「总体印象」槽位优先捕捉全局关系的原因。

为什么支架视图是承重镜头

三个槽位中，「结构细节」是撑起整条管线的那个，对城市高架施工而言，支架视图是其最佳表达。

支撑塔架配置、桥面模板几何、剪刀撑布置每周都在变，因此一张视角一致的支架照片本身就是配置基线。把它放在模型里，意味着周期对比是对固定视角图像做差异分析，而不是在共享网盘里做考古。

这套方法带来什么

先模型、后渲染，三件事随之改变。

文档变得可评审，因为模型改动产生叙述差异。文档变得完整，因为空置的必填槽位会大声报错而非无声消失。文档变得低成本，因为下个周期更新一座结构只需编辑几个类型化字段，而不是从头重写散文。

Shapezo 不是文档管理系统，也不是静态站点生成器。它是「在动笔之前先决定内容形态」这一纪律，加上刚好够用的工具来强制执行这个决定。对于立交桥施工——其底层资产本就是结构、线形与阶段的良定义图谱——这种纪律几乎是不公平的杠杆。