3D 查看器裁剪的取舍

【踩坑实录】3D 查看器裁剪的取舍

▍现象
电路设计工程的版本边界决策：上游的 3D 查看器（电路板的三维预览）与电路仿真器要不要进第一版。两者都是上游的招牌能力，但都拖着沉重的依赖：3D 查看器要几何内核（OCC 级别的大型库），仿真器要独立的仿真内核——每一个都是一次完整的移植工程量。

▍定位与取舍过程
决策框架三问：依赖成本（几何内核的交叉编译与适配量——头文件与库体量巨大）、用户价值（第一版的核心场景是原理图查看与编辑——3D 与仿真是进阶场景）、组合风险（带病进版的半成品比缺席更伤——3D 查看器若渲染不稳，用户对整个应用的信任降级）。工程的拍板：第一版明确不含 3D 查看器与仿真（登记原文：能打开、编辑原理图并存盘的子集是 v1 范围）；构建期硬依赖用桩满足（仿真内核以桩库通过构建期依赖检查——上游代码引用它，桩让链接过，功能不启用）；几何内核仅编译期满足（头文件可用，库不进运行时分发）。

▍根因抽象
裁剪的艺术在边界诚实：裁掉的能力显式登记（不装作存在）、构建期依赖用桩驯服（上游的依赖图认它，运行时不加载）、版本边界对用户透明（功能列表如实标注）。做不到这三点，裁剪就会变成隐形故障源。

▍对策的另一半
被裁能力的回归通道：桩与真库的切换点留好（后续版本换真库启用功能——裁剪不是死刑，是延期）；裁剪决策记档（什么时候裁的、什么条件下重启——避免 N 个月后没人知道这段历史）。

▍方法论沉淀
版本边界的取舍三问加边界诚实三原则，这个组合拳适用于一切大工程的分期交付。

v1 边界与桩化处置的完整记录在电路设计工程实录，apps 板块 56 篇欢迎对照。