10 · 翼角逐根 + 交互式网页推进 · v1.0
编制:小明(建筑设计师) | 2026-11-17
本轮目标:① 翼角从"总括三口径"推到逐根(每根椽的实长/摆角/坡度/翘度/撇度);
② 把 3D 从"静态查看器"改成输入参数实时重建的交互式网页。
一句话:翼角不再是"算一个长度",而是七十二根各不相同的椽,且能当场改参数看它怎么变。
0. 结论先行
- 逐根已落地:七檩庑殿 4 角 × 2 侧 × 9 根(成单) = 72 根,含 11 项自校验全通过。
根数不再拍板 —— 由「檐口曲线长 ÷ 椽档」反推,只试奇数。
摆角从贴角梁的 44.5° 收到末根的 2.0°,是真正的扇形(初版只跨 2.2°,已撤回)。
- 找到并落地工匠口径原文(马炳坚转引),把旧的"等分转角 ± 长度线性过渡"简化表整个替换掉:
半椽档 / 一椽档、撇半椽(4/10 椽径)、拔梢 8/10、扭脖 8/10。该口径未见则例原文,单独标注,不与官刊混引。
- 交互式网页跑通:三栏(参数 / 3D / 数据),改任一参数 170 ms 防抖后重算,
实测重算 129~172 ms、console 0 错误。前端零求解逻辑,所有数值走 Python 引擎。
- 本轮修掉 11 个实质缺陷,其中 6 个是我自己上一版写错的(§3 逐条撤回)。
最值得记的三条:椽尾起点用错了金檩外端(导致翼角画成斜平行栅栏)、
尾部起点又曾用错"金檩交点"(摆角只有 45~47°)、
瓦面抬升只加了半个椽径导致与椽共面("瓦面不见了")。
- 规则库 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_RATIO | 3.0(椽径) | 冲三 |
QIAO_RATIO | 4.0(椽径) | 翘四 |
HEAD_GAP_FIRST_RATIO | 0.5 | 第一翘半椽档 |
HEAD_GAP_REST_RATIO | 1.0 | 第二翘以后一椽档 |
PIE_FIRST_RATIO | 0.4 | 撇半椽 |
TAISHO_RATIO | 0.8 | 拔梢 8/10(未建模) |
NECK_RATIO | 0.8 | 扭脖 8/10(未建模) |
1.3 三组参数实测
| 参数组 | 每侧根数 | 合计 | 实长 mm | 摆角° | 首翘→末翘 | 首撇→末撇 | 正身檐椽 | 实长/正身 |
|---|---|---|---|---|---|---|---|---|
| 母板 5 檩 10.24×6.4 | 9 | 72 | 2720.4~3692.2 | 44.6→1.6 | 278.4→0 | 27.8→0 | 2833.6 | 0.960~1.303 |
| 七檩 19.8×9.6 | 9 | 72 | 2868.8~3910.1 | 44.5→2.0 | 352.8→0 | 35.3→0 | 2999.2 | 0.957~1.304 |
| 九檩歇山 19.8×11.2 | 11 | 88 | 2925.5~3987.8 | 44.5→1.9 | 352.8→0 | 35.3→0 | 3059.0 | 0.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 庑殿 轴测 | 866 | 72 | 实体屋面、四面坡、四角起翘 |
| 02 翼角特写 | 866 | 72 | 实体,见起翘与椽头 |
| 02b 翼角特写 只骨架 | 866 | 72 | 见放射状椽束 + 45° 角梁 |
| 06 庑殿 俯视 | 866 | 72 | 四面坡闭合、四角扇形椽 |
| 03 歇山 轴测 | 858 | 72 | 正脊/面阔 = 0.909(庑殿 0.562) |
| 07 歇山 俯视 | 858 | 72 | 撒头 + 山花 |
| 04 歇山九檩 侧立面 | 1108 | 72 | 举架逐级变陡 |
| 05 硬山 无翼角 | 1028 | 0 | 反证:非 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. 缺口(如实标注,不编圆满)
- 拔梢 8/10、扭脖 8/10 未建模 —— 只存常数(
TAISHO_RATIO/NECK_RATIO),
3D 里椽为等截面直杆。这两项影响椽尾与角梁椽槽的咬合,不影响长度与排列。
- 扭度只出参数 ——
twist_deg字段有值,椽身未按转折面切。
3D 里椽的扭转取的是撇度折算角(≤21.8°),不是摆角(≤66°)—— 摆角是平面方向,不是断面扭转,
这一点上一版混用过,已改。
- 檐口曲线是两段折线,不是弧线 —— 折线会低估弧长约 3~5%,即翼角范围偏小一点。
- 翘度按根次线性递减 —— 原文是"以大连檐下皮定第一翘",属逐根放样,未做。
- 椽尾的"椽槽夹持"未做 —— 现在尾部沿金檩按 (段长−让出量)/(n−1) 均分,
原文是并排挤进角梁侧椽槽。影响:贴角梁那几根两侧的椽头会重合在角梁中线附近
(被角梁挡住看不出来),尾部在角部有微量交叉。
- 屋脊(正脊/垂脊/戗脊)未出构件 —— 俯视只看得到两坡相交的棱线,没有脊筒、吻兽。
- 瓦垄纹理未做 —— 瓦面是整片素面,不是一垄一垄的筒瓦。
- 山面无正身椽 —— 前后坡有正身椽,庑殿/歇山的山面坡目前只有瓦面,没有沿山面排的椽。
- 悬山出梢未计 —— 与硬山同长。
5. 验收(本轮)
| 项 | 结果 |
|---|---|
| 单元测试 | 70 / 70 OK |
| 规则库条目 | 42 → 44 条,01_参数规则库.md 重新生成并回读校验(15331 字符) |
| 翼角自校验 | 母板 / 七檩 / 九檩三组,11 项 checks 全 True |
| 图元数 | 硬山 1028 / 庑殿 866 / 歇山 858 / 九檩歇山 1108 |
| 翼角数反证 | 硬山 0、庑殿 72、歇山 72、九檩歇山 88 |
| 网页 console | 0 error |
| 网页重算耗时 | 129~172 ms |
6. 下一步建议(按价值排序)
- 屋脊构件(正脊/垂脊/戗脊 + 瓦垄)—— 视觉收益最大,目前"没有脊"最不像古建。
- 山面正身椽 —— 补上后庑殿/歇山四面都完整。
- 拔梢 / 扭脖建模 —— 让椽尾真正做出斜切,这是"像不像木作"的分水岭。
- 弧线檐口 —— 把两段折线换成弧,翼角范围会扩大 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://):
| 操作 | 图元 | 翼角 | 形式 |
|---|---|---|---|
| 启动(庑殿七檩) | 812 | 72 | wudian |
| 切歇山九檩七间 | 1430 | 88 | xieshan |
| 切硬山五檩 | 250 | 0 | yingshan |
console 错误 0 条。