Benchmark · 体系对标

别人的古建参数化,
哪一层能抄、哪一层不能抄

把 GuCAD、yingzao、九野营造、chbim、ACA-Builder 逐维度拆开,只回答一个问题: 我们的构件架构该改哪里。

取证方式:三家均已取得源码副本,逐份读代码,不靠二手描述; GuCAD 为闭源,只能依据官方产品说明与其配套著作《中国古代建筑计算机设计方法》(建工社 2009)。

0. 先说一个坑:「yingzao」是三个不同的东西

Coding-X 的 yingzao(YingZao_PyPI)

宋《营造法式》数驱参构系统。Python 核心 + Grasshopper 插件,模块 Dou / Gong / PuZuo / Column / TimberStructuralFrame / CuttingToolBody。底层是 SQLite/JSON 参数表 → 构件几何 + 切割刀具。绑 Rhino。

宋式,与我们的清式不同源;在许可未核实前未克隆(取证记录见研究区备忘)。

九野营造 lvxiangyu11/jiuye-yingzao

GPL-3.0 代码 + CC BY-NC-SA 文档。有 4.9 万字的中文技术手册,把宋式举折、清式举架、民间坡度、平顶四种剖面统一到一个屋面函数。

★ 已取得源码副本(只读文档),代码不进引擎(GPL)。

itsharex/guizang-yingzao-skill

一个 AI 出图的视觉技能包,名字带 yingzao 但做的是「古建风格图像生成」。

与参数化无关。搜「yingzao」很容易撞上它,注意别弄错。

搜索「yingzao」会同时撞上这三家。第一家是宋式参数化系统(我们该研究的), 第二家是融合式可视化(我们已经拿到并读了手册),第三家是出图工具(与参数化无关)。 不先分清就调研,结论会串味。

1. 六方逐维度对比

维度GuCADyingzao(Coding-X)九野营造chbimACA-Builder本引擎
体系明清官式 + 北京四合院宋《营造法式》宋式为主,融合清式/民间/平顶中国古建(缝编码)清官式清式 + 北京民居四合院
技术栈自研纯中文三维平台(PKPM3D 系)Python 核心 + Rhino/GrasshopperPython + Blender/MC 生态OpenSCAD + PythonBlender bpy 插件纯 Python 无依赖 + three.js 单文件
数据模型参数表(面宽/檩数/间数/步举架值)SQLite / JSON 参数表 → 构件几何统一高度函数 + 风格系数构件 JSON + 缝(seam)编码const.py 常量 + 逐构建函数primitive 数组(box/leg/prism)
构件划分殿堂/门式/亭牌楼/墙廊桥 四大类Dou / Gong / PuZuo / Column / Frame / CuttingTool统一屋面三拼片 + 分件按族(zhu/liang/lin/fang/chuan/ban)台基/柱网/装修/斗科/梁架/椽架/翼角/瓦面按「作」分模块(木/瓦/石)
出图能力★★ 能出二维施工图(其核心卖点)无(造型工具)无(导出 GLB 到 Unity)有三视图导出(挡案级)无构件表 + 参数表;施工图未做
许可闭源商业(须采购)开源(需查具体协议)GPL-3.0(代码)+ CC BY-NC-SA(文档)MIT(最宽松)无 LICENSE(保留所有权利)自有
能否嵌入我们的链路❌ 闭源 + 绑平台❌ 宋式 ≠ 清式 + 绑 Rhino❌ 几何精度不足❌ MVP 只到檐柱❌ 绑 Blender + 代码不可抄—
一个值得注意的巧合:GuCAD 官方说明里,控制建筑体量的参数只有四个—— 面宽、檩数、间数、步举架值。这与我们引擎的 bays_mm / purlin_count / depth_mm / jiajia 完全一致。这不是抄的,是两拨人各自从《工程做法》推出来的同一个结论: 清式建筑的自由度就在这四个维度上。这算是对我们参数选择的一次独立验证。

2. ★ 能学的:五条,按投入产出排序

lv

title

来源:src
它怎么做

what

我们怎么做

ours

★ 该怎么改

act

lv

title

来源:src
它怎么做

what

我们怎么做

ours

★ 该怎么改

act

lv

title

来源:src
它怎么做

what

我们怎么做

ours

★ 该怎么改

act

lv

title

来源:src
它怎么做

what

我们怎么做

ours

★ 该怎么改

act

lv

title

来源:src
它怎么做

what

我们怎么做

ours

★ 该怎么改

act

lv

title

来源:src
它怎么做

what

我们怎么做

ours

★ 该怎么改

act

3. 不能学的:五条

不要学为什么
GuCAD 的平台闭源商业 + 自研图形平台。学它的成果形态(能出施工图)就够了,不必学它的技术路线——我们已经有 three.js 与 Python,不需要第三个平台。
yingzao 的宋式参数宋式是材份制,清式是斗口制,两套模数不同源。拿宋式尺寸填清式参数,做出来的房子两边都不像。
ACA-Builder 的代码无 LICENSE = 保留所有权利。可读、可学算法思想,任何形式的代码复制都不行。
九野营造的几何精度它明确是「简化几何」,目标是导出 GLB 进 Unity 做可视化,不是出施工图。它的模型结构值得学,尺寸精度不能当依据。
chbim 的 OpenSCAD 核心几何核心是 .scad,与我们的 Python 链路不兼容。只取它的 schema 与编号规则(MIT,可抄)。

4. 我们的位置:唯一做对的一件事

五家里,没有一家把「这条尺寸的证据等级」做进数据模型。

GuCAD 只给结果,不给依据。
yingzao 把《营造法式》转成了数据库,但只存参数,不存「这个参数是原文还是推定」。
九野营造做得最细,标了【原文 卷四】【推定】,但那是写在文档里,不进引擎、不进输出。
chbim 的 schema 有 src 出处字段(这点最好),但只到「出处」,不到「证据等级」。

我们是唯一把八态标记(已验证·原文 / 工匠口径·转引 / 缺口 / 未实现 …) 贯穿到规则库、构件、输出报告的。
这不是自夸——是设计院出图的真实需求:业主问「你这个尺寸哪来的」, 别人答「软件生成的」,我们答「《工程做法》卷二十四,原文这么写,我们复现过 66 条算例」。

5. 建议的改造顺序(要拍板的标出来)

序动作为什么排这个位置需拍板
1primitive 加 seam 字段 改动最小(只加不换),但解锁两件事:改模数全模型跟随、构件能出施工图编号。MIT 可抄。 否
2规则库加 expr 字段 + 双向校验 把规则库从文档变成可执行规格。做一次,以后每条规则自动对账。否
3抽 section.py(剖面制度可插拔) 不做假想工程——但接江南或明代项目时,这是唯一出路。 ⚠ 要:得先定「做不做地域扩展」
4抽 roof_surface.py(拼片统一) 投入最大(要重写 model3d 的屋顶部分),收益也最大(屋顶形式 4→10+)。 ⚠ 要:要评估重写风险
5按八段切模块 工程卫生,不急。等 3/4 做完再切才有意义。否
6出二维施工图 先别做。没有缝编码就出图,改一次模数全废。⚠ 要:什么时候开始出图
我的判断:第 1、2 两条现在就该做,成本低、不改进现有输出、收益立刻可见。 第 3、4 条是架构级重写,只有在你确认「要接非清式项目」之后才值得动手—— 否则就是为不存在的需求重写一套能跑的引擎。这两条我不替你拍板。

6. 取证边界