古建参数化 · 最新动态简报 v0.1(2026-11-16 查)
目的:母板做完后,看外部有没有新东西能用、有没有新依据能补我们的缺口
编制:小明(建筑设计师)
取证:GitHub API + 论文正文 + 古籍转引。三态标注见文末 §7,别把"未验证"当结论用。
1. 一句话结论
有三条真收获,一条要当心。
- 加一个必须读的开源项目:九野营造(GPL-3.0,2026-10 新建)——它的"规则表由代码自动生成"正是我们缺的工程化做法。
- 翼角有 2026 年专门论文(Dynamo 实现,亚厘米精度),而且《工程做法》原文的角梁算法我拿到了——翼角不用等任何软件,可以直接按原文写。
- 我们的"椽中距"缺口,则例原文有答案:「每椽空档随椽径一分」→ 空档 = 椽径,中距 = 2×椽径。假设被原文证实了。
- ⚠️ 但要当心许可:九野营造代码 GPL-3.0 + 「商业闭源集成须另行授权」,文档 CC BY-NC-SA。我们的成果是要出图的商业交付,只能读思路,不能复制代码或文档内容。
2. GitHub 侧:三个仓库体检
| 仓库 | 是什么 | 更新 | 许可 | 能不能用 |
|---|---|---|---|---|
| lvxiangyu11/jiuye-yingzao<br>九野营造 | Blender 插件,按宋《营造法式》参数化生成。87 种类型、16 风格、11 种屋顶、LOD0-2,可导出 GLB/FBX | 建仓 2026-10-28,最后 push 2026-10-28,2 star | GPL-3.0-or-later(代码)<br>CC BY-NC-SA 4.0(文档图片)<br>商业闭源须另行授权 | ❌ 不能直接用<br>✅ 必须学习 |
| in-a-mist/miniLibs | Rhino 平台中国古建参数化构件库,明确「以《营造法式》与《工程做法则例》为本」 | 2023-09 停更,17 star | MIT | ❌ 绑 Rhino<br>✅ 许可最松,构件分类可参考 |
| Chartreuse310/chbim-prototype | 缝编码 + OpenSCAD 原型,MVP 只到檐柱 | 2026-09 | 开源 | ❌ 太早期 |
九野营造里最该学的一条
它的 技术手册_附表.md(36KB)是自动生成的,文件头写着:
由
tools/gen_manual_tables.py从data/types.json、data/styles.json、gen/specials.py… 生成,勿手改。
这意味着它的规则表与代码永远同源,不会脱节。对照我们:01_参数规则库.md 是手写的,改了代码忘了改文档就会漂。这个做法我们应该抄——把规则表从 rules.py 生成出来。
它的参数体系(附表暴露的,对我们有参考)
| 风格 | 举屋方法 | 出檐系数 | 起翘/B | 生出/B | 生起 | 侧脚 | 梭柱 | 铺作高/柱高 |
|---|---|---|---|---|---|---|---|---|
| 宋式 | song | 1.0 | 0.09 | 0.05 | 是 | 是 | 0.06 | 0.32 |
| 明式 | song | 0.9 | 0.08 | 0.03 | 否 | 是 | 0 | 0.20 |
| 清官式 | qing | 0.85 | 0.08 | 0.02 | 否 | 否 | 0 | 0.12 |
| 江南 | folk | 0.8 | 0.20 | 0.06 | 否 | 否 | 0 | 0.08 |
| 中原北地民居 | folk | 0.55 | 0 | 0 | 否 | 否 | 0 | 0 |
两点值得记:
- 它把清官式"保留但弱化"(README 原话:自动选择时不会选到)——说明作者自己判断清式在其体系里不是强项,这反证清式这块仍是空档,我们的方向没撞车。
- 翼角参数用"起翘/B、生出/B"的相对比值(B 应是材/斗口级模数)——这是翼角参数化的一种简洁口径,可与我们"冲三翘四按椽径"对照。
3. 学术侧:2026 年五篇,三篇要细读
★★★ 3.1 翼角参数化(Dynamo,2026)
A simulation–driven digital twin framework for parametric design of wing corner structures in traditional Chinese architecture using Dynamo
Cheng Zhang, Jie Zhou(义乌工商职业技术学院)|Int. J. Modeling, Simulation, and Scientific Computing|DOI10.1142/S1793962326500418
- 四阶段参数化建模流程,生成两种类型的翼角:
- 北方官式·刚性(守《营造法式》)
- 南方园林·柔性(守《营造法原》)
- 验证:太和殿 + 殿春簃,亚厘米级(sub-centimeter)精度
- 明确的立论:Scan-to-BIM 只能生成不可编辑的静态网格,不够做改造模拟与结构评估;必须把做法规则编码成计算表示
- 对我们的直接价值:这正是我们 M3 翼角要的"两种类型"框架——刚性与柔性并存,与我们的「通则层 vs 地域层」完全同构。
★★★ 3.2 明清大木隐蔽参数推断(MDPI Buildings 2026, 16(19):3871)
Knowledge-Driven Inference of Hidden Structural Parameters in Ming–Qing Large Woodwork
集成点云 + 传统做法规则
这篇是我们参数体系该升级的方向,方法很硬:
| 它做的 | 我们现在 |
|---|---|
参数空间 S = ⟨C, P⟩:Component Schema(名称/ID/类别/位置/拓扑)+ Parameter Schema(名称/语义/类型/单位/当前值/取值范围/状态标签/推理深度) | 只有 dict,参数没有"状态"字段 |
| 参数三态:Observed / Missing / Inferred,每次状态转移留痕 | 文档里手写 [已验证/待核/缺口],代码里没有 |
| Reasoning Depth 按依赖深度排序,只有前置参数都有值才激活规则 | 推导顺序硬编码在 solve.py 里 |
规则条目字段:Rule_ID / Rule_Type / Relevant_Parameters / Mathematical_Formula / Rule_Source | 只有"公式 + 出处"两栏 |
| 三类约束:比例 y∈[αx, βx]、关系 y=kx+b、空间(轴线对齐/榫卯/支承) | 只有"关系"一类(全是等式) |
| 实现:Z3 约束求解器 | 直接算,无求解器 |
实测数据(崇善寺大悲殿,120 个构件实例):
- 68 条规则,39 条实际参与(2 比例 + 34 关系 + 3 空间)
- 1848 个隐蔽参数,推出 1800 个 → 求解率 97.4%
- 48 个未解,原因不是算错,是规则库缺"锁销节点"约束 → 保持 Missing,绝不硬填
- 精度:本文 4.5cm 平均偏差(人工测绘 4.2cm、纯点云拟合 0.5cm),但建模耗时 6.5h(人工 58–70h)
- 作者自己承认:求解率≠数值精度;点-模型距离只反映可观测表面,不能当作隐蔽参数的真值验证
这条对我们最有用的不是数字,是那句"保持 Missing,绝不硬填"。 我们现在对缺口项(望板厚、椽档、瓜柱径)是给个经验值就往下算——它证明更正确的做法是留空 + 标状态 + 终止依赖它的传播。
★★ 3.3 闽北传统民居大木构架规则驱动参数化(2026)
陈恒毅(武夷学院)|《建筑与设计》2026, 2(6)
- 四类计算要素:基础参数 / 派生参数 / 构件对象 / 关系规则 ← 与我们 L1/L0/构件表/规则几乎一一对应
- 核心输入:标柱高度、面阔、步架、分水系数(= 我们的举架成数,南方叫分水)
- 五步:柱网定位 → 柱高递推 → 构件标高求解 → 离散尺寸校正 → 拓扑装配
- 约束:等高、中点、比例定位、搭接、从属;约束图组织参数传播顺序
- 验证:三组边界参数,几何约束残差为零
- "离散尺寸校正"就是我们把尺寸归到清尺/整寸那一步——有人已经把它写成方法论了,我们不是拍脑袋。
★ 3.4 开平碉楼 HBIM(MDPI Appl. Sci. 2026, 16(16):8225)
- 参数化构件库 + 三级编码系统(three-tier coding) + LOD/LOI 值域驱动
- 对"构件编码"有参考:它用三级编码处理非标准构件,正是我们要解决的"缝号+构件号"
★ 3.5 点云参数化重建(Springer, SN Applied Sciences 2026)
- RANSAC + 最小二乘提取弧线布置路径与圆角矩形截面参数 —— 与"实测反算"路线相关,暂不急
4. ★ 最实用的一条:《工程做法》角梁原文算法(可直接补我们的翼角)
来源:微信公众号《清工部〈工程做法〉笔记·卷二十二 四角攒尖方亭大木做法》所引原文(转引,未见影印本,见 §7)。
| 构件 | 原文算法 | 我们现在的状态 |
|---|---|---|
| 仔角梁 | (步架 + 出檐) × 方五斜七 1.4 × 一一五加举 1.15,再加翼角斜出三椽径(即"冲三"),再加套兽榫(长 = 角梁厚,高 3 椽径,宽 2 椽径) | 未做 |
| 老角梁 | 仔角梁长 − 飞檐头 − 套兽榫,再加后尾三岔头(照交金檩厚一分) | 未做 |
| 由戗 | 步架 × 1.4 × 一二五加举 1.25 | 未做 |
| 檐椽 | (步架 + 出檐) × 1.15,用飞椽时再减飞檐头 | ✅ 已做(用精确 √(1+h²)) |
| 椽径 | 桁条径 × 3/10 | ✅ 已做(柱径/3,檩径=柱径,等价) |
| 椽档 | 「每椽空档随椽径一分」→ 空档 = 椽径 | ⚠️ 原为缺口假设,现被原文证实 |
| 椽数 | 「椽数应成双,档之宽窄随数均匀」→ 必须偶数、均匀分档 | ⚠️ 全屋 98 为偶,但每坡 49 为奇;若「成双」指每坡则母板不合 —— 口径待定,已记入自检报告 |
| 翼角翘椽 | 长径同平身檐椽;起翘 = 出檐 × 1.4 + 步架 | 未做 |
三个必须记住的技术细节
- 「方五斜七」古人用 1.4,不是 1.414。 我们引擎用精确 √2,则例用 1.4 —— 角梁长度会差 1%(约 7 cm)。翼角模块必须明确:按则例口径用 1.4,还是按几何精确值? 这是个要拍板的口径问题,不能含糊。
- 加举口算系数是"取整放大"的:五举 1.15(精确 1.118)、七举 1.25(1.221)、八举 1.30(1.281)、九举 1.35(1.345)。则例值系统性偏大 1–2%,是匠人为便于记忆取整。我们用精确值是对的,但报告里必须写明"则例原值为口算放大值"。
- "冲三"是三椽径,且是构件延伸长度不是水平长度(原文明确)。这一条极易做错。
5. 顺带确认:三种屋面定坡法别混用
| 法 | 朝代/地域 | 做法 |
|---|---|---|
| 举折 | 宋《营造法式》 | 先定脊高(举高 = 总进深 1/3~1/4),再自上而下折 R/10、R/20、R/40 |
| 举架 | 清《工程做法》(我们用的) | 自下而上逐步递增(五举、七举、九举) |
| 提栈 | 南方民间 | 从檐檩起算 1/10 界深,逐界递增(三算半、四算…十算/对算) |
我们的母板用举架没问题(清式小式)。但改良版如果做南方民居(如岭南、江南),必须换"提栈",不能拿举架硬套——这是体系问题,不是参数问题。
另有一条气候学旁证(2026,南大 + 中科院):唐→明清屋顶坡度整体变陡(高跨比 20%→35%),与寒冷期降雪增加相适应;举架法在明代中后期出现并于 1730s 入规范。这解释了我们母板"脊步七举"为什么比宋式陡——不是随意的,是气候驱动。
6. 对我们的三个动作(按优先级)
| 优先级 | 动作 | 依据 | 代价 |
|---|---|---|---|
| 1 | ~~把"椽中距"缺口升级~~ ✅ 已做(2026-11-16):RAFTER_SPACING_STATUS 由 缺口 → 待核原文,依据改为原文条款;同时新增"椽数成双(口径)"待核项,暴露"每坡 49 根为奇"的问题 | §4 原文转引 | 已完成,29 项测试仍全绿 |
| 2 | 规则表改为自动生成(抄九野营造做法):写 tools/gen_rules_doc.py,从 rules.py 生成 01_参数规则库.md 的表格部分 | §2 九野营造 | 半天;防止文档与代码漂移 |
| 3 | 翼角按原文自己实现,不买任何软件:先做仔角梁/老角梁/由戗/翘椽四条,参数为"冲三椽径 + 起翘",口径待你拍板(1.4 还是 √2) | §3.1 + §4 | 这个月的活 |
暂不做:
- 引入 Z3 求解器 / Observed-Missing-Inferred 状态机 → 方向对,但我们现在算例规模小,等参数上到上千再上(现在上等于给 16 个构件配一套重武器)
- 采购任何一家(ACA / GuCAD / 九野商业授权)→ 见 §7 红线
7. 许可红线与取证边界(重要,别越)
7.1 许可
| 对象 | 许可 | 我们能做什么 |
|---|---|---|
| 九野营造 代码 | GPL-3.0-or-later | ❌ 不能复制进我们的交付(GPL 传染,我们必须开源);✅ 可以读、可以学做法、可以自己重写 |
| 九野营造 文档/图片 | CC BY-NC-SA 4.0 | ❌ 禁止商用。技术手册里的规则表述不能抄进我们的商业文档 |
| miniLibs | MIT | ✅ 最宽松,可参考可复用(但它绑 Rhino) |
| MDPI 论文(Open Access) | CC BY | ✅ 可引用可改写(需署名) |
| World Scientific 翼角论文 | 付费墙 | ⚠️ 只读到摘要,不能引用正文细节 |
结论:九野营造只能当"教科书"读,不能当"零件库"用。 我会保持这条线。
⚠️ 2026-11-17 编者注(此条已放宽):小明定为研究用途、非商用。据
07_研究用途许可口径_v1.0.md:GPL 义务只在分发时触发,故内部研究可直接 clone、直接跑、整段读;文档按「署名 + 同协议 + 非商用」引用即可。但交付物仍不得含 GPL 代码与 NC 原文——三区隔离照旧。
7.2 三态标注
- [已验证] 九野营造仓库存在、GPL-3.0、附表自动生成、参数体系表 —— 读了 GitHub API 与 raw 文件原文
- [已验证] MDPI Buildings 3871 的方法、97.4% 求解率、三类约束、Z3 实现 —— 读了论文正文
- [已验证] 闽北论文的方法框架 —— 读了期刊页摘要
- [未验证] 翼角 Dynamo 论文的"亚厘米精度" —— 付费墙,只读到摘要,是作者自述,我没跑过
- [未验证] 九野营造的实际出模质量 —— 没装 Blender、没跑过
- [原文转引] 《工程做法》卷二十二角梁算法 —— 来自公众号所引原文,未与影印本逐字核对。出图引用前必须回影印本
7.3 尚未查到 / 待补
- 维基文库是否有《工程做法》全文:九野营造 README 明确《营造法式》34 卷在维基文库(可直接用),但《工程做法》我只查到《钦定大清会典则例》(工部部分,含城垣规制,不是大木做法)。《工程做法》全文目前只见于 kandianguji.com(2323 页,需注册)和中国哲学书电子化计划之外的古籍站。这是下一步要解决的最大缺口——母板里 8 条"待核原文"全卡在这。
- 国内 CNKI/建筑学报侧因无检索权限未覆盖,只用公开搜索覆盖到 2026 年论文摘要
本简报 v0.1 · 2026-11-16 · 下一步:先做 §6 第 1 项(10 分钟可完成),第 2、3 项等你点头