11 · 硬山构件完善 + 瓦作与屋脊模块化 · v1.0

编制:小明(建筑设计师) | 2026-11-17
本轮目标:按上一轮的建议补屋脊与山面椽;然后以硬山为基准形式,把
椽子 / 屋面瓦 / 屋脊 三项按传统样式做成可复用模块;再把柱、梁、额枋接上。
一句话:屋脊不再是"压一条灰带子",而是有断面、有层序、四种屋顶共用一套断面的瓦作模块。


0. 结论先行

  1. 屋脊与瓦作独立成模块 engine/roof_parts.py:把「断面」与「路径」拆开 ——

ridge_layers() 给断面、lay_ridge() 沿路径铺、各屋顶形式只给路径。
加一种脊只加一个路径函数,加一层线脚只加一行断面。

  1. 正脊按「三砖五瓦」八层断面建(当沟 → 瓦条 → 瓦条 → 混砖 → 陡板 → 混砖 → 瓦条 → 筒瓦眉子),

垂脊/戗脊/博脊按「皮条脊」四层断面建。瓦作模数 = 瓦宽,不是柱径也不是斗口。

  1. 瓦垄按「分中号垄」建:最中一垄是底瓦(不是筒瓦)、筒瓦垄落在相邻两底瓦的缝上、

两侧各留一个瓦宽给排山。母参数下每坡底瓦 85 垄、筒瓦 84 垄。

  1. 硬山从"半个样子"补成完整形式:山墙(154 片竖片叠砌)、排山勾滴、4 条垂脊、

额枋/金枋/脊枋 35 根(构件表早有、3D 一直空着)。
图元:硬山 1639 / 庑殿 1765 / 歇山 1653。

  1. 本轮修掉 7 个实质缺陷,其中 4 个是我自己上一版写错的(§4 逐条撤回)。

最值得记的三条:当沟底面与筒瓦拱顶相切导致脊根一排白点、
梁厚 358 > 墙厚 353 导致山面一条贯穿横带、片间 1 mm 重叠导致整面墙像百叶。

  1. 规则库 44 → 52 条(新增 K1~K8 瓦作与屋脊段);状态由四态扩到六态

(增 [工匠口径·转引] 与 [本引擎构造约定],见 §5)。
测试 70 项全绿,网页 console 0 错误。


1. 为什么瓦作要单独一个模块

屋脊和瓦垄属瓦作,不属大木作。四种屋顶形式里「正脊 / 垂脊 / 戗脊 / 博脊 / 排山勾滴」
的有无与走向各不相同,但每一种脊身的断面层次是同一套。

若不拆开,就会出现「硬山的垂脊写一遍、庑殿的戗脊再抄一遍、歇山的博脊又抄一遍」,
三份断面各自漂移。故:

ridge_layers(kind)   断面:三砖五瓦(zhengji)/ 皮条脊(chuiji)
lay_ridge(pts, ...)  沿折线铺断面;flat=True 用 box(正脊),否则用 leg(垂脊/戗脊)
各形式  只给路径:zhengji_path / chuiji_points / qiangji_points

实测这层抽象是值的:本轮加「博脊 + 歇山垂脊」只写了 3 行路径,
断面一行没动;后来修脊根白点只改了 ridge_sink() 一处,四种形式的脊同时修好。


2. 瓦作各件的做法与出处

2.1 分中号垄(K1)

判据内容状态
底瓦做中最中一垄(x = 0)是底瓦,不是筒瓦[工匠口径·转引]
两垄板瓦上盖一垄筒瓦筒瓦垄落在 x = ±(i+0.5) × 垄距[工匠口径·转引]
蚰蜒当两垄板瓦净距 5 公分(rules.GOU_YAN_DANG_MM = 50)[工匠口径·转引]
两侧留边博缝板外皮向内约不到两个瓦口宽 → 本引擎取一个板瓦宽[工匠口径·转引]

为什么"底瓦做中"值得单独写一句:直觉一定把筒瓦(更显眼的那道凸起)放中线,
做出来也像那么回事。但原文明确"底瓦做中",且是明清官式的重要原则 ——
中线落错,整片瓦垄就整体错半垄,从正脊往下看会一路错到底。

母参数(布瓦筒瓦 2 号 w=190 / 板瓦 2 号 w=180 / 蚰蜒当 50)下:
垄距 230 mm,每坡底瓦 85 垄、筒瓦 84 垄,两侧各余 175 mm 给排山。

2.2 正脊「三砖五瓦」八层(K2)

自下而上,各层高 = 系数 × 筒瓦宽,各层宽 = 系数 × 脊底宽(脊底宽默认 3 瓦宽):

层名高 / 瓦宽宽 / 脊底宽说明
1当沟0.451.00最宽,骑在两坡瓦垄上
2瓦条0.300.86
3瓦条0.300.82
4混砖0.420.76出挑(亮)
5陡板(通天板)0.750.62收进(暗)—— 线脚的主体
6混砖0.420.76出挑(亮)
7瓦条0.300.82
8筒瓦眉子0.500.90收圆压顶

「三砖」= 陡板上下两层混砖 + 陡板本身;「五瓦」= 五层瓦条。
八层各给一个明度差色 —— 这不是装饰:同色 box 叠起来,正交视角下只剩一个轮廓,
八层等于没做。实际脊身是砖瓦垒砌 + 灰缝,凸出的混砖亮、凹进的陡板暗,
用明度差把线脚"显"出来,是让几何可读。

2.3 垂脊「皮条脊」四层(K3)

减陡板与上层混砖:当沟 → 瓦条 → 混砖 → 筒瓦眉子。原文"
既可以用于大式建筑,也可以用于小式建筑",小式硬山/悬山常用。
硬山 4 条、庑殿戗脊 4 条、歇山戗脊 4 + 垂脊 4 + 博脊 4 段,全用这一套断面。

2.4 瓦垄(K4)

筒瓦是半圆筒,宽 = 直径,拱高 = 宽 / 2。每垄每段铺一根圆杆(kind=round,
半径 = 拱高),圆心压在板瓦面上皮,露出上半圆 —— 视觉上就是一道道筒瓦垄,
且与"板瓦垄是凹的、筒瓦是凸的"的真实断面一致。

段数与举架对齐:一坡切成「檐口外段 + 每个步架一段」,段与段在檩位相接。
若用一根直杆从檐口拉到脊,举架变坡处垄身会在中途离瓦面几厘米。
母参数下 84 垄 × 2 坡 × 4 段 = 672 根。

2.5 排山勾滴(K7)· 山墙(K8)

  • 排山勾滴:本版做成一条连续勾滴压边,非逐块勾头。逐块要 4 × 40 ≈ 160 块,图元会爆。
  • 山墙:t = max(梁厚 + 60, 1.2 × 柱径),纯经验值,无则例依据。

唯一的硬约束是 t > 梁厚 —— 见 §4.2。


3. 硬山补齐了什么(本轮重点)

硬山的定义就是「屋面不出山墙」:山墙把山面整个封住,屋面止于墙外皮。
没这道墙,山面会把整片梁架露在室外,看着像棚子不像房子。

构件本轮状态图元数(七檩 19.8×9.6)
正脊(三砖五瓦 8 层)新建8
垂脊(皮条脊 4 层 × 4 条)新建48
瓦垄(筒瓦,84 垄 × 2 坡 × 4 段)新建672
排山勾滴新建(连续带)2
山墙新建(150 mm 竖片叠砌)154
额枋 / 金枋 / 脊枋补齐(构件表早有,3D 一直空着)35
椽 / 檩 / 垫板 / 梁架 / 望板 / 苫背 / 瓦面 / 檐口沿用624 / 7 / 7 / 48 / 6 / 6 / 6 / 4
合计1639

对照:庑殿 1765(多山面椽 206、翼角椽 72、角梁 8),歇山 1653(山面椽 102)。

硬山的山墙用竖片叠砌而不是一整片 quad,理由见 §4.3。
墙顶随屋面折线,每片取片内较高端,顶边呈 150 mm 级台阶 ——
台阶整段藏在垂脊当沟里,从山面看不到锯齿(§4.5)。


4. 本轮撤回与修正(逐条,含错在哪)

4.1 脊根一排白点 —— 当沟与筒瓦拱顶相切

现象:正脊根部、每隔一个瓦垄一个闪白的点,远看像一排瓦当,近看是漏光。
根因:当沟底面标高取 檩中 + 瓦面上皮 + 筒瓦拱高,正好等于筒瓦圆柱的拱顶。
两个曲面在拱顶那一条线上相切(共面),深度缓冲分不出前后,逐像素打架。
修法:当沟向下加高 sink = 筒瓦拱高 + 0.15 × 瓦宽,底面落到拱腰以下,
把筒瓦端头整个吞进去;脊顶标高不变(不影响脊高对表)。
实际做法也是当沟压在瓦垄上、筒瓦端头剁齐塞进灰浆。
教训:先试过只沉一点点(0.7 倍拱高),结果当沟底面悬在板瓦面上方,脊根出现一条通长缝 ——
共面要躲,但躲得不够就是另一种病。

4.2 山面一条贯穿全进深的深棕色横带

现象:山墙砌好后,墙面上有一条贯穿全进深的横向深色带,像是墙没砌住梁。
根因:梁厚 358.0 > 墙厚 353.0(墙取 1.2 × 柱径)。梁的两侧面比墙外皮各凸出 2.5 mm。
定位手法:逐组隐藏(梁架 / 垫板 / 枋 / 檐口)看哪一组消失 —— 是梁架。
修法:t_wall = max(梁厚 + 60, 1.2 × 柱径) → 418,墙外皮 ±10109 包住梁 ±10079。
教训:这类"几毫米的凸出"在剖面里看不出来,只能靠逐组开关 + 换视角逼它现形。

4.3 单层 quad 做山墙不可靠

现象:内外两皮 quad(每个步架一段梯形)做山墙,同一套 quad 一端完整、
另一端只渲染出一条竖边,且梁会从墙里透出来。
已排除:mesh bbox 正确、side=DoubleSide 已开、纯色 Basic 材质照旧。
结论:单层 quad 在 root.rotation.x = -π/2 + 逐面 computeVertexNormals 的管线下表现不可靠。
修法:改用竖片 box 叠砌(步长 150)。墙本来就是砖砌实体,
从任何角度都是实体、有厚度、必然挡住梁 —— 不跟渲染管线较劲。

4.4 整面墙像贴了网格纸 —— 片缝的两次误判(本轮改判)

现象:斜视山墙时,墙面每 150 mm 一条浅色细线,整面像百叶/网格纸;正视山面时完全看不见。

先按「z-fighting」判,判错了一次:当时认为 dy + 1 mm 重叠使两片外皮共面挣深度,
改成精确 dy 相接。改完条纹照旧 —— 说明根因不在重叠。

逐组隐藏归因(隐藏「山墙」后那排亮线整段消失)确认线在墙上,再把步长从 150 改到
1000 做对照:墙变成十几片大板,每片交界仍有一条浅色竖线,间距随步长同步放大。
→ 线就在片与片的交界上,是相邻前脸的栅格化接缝:两片前脸共面且共享一条边时,
边界像素两侧各只覆盖一半采样,抗锯齿把背景混进来,成 1 px 亮线。不是 z-fighting。

修法:片宽取 dy + 20(搭接 20 mm),边界像素被两片完整覆盖,缝就没了。
同时踩到的反例:为了「保证谁在前」给相邻片外让 0.35 mm —— 落后那片的侧脸
露出 0.35 mm 宽的竖条,侧脸法线朝 ±Y、受光完全不同,反而是一条条更亮的竖线。
同色共面重叠不存在可见后果:两片颜色相同,深度谁赢都是同一个像素。别加错位。

残留(如实记):斜视时仍有极淡的 1 px 接缝,根因是「一片墙 = 156 个独立 mesh」。
彻底解决要把整片墙做成单网格(多边形三角化 + 侧壁),本轮未做,记入 §6。

4.5 山墙顶一排锯齿从垂脊下沿露出来

现象:山面图上,墙顶 150 mm 台阶沿灰脊下沿排出一排米黄锯齿。
两次根因:
① 墙顶标高取的是片中心的屋面标高,台阶上下各偏半步(150 × 0.5 ≈ ±44),
低的那半截掉到当沟底面以下;
② 改取样后仍在 —— 因为垂脊外皮与墙外皮正好重合(都是 half_w + 墙厚/2),
两面共面挣深度缓冲,墙顶台阶以米黄锯齿的形式从灰脊里透出来。
修法:① 每片取片内较高端,台阶只向上偏,整段落进当沟体内;
② 垂脊中线 = 墙外皮内收半脊宽,再外让 15 mm,真的盖过墙皮。
脊宽取 2.6 瓦宽(494)> 墙厚(418)才盖得住。

但还没完(本轮补的第二刀):檐口端头仍有一段米黄阶梯裸露(out/web/_z_eaveend.png)。
根因不在标高,在长度:chuiji_points() 的折线由 steps 生成,而 steps 只到檐檩,
出檐那一截(yan_out)没有点,垂脊到檐檩就收头了。
修法:chuiji_points() 增加 yan_out 参数,按檐步坡度补一个檐口端头点。
改完当沟一路压到檐口,端头由排山勾滴带收口,交界成一条干净斜线。

4.6 垂脊在檐口收头过早(见 4.5 末段)

单独记一笔,因为它是个参数传递漏项而不是几何算错:函数签名里根本没有出檐这个量,
几何再怎么调标高也补不上漏掉的那一段。教训:先查折线的点是不是走完了构件全长,
再查点上的标高对不对 —— 顺序反了会反复在标高上打转。

4.7 默认轴测站在右后方,看到的是背立面

根因:three.z = r·sinθ,而工程 y = −three.z,故 θ>0 落到工程 y<0(前檐侧)。
原取 −0.38π,实际站在右后方。
修法:改正号,并收到 0.26π(约 47°,接近轴测经典的 45°)——
原来 68° 太偏正前,山墙几乎侧对视线,被压成一条线。

4.8 文档层撤回:K5/K6 曾被我错标成「工匠口径·转引」

「当沟要沉到筒瓦拱腰以下」「脊身要盖住山墙顶」这两条,书里根本没有条款,
是几何自洽逼出来的构造约定。初版规则库把它们标成 [工匠口径·转引] ——
等于给自己的工程约定借了文献的权重。
修法:新增第六态 [本引擎构造约定](rules.CONVENTION),单列这两条。
宁可自认工程约定,也不许借文献的权重。


5. 规则库:四态扩到六态

新增两态,都是"现有四态装不下、又不许硬塞"的产物:

标记含义新增理由
[工匠口径·转引]近代匠作转述 / 百科词条 / 工法帖,多源互证但无则例卷次三砖五瓦、底瓦做中、蚰蜒当、睁眼只有转引;不能进"已验证"(会与官刊混引),也不该退成"待核"(会把"转引可信"与"完全没线索"混在一起)
[本引擎构造约定]文献里没有这条规则,但几何上必须这么接见 §4.7

K 段共 8 条(K1 分中号垄 / K2 正脊断面 / K3 垂脊断面 / K4 筒瓦拱高与睁眼 /
K5 当沟压瓦垄 / K6 脊身压山墙顶 / K7 排山勾滴 / K8 山墙厚度),
其中 K4、K7 标 ⚠(部分实现),其余已实现。
规则库总数 44 → 52 条,01_参数规则库.md 由 python tools/gen_rulebook.py 重新生成。


6. 仍未做的(不许把不完美编圆满)

#缺口原因 / 代价
1板瓦垄不逐块数量级上万块;由瓦面整片代表,只建筒瓦垄那一道凸起
2排山勾滴是连续带,非逐块勾头逐块 4 × 40 ≈ 160 块,图元会爆
3排山走向待核硬山的排山应沿坡向博缝布置,本版仍是沿进深方向的水平带
4筒瓦"睁眼"未建本引擎的筒瓦垄是压在瓦面上的半圆杆,没有"底瓦 → 灰 → 盖瓦"三层厚度
5陡板(通天板)细部未建板厚、企口、与混砖的咬合未做,只按高度比例垒
6垂脊兽前/兽后、仙人走兽未做属脊饰,另立专题
7下碱的砖砌做法(干摆/丝缝/淌白)、砖缝、博缝头雕饰山墙仍是一整片面,只做到「轮廓 + 腰线石 + 护角石 + 拔檐 + 博缝」五件事
8~~台基、踏跺完全没有~~ 本轮已补见 12_硬山台基与砖石作_v1.0.md:台明 + 阶条石 + 台帮 + 台面 + 柱顶石 + 踏跺 + 垂带
9拔梢 / 扭脖(翼角椽)仍未建模沿用上一轮,只记录不建模
10~~山墙是 156 个独立竖片~~ 本轮已改新增 prism 图元,山墙改为一片挤出体(2 个图元)。竖片版与水平层版两次失败的原因见 12 号文档 §4.2

另外记录一处观感但非缺陷的现象:俯视图里正脊两侧有一串"X 形"亮线。
逐组隔离查证后确认不是伪影,是筒瓦垄从当沟底面钻出来时与当沟侧面相交的交线,
两侧坡的垄交错出现,看着像 X。真实构造就是这样。


7. 怎么复现 / 怎么验

python tools/serve.py --port 8712            # 起本地服务(前端零求解,全走 Python 引擎)
python tools/shot_web.py                     # 12 张截图 + console 错误统计
python tools/diag_group.py 硬山 top           # 逐组单独显示/隐藏,定位异常图元
python -m unittest discover -s tests -q      # 70 项
python tools/gen_rulebook.py                 # 重生成 01_参数规则库.md

本轮截图(out/web/):

文件验什么
01_庑殿_轴测 / 06_庑殿_俯视四面坡闭合、"回"字无缺口、戗脊四条
03_歇山_轴测 / 07_歇山_俯视撒头 + 山花 + 博脊
05_硬山_轴测正脊 / 四条垂脊 / 瓦垄 / 山墙 / 额枋一起看
10_硬山_正立面瓦垄竖向线条、檐下柱与枋、正脊层次
11_硬山_山面山墙完整、垂脊连续、墙顶与脊贴合(本轮三个坑都在这张图上抓到)
12_硬山_俯视正脊通长、瓦垄一垄一垄、垄距均匀
13_硬山_正脊放大三砖五瓦八层线脚、脊根是否干净

8. 一句话总结

这一轮把"屋顶"从一张曲面,变成了一个由 8 条规则、4 种断面、2 个模块组成的瓦作系统;
硬山则从一个"缺墙少脊"的样式,补成了能自圆其说的完整形式。

剩下的缺口集中在脊饰、砖作细部、台基三块 —— 都写进 §6 了,没有拿"看起来差不多"糊过去。