母板定义书 v1.0 · 清式小式五檩三开间

母板 = 完全按《工程做法则例》推导、不掺任何实测修正的「通则基准模型」
编制:小明(建筑设计师)| 2026-11-16 | 引擎 GuJian-Param v0.1
数据实体:presets/muban.json(数据即模型,改这个文件就换模型,不改代码)


0. 一句话讲清母板是什么、不是什么

是后续所有方案的零点:母板尺寸全部由则例规则算出,任何偏差都能定位到"哪一步、哪条规则"
是改良版的起点:改良版 = 母板 + 只改 L2 地域层参数(不动 L0 规则),改了什么一眼看得见
是对表基准:13 项关键尺寸全部取清尺整数,可直接拿则例原文/清尺带尺去核
不是不是某个具体项目的施工图 —— 母板没有场地、没有实测、没有选材确认
不是不是"最优做法" —— 母板严格守则例,遇民居/地域做法(如西倒座房)一定对不上,对不上才是发现

1. 为什么关键尺寸取「清尺整数」

这是母板 v1.0 相对之前那个"默认算例"最实质的改动。

之前默认算例用的是 3000 / 3300 / 3600(现代整数,看着干净),但没法回则例对表 —— 则例是按清营造尺(1 尺 = 320 mm)写"柱高一丈、柱径一尺、步架五尺"的。用现代整数,每一条都要先除 320 再折算,等于自己给自己加了一层换算误差。

母板改成 10 尺柱高 / 1 尺柱径 / 5 尺步架 / 20 尺通进深 / 12 尺明间 / 10 尺次间,于是所有派生量都落在整尺或整寸上(没有零头毫米):

派生量计算mm清尺
柱高输入320010 尺
柱径柱高 ÷ 103201 尺
步架20 尺 ÷ 4 步16005 尺
檐檩标高10 尺 + 垫板 0.7 尺 + 檩半径 0.5 尺358411.2 尺
脊檩标高11.2 尺 + 2.5 尺 + 3.5 尺550417.2 尺
总举高2.5 尺 + 3.5 尺19206 尺
上檐出柱高 × 3/109603 尺
檐椽出 / 飞椽出2 : 1640 / 3202 尺 / 1 尺
飞椽通长飞头 × 412804 尺
檐垫板高柱径/2 + 2 寸2247 寸
金/脊垫板高−1 寸1926 寸
瓦口高(筒瓦头号)3 寸963 寸

结论:母板可被一把清尺复算。任何一项对不上尺,就是规则取错了,不会藏在"换算"里。


2. 三层架构(这是"母板"能反复套用的关键)

层内容母板是否允许改谁定
L0 通则层举架成数表、加斜、柱径/椽径比例、上檐出、飞椽、垫板、瓦口❌ 不改(改就是另立体系)则例原文
L1 尺度层面阔、通进深、檩数、柱高、柱径✅ 按项目改(母板给标准值)设计条件
L2 地域层不等步架、实测举架、梁断面、实测椽径、瓦种瓦号、望板/苫背厚⛔ 母板全为空(不掺实测)地域做法 / 实测

只有 L2 是改良版的战场。 母板把 L2 全部留空,就是为了让"改了哪几项"永远可追溯。


3. 母板参数卡

3.1 L1 尺度层(只给这 5 项,其余全推)

参数值mm清尺依据三态
檩数5——小式最常见;每侧 2 步已验证·原文
柱高3200320010 尺小式通例(一丈)待核原文
柱径3203201 尺无斗拱「径按高十分之一」已验证·原文
通进深(檐檩中距)6400640020 尺五檩两坡,步架 5 尺待核原文
面阔明间 3840 / 次间 32001024012 尺 / 10 尺明间 = 柱高 × 1.2,次间 = 明间 × 0.8待核原文(比例非则例硬条文)

3.2 L0 通则层(引擎按则例自动算,母板不手填)

规则公式出处三态
举架(五檩)檐步五举 0.50 / 脊步七举 0.70则例大木小式已验证·原文
加斜斜长 = 水平长 × √(1+举架²)则例给近似"因"数,此处用精确值已验证·原文
分举高步架 × 举架成数则例已验证·原文
椽见方柱径 ÷ 3则例已验证·原文
上檐出柱高 × 3/10则例已验证·原文
檐椽出 : 飞椽出2 : 1则例已验证·原文
飞头长柱高 ÷ 10则例已验证·原文
飞椽飞尾 = 3 × 飞头,通长 = 4 × 飞头,自身三五举则例已验证·原文
檐垫板高 = 柱径/2 + 2 寸,厚 = 0.2 柱径则例("垫板即是平水")已验证·原文
金/脊垫板高 = 檐垫板 − 1 寸则例已验证·原文
瓦口头号筒瓦 3 寸,厚 = 0.3 × 高则例待核原文

3.3 母板明确留空(L2,等改良版填)

step_lens_mm(不等步架)、jiajia_override(实测举架)、beam_section_mm(实测梁断面)、rafter_mm(实测椽径)、tile_*(瓦种瓦号)、plank_thick_mm / daub_thick_mm(缺口项)。


4. 对表结果(机器证据,13/13 通过)

命令回读:python -m engine.cli --preset muban,逐项与 presets/muban.json 里的 _meta.expected 核对,容差 0.5 mm:

项期望实得偏差
步架1600.001600.00+0.00
檐檩标高3584.003584.00+0.00
脊檩标高5504.005504.00+0.00
总举高1920.001920.00+0.00
上檐出960.00960.00+0.00
檐椽出640.00640.00+0.00
飞头320.00320.00+0.00
飞椽通长1280.001280.00+0.00
椽见方106.67106.67−0.00
檐垫板高224.00224.00+0.00
金/脊垫板高192.00192.00+0.00
瓦口高96.0096.00+0.00
通面阔10240.0010240.00+0.00

三条内置校核也全绿:檩标高闭合(逐架累加 = 脊檩标高)、加斜与则例近似因最大偏差 0.002(阈值 0.03)、上檐出 = 檐椽出 + 飞椽出。

对表结果落盘在 out/muban/母板对表.csv。以后母板被谁改了、改了哪一项,跑一次就看出来。


5. 母板构件清单(16 类)

编号类别名称断面长度数量关键依据
Z01柱檐柱⌀32032008柱高/10
L01檩各架檩(桁)⌀320102405檩径 = 柱径
B01垫板檐垫板224×64102402高 = 柱径/2 + 2寸
B02垫板金/脊垫板192×64102403檐垫板 − 1寸
C01椽檐椽107×107250498步架×加斜 + 平出/cos坡角
C02椽脑椽107×107195398步架 × 加斜
C90椽飞椽107×107128098通长 = 4 × 飞头
E01檐口小连檐107×18102402檐椽头
E03檐口大连檐107×18102402飞椽头
E02檐口瓦口96×29102402头号筒瓦 3 寸
P01望板横望板18 厚3742(单坡)2缺口项
T01瓦面布瓦筒瓦 2#190×11190未计压七露三
G01梁架五架梁448×320640041.4d × d(简化,待核)
G02梁架三架梁448×32032004同上
G90梁架金瓜柱⌀25638480.8d(待核)
G91梁架脊瓜柱⌀256112040.8d(待核)

图元 352 个,三维查看器 out/muban/viewer.html(单文件,断网可开)。


6. 母板 vs 实测母本(西倒座房)——这正是要做改良版的理由

项母板(通则)实测母本判断
步架1600 均分(5 尺)1280 / 955 不等民居不等步架,通则给不出
檐步举架0.500.549檐步更陡 +10%
脊步举架0.700.627脊步更平 −10%
平均坡度0.6000.583总高只差 −2.9%,曲率明显更小(近直坡)
五架梁断面448×320(d=320)250×200(d=210)同式 1.4d 在 d=210 时给 294,实测 250 → 简化式偏高约 15%
椽见方107(= d/3)69.2(d/3 = 70)比例一致,差异来自柱径

结论:母板严格守则例 → 与民居实做必然对不上。这不是母板错了,是则例管官式、不管民居。改良版的任务就是把 L2 层换成实测值,同时保留 L0 规则做校验,看"哪些地方守了规矩、哪些地方没守"。

详细反算过程见 out/母本反算校核报告.md。


7. 改良版怎么派生(三步,不动代码)

cd _古建参数化

# 1. 复制母板 → 派生改良版(只改 L2 层)
cp presets/muban.json presets/gaiban_xdz.json

# 2. 在 gaiban_xdz.json 里只改这几项(其余保持母板原值 = 通则不破):
#    step_lens_mm:  [1280, 955]
#    jiajia_override:[0.5492, 0.6272]
#    beam_section_mm:[250, 200]
#    column_dia_mm / column_height_mm 换成实测

# 3. 跑,并保留母板对表(会显示哪几项偏离通则、偏多少)
python -m engine.cli --preset gaiban_xdz --out out/gaiban_xdz

规范化要求:改良版必须保留母板的 _meta.expected,跑出来对表报"哪几项不符",这就是改良版的设计说明。改到对表全绿 = 已经把母板改成了另一个通则,不是改良版了。


8. 母板自检:设计中发现的 8 个问题(第 5 段作业)

#问题影响处置
1梁高 1.4 柱径是简化式,实测母本只到 1.19d梁断面偏大 15%,直接影响大木料单标"待核则例",改良版必须用实测断面
2垫板厚 = 0.2 柱径,在 d=1 尺时恰好 = 2 寸两条规则(比例说 / 定寸说)在母板碰巧重合,换了柱径就分叉回则例原文确认是哪种,母板暂时无法暴露此矛盾
3望板长按单坡斜长给(3742)望板实际逐块横铺,长度 ≠ 单坡斜长,构件表只能当估算量已改注释;算料图后置
4瓦面数量未计(T01 数量空)出不了瓦垄排布图、算不出瓦件数瓦垄排布列为 M4
5面阔比例(明间=1.2 柱高、次间=0.8)非则例硬条文母板最"软"的一项,最容易被质疑标"待核原文";按项目条件定
6椽中距 = 2×椽见方:2026-11-16 已找到原文依据(卷二十二「每椽空档随椽径一分」),由缺口升为待核原文;但同卷「椽数应成双」的口径未定 —— 母板每坡 49 根为奇,若成双指每坡则不合椽根数 98 受它影响,误差 10% 就是 10 根椽状态已升级,出处已写进引擎;「每坡成双还是全屋成双」待回原文定
7飞椽"三五举"未确认是定值还是随檐步檐口反宇曲线形状会变标待核;母板用定值 0.35
8檩径一律 = 柱径,金檩/脊檩是否收分未做上部檩可能偏大标待核;大式再议

这 8 条不是"以后再说",是母板已知的信用边界:引用母板数据时必须连同这张表一起给,否则就是把推定值当条文用。


9. 缺口清单(引用母板时必须带)

项状态当前值说明
望板厚度缺口18 mm则例只写"小连檐厚按望板厚",未见望板本身厚
椽中距(椽档)待核原文213 mm原文「每椽空档随椽径一分」→ 空档=椽径(卷二十二·转引);椽数成双 口径未定
苫背厚度缺口30 mm只影响屋面几何偏移
布瓦规格待核原文筒瓦 2# 190×190来自科普词条,非则例;须以封样为准
梁断面 / 瓜柱径待核1.4d / 0.8d简化式,见 §8-1
面阔比例待核12 尺 / 10 尺民居通行比例

10. 母板不做什么(边界,别越界引用)

  • 不写 DWG、不出施工图、不替代设计审批
  • 不做翼角(转角仍是直角相交)、不做山墙/博风、不做斗拱(大式后置)
  • 不做门窗装修、不做台基踏跺
  • 算的是尺寸与位置,不是规范合规结论(合规另走知识库 03_技术判据)

母板 v1.0 · 2026-11-16 · 数据实体 presets/muban.json | 输出 out/muban/


§9 v1.1 修订(2026-11-16 晚)—— 则例原文到手后的重算

本文件正文按 v1.0 写就,§1~§8 中的推定值已被下文取代。看母板请以 presets/muban.json(v1.1)与本附节为准。
原文献入档:data/则例原文/卷24_七檩小式大木.md、data/则例原文/卷26_五檩小式大木.md
核对过程:05_文献源核对_v1.0.md;复现证据:out/则例算例复现报告.md(66/66)

9.1 输入链方向改了(这是根本性的)

v1.0 把 柱高当输入、面阔靠假设(明间 12 尺 / 次间 10 尺取自民居惯例)。

则例原文是反的——面阔是自变量:

卷次檐柱高檐柱径
卷二十四 七檩小式面阔 × 0.8面阔 × 0.07
卷二十六 五檩小式面阔 × 0.7面阔 × 0.05

母板仍保留「柱高/柱径」作为设计条件输入(工程上柱高常由使用要求定),但引擎同时算出 zl_column_h_mm / zl_column_d_mm(按面阔反推的通则值),用来回答"你这柱子按则例该多粗"。

母板当前偏离:明间 3840,则例七檩小式应 柱高 3072 / 柱径 269;五檩小式应 2688 / 192。母板取 3200 / 320,柱径偏粗 19%(对七檩口径)。这是设计取值,不是错误,但必须标注。

9.2 被推翻的 4 条(v1.0 正文里要划掉)

  1. §2「飞椽」整段作废。卷十七:「小式…与前法同,而无飞檐」;卷二十四/二十六构件清单只有檐椽、脑椽。→ 上檐出 0.3 柱高 全部由檐椽承担,不再拆 2:1。引擎 has_fei 默认 False。
  2. §4「檩径一律 = 柱径」作废。卷二十六:檐柱径 + 1 寸;卷二十四:同檐柱径。两卷不一,按檩数取。
  3. §5「椽见方 = 柱径/3」作废。两卷均为「檩径十分之三」。
  4. §3「垫板高 = 柱径/2 + 2 寸、厚 = 0.2 柱径」作废。原文:宽(=高)= 檐枋高 − 1 寸,但六寸以下不收分;厚 = 檩径十分之三。→ 由此平水 = 垫板宽被原文坐实(卷二十四「平水高六寸三分」= 其垫板宽 6.3 寸)。

9.3 新基准(24 项对表,全绿)

项v1.0v1.1变化原因
檐檩标高35843664平水(垫板宽)288 而非 224;檩半径 176 而非 160
脊檩标高55045584同上 +80
上檐出960960不变
檐椽出640960小式无飞椽,檐椽独担
飞头长 / 飞椽通长320 / 12800 / 0小式无飞椽
檩径320352柱径 + 1 寸
椽见方106.67105.6檩径 × 0.3
檐垫板 宽×厚224 × 64288 × 105.6檐枋高−1寸;檩径×0.3
金/脊垫板 宽192288金/脊枋高同按檐柱径 → 与檐同
五架梁 高×厚448 × 320448 × 384厚 = 柱径+2寸,高 = 厚+2寸
三架梁 高×厚—384 × 320五架梁各收 2 寸
瓜柱径256288三架梁厚 − 1 寸
檐/金/脊枋无320 × 256原文有,v1.0 漏了

9.4 新增的两条工程区分(重要)

  1. 算料长 ≠ 几何长。则例的「加举」是匠人口算系数(五举 1.15、七举 1.25、九举 1.35),比 √(1+h²) 大 1~3%。这 1~3% 是椽头余量,开工截掉。

→ 引擎里 length_mm 给料单(则例值),model_len_mm 给三维模型(几何值)。两者混用会做出溢出檐口的模型(本轮真踩到,见测试 test_yan_rafter_reaches_eave)。

  1. 则例是「算例集」不是「公式集」。同一构件跨卷会不一样(檩径、单步梁收分、垫板入榫头数)。不能拿一套统一公式套所有卷次,必须按卷立算例——这就是 engine/zelie.py 存在的理由。

9.5 §8 自检 8 问的现状

#v1.0 的问题现状
1梁高 1.4d 偏高 15%✅ 已解决:则例 厚=柱径+2寸、高=厚+2寸
2垫板厚两种口径在 d=1 尺时重合✅ 已解决:厚 = 檩径 × 0.3
3望板长 ≠ 算料量⚠️ 仍存(长度只给几何值)
4瓦面数量未计⚠️ 仍存
5面阔比例非硬条文✅ 已确认:则例「临期酌夺地势定尺寸」——面阔本就自由
6椽档是缺口❌ 恶化了:现在有两条互相矛盾的原文(每丈20根 vs 空档随椽径)
7飞椽三五举未定✅ 已解决:小式根本没有飞椽
8檩径一律=柱径✅ 已解决:卷次不一,已按卷取

净结果:8 条里 6 条解决、1 条恶化(椽档)、1 条仍存(望板+瓦面数量)。


§10 v1.2 修订(2026-11-17)—— 规则表改自动生成 + 一处口径误标自查

10.1 母板自身没有变化

本次不动任何数值:24 项对表仍全绿,三维图元数不变,则例复现 66/66。
改的是「文档与代码的一致性机制」。

10.2 自查出一处口径误标(实质错误,必须记)

rules.py 里原有一张表叫 ZL_JIAXIE_APPROX,语义标称「则例给出的加斜因数」,内容为
五举 1.12 / 六举 1.17 / 六五举 1.19 / 七举 1.22 / 七五 1.25 / 八举 1.28 / 九举 1.35。
旧的 01_参数规则库.md 把它列成「则例『因』数」一栏,与「精确」列并排放。

核对则例原文后确认这是误标:

举架精确 √(1+h²)本表(原标"则例因数")则例原文实际给的口算系数
五举 0.501.11801.12一一五 = 1.15
七举 0.701.22071.22一二五 = 1.25
九举 0.901.34541.35一三五 = 1.35

即:那张表的数值是精确值的两位取整,与则例原文不同源;
则例的匠人口算系数是系统性放大的(五举放大 2.9%、七举放大 2.4%、九举重合)。

为什么这个错要紧:如果有人问「则例五举加斜多少」,按旧文档答 1.12 是错的,原文是一一五。
更麻烦的是,拿 1.12 去算料会少算 2.9%,而则例的本意正是给椽头留这份余量。

已处理:

  1. 常量改名 EXACT_JIAXIE_ROUNDED,语义改为「精确值两位取整」;旧名留作别名只为不破坏引用
  2. ZL_JIAXIE_APPROX_STATUS = GAP(旧命名不成立)
  3. 规则库 A6 条把三种口径并列写清:算料用则例口算、建模用精确值
  4. 测试 test_misnamed_jiaxie_is_corrected 钉住「1.15 ≠ 1.12」,防止再次混口径

10.3 规则表改为自动生成(这是本次主要交付)

起因:01_参数规则库.md 是手写的,已经漂了 ——
里面 B1~B9、整个 C 段都是则例原文推翻的旧假设(柱径=柱高/10、椽见方=柱径/3、
垫板=0.5柱径+2寸、飞椽 2:1 拆分……),还挂着上面那张假出处表。
手写文档迟早会漂,这是结构问题,不是笔误。

做法(抄九野营造:规则附表由脚本从 data/*.json 生成、文件头写「勿手改」):

层文件职责
数值 + 状态engine/rules.py唯一数值来源,别处不许重复定义
描述 + 索引engine/rulebook.py35 条规则的公式读法 / 出处 / 实现状态
生成tools/gen_rulebook.py渲染 → 写入 md,并把当前算例的实得值灌进表
防漂移tests:TestRulebook7 项,核心一条:磁盘文件必须与「此刻重新生成」逐字一致

防手改是真生效的(做过负向验证):把表里 檩径 × 0.3 手改成 0.25,
test_no_hand_edit 立刻红并提示「请运行 python tools/gen_rulebook.py」;还原后转绿。

10.4 规则库新增的两个诚实标注

  1. 「母板实得」列区分通则值与实用值:B1 柱高显示 2688 / 实用 3200,

B2 柱径显示 192 / 实用 320 —— 斜杠前是按面阔反推的则例值,斜杠后是本模型实际采用的设计值。
不分开就会让人误以为母板柱径只有 192。

  1. 附录 3 单列「规则有据 · 引擎未做」5 条:双步梁/单步梁、翼角四条、飞檐椽加举。

交付时被问到这些构件,答「规则已入规则库、几何未生成」,不含糊。

10.5 §8 自检 8 问的现状(更新)

#v1.0 的问题现状
1梁高 1.4d 偏高 15%✅ 已解决:厚=柱径+2寸、高=厚+2寸
2垫板厚两种口径在 d=1 尺时重合✅ 已解决:厚 = 檩径 × 0.3
3望板长 ≠ 算料量⚠️ 仍存(望板只给几何长)
4瓦面数量未计⚠️ 仍存
5面阔比例非硬条文✅ 已确认:则例「临期酌夺地势定尺寸」
6椽档是缺口❌ 仍恶化:两条原文互斥(每丈20根 vs 空档随椽径),差约 30%
7飞椽三五举未定✅ 已解决:小式无飞椽
8檩径一律=柱径✅ 已解决:卷次不一,已按卷取

新增第 9 条:加斜口径(则例口算 1.15 vs 精确 1.118)曾被误标 —— 已订正,见 §10.2。

净结果:9 条里 6 条解决、2 条仍存(望板/瓦面数量)、1 条恶化(椽档)、1 条已订正。