现成古建参数化方案调研 v0.1

目的:在做母板之前先确认——有没有现成的古建模块/平台可以直接拿来用,省掉自研
编制:小明(建筑设计师)| 2026-11-16
取证方式:公开网页 + 仓库页读到的信息。全部标「未验证」——没有一家我实际装过、跑过、量过它的输出精度。


1. 结论先行(三句话)

  1. 没有能直接用的。 面向"按通则出尺寸、出构件表、出施工图"这一条,六家没有一个可以嵌进我们的流水线。
  2. 但架构有得抄。 ACA-Builder 的八段式模块划分、chbim 的「缝编码 + 构件 JSON」数据模型,正好补我们现在缺的两块(模块边界、可互操作的数据格式)。
  3. 自研路线是对的,不是白干。 我们的引擎已经能出 13/13 对表的母板 + 352 图元三维 + 构件表,这条路没有现成替代品。

2. 六个候选,逐个体检

#方案是什么体系获取方式能否直接用可借鉴什么
1ACA-Builder「筑韵古建」Blender 插件,Python 实现清官式(《清工部工程做法则例》)GitHub 仓库 ppddry/ACA-Builder:实为 18 个 Python 文件、约 500 KB 源码(buildBeam / buildDougong / buildRoof / buildRooftile / const.py 等),但无 LICENSE(默认保留所有权利);正式安装包走腾讯文档里的联系方式⚠️ 代码不可抄(无许可),但可读、可当算法参照;绑 Blender,仍不能直接嵌① 模块八段划分:台基→柱网→装修→斗科→梁架→椽架→翼角→瓦面 ② 「斗口 + 柱径」双模数 ③ 举折/收山/推山参数化口径 ④ 冲三翘四的系数化实现(见 §7)
2GuCAD 古建软件中建研科技(中国建研院)自研三维 CAD明清官式 + 民居商业软件,闭源,绑自研图形平台❌ 不能(闭源 + 自研平台,无法嵌 Python 链路)① 产品分类法:殿堂/门式/亭/牌楼/墙廊桥 ② 能出二维施工图——这是我们最终要到的终点,值得当成果对照
3yingzao(YingZao_PyPI)Python 核心包 + Grasshopper 插件宋《营造法式》开源仓库(Coding-X),模块 ancientArchi/:Dou、Gong、PuZuo、TimberStructuralFrame、Column、CuttingToolBody❌ 不能(宋式≠清式,且绑 Rhino/GH)① "构件 = 数据 + 切割刀具"的建模哲学 ② SQLite/JSON 驱动的参数库 ③ 铺作装配的求解器分层
4chbim-prototype开源原型,OpenSCAD 几何核心 + Python 粘合中国古建(缝编码体系)开源仓库 Chartreuse310/chbim-prototype,MVP 阶段❌ 不能(MVP 只做到檐柱,远不成熟)★ 架构最像我们:JSON 描述构件 → 生成几何 → 导出三视图;"缝(seam)"作为轴线编码单位,比我们现在的"开间/步架"更接近大木做法
5threejs-architecture-effects前端程序化生成(Three.js)视觉化(非尺寸体系)开源代码❌ 不能(无尺寸规则,纯视觉)① 飞檐用幂函数 profile(height*(1-t)^1.75 + 端部抬升)② 上万零件合并批处理 + GPU 位移,性能做法值得抄
6ARCHICAD GDL 古建(行业实践)GDL 参数化部件 + 屋面系统《营造法式》材份 + 清式混用需 ARCHICAD 授权 + 自研 GDL 部件❌ 不能(绑 ARCHICAD)"HOTSPOT 热点驱动"的交互:拖热点改举折,比填参数表直观——这是我们查看器该学的

3. 为什么不选它们(逐条给理由,不是嫌麻烦)

否决理由说明
~~拿不到代码~~ (此条已作废,见 §7)ACA-Builder 源码是可得的(18 个 py);真正的障碍是无许可证不可抄 + Blender bpy 生态,脱离 Blender 不成立
绑死宿主软件Rhino/Grasshopper、ARCHICAD、Blender、OpenSCAD —— 我们现有链路是「DWG 取数 → Python 引擎 → 单文件 three.js / 施工图」,任何一家进来都要推倒重来
体系不对yingzao 是宋式材份制,我们是清式举架。混用会出错,不是"差不多的东西"
成熟度不够chbim 的 MVP 只到檐柱;拿它当基础,等于替别人做开发
不能出图除 GuCAD 外,其余都是"造型工具",出不了我们要的施工图与构件表

4. 从它们身上拿什么(这是本次调研的实际收益)

4.1 立刻可用的两条

借鉴项来源落到哪
八段式模块划分ACA-Builder我们现在的引擎是"一条链算到底",缺模块边界。后续按「台基 / 柱网 / 装修 / 梁架 / 椽架 / 翼角 / 瓦面 / 出图」切模块,翼角才能独立开发不牵动主体
缝(seam)编码chbim-prototype现在用"开间索引 + 步架索引",跨软件对接会歧义。改成"缝号 + 构件号"(如 J2-C-07),对施工图轴网、对构件表、对大木编号都是同一套号

4.2 待条件成熟再用

借鉴项来源前提
热点拖动改举折ARCHICAD GDL 实践查看器要先有"参数 ↔ 几何"双向绑定
幂函数飞檐曲线threejs-architecture-effects做翼角时用它的 profile 思路,但曲率必须由冲三翘四算,不能用视觉拟合
批处理合并几何同上图元过万时(现在 352 不用急)
双模数(斗口 + 柱径)ACA-Builder上大式(带斗拱)时必需

5. 建议路线(需拍板的部分标出来)

路线用途建议是否需拍板
A. 自研引擎(继续)尺寸推导 / 构件表 / 参数化模型 / 施工图✅ 主线,母板已跑通 13/13 对表否(已在做)
B. 采购 ACA-Builder 一份只作第二意见对表:拿它生成的同一栋房子,和我们的母板比尺寸,看谁偏离则例建议先问价,值不值得买看报价⚠️ 要花钱,须你拍板
C. GuCAD 试用只作成果形态对照:看它出的施工图长什么样,反推我们出图要补什么可申请试用,不采购⚠️ 需你决定是否接触供应商
D. 用 Rhino/Blender 链路—❌ 不建议,与现有链路冲突—

我的判断:主线必须自研(A),理由不是"我们能写",而是只有自研才能把"通则层 / 地域层"分开——现成工具全是"一套参数生成一个房子",没有一家把"哪些是则例、哪些是实测"做成可追溯的两层。而这恰恰是设计院出图最需要的东西(业主问"你这尺寸哪来的",得答得出)。


6. 本次调研的取证边界

  • 六家的能力描述全部来自其公开页面/仓库 README,我没有安装、没有跑、没有量过它们的输出精度。
  • 因此"能否直接用"是基于获取方式与技术栈的判断,不是实测结论。
  • ACA-Builder 的售价、GuCAD 的报价:未知,未询价。
  • 若后续要正式引用(写进方案/汇报),建议至少实测一家(优先 ACA-Builder,体系最对口)。

调研 v0.1 · 2026-11-16 · 下一步:母板已落地(见 02_母板定义书_v1.0.md),改良版在母板上只动 L2 层


7. 订正(2026-11-17):ACA-Builder 源码实测,v0.1 判断有误

7.1 撤回

v0.1 写的「仓库只有 README、拿不到代码」是错的。 2026-11-17 用 git ls-tree 实测:仓库共 23 个文件,其中 18 个 .py,另有 template/*.xml(Blender 面板)与 package.bat;buildRoof.py 单文件 144 KB,buildBeam.py 58 KB。GitHub API 亦报 language=Python、size≈68 MB(体积主要是贴图)。

错因:v0.1 只看了仓库首页渲染后的 README 与「无 Releases」,把「没有发行包」误推成「没有源码」。这是看页面不看树的典型错,记入教训。

7.2 现状([已验证],读源码原文)

项实测
许可无 LICENSE 文件 → 默认保留所有权利。代码不可复制,只能读
体系README 自述「依照《清工部·工程做法则例》,内置模数化权衡算法」,清官式,与我们同体系
能力硬山/悬山/歇山/庑殿/盝顶(含卷棚);台基·柱网·装修·清式斗科·梁架·椽架·翼角·瓦面;自动 UV 与和玺彩画贴图
模数DEFAULT_DK = 0.08(默认斗口 80 mm);「斗口 + 柱径」双模数

7.3 读出来的三条硬口径(对我们直接有用)

  1. 冲出、起翘按「椽径」为单位做系数,不是按角度也不是按固定长度:

buildRoof.py 中 ex_length += bData.chong * con.YUANCHUAN_D * dk(冲出)、
起翘点 + bData.qiqiao * con.YUANCHUAN_D * dk,注释写「翘四:默认起翘 4 椽」。
→ 即「冲三翘四」被实现成 冲出 = 3 × 椽径、起翘 = 4 × 椽径(YUANCHUAN_D 为椽径的斗口倍数)。

  1. 冲的分解:buildRoof.py:1185 注释「飞椽平出 + 冲 1 椽(老角梁已经冲了 2 椽)」,

→ 冲三 = 老角梁 2 椽 + 仔角梁/飞椽 1 椽。这条给了我们翼角构件拆分依据。

  1. 末步举架按 0.9 计(buildRoof.py:2977 注释「按最后一步架举架 0.9 计算」),与则例九檩 0.9 一致。

另有注释引用「汤书 p171」(讲起翘要补偿半个椽/0.75 斗口),书名未核实,暂标 [未验证],不当依据用。

7.4 对我们在做决策的影响

  • 翼角不必先拍「1.4 还是 1.414」:既然冲出是显式几何偏移(按椽径计),角梁长度就由两端点求距得出,系数只影响端点位;「方五斜七」的 1.4 是估料口诀,不是几何真值。建议:几何用真值、算料用口诀,两条并列写清——这与我们「算料长 / 建模长」分离的做法一致。
  • 新增一条第二意见来源:ACA 源码可作算法参照(尤其斗科、瓦面、翼角),但它无许可证 → 只读,不抄,不引入 engine/。

03 v0.2 订正 · 2026-11-17 · 源码已稀疏存入 vendor/_ref/ACA-Builder/(仅 py + xml,1.2 MB)