10 · 翼角逐根 + 交互式网页推进 · v1.0

编制:小明(建筑设计师) | 2026-11-17
本轮目标:① 翼角从"总括三口径"推到逐根(每根椽的实长/摆角/坡度/翘度/撇度);
② 把 3D 从"静态查看器"改成输入参数实时重建的交互式网页。
一句话:翼角不再是"算一个长度",而是七十二根各不相同的椽,且能当场改参数看它怎么变。


0. 结论先行

  1. 逐根已落地:七檩庑殿 4 角 × 2 侧 × 9 根(成单) = 72 根,含 11 项自校验全通过。

根数不再拍板 —— 由「檐口曲线长 ÷ 椽档」反推,只试奇数。
摆角从贴角梁的 44.5° 收到末根的 2.0°,是真正的扇形(初版只跨 2.2°,已撤回)。

  1. 找到并落地工匠口径原文(马炳坚转引),把旧的"等分转角 ± 长度线性过渡"简化表整个替换掉:

半椽档 / 一椽档、撇半椽(4/10 椽径)、拔梢 8/10、扭脖 8/10。该口径未见则例原文,单独标注,不与官刊混引。

  1. 交互式网页跑通:三栏(参数 / 3D / 数据),改任一参数 170 ms 防抖后重算,

实测重算 129~172 ms、console 0 错误。前端零求解逻辑,所有数值走 Python 引擎。

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

最值得记的三条:椽尾起点用错了金檩外端(导致翼角画成斜平行栅栏)、
尾部起点又曾用错"金檩交点"(摆角只有 45~47°)、
瓦面抬升只加了半个椽径导致与椽共面("瓦面不见了")。

  1. 规则库 42 → 44 条(新增 G5 逐根三度、G6 拔梢扭脖);测试 67 → 70 项全绿。

1. 翼角逐根:口径与算法

1.1 原文口径(转引,非则例)

马炳坚《中国明清建筑木作营造诠释》:

"每一个檐角,都是以角梁两侧左右翼角椽、翘飞椽单数对应成角"
"翼角椽后尾由第一翘开始按照 8/10 椽径拔梢"
"第一翘翼角椽头与角梁间距半椽档,第二翘以后的椽头与椽头之间的椽档应控制在一椽左右"
"椽头的撇度……紧贴角梁的第一翘的撇度为 4/10 椽径即半椽,依次按翼角椽根数缩减退之"
"翘飞椽的翘度是以仔角梁头大连檐下皮确定第一翘飞椽翘度"
"椽尾子处按照椽径 8/10 斜度做扭脖"

三度定义(同书):

度定义几何含义
翘度后尾翘起的程度椽身沿檐口曲线逐根抬升,第一根满值、末根归零
扭度翘起处两转折面交线的斜度交线平行檐口曲线;即椽身绕自身轴的扭转
撇度断面由方形变菱形顶边平行檐口曲线;第一根 4/10 椽径,递减至 0

排列方向也有原文依据(唐中期以后):

翼角椽"逐根呈辐射状展开,向角梁靠拢,最末一根与角梁相并";
"不是逐根缩短,而是在开始时逐根加长,只是最后几根椽尾出于构造原因并入角梁椽槽,才开始缩短"。

这条直接决定了算法:头部密、尾部疏,且实长从正身端向角梁端先增后减。

1.2 引擎怎么算(engine/yijiao.py)

檐口平面曲线 = 正身直线段 + 出冲 45° 斜段
  正身末椽头 P0 = (hw − 椽径, −(hd + 檐出))
  出冲转折点 Q  = (hw + 檐出, −(hd + 檐出))          ← 原文"出三椽径与檐角中线相交为冲三"
  角梁外端  A  = (hw + 檐出 + 冲, −(hd + 檐出 + 冲))
曲线上按"头档半椽、其后一椽档"排椽头;尾部沿**各侧自己**的金檩角部端点向内等距排;
n_auto 只试奇数,取使头档 ≤ 椽档的最小奇数。

关键常数(全部集中在文件头):

常数值来源
CHONG_RATIO3.0(椽径)冲三
QIAO_RATIO4.0(椽径)翘四
HEAD_GAP_FIRST_RATIO0.5第一翘半椽档
HEAD_GAP_REST_RATIO1.0第二翘以后一椽档
PIE_FIRST_RATIO0.4撇半椽
TAISHO_RATIO0.8拔梢 8/10(未建模)
NECK_RATIO0.8扭脖 8/10(未建模)

1.3 三组参数实测

参数组每侧根数合计实长 mm摆角°首翘→末翘首撇→末撇正身檐椽实长/正身
母板 5 檩 10.24×6.49722720.4~3692.244.6→1.6278.4→027.8→02833.60.960~1.303
七檩 19.8×9.69722868.8~3910.144.5→2.0352.8→035.3→02999.20.957~1.304
九檩歇山 19.8×11.211882925.5~3987.844.5→1.9352.8→035.3→03059.00.956~1.304

摆角从贴角梁那根的 44.5°(正对转角对角线)一路收到末根的约 2°(与正身椽平行) ——
这才是原文说的"逐根呈辐射状展开,向角梁靠拢,最末一根与角梁相并"。
末根实长略短于正身椽(0.96 倍),贴角梁那根长 30%,是因为它的尾部退到了角梁后尾。

这个 44.5°→2° 是改出来的,不是初版就有的(初版只跨 2.2°,见 §3.3 与 §3.11)。

1.4 十一项自校验(每次求解都跑)

n_is_odd / first_lift_eq_qiao / last_lift_is_zero / last_pie_is_zero /
len_spread_within_35pct / head_gap_le_rafter_spacing / tail_denser_than_head /
two_sides_symmetric / head_gap_first_half / last_head_at_P0_x / gap_eff_within_25pct

七檩、九檩、母板三组参数下全部 True。


2. 交互式网页

2.1 架构决策:前端不重复实现求解器

tools/serve.py(本地 HTTP 服务)+ viewer/interactive.html(UI + three.js)。

GET  /                  交互式页面
GET  /api/meta          引擎版本、规则条数、算例清单、字段定义
POST /api/solve         {参数} → 完整模型 JSON(图元 + 翼角 + 校验)
GET  /model/<key>       预设算例

为什么不在浏览器里写一份 JS 求解器:那等于同一个引擎两套实现,
迟早出现两套数(网页显示 3200、引擎算出 3184)。现在前端只做三件事 ——
收集参数、画几何、显示引擎给的数。数值只有一个来源。

2.2 界面

  • 左栏参数:算例预设 / 屋顶形式(硬山悬山庑殿歇山)/ 檩数 / 开间(可增删)/ 进深 /

柱高 / 柱径 / 椽径 / 上檐出(留空 = 按则例自动)/ 推山 / 收山 / 举架体系。
留空的字段由引擎按则例补 —— "自动"是本引擎的默认,不是缺省值。

  • 中栏 3D:轴测 / 正立面 / 侧立面 / 平面 / 翼角特写 五个预设视角,鼠标拖转、滚轮缩放、

右键平移;构件显隐 chip(柱/梁架/檩/椽/望板/苫背/瓦面/翼角椽/角梁/山花);
只骨架 / 线框;底部剖切滑块(Y≤ 逐步切)。

  • 右栏数据:翼角根数、关键尺寸、举架推算表、屋顶平面(正脊长 / 正脊÷面阔 / 山面总收进)、

翼角逐根表。所有数字都是引擎算的,前端不算数。

2.3 机器证据

tools/shot_web.py 用 playwright 起真浏览器截图,逐张记录状态(不再最后统一读,避免读到末态误判):

截图图元翼角说明
01 庑殿 轴测86672实体屋面、四面坡、四角起翘
02 翼角特写86672实体,见起翘与椽头
02b 翼角特写 只骨架86672见放射状椽束 + 45° 角梁
06 庑殿 俯视86672四面坡闭合、四角扇形椽
03 歇山 轴测85872正脊/面阔 = 0.909(庑殿 0.562)
07 歇山 俯视85872撒头 + 山花
04 歇山九檩 侧立面110872举架逐级变陡
05 硬山 无翼角10280反证:非 hip 形式不出翼角

console 错误 0 条。


3. ★ 撤回与修正记录(本轮 11 条)

3.1 撤回:尾部起点用错了"金檩交点"

表现:每侧 9 根全挤在 45° 对角线附近,摆角只有 45~47°,两侧几乎重合成一束。

错因:我把椽尾起点取成"交金檩点"(cx−setback, cy−setback),即四角那个点。

正解:各侧椽尾要落在自己那根金檩的角部端点上 ——

前檐侧:Bx = (cx, cy − sy·setback)      前檐金檩沿面阔横跨,端点在角部
山面侧:By = (cx − sx·setback, cy)      山面金檩沿进深横跨,端点在角部
角梁后尾:Cj = (cx − sx·setback, cy − sy·setback)

改后摆角 24~28°,实长 3100~3239,几何才自洽。这个 bug 只能靠画图看出来,
表里数字看着都"合理"。

3.2 撤回:辐射方向反了

第一版头部档距 234.7 > 尾部 211.2 —— 椽子向外散开,与原文"向角梁靠拢"相反。
改为 n_auto 只试奇数、取使 gap ≤ 椽档 的最小奇数,得 9 根(头 88.2 / 尾 161.8)。

3.3 撤回:两侧翼角椽完全重合

根因是两侧共用同一角点与角梁外端。加 lead = 椽径 让出角梁半宽,尾部同步偏移。

3.11 撤回:尾部起点用金檩外端,翼角画成"斜平行一束"

表现:9 根椽几乎平行,方向角只从 67.9° 变到 65.7°(跨 2.2°),像个斜放的栅栏,不是扇形。

错因:把椽尾起点取成金檩外端(角柱轴线),再往内按椽档排。这样头尾都按同一个档距均分,
头尾等距 → 椽身自然平行。

正解(原文「椽尾…并入角梁侧椽槽内」):椽尾从角梁后尾 Cj 起、朝正身方向排。

  • 贴角梁那根:尾在 Cj(角部),头在角梁外端 → 摆角 ≈ 45°(正对转角对角线)
  • 末根:尾在金檩外端,头在正身末椽 → 摆角 ≈ 2°(与正身椽平行)

一改,摆角跨度从 2.2° 变成 42.5°(44.5→2.0),扇形才出来。这是本轮最关键的一处修正。

3.4 撤回:庑殿被画成"单片斜坡"

望板/苫背/瓦面原来是沿面阔拉伸的一块板,只有前后两坡 —— 转角处必然是假坡,
翼角根本没地方落。改为 build_roof_shell():由檩环相邻两层对边连四边形,
四面坡、推山、收山自然落进去。

3.5 撤回:瓦面与椽子共面("瓦面不见了")

build_roof_shell 的抬升只加了 pd/2 + rf/2(椽中线),没加望板、苫背、瓦厚。
结果瓦面正落在椽中线上,两层互相穿插 —— 渲染出来像"瓦面没了、只剩椽"。

正确偏移(自檩中起算):

望板中面 = lift + 椽径/2 + 望板厚/2
苫背中面 = lift + 椽径/2 + 望板厚 + 苫背厚/2
瓦面中面 = lift + 椽径/2 + 望板厚 + 苫背厚 + 瓦高/2

三层必须各自一个 z,合并成一个 lift 就会复发。

3.6 撤回:瓦面停在檐檩、没铺到檐口

rings[0] 是檐檩环(y = ±半进深),而檐口在 ±(半进深 + 檐出)。
差 1008 mm 的檐椽头全部露在瓦面外,看着像没铺瓦的屋架。

修:最外环外扩 檐出,并沿檐步坡降低 檐出 × tan(檐步坡角)。
另加转角三角面(檐口转角 → 角梁头 + 起翘 → 金檩环角点),补上翼角起翘段。

3.7 撤回:正身椽排满到角、与翼角椽重叠

正身椽原来按通面阔均布到 ±W/2,与翼角椽在转角处打两套。
hip 形式改为缩到 ±(W/2 − 椽径 − 椽档),正好让出翼角末根的位置。
(非 hip 形式不变。)

3.8 修正:turn_point 四角同一坐标

_relocate() 镜像时漏搬 turn_point 字段,四个角显示同一个点。
改为遍历所有平面点字段统一镜像 —— 漏一个字段就会四角同一坐标,这类错必须用循环写,不能逐条手抄。

3.9 修正:俯视一片竖条纹

matOf 里 depthWrite = (opacity >= 1),瓦面 0.94 不写深度 → 半透明排序混乱,
下层的椽被画到瓦面上。改为 depthWrite = (opacity > 0.6),并把屋面三层默认设成实体
(想看内部用「只骨架」或剖切)。

3.10 修正:翼角特写相机钻进屋顶

target 原先取 hw*0.90, hd*0.90(往内缩),加上半径按对角线 1.22 倍,
相机实际落在屋顶内部。改为 target 压在转角檐口外侧、半径按椽径定标(≈7600 mm)、
俯角 26°。


4. 缺口(如实标注,不编圆满)

  1. 拔梢 8/10、扭脖 8/10 未建模 —— 只存常数(TAISHO_RATIO / NECK_RATIO),

3D 里椽为等截面直杆。这两项影响椽尾与角梁椽槽的咬合,不影响长度与排列。

  1. 扭度只出参数 —— twist_deg 字段有值,椽身未按转折面切。

3D 里椽的扭转取的是撇度折算角(≤21.8°),不是摆角(≤66°)—— 摆角是平面方向,不是断面扭转,
这一点上一版混用过,已改。

  1. 檐口曲线是两段折线,不是弧线 —— 折线会低估弧长约 3~5%,即翼角范围偏小一点。
  2. 翘度按根次线性递减 —— 原文是"以大连檐下皮定第一翘",属逐根放样,未做。
  3. 椽尾的"椽槽夹持"未做 —— 现在尾部沿金檩按 (段长−让出量)/(n−1) 均分,

原文是并排挤进角梁侧椽槽。影响:贴角梁那几根两侧的椽头会重合在角梁中线附近
(被角梁挡住看不出来),尾部在角部有微量交叉。

  1. 屋脊(正脊/垂脊/戗脊)未出构件 —— 俯视只看得到两坡相交的棱线,没有脊筒、吻兽。
  2. 瓦垄纹理未做 —— 瓦面是整片素面,不是一垄一垄的筒瓦。
  3. 山面无正身椽 —— 前后坡有正身椽,庑殿/歇山的山面坡目前只有瓦面,没有沿山面排的椽。
  4. 悬山出梢未计 —— 与硬山同长。

5. 验收(本轮)

项结果
单元测试70 / 70 OK
规则库条目42 → 44 条,01_参数规则库.md 重新生成并回读校验(15331 字符)
翼角自校验母板 / 七檩 / 九檩三组,11 项 checks 全 True
图元数硬山 1028 / 庑殿 866 / 歇山 858 / 九檩歇山 1108
翼角数反证硬山 0、庑殿 72、歇山 72、九檩歇山 88
网页 console0 error
网页重算耗时129~172 ms

6. 下一步建议(按价值排序)

  1. 屋脊构件(正脊/垂脊/戗脊 + 瓦垄)—— 视觉收益最大,目前"没有脊"最不像古建。
  2. 山面正身椽 —— 补上后庑殿/歇山四面都完整。
  3. 拔梢 / 扭脖建模 —— 让椽尾真正做出斜切,这是"像不像木作"的分水岭。
  4. 弧线檐口 —— 把两段折线换成弧,翼角范围会扩大 3~5%。

7. 补:离线演示版(同日晚)

本地服务版要 python tools/serve.py 才能跑;发给别人看时对方没环境就白屏。
故加 tools/build_offline.py:把 6 套预计算模型 + three.js 内联成单文件
out/翼角演示.html(1.6 MB),双击即开、断网可用,视角/显隐/剖切/只骨架/线框照常,
只是参数不能改(改参数必须真跑引擎)。

实现上踩了一个坑:离线分支没有 await fetch 让出执行栈,init() 会同步走到 build3D(),
撞上主脚本后面 let R 的 TDZ(Cannot access 'R' before initialization)。
修法是在离线分支开头 await null 让一个 microtask。

机器验证(playwright 打开 file://):

操作图元翼角形式
启动(庑殿七檩)81272wudian
切歇山九檩七间143088xieshan
切硬山五檩2500yingshan

console 错误 0 条。