00 · 古建木作参数化交互模型 · 需求梳理 v0.1(待小明确认)

版本:v0.1 梳理稿,未经确认,不动手 | 日期:2026-11-16 | 编制:小明(建筑设计师)| 整理:小蓝1号
上游口径:Z:\小蓝项目\_公共\古建知识库\00_项目口径卡.md(新建仿古 / T20V10 / t8 / 不新增图层)
状态:本文件只做「听懂了什么 + 怎么拆 + 卡在哪」,无代码、无模型、无图纸产出
三态:[已验证·原文] 有则例/官方原文可回读 | [待核原文] 多源一致但未见原件 | [缺口] 本地无依据


0. 一句话重述(听不懂就纠正我)

做一个网页上能转、能改参数、改了立刻重算重画的古建木构架模型:输入一间房的基本条件(跨度、柱高、椽径…),自动推出举架曲线、各檩标高、椽望瓦砖的全部尺寸与位置,把「翹角/翼角」这种最难的部分也参数化出来,最后做成一个能复用的工具箱。


1. ⚠️ 先纠一处:你把「跨度 → 檐口高 → 屋顶高」当成了输入链,这在古建里是反的

你说的顺序是:给跨度 → 出檐口高度 → 出结构标高与屋顶标高。
但按《工程做法则例》,实际是:

通进深 ──定步架划分──> 各步架长 ──×举架成数──> 各步举高 ──累加──> 各檩标高 ──> 屋脊标高
                            ↑
                    檐柱高(设计给定)、椽径(定材份)

结论:屋面曲线不是「跨度算出来的」,是「步架 × 举架成数」推出来的。檐口高度是设计条件(你定),不是计算结果。
跨度只做一件事:决定步架怎么划(几步、每步多长)。

所以「谁是自变量」必须你拍板,三种口径差别很大:

口径输入输出适用
A 正算(则例法)通进深、檩数、檐柱高、柱径、椽径全部构件尺寸与标高做设计、出图,最贴则例
B 反算(控高法)通进深、目标屋脊标高、柱高反解举架成数分布甲方给限高、规划控高时
C 双向(建议)A 的输入 + 可选脊高约束正算后与约束比对,不满足则提示并给反解实际工程就这两种情况来回切

我的建议:做 C。 引擎里先写正算,再加一层「给定脊高反解」,两个方向互为校验——反算出来的成数若不在则例表里,就是个红灯(说明这组条件本身别扭)。


2. 这套东西其实是三层,别混在一起做

层是什么能不能机器验证优先级
L1 参数引擎纯公式与规则:步架→举高→标高→构件尺寸,输出 JSON✅ 能(单元测试 + 用真图反算)先做
L2 三维表达把 JSON 画成能转能改的 3D 模型🟡 只能验证「形似」后做
L3 工具箱参数表导出、节点图、与施工图衔接🟡 部分最后

判断(我坚持这条):先做 L1 再做 L2。 反过来做,你会得到一个很漂亮但算错的模型——仿古最容易翻车就在这:看着像,尺寸全错。L1 可以先跑通、先算对、先用真图校,L2 只是换了个显示器。


3. 参数骨架(L1 的核心,这是要你逐条过的东西)

3.1 输入参数

组参数说明来源
平面明间面阔、次/梢间面阔或直接给总面阔 + 开间数设计给定
平面通进深、檩数(步架数)通进深 ÷ 步架数 = 步架长(均分法)设计给定
竖向檐柱高举架推算的起点设计给定
材份柱径一切断面的母数(小式)设计给定 / 按柱高比例
材份椽径椽、望板、翼角全部由它派生设计给定
材份斗口仅大式带斗拱需要,本期建议不做(见 §7)—
屋面瓦种(琉璃/布瓦)、瓦号(二样…九样 / 1#3#)定瓦口高、瓦垄数、屋面自重设计给定
屋面举架成数表(可覆盖)默认取则例,允许逐项改则例 + 设计微调
檐口出檐系数(默认 3/10 柱高)、翼角类型清式冲三翘四 / 南方发戗设计给定

3.2 推导链与出处

#推导规则出处三态
1步架长均分:通进深 ÷ 步架数;或 大式 廊步=0.4×檐柱高、其余=0.32×檐柱高;小式 廊步=5×檐柱径、其余=4×檐柱径梁思成《营造算例》建议值[待核原文]
2分举高分举高 = 步架长 × 举架成数《工程做法则例》[已验证·原文](多源同引)
3檩标高从檐檩起逐架累加:Z(i+1) = Z(i) + 步架(i) × 举架(i)同上[已验证·原文]
4平水(垫板高)檐垫板 高 = 柱径/2 + 2 寸;厚 = 0.2×柱径。垫板即是平水《则例》大木小式[已验证·原文]
5举架加斜(斜长系数)斜长 = 步架 × √(1+举架²)(五举 1.118、七举 1.221、九举 1.345、十举 1.414);则例另给近似「因」数表(五举 1.12…十举 1.414),二者略有出入,以原文为准《则例》加斜因表[待核原文]
6檐椽长长 = 步架 × 加斜 + 平出檐(平出檐 = 出檐总长 − 飞椽出)《则例》大木小式[已验证·原文]
7檐椽断面见方 = 柱径 1/3(或 3/10)《则例》[已验证·原文]
8上檐出无斗拱大式/小式:上檐出 = 3/10 × 檐柱高;檐椽出 : 飞椽出 = 2 : 1《则例》/ 古建木作营造技术[待核原文]
9飞椽飞头长 = 柱高/10;飞尾 = 3 × 飞头,通长 = 4 × 飞头;断面同檐椽;飞椽自身举 = 三五举(0.35)《则例》「每柱高一丈得飞头一尺,飞尾按头长三份」[已验证·原文]
10花架椽 / 脑椽长 = 步架 × 举架加斜(逐架变坡,所以逐架变长)《则例》[已验证·原文]
11连檐见方 = 椽见方;小连檐 高 = 椽径、厚 = 望板厚《则例》[已验证·原文]
12瓦口高板瓦:头号 4 寸 / 二号 3.5 寸 / 三号 3 寸;筒瓦:头号 3 寸 / 二号 2.5 寸 / 三号 2 寸;厚 = 0.3 × 高《则例》[已验证·原文]
13望板横望板 宽按前后椽凑宽扣连檐与金边(椽头金边 = 椽见方 × 2/10);宽用举架加斜(五举加 5 寸…十举加 1 尺)《则例》[已验证·原文](厚度规则未见明确值,见 §6 缺口)
14椽档 / 椽数按开间与椽径排布,需「椽档」规则(清式小式 椽档 ≈ 椽径 1 空?待核)—[缺口]
15瓦垄数由瓦号定瓦宽 → 屋面宽 ÷ 瓦宽;板瓦压七露三琉璃瓦铺法(清制)[待核原文]

3.3 举架成数表(清式,直接可编码)

檩数檐步下金步中金步上金步脊步
五檩(小式)五举 0.50———七举 0.70
七檩五举 0.50七举 0.70(或六五举 0.65)——九举 0.90(或八举 0.80)
九檩(大式)五举 0.50六五举 0.65—七五举 0.75九举 0.90
十一檩(大式)五举 0.50六举 0.60六五举 0.65七五举 0.75九举 0.90

出处:《工程做法则例》大木大式/小式做法。多源一致 [待核原文·高置信]。
仿古可微调:园林亭榭檐步常做四五举~五五举,四/六角亭脊步 ≤ 九举,城楼脊步可到九五举~十举。
宋《营造法式》举折是另一套(先定总举高 = 前后檐槫距 1/3 或 1/4,再自脊向檐逐槫折下),与清式举架方向相反,代码里必须是两个分支,不能混算。


4. 翘角 / 翼角:能参数化到什么程度(诚实边界)

能参数化的部分(清式官式,冲三翘四):

项规则三态
出翘(冲)仔角梁端水平投影 = 正身飞椽头再长出 3 × 椽径[待核原文·多源一致]
起翘(翘)仔角梁端上表面 = 正身飞椽头上表面高 4 × 椽径同上
角梁断面角梁断面高 ≈ 3 × 椽高同上
老角梁长按檐步架加斜 + 柱径 1.5 + 檐出(扣飞头),再按一四斜,加椽径 2 份《则例》大木小式 [已验证·原文]
仔角梁长按檐步架用一二斜 + 柱径半份 + 檐出,再用一四斜,外加椽见方 5 分;宽厚 = 2 × 椽径同上
枕头木(生头木)转角两侧檩上垫三角木,把角椽上皮垫到与角梁上皮平[待核原文]
宋式对照生起/生出:一间生 4 寸、三间 5 寸、五间 7 寸《营造法式》卷五 [待核原文]

不能纯公式算的部分(必须规则 + 逐根表):

  • 翼角椽是逐根变化的:椽长渐变、断面由方变菱形(撇度)、转折面斜度随大连檐曲线变(扭度)、后尾翘起程度变(翘度)。
  • 传统靠放线法解决:撇半椽、翼角搬增、扭脖子。这是一套作图程序,不是一条解析曲线。
  • 所以翼角模块的产物必须是一张「逐根椽参数表」(第 n 根椽:长/断面上宽下宽/倾角/起翘量),再由 3D 读表生成。指望一条公式生成整个翼角=做不出来,这点我提前说清,免得后面白费工。

5. 材料与瓦砖规格参数(可查表,直接进库)

5.1 琉璃瓦(清官式,国家文物局《清代官式建筑修缮材料·琉璃瓦》)

样数筒瓦 长×宽×高×厚 (mm)板瓦 长×宽×高×厚 (mm)
二样400×208×104423×323×528×28
三样368×192×96400×320×80
四样352×176×88384×304×76
五样336×160×80×19368×272×68×22
六样304×144×72×19336×256×60×20
七样288×128×64320×224×56
八样272×112×56304×208×52
九样256×96×48288×192×48

[已验证·官方] 出处 ncha.gov.cn 附件。表内部分厚度为「*」(维修以实物为准)。原表排版有串列,编码前必须回 PDF 逐行核。

5.2 布瓦(黑活/小青瓦,常见规格)

  • 筒瓦:2# 190×190、3# 170×90、10# 90×70 mm
  • 板瓦:2# 180×180、3# 160×160、10# 110×110 mm
  • [待核原文] 来源为科普中国词条,非则例原文;项目实际用瓦须以设计/甲方封样为准。

5.3 砖(本项目已有硬口径)

  • 小停泥砖 280×140×70 mm,走 70 模数 —— 华通 2026-10-30 沟通问题原文 [已验证·原文],见知识库 02_华通制图口径摘录.md §C。这是本项目唯一已锁定的砖规格,参数引擎必须按 70 模数校验。

6. 缺口(本地真没有的,别指望我编)

缺口影响怎么补
望板厚度定值规则(则例只给了「小连檐厚按望板厚」,没给望板本身厚度)望板建模厚度、屋面自重查《则例》望板节原文 / 用母本图反算
椽档(椽与椽净距/中距)规则椽根数、瓦垄对齐查则例「椽」节 / 母本反算
88J14-4 图集本体 192 页只 OCR 了 37 页,且这 37 页全是图集一览表北京四合院要素(含举架、檩椽)拿不到续跑 OCR 到含「举架/要素」的页,或小明提供正版
母本 DWG 一张未读无法用真图反算校验只读解析(COM 直读,不用 accoreconsole)
大式带斗拱的材份制(斗口制)本期建议不做(见 §7)后置

7. 范围建议:本期只做「小式/无斗拱」

理由:四合院民居(158 号院、西倒座房这类母本)就是小式。大式带斗拱会把参数体系从「柱径母数」翻成「斗口母数」,再叠平身科/角科斗拱的攒当、拽架、出跳——复杂度指数级上升,而且不是本项目(模式口四合院)的主线。

→ M1 只做小式无斗拱;斗拱留接口(style: "daxiao" | "xiaoshi"),后置。


8. 技术路线(待确认)

层建议为什么
L1 引擎Python 纯函数 + JSON schema + 单元测试可测、可回归、可被任何前端调用
L2 三维Three.js(浏览器),参数面板改 → 引擎重算 → 场景重建无需装软件、可分享链接、几何可控
L2 备选Blender / Grasshopper(Rhino)参数化更强,但门槛高、不好分享
L3 输出参数表 CSV/xlsx、逐根椽表、节点图(后期再接 CAD)—

❓ 你说的「3D3」我不确定指什么(语音转写?)。如果指某个具体工具/软件,请点一下;没指定我就按 Three.js 网页交互做。


9. 怎么证明它算得对(这步不能省)

用母本真图反算做回归测试:

从 DWG 只读量取:每步架水平长、各檩底标高、椽径、柱径、出檐
        ↓
喂进引擎,令其"按则例正算"
        ↓
比对:算出的举架成数是否落在则例表内?各檩标高误差?
        ↓
偏差 > 阈值 → 规则错 / 量取错 / 该房本来就不是标准则例做法(要能区分)

候选验证图(都在 E:\BaiduSyncdisk\古建图纸参考\09 参考图纸\):

  • 北京四合院\158号院修缮2018.12.24_t8.dwg
  • 北京四合院\西倒座房_t8.dwg
  • 历史所参考\其它 CAD图纸参考\15 5-8组院落门窗表 院门 节点详图_t8.dwg

这一步做完,工具箱才敢给别的项目用。没有回归测试的参数化=精美的猜测。


10. 分期

期交付验收
M0 梳理确认(本轮)本文件小明逐条确认 §3 参数与 §11 问题
M1 引擎engine/ 参数推导 + JSON 输出 + 单元测试 + 用真图反算报告举架成数与则例表一致 / 标高闭合 / 反算偏差在阈值内
M2 三维网页交互:拖参数、转视角、剖切看木构几何与 M1 JSON 一一对应(不许前端自己算)
M3 翼角逐根椽参数表 + 3D 生成出翘 3 椽径、起翘 4 椽径可量、椽根数正确
M4 工具箱参数表导出 / 节点图 / 与 t8 对接边界能交人用的一次完整流程

11. 要你拍板的 5 件事

#问题我的建议
1「3D3」是什么? Three.js 网页 / Rhino-Grasshopper / 其他网页 Three.js,无需装软件、可发链接给你看
2谁是自变量:A 正算 / B 反算控高 / C 双向C(正算为主,反算做校验)
3举架体系:锁定清式举架 / 清式+宋式举折双分支锁定清式(北京四合院=清式官式+民居小式),宋式留接口不实现
4瓦种:琉璃瓦(按样数)/ 布瓦小青瓦 / 都要本项目模式口是四合院,按布瓦为主、琉璃瓦可切;具体以设计封样为准
5一期范围:只做小式无斗拱 / 含大式斗拱只做小式,斗拱留接口后置

12. 本版明确没做的

  • 未写任何代码、未建任何模型、未画任何图;
  • 未打开/读取任何 DWG(母本反算未开始);
  • 88J14-4 未续跑 OCR;
  • 上面所有公式均为文献/公开资料整理,正式使用前须回《工程做法则例》原文逐条核,并标条文位置。

v0.1 梳理稿 2026-11-16 | 依据小明口述 + 《工程做法则例》大木小式做法 + 国家文物局琉璃瓦材料标准 | 小蓝1号 | 等小明确认后才动手