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×104 | 423×323×528×28 |
| 三样 | 368×192×96 | 400×320×80 |
| 四样 | 352×176×88 | 384×304×76 |
| 五样 | 336×160×80×19 | 368×272×68×22 |
| 六样 | 304×144×72×19 | 336×256×60×20 |
| 七样 | 288×128×64 | 320×224×56 |
| 八样 | 272×112×56 | 304×208×52 |
| 九样 | 256×96×48 | 288×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号 | 等小明确认后才动手