现成古建参数化方案调研 v0.1
目的:在做母板之前先确认——有没有现成的古建模块/平台可以直接拿来用,省掉自研
编制:小明(建筑设计师)| 2026-11-16
取证方式:公开网页 + 仓库页读到的信息。全部标「未验证」——没有一家我实际装过、跑过、量过它的输出精度。
1. 结论先行(三句话)
- 没有能直接用的。 面向"按通则出尺寸、出构件表、出施工图"这一条,六家没有一个可以嵌进我们的流水线。
- 但架构有得抄。 ACA-Builder 的八段式模块划分、chbim 的「缝编码 + 构件 JSON」数据模型,正好补我们现在缺的两块(模块边界、可互操作的数据格式)。
- 自研路线是对的,不是白干。 我们的引擎已经能出 13/13 对表的母板 + 352 图元三维 + 构件表,这条路没有现成替代品。
2. 六个候选,逐个体检
| # | 方案 | 是什么 | 体系 | 获取方式 | 能否直接用 | 可借鉴什么 |
|---|---|---|---|---|---|---|
| 1 | ACA-Builder「筑韵古建」 | Blender 插件,Python 实现 | 清官式(《清工部工程做法则例》) | GitHub 仓库 ppddry/ACA-Builder:实为 18 个 Python 文件、约 500 KB 源码(buildBeam / buildDougong / buildRoof / buildRooftile / const.py 等),但无 LICENSE(默认保留所有权利);正式安装包走腾讯文档里的联系方式 | ⚠️ 代码不可抄(无许可),但可读、可当算法参照;绑 Blender,仍不能直接嵌 | ① 模块八段划分:台基→柱网→装修→斗科→梁架→椽架→翼角→瓦面 ② 「斗口 + 柱径」双模数 ③ 举折/收山/推山参数化口径 ④ 冲三翘四的系数化实现(见 §7) |
| 2 | GuCAD 古建软件 | 中建研科技(中国建研院)自研三维 CAD | 明清官式 + 民居 | 商业软件,闭源,绑自研图形平台 | ❌ 不能(闭源 + 自研平台,无法嵌 Python 链路) | ① 产品分类法:殿堂/门式/亭/牌楼/墙廊桥 ② 能出二维施工图——这是我们最终要到的终点,值得当成果对照 |
| 3 | yingzao(YingZao_PyPI) | Python 核心包 + Grasshopper 插件 | 宋《营造法式》 | 开源仓库(Coding-X),模块 ancientArchi/:Dou、Gong、PuZuo、TimberStructuralFrame、Column、CuttingToolBody | ❌ 不能(宋式≠清式,且绑 Rhino/GH) | ① "构件 = 数据 + 切割刀具"的建模哲学 ② SQLite/JSON 驱动的参数库 ③ 铺作装配的求解器分层 |
| 4 | chbim-prototype | 开源原型,OpenSCAD 几何核心 + Python 粘合 | 中国古建(缝编码体系) | 开源仓库 Chartreuse310/chbim-prototype,MVP 阶段 | ❌ 不能(MVP 只做到檐柱,远不成熟) | ★ 架构最像我们:JSON 描述构件 → 生成几何 → 导出三视图;"缝(seam)"作为轴线编码单位,比我们现在的"开间/步架"更接近大木做法 |
| 5 | threejs-architecture-effects | 前端程序化生成(Three.js) | 视觉化(非尺寸体系) | 开源代码 | ❌ 不能(无尺寸规则,纯视觉) | ① 飞檐用幂函数 profile(height*(1-t)^1.75 + 端部抬升)② 上万零件合并批处理 + GPU 位移,性能做法值得抄 |
| 6 | ARCHICAD 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 读出来的三条硬口径(对我们直接有用)
- 冲出、起翘按「椽径」为单位做系数,不是按角度也不是按固定长度:
buildRoof.py 中 ex_length += bData.chong * con.YUANCHUAN_D * dk(冲出)、
起翘点 + bData.qiqiao * con.YUANCHUAN_D * dk,注释写「翘四:默认起翘 4 椽」。
→ 即「冲三翘四」被实现成 冲出 = 3 × 椽径、起翘 = 4 × 椽径(YUANCHUAN_D 为椽径的斗口倍数)。
- 冲的分解:
buildRoof.py:1185注释「飞椽平出 + 冲 1 椽(老角梁已经冲了 2 椽)」,
→ 冲三 = 老角梁 2 椽 + 仔角梁/飞椽 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)