09 · 屋顶形式(roof_form)推进 · v1.0

编制:小明(建筑设计师) | 2026-11-17
本轮目标:让翼角有地方落。此前所有算例都是两坡(硬山/悬山),转角处根本没有翼角,
翼角几何算得再准也无处安放。故先把屋顶平面做出来。


0. 结论先行

  1. 屋顶四形式已可算:硬山 / 悬山 / 庑殿 / 歇山,同一套参数只换 roof_form。
  2. 推山查出原文,复算 2/2 吻合 —— 但我第一版公式是错的,已撤回(见 §1)。
  3. 收山有两种解法,差 1600 mm(整个檐步),本引擎两解并列输出,不替原文定口径。
  4. 发现一条硬约束:庑殿正脊 ≈ 通面阔 − 通进深。母板 10.24 × 6.40 → 正脊 4.16 m(0.41 倍面阔);

若进深接近面阔,正脊退化到不可用(九檩 10.24 × 11.2 → 0.61 m)。
故做庑殿/歇山必须先校面阔进深比,再定檩数。

  1. 规则库 38 → 42 条;测试 54 → 67 项全绿。

1. ★ 撤回:推山公式的第一版写错了

1.1 错在哪

我第一版按"每步山面水平 = 正面水平 − 该步举高"实现。母板五檩算出山面举架 0.78(尚可),
但七檩算出 9.00、九檩更离谱。畸陡到不可能施工 —— 这不是参数问题,是公式错。

错因:把"推山使山面变陡"这个定性印象,直接写成了"减举高"这个定量式,中间没有回原文核。
教训同 03 文档那次:定性印象不能当定量依据。

1.2 原文怎么写

《营造算例》(梁思成《清式营造则例》所附,是工匠手抄本,不是《工程做法》刊本):

"(庑殿推山)除檐步方角不推外,自金步至脊步,每步递减一成。
如七檩每山三步,各五尺;除第一步方角不推外,第二步按一成推,计五寸;
再按一成推,计四寸五分,净计四尺零五分。"

"如九檩,每山四步,第一步六尺,第二步五尺,第三步四尺,第四步三尺。
除第一步方角不推外,第二步按一成推,计五寸,净四尺五寸,连第三步第四步亦各随五寸。
再第三步,除随第二步推五寸,余三尺五寸外,再按一成推,计三寸五分,净计步架三尺一寸五分;
第四步又随推三寸五分,余二尺一寸五分,再按一成推,计二寸一分五厘,净计步架一尺九寸三分五厘。"

1.3 关键在"随"字

"随推"随的是累计推山量,不是每步独立递减。 这是从九檩算例反推出来的:

步正面步架原文动作余值本步推净步架
1 檐步6 尺方角不推—06.00
25 尺按一成推5.000.504.50
34 尺"随第二步推五寸" → 余 3.50,再一成4−0.50=3.500.353.15
43 尺"随推三寸五分,余二尺一寸五分"3−0.85=2.150.2151.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.055 / 4.5 / 4.05✅
九檩·六五四三6 / 4.5 / 3.15 / 1.9356 / 4.5 / 3.15 / 1.935✅

2. 四态:为什么规则库从三态扩成四态

推山只有手抄本、没有刊本。它比"待核原文"强(算例能逐条复算吻合),
比"已验证·原文"弱(不是官刊)。压进三态只有两个结果:要么谎称已验证,要么丢掉算例复现这个强证据。

故新增第四态 [手抄本·算例复现],并同步改了那条三态闸门测试(不是绕过闸门,是把闸门语义写清)。
引用的硬约束:只能写"据《营造算例》",不得写成《工程做法》。


3. 正脊长度:一条被忽略的硬约束

正脊 = 通面阔 − 2 × 山面总收进(几何恒等,不依赖文献)。于是:

算例通面阔通进深形式正脊正脊/面阔
母板10.246.40硬山10.241.00
母板同参10.246.40庑殿4.160.41
母板同参10.246.40歇山6.340.62
三间加宽12.006.40庑殿5.920.49
五间七檩16.809.60庑殿8.130.48
三间九檩10.2411.20庑殿0.610.06

读数:庑殿正脊约等于「面阔 − 进深」。进深接近面阔时,正脊退化为零,屋顶就不成立了。
实际庑殿多取面阔 ≥ 1.6~2.0 倍进深,正脊才舒展。

→ 做庑殿/歇山,第一步不是选檩数,是先校面阔进深比。 这条已写进规则库 J4。


4. 收山:两种解法,差一整个檐步

教科书通行表述:"山花板外皮退入正心桁(山面檐檩)中线一檩径。"照字面解:

解法山花外皮 x撒头水平进深撒头举架能不能施工
① 字面解5.12 − 0.352 = 4.77 m0.352 m2.27❌ 檐步常规 0.5,陡到不可能
② 几何解(本引擎默认)5.12 − 1.60 − 0.352 = 3.17 m1.952 m0.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.pyresult["roof"] 接入;hip 形式自动进 pending
engine/model3d.py输出透传 roof
engine/rulebook.pyJ1–J4;图例改四态
presets/wudian.json、presets/xieshan.json ★新建母板同参,只换屋顶形式
tools/plot_roof.py ★新建四形式平面对比图 out/屋顶平面_四形式.png
tools/gen_rulebook.py → 01_参数规则库.md重新生成,42 条
tests/test_engine.py54 → 67 项(TestRoofForm 13 项)

7. 验收

维度结果
回归测试67 / 67
推山算例复现2 / 2(七檩、九檩,容差 0.06 尺)
则例算例复现66 / 66
母板对表24 / 24
三区隔离闸门通过
规则库42 条,防手改校验通过
算例7 个预设 + default 全跑通

8. 未做 / 下一步

  1. 翼角逐根椽(撇度 / 扭度 / 翘度)—— 屋顶平面有了,下一步才是把 yijiao.solve() 按转角 × 每根椽铺开。
  2. 庑殿/歇山进 3D —— 现在只有平面几何,model3d 仍按两坡拉伸。要进 3D 需把瓦面/望板改成按坡面多边形生成,工作量大于本轮。
  3. 悬山出梢 —— 缺口,现在与硬山同长(图上已注明)。
  4. 收山口径 —— 待核原文或实测(两解差 1600 mm)。

v1.0 · 2026-11-17 · 推山口径属手抄本,引用须写「据《营造算例》」,不得写成《工程做法》