古建参数化 · 最新动态简报 v0.1(2026-11-16 查)

目的:母板做完后,看外部有没有新东西能用、有没有新依据能补我们的缺口
编制:小明(建筑设计师)
取证:GitHub API + 论文正文 + 古籍转引。三态标注见文末 §7,别把"未验证"当结论用。


1. 一句话结论

有三条真收获,一条要当心。

  1. 加一个必须读的开源项目:九野营造(GPL-3.0,2026-10 新建)——它的"规则表由代码自动生成"正是我们缺的工程化做法。
  2. 翼角有 2026 年专门论文(Dynamo 实现,亚厘米精度),而且《工程做法》原文的角梁算法我拿到了——翼角不用等任何软件,可以直接按原文写。
  3. 我们的"椽中距"缺口,则例原文有答案:「每椽空档随椽径一分」→ 空档 = 椽径,中距 = 2×椽径。假设被原文证实了。
  4. ⚠️ 但要当心许可:九野营造代码 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 starGPL-3.0-or-later(代码)<br>CC BY-NC-SA 4.0(文档图片)<br>商业闭源须另行授权❌ 不能直接用<br>✅ 必须学习
in-a-mist/miniLibsRhino 平台中国古建参数化构件库,明确「以《营造法式》与《工程做法则例》为本」2023-09 停更,17 starMIT❌ 绑 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生起侧脚梭柱铺作高/柱高
宋式song1.00.090.05是是0.060.32
明式song0.90.080.03否是00.20
清官式qing0.850.080.02否否00.12
江南folk0.80.200.06否否00.08
中原北地民居folk0.5500否否00

两点值得记:

  • 它把清官式"保留但弱化"(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|DOI 10.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. 「方五斜七」古人用 1.4,不是 1.414。 我们引擎用精确 √2,则例用 1.4 —— 角梁长度会差 1%(约 7 cm)。翼角模块必须明确:按则例口径用 1.4,还是按几何精确值? 这是个要拍板的口径问题,不能含糊。
  2. 加举口算系数是"取整放大"的:五举 1.15(精确 1.118)、七举 1.25(1.221)、八举 1.30(1.281)、九举 1.35(1.345)。则例值系统性偏大 1–2%,是匠人为便于记忆取整。我们用精确值是对的,但报告里必须写明"则例原值为口算放大值"。
  3. "冲三"是三椽径,且是构件延伸长度不是水平长度(原文明确)。这一条极易做错。

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❌ 禁止商用。技术手册里的规则表述不能抄进我们的商业文档
miniLibsMIT✅ 最宽松,可参考可复用(但它绑 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 项等你点头