09 · 屋顶形式(roof_form)推进 · v1.0
编制:小明(建筑设计师) | 2026-11-17
本轮目标:让翼角有地方落。此前所有算例都是两坡(硬山/悬山),转角处根本没有翼角,
翼角几何算得再准也无处安放。故先把屋顶平面做出来。
0. 结论先行
- 屋顶四形式已可算:硬山 / 悬山 / 庑殿 / 歇山,同一套参数只换
roof_form。 - 推山查出原文,复算 2/2 吻合 —— 但我第一版公式是错的,已撤回(见 §1)。
- 收山有两种解法,差 1600 mm(整个檐步),本引擎两解并列输出,不替原文定口径。
- 发现一条硬约束:庑殿正脊 ≈ 通面阔 − 通进深。母板 10.24 × 6.40 → 正脊 4.16 m(0.41 倍面阔);
若进深接近面阔,正脊退化到不可用(九檩 10.24 × 11.2 → 0.61 m)。
故做庑殿/歇山必须先校面阔进深比,再定檩数。
- 规则库 38 → 42 条;测试 54 → 67 项全绿。
1. ★ 撤回:推山公式的第一版写错了
1.1 错在哪
我第一版按"每步山面水平 = 正面水平 − 该步举高"实现。母板五檩算出山面举架 0.78(尚可),
但七檩算出 9.00、九檩更离谱。畸陡到不可能施工 —— 这不是参数问题,是公式错。
错因:把"推山使山面变陡"这个定性印象,直接写成了"减举高"这个定量式,中间没有回原文核。
教训同 03 文档那次:定性印象不能当定量依据。
1.2 原文怎么写
《营造算例》(梁思成《清式营造则例》所附,是工匠手抄本,不是《工程做法》刊本):
"(庑殿推山)除檐步方角不推外,自金步至脊步,每步递减一成。
如七檩每山三步,各五尺;除第一步方角不推外,第二步按一成推,计五寸;
再按一成推,计四寸五分,净计四尺零五分。"
"如九檩,每山四步,第一步六尺,第二步五尺,第三步四尺,第四步三尺。
除第一步方角不推外,第二步按一成推,计五寸,净四尺五寸,连第三步第四步亦各随五寸。
再第三步,除随第二步推五寸,余三尺五寸外,再按一成推,计三寸五分,净计步架三尺一寸五分;
第四步又随推三寸五分,余二尺一寸五分,再按一成推,计二寸一分五厘,净计步架一尺九寸三分五厘。"
1.3 关键在"随"字
"随推"随的是累计推山量,不是每步独立递减。 这是从九檩算例反推出来的:
| 步 | 正面步架 | 原文动作 | 余值 | 本步推 | 净步架 |
|---|---|---|---|---|---|
| 1 檐步 | 6 尺 | 方角不推 | — | 0 | 6.00 |
| 2 | 5 尺 | 按一成推 | 5.00 | 0.50 | 4.50 |
| 3 | 4 尺 | "随第二步推五寸" → 余 3.50,再一成 | 4−0.50=3.50 | 0.35 | 3.15 |
| 4 | 3 尺 | "随推三寸五分,余二尺一寸五分" | 3−0.85=2.15 | 0.215 | 1.935 |
第 4 步的余值 2.15 = 3 − (0.50+0.35),减的是累计 0.85。
若误作每步独立递减(3 − 0.35 = 2.65,再减 0.265 = 2.385),与原文"一尺九寸三分五厘"对不上。
这条正是靠原文算例才能钉住的。
1.4 现在的实现
# engine/roof.py
def tuishan_steps(L, tui=True):
out, cum = [], 0.0
for i, l in enumerate(L):
if i == 0 or not tui:
out.append(l); continue
rest = l - cum # 扣累计推山量
d = rest * 0.10 # 一成
out.append(rest - d); cum += d
复现结果(reproduce_tuishan(),容差 0.06 尺):
| 算例 | 算得(尺) | 原文(尺) | |
|---|---|---|---|
| 七檩·各五尺 | 5 / 4.5 / 4.05 | 5 / 4.5 / 4.05 | ✅ |
| 九檩·六五四三 | 6 / 4.5 / 3.15 / 1.935 | 6 / 4.5 / 3.15 / 1.935 | ✅ |
2. 四态:为什么规则库从三态扩成四态
推山只有手抄本、没有刊本。它比"待核原文"强(算例能逐条复算吻合),
比"已验证·原文"弱(不是官刊)。压进三态只有两个结果:要么谎称已验证,要么丢掉算例复现这个强证据。
故新增第四态 [手抄本·算例复现],并同步改了那条三态闸门测试(不是绕过闸门,是把闸门语义写清)。
引用的硬约束:只能写"据《营造算例》",不得写成《工程做法》。
3. 正脊长度:一条被忽略的硬约束
正脊 = 通面阔 − 2 × 山面总收进(几何恒等,不依赖文献)。于是:
| 算例 | 通面阔 | 通进深 | 形式 | 正脊 | 正脊/面阔 |
|---|---|---|---|---|---|
| 母板 | 10.24 | 6.40 | 硬山 | 10.24 | 1.00 |
| 母板同参 | 10.24 | 6.40 | 庑殿 | 4.16 | 0.41 |
| 母板同参 | 10.24 | 6.40 | 歇山 | 6.34 | 0.62 |
| 三间加宽 | 12.00 | 6.40 | 庑殿 | 5.92 | 0.49 |
| 五间七檩 | 16.80 | 9.60 | 庑殿 | 8.13 | 0.48 |
| 三间九檩 | 10.24 | 11.20 | 庑殿 | 0.61 | 0.06 |
读数:庑殿正脊约等于「面阔 − 进深」。进深接近面阔时,正脊退化为零,屋顶就不成立了。
实际庑殿多取面阔 ≥ 1.6~2.0 倍进深,正脊才舒展。
→ 做庑殿/歇山,第一步不是选檩数,是先校面阔进深比。 这条已写进规则库 J4。
4. 收山:两种解法,差一整个檐步
教科书通行表述:"山花板外皮退入正心桁(山面檐檩)中线一檩径。"照字面解:
| 解法 | 山花外皮 x | 撒头水平进深 | 撒头举架 | 能不能施工 |
|---|---|---|---|---|
| ① 字面解 | 5.12 − 0.352 = 4.77 m | 0.352 m | 2.27 | ❌ 檐步常规 0.5,陡到不可能 |
| ② 几何解(本引擎默认) | 5.12 − 1.60 − 0.352 = 3.17 m | 1.952 m | 0.50 | ✅ 正常 |
①的字面解意味着撒头水平只剩一檩径,坡陡 2.27 —— 不成立。
故判"原话省略了语境",实际基准应是撒头内边界(山面金檩)。
但这只是我的判断,不是原文。 两种解同时在 model.json 的 roof.shou_shan_compare 里输出,
规则库 J3 的状态仍是 [待核原文]。要定口径,得核原文或实测。
5. 歇山的山花不是坡 —— 又一个自己犯的错
第一版把歇山第 2 步也列入"山面步架表",算出 3.18 的假陡坡。
真相:歇山上部是山花竖直面,山面根本没有坡。山面步架表只该有撒头一步。
修法:n_hip = k if form == "wudian" else 1;垂脊改为"博脊平段(撒头内边界 → 山花外皮)+ 山花竖段"。
图上这一改很直观 —— 歇山子图里那根橙色虚线由一小段水平加一段竖直组成。
6. 交付物
| 文件 | 变化 |
|---|---|
engine/roof.py ★新建 | 平面檩线环 / 山面步架 / 戗脊垂脊端点 / 闭合校验 / 推山算例复现 |
engine/rules.py | 加 ROOF_FORMS、推山 5 个常量、收山 3 个常量、REPRODUCED 第四态 |
engine/params.py | 加 roof_form / tui_shan / shou_shan_purlin + 校验 |
engine/solve.py | result["roof"] 接入;hip 形式自动进 pending |
engine/model3d.py | 输出透传 roof |
engine/rulebook.py | J1–J4;图例改四态 |
presets/wudian.json、presets/xieshan.json ★新建 | 母板同参,只换屋顶形式 |
tools/plot_roof.py ★新建 | 四形式平面对比图 out/屋顶平面_四形式.png |
tools/gen_rulebook.py → 01_参数规则库.md | 重新生成,42 条 |
tests/test_engine.py | 54 → 67 项(TestRoofForm 13 项) |
7. 验收
| 维度 | 结果 |
|---|---|
| 回归测试 | 67 / 67 |
| 推山算例复现 | 2 / 2(七檩、九檩,容差 0.06 尺) |
| 则例算例复现 | 66 / 66 |
| 母板对表 | 24 / 24 |
| 三区隔离闸门 | 通过 |
| 规则库 | 42 条,防手改校验通过 |
| 算例 | 7 个预设 + default 全跑通 |
8. 未做 / 下一步
- 翼角逐根椽(撇度 / 扭度 / 翘度)—— 屋顶平面有了,下一步才是把
yijiao.solve()按转角 × 每根椽铺开。 - 庑殿/歇山进 3D —— 现在只有平面几何,
model3d仍按两坡拉伸。要进 3D 需把瓦面/望板改成按坡面多边形生成,工作量大于本轮。 - 悬山出梢 —— 缺口,现在与硬山同长(图上已注明)。
- 收山口径 —— 待核原文或实测(两解差 1600 mm)。
v1.0 · 2026-11-17 · 推山口径属手抄本,引用须写「据《营造算例》」,不得写成《工程做法》