古建木作参数化工具箱 · v0.3(清式小式 · 母板 · 翼角逐根 · 交互式网页)

输入参数 → 举架推算 → 构件尺寸 → 三维模型 / 参数表 / 自检报告
编制:小明(建筑设计师)| 实现:小蓝1号 | 2026-11-17
体系:清式举架 · 小式无斗拱 · 单位 mm · 坐标 Z 向上
母板 v1.0 已落地:presets/muban.json,13 项关键尺寸对表全绿,见 02_母板定义书_v1.0.md
翼角逐根已落地:每角每侧 9 根(成单),7 檩庑殿共 72 根,见 10_翼角逐根与交互式网页_v1.0.md


0. 现在能干什么、不能干什么

能做不能做(本版明确没做)
五/七/九/十一檩小式,任意开间与进深大式带斗拱:斗口制、平身科/角科未做
举架推算:步架→举高→各檩标高(清式则例查表)吻兽、脊筒分件:正脊/垂脊/戗脊/博脊已建断面,兽件未做
屋顶四形式:硬山 / 悬山 / 庑殿(推山)/ 歇山(收山)逐块勾头滴水:瓦垄已按垄排,勾滴按连续带做
翼角逐根:72~88 根,每根出实长/摆角/坡度/翘度/撇度/档距拔梢 8/10、扭脖 8/10:只存常数,3D 椽为等截面直杆
柱、檩、垫板、五架梁/三架梁、瓜柱、椽、飞椽、连檐、瓦口、望板、苫背、瓦面、角梁山面正身椽:山面坡目前只有瓦面,没有沿山面排的椽
交互式网页:改参数实时重建(129~172 ms),五视角 + 构件显隐 + 剖切博风板细节:檩窝、托舌、悬鱼惹草未做实体
构件表 CSV + 自检报告(带缺口清单)直接出 DWG:不写 CAD,不做 t8 提资(后面才接)

1. 三条命令跑通

cd _古建参数化
python -m engine.cli --preset muban        # ★ 母板 v1.0(通则基准,13 项对表全绿)
python -m engine.cli                       # 默认算例(五檩三开间)
python -m engine.cli --preset qilin7       # 七檩五开间
python -m engine.cli --preset wudian       # 庑殿(四坡五脊四翼角)
python -m engine.cli --preset xieshan      # 歇山(下四坡 + 上两坡)
python -m engine.cli --list                # 看有哪些算例(含 presets/*.json)
python -m engine.cli --set depth_mm=7200 --set purlin_count=7   # 临时改参数
python -m unittest discover -s tests -v    # 跑回归测试(82 项,含则例复现 66 条 + 规则库防手改)

★ 交互式网页(改参数当场看)

python tools/serve.py --port 8712          # 起本地服务
# 浏览器打开 http://127.0.0.1:8712/
python tools/shot_web.py                   # 无头浏览器截图 + console 报错检查(视觉验收证据)

三栏布局:左参数 / 中 3D / 右数据。改任一参数,170 ms 防抖后整个模型重算并重画。
左上角五个视角(轴测/正立面/侧立面/平面/翼角特写),右侧构件显隐、只骨架、线框、剖切。
前端零求解逻辑——所有数值 POST 到 Python 引擎,避免"网页一份数、引擎一份数"。

★ 离线演示版(双击即开,给别人看用这个)

python tools/build_offline.py              # → out/翼角演示.html(1.6 MB,自包含)

把 6 套预计算模型(庑殿五/七/九檩、歇山七/九檩、硬山五檩)和 three.js 一起内联进单文件,
双击即开、断网可用,视角/显隐/剖切/只骨架/线框全都能用,只是参数不能改
(改参数必须真跑引擎,所以要么起本地服务,要么重跑这个脚本)。

输出在 out/:

文件内容
model.json完整推导结果 + 图元清单(可被任何前端消费)
viewer.html单文件三维查看器(three.js 已内联,断网也能开,双击即看)
构件表.csv构件清单:断面、长度、数量、依据
自检报告.md输入参数、举架表、檩位表、构件表、校核、缺口清单
web/*.png交互式网页的 8 张验收截图
翼角逐根核对.png翼角逐根平面 + 轴测核对图

三维校核图(二维投影,看几何对不对):

python -m engine.preview out/model.json out/剖面校核.png
python tools/plot_yijiao.py                 # ★ 翼角逐根核对图

浏览器截图(视觉验收证据):

python tools/shot.py out/viewer.html out/viewer_shot.png

2. 目录

_古建参数化/
├── 00_需求梳理_v0.1.md        需求与口径(已确认)
├── 01_参数规则库.md           ★ **自动生成**(勿手改)每条规则的公式 + 出处 + 六态 + 母板实得
├── 02_母板定义书_v1.0.md      ★ 母板是什么/三层架构/参数卡/对表/自检 8 问
├── 03_现成方案调研_v0.1.md    ★ 六个现成古建方案体检,为什么都得自研
├── 04_最新动态_v0.1.md        ★ 2026-11 最新:九野营造开源、翼角最新论文、则例原文线索
├── 05_文献源核对_v1.0.md      ★★ 则例全文拿到了:源清单 + 推翻 4 条 + 冲突 5 条
├── 06_古建知识源谱系_v1.0.md  ★★★ 知识库/方法论/图档/期刊/机构/GitHub/公众号 分七层 + 规则准入五关
├── 07_研究用途许可口径_v1.0.md ★★★ **研究用途**放宽后可取范围 + 三区隔离 + 逐源义务表 + 商用剥离预案
├── 08_大式与翼角_推进_v1.0.md  ★★★ Blender 4.2 实测九野对表 + 斗口制骨架 + 翼角几何(三量分离)
├── 09_屋顶形式_推进_v1.0.md    ★★★ roof_form 四形式 + 推山(算例 2/2 复现)+ 收山两解 + 正脊硬约束
├── 10_翼角逐根与交互式网页_v1.0.md ★★★ 逐根 72 根 + 工匠口径三度 + 10 条撤回记录 + 交互式网页
├── 11_硬山构件与瓦作_v1.0.md  ★★★ 屋脊/瓦作模块化(断面+路径分离)+ 硬山补齐 + 7 条撤回记录
├── 12_硬山台基与砖石作_v1.0.md ★★★ 台明/阶条石/踏跺 + 砖博缝/拔檐/腰线石/护角石 + 3 条撤回记录
├── 13_北京四合院元素规范与修缮_v1.0.md ★★★ 项目主线:导则依据分层 + 三类院落五类建筑 + 修缮边界(引擎只做生成,判定权在人)
├── 14_卷棚与墀头_v1.0.md      ★★ 卷棚过垄脊(双脊檩罗锅椽)+ 墀头盘头梢子六/五层 + 近似如实标
├── 15_博风板与博缝头_v1.0.md  ★★ 博风头七等份放线法(几何自洽性附机器验算)+ 木博风板/砖博缝头
├── presets/
│   ├── muban.json             ★ 母板数据实体(改它 = 换模型,不改代码)
│   ├── wudian.json / xieshan.json  ★ 四形式算例
│   ├── siheyuan.json          ★ 北京四合院正房 · 硬山合瓦清水脊(民居默认做法)
│   ├── siheyuan_juanpeng.json ★ 卷棚过垄脊算例
│   ├── siheyuan_fei.json      ★ 飞椽 + 砖雕墀头(演示单椽/飞椽、素面/砖雕两对开关)
│   ├── siheyuan_xuanshan.json ★ 悬山木博风板(演示木博风板 + 博风板头 + 燕尾枋)
├── engine/
│   ├── rules.py               规则常量(举架表、加斜、则例系数、瓦规格)
│   ├── rulebook.py            ★ 规则注册表 + Markdown 渲染(规则表与代码同源的执行者)
│   ├── zelie.py               ★ 则例算例复现校验(卷24/26 共 66 条,原文自带答案)
│   ├── yijiao.py              ★★ 翼角几何:总括三口径 + **逐根**(`corner_rafters` / `all_corners`)
│   ├── doukou.py              ★ 斗口制骨架(十一等 + 材份换算;未核项故意抛错)
│   ├── roof.py                ★ 屋顶平面(四形式 / 推山 / 收山;只出几何不出网格)
│   ├── params.py              输入参数定义与校验
│   ├── solve.py               举架推算 + 构件尺寸推导
│   ├── model3d.py             ★ 三维图元(box / cyl / **leg 两点杆** / **quad 面片** / **round 圆杆** / **prism 多边形棱柱** / 坡面壳)
│   ├── roof_parts.py          ★★ 瓦作与屋脊:断面(三砖五瓦 / 皮条脊)与路径分离,四形式共用
│   ├── base_parts.py          ★★ 台基:台明 / 阶条石 / 台帮 / 台面 / 柱顶石 / 踏跺 / 垂带
│   ├── roof_finish.py         ★★ 六种屋面做法(筒瓦/合瓦 × 大脊/清水/鞍子/过垄)+ 脊身断面 + 卷棚圆弧 + 清水脊端部
│   ├── tiptou.py              ★★ 墀头 v2:三材质(石/砖墙/砖雕)+ 砖模数归整 + 看面六式 + 整石挑檐 + 砖雕线脚 + 戗檐 + 博缝头
│   ├── bofeng.py              ★★ 博风板 v1:七等份放线法(1大圆+4小圆=五个凸指)+ 木博风板 + 砖博缝头
│   ├── export.py              JSON / CSV / 报告 / 单文件 HTML
│   ├── preview.py             二维剖面·立面校核图
│   └── cli.py                 命令行入口(自动读 presets/*.json + 母板对表)
├── viewer/
│   ├── template.html          静态查看器模板(three.js 内联位)
│   └── interactive.html       ★★ 交互式网页(三栏 / 五视角 / 显隐 / 剖切;零求解逻辑)
├── vendor/three.min.js        three.js r128(本地,不依赖 CDN)
├── vendor/_ref/               ★ B 区研究参考:chbim(MIT)/miniLibs(MIT)/九野(GPL+NC) 克隆 + 许可台账(永不进交付)
├── tools/serve.py             ★★ 本地服务(GET / /api/meta /model/<k>;POST /api/solve)
├── tools/build_offline.py     ★ 生成离线演示版单文件(预计算 9 套模型:3 套四合院置顶 + 6 套四形式)
├── tools/shot_web.py          ★ 交互式网页截图 + console 报错检查(逐张记录状态)
├── tools/diag_group.py        ★ 逐组单独显示/隐藏截屏,定位异常图元出自哪一组
├── tools/plot_yijiao.py       ★ 翼角逐根核对图(平面 + 轴测)→ out/翼角逐根核对.png
├── tools/shot.py              无头浏览器截图(自动探测本机 chromium)
├── tools/gen_rulebook.py      ★ 生成 01_参数规则库.md(改完 rules.py 必跑)
├── tools/check_license.py     ★ 三区隔离闸门(扫交付区是否混入外部实现/NC 内容)
├── tools/plot_roof.py         ★ 四形式平面对比图 → out/屋顶平面_四形式.png
├── data/则例原文/               ★★ 卷二十四、卷二十六 小式大木原文(可回读)
├── tools/check_zelie.py       跑则例复现,出 out/则例算例复现报告.md
├── tools/check_distill.py     ★ 专家库蒸馏表落点校验(查幽灵文件 / 幽灵函数 / 缺归属)
├── tests/test_engine.py       94 项回归测试(母板契约 + 则例复现 + 规则库防手改 + 出处链 + 许可闸门 + 翼角逐根 + 屋顶形式 + 博缝头形制)
└── out/                       输出(muban/ 母板、muben/ 实测母本、各算例、web/ 网页截图)

3. 输入参数(全部 mm)

参数默认含义依据
bays_mm[3300,3600,3300]各开间面阔设计给定
depth_mm6400前后檐檩中到中(通进深)设计给定
purlin_count5檩数,只收 5/7/9/11则例
column_height_mm3000檐柱高:柱脚到柱头上皮设计给定
column_dia_mm柱高/10柱径则例 无斗拱「径按高十分之一」
rafter_mm柱径/3椽见方则例「见方按柱径三分之一」
rafter_spacing_mm2×椽见方椽中距缺口项(暂按净距=椽径)
eave_out_mm0.3×柱高上檐出(总平出)则例
tile_system / tile_kind / tile_no布瓦 筒瓦 2#瓦种瓦号布瓦规格来自科普词条,须以封样为准
wakou_no头号瓦口档(头号/二号/三号)则例
plank_thick_mm18望板厚缺口项
daub_thick_mm30苫背厚缺口项(仅影响几何,不影响结构)
purlin_overhang_mm0檩山出(硬山=0,悬山可给)设计给定
step_lens_mmNone不等步架(每侧各步,檐→脊)。给了就以实测为准,depth_mm 自动改为 2×各步之和西倒座房实测:1280 / 955
jiajia_overrideNone覆盖举架成数(长度须=每侧步数)允许设计微调;母本 0.549 / 0.627
beam_section_mmNone梁断面 [高, 厚],覆盖则例断面链(默认 厚 = 柱径+2寸、高 = 厚+2寸)西倒座房引注 250×200
roof_formyingshan屋顶形式:yingshan 硬山 / xuanshan 悬山 / wudian 庑殿 / xieshan 歇山只有 hip 形式才出翼角
tui_shanTrue庑殿/歇山是否推山(每山自金步起逐层递减一成)《营造算例》转引,算例 2/2 复现
shou_shan_purlin1歇山收山的檩数口径(两解并存,引擎不替原文拍板)见 09 文档 §2
jiaxie_modevernacular加斜口径:vernacular 民间(1.15/1.25/1.35)/ zelie 则例两者差 1~3%
style小式本期只支持小式—

4. 推导链(算的是什么)

明间面阔 × 0.8 / 0.7         → 檐柱高(通则反推值,仅用于校核设计取值)
明间面阔 × 0.07 / 0.05       → 檐柱径(同上;**不是**柱高/10)
通进深 ÷ (2k)               → 步架长(默认均分,可由 step_lens_mm 改实测)
步架长 × 举架成数            → 各步举高(分举高)
柱高 + 平水 + 檩半径          → 檐檩标高 → 逐架累加 → 脊檩标高
檩径 = 柱径(七檩)/ 柱径+1寸(五檩)
檩径 × 0.3                  → 椽见方 → 椽档 → 椽根数
檐柱径                       → 檐枋高(= 柱径)→ 厚 = 高 − 2寸
檐枋高 − 1寸(≤6寸不收)      → 垫板宽 = **平水**
檩径 × 0.3                  → 垫板厚
柱高 × 0.3                  → 上檐出(小式无飞椽 → 檐椽独担,不拆 2:1)
(步架 + 出檐) × 加举          → 檐椽长(算料)/× √(1+h²) → 檐椽长(建模)
柱径 + 2寸 → 厚;厚 + 2寸 → 高 → 五架梁;每层高厚各收 2寸 → 三架梁
三架梁厚 − 1寸               → 瓜柱径
檩环(檐檩→金檩→脊檩)        → 屋顶平面;hip 形式推山使山面逐层内收 → 正脊加长
檩环相邻两层对边连四边形      → 四面坡(望板/苫背/瓦面三层各一 z)
檐口曲线 = 正身直线 + 出冲45°  → 翼角椽头位置;椽尾沿各侧金檩角部端点
曲线长 ÷ 椽档 → 只试奇数       → 翼角椽根数(成单);头部半椽档、其后一椽档
翘度 4椽径递减至0 / 撇度 0.4椽径递减至0 → 每根翼角椽的 lift / pie

两条不许混的口径:

  • 算料长 vs 几何长:则例「加举」是匠人口算(五举 1.15、七举 1.25、九举 1.35),比 √(1+h²) 大约 1~3%,那 1~3% 是椽头余量。length_mm 给料单,model_len_mm 给模型。
  • 通则反推 vs 设计取值:柱高柱径引擎按面阔反推一份,同时保留设计输入值,两者都要报出来。

完整公式、出处、六态、母板实得见 01_参数规则库.md。该文件由 python tools/gen_rulebook.py 从
engine/rules.py + engine/rulebook.py 自动生成,勿手改(手改会被 tests:TestRulebook 抓出)。
改规则的流程是:改 rules.py → 补 rulebook.py 的条目 → 跑 gen_rulebook.py → 跑测试。


5. 交互式网页怎么用

python tools/serve.py --port 8712     # 然后浏览器开 http://127.0.0.1:8712/
  • 左栏参数:算例预设 / 屋顶形式 / 檩数 / 开间(可增删)/ 进深 / 柱高 / 柱径 / 椽径 / 上檐出 / 推山 / 收山 / 举架体系;

椽与墀头:屋面做法 / 飞椽开关(单椽↔飞椽)/ 墀头开关 / 盘头层数 / 盘头材质(砖↔石挑檐)/ 砖雕等级(素面↔外框↔纹样)/ 看面排砖六式 / 天井柱径比。
做法:台明下出比(小式 0.8 / 大式 0.75)。共 20+ 个可输入参数,改后 170ms 防抖重算。
留空 = 按则例自动(柱径、椽径、上檐出留空即为"自动",这是默认口径,不是缺省值)。

  • 中栏 3D:左键拖旋转,滚轮缩放,右键/Shift+左键平移。

顶部五个视角:轴测 / 正立面 / 侧立面 / 平面 / 翼角特写。
右侧 chip 逐组显隐(柱/梁架/檩/椽/望板/苫背/瓦面/翼角椽/角梁/山花);
「只骨架」一键关掉望板苫背瓦面看屋架;「线框」;底部剖切滑块从前往后切。

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

翼角逐根表。所有数字由引擎算,前端不参与计算。

默认显示实体屋面(不是玻璃盒子)。想看内部梁架:点「只骨架」或拉剖切滑块。


6. 已经踩过的坑(别再犯)

坑表现正解
檐椽按则例字面「加平出檐一份」椽头比檐口短 64 mm,连檐悬空平出是水平投影,折斜长要 ÷cos(坡角)
飞椽当成「向上翘的一段」檐口断裂、构件悬空飞椽本身更平(三五举 < 五举),头因坡度差而抬高,这才是反宇
三层屋面都做半透明0.66×0.55×0.38 ≈ 0.9,等于不透明,屋里看不见默认只显示瓦面层
只有檐柱金檩、脊檩悬空必须补梁架:五架梁 / 三架梁 / 金瓜柱 / 脊瓜柱
檩直接坐柱头垫板没位置,层次错层次是「檩 → 垫板 → 柱头/梁背」,垫板高就是平水
翼角椽尾取"交金檩点"摆角只有 45~47°,两侧挤成一束重合各侧用自己那根金檩的角部端点;改后 24~28° 才自洽
翼角椽辐射方向反了头部档距 > 尾部档距,椽向外散原文是"向角梁靠拢",头密尾疏;n_auto 只试奇数取最小
坡面抬升只加半个椽径瓦面与椽共面、互相穿插,看着像"瓦面不见了只剩椽"望板/苫背/瓦面三层各一个 z,见 10 文档 §3.5
坡面停在檐檩1008 mm 檐椽头全露在瓦面外,像没铺瓦的屋架最外环要外扩檐出、沿檐步坡降低
正身椽排满到 ±W/2转角处两套椽重叠,翼角忽然密一倍hip 形式缩到 ±(W/2 − 椽径 − 椽档)
材质 depthWrite = (opacity>=1)俯视一片竖条纹,下层椽透到瓦面上depthWrite = (opacity>0.6)
坡面 quad 只设单面转角几片被整块剔除单层 quad 一律 DoubleSide
three.js 走 CDN断网白屏内联进单文件 HTML
天正尺寸 TDbDimension2 在 COM 里没有 Measurement取不到标注数值先 EXPLODE 成 AcDbAlignedDimension 再读;或直接量几何
accoreconsole.exe 本机起不来(2024 报 53、2018/2021 挂)无头批处理不可用改走 COM:DispatchEx("AutoCAD.Application.24.3") 起独立实例,只读打开副本
COM 起第二个实例后 app.Documents 抛 <unknown>.Open实例一多就连不上一次运行只起一个实例、干完即退,不要连续起停
matplotlib 中文字号 < 9中文整段消失,只剩数字(标题正常,极易误判为字体缺失)中文文本一律 fontsize>=10
timeout 在 Git Bash 里是 Windows 的 TIMEOUT命令根本没执行却"看起来失败"用 powershell 的 Start-Process 超时,或不加超时改用后台任务
镜像点字段只搬一半turn_point 四角同一坐标,数据面板与核对图全错镜像用循环遍历全部平面点字段,不逐条手抄
截图脚本最后统一读状态读到的是末态(硬山无翼角),误判成"庑殿也没翼角"每截一张当场记录该状态
当沟底面与筒瓦拱顶相切脊根每隔一垄一个闪白点,像漏光两曲面在拱顶共面挣深度缓冲;当沟下沉 拱高 + 0.15×瓦宽,把瓦垄端头整个吞进去
墙厚 < 梁厚山面一条贯穿全进深的深棕横带,像墙没砌住梁墙厚 max(梁厚+60, 1.2×柱径);定位靠逐组开关
单层 quad 做山墙一端完整、另一端只剩一条竖边,梁从墙里透出来改竖片 box 叠砌,不跟渲染管线较劲
山墙竖片精确相接斜视时整面墙像贴了网格纸,每 150 mm 一条 1 px 亮线(正视看不见)不是 z-fighting,是相邻共面前脸的栅格化接缝;片宽取 dy + 20 搭接,边界像素被两片完整覆盖
给搭接片加"外让 0.35 mm 保证谁在前"反而每条缝更亮落后那片的侧脸露 0.35 mm 竖条,侧脸受光不同;同色共面重叠谁赢都一样,别加错位
山墙顶台阶取片中心标高台阶上下各偏半步,低的那截掉到当沟以下,露出一排锯齿取片内较高端,台阶只向上偏、落进当沟体内
脊外皮与墙外皮重合墙顶台阶以米黄锯齿从灰脊里透出来脊中线再外让 15 mm,真的盖过墙皮
垂脊折线只到檐檩出檐那一段墙顶台阶裸在脊外,檐口端头一排米黄锯齿chuiji_points() 漏了 yan_out 这个量;补檐口端头点,先查折线走没走完全长再查标高
轴测方位角取负默认视角站在右后方,看到的是背立面three.z = r·sinθ 而工程 y = −three.z,正号才在前檐侧
台基向下长时,新构件的落脚面台阶整座悬在台明上方 670,垂带石留在下面踏步必须从地面(−台明高)向上长;台基把 z 基准从 0…脊顶 扩成 −670…脊顶,凡新增竖向构件都要重问一句「落脚面在哪个标高」
用箱体切「一片异形墙体」竖切 → 满墙竖纹;横切 → 满墙亮横纹。两次都失败台阶总有一面(侧脸朝 ±Y / 顶面朝 +Z)要露出来且受光与正面不同。改用 prism 多边形棱柱一次挤出,152 图元 → 2
一个缺陷反复调参数修不掉在山墙接缝/搭接/步长上折了两轮先怀疑「图元类型选错了」,不要一直调参数 —— 真解往往在换表示,不在调数值
GridHelper 在整体旋转的 root 里一张"地面网格"其实是一面竖网,立在建筑正中、白线穿过所有墙体GridHelper 默认在局部 XZ,root 绕 X 转 −90° 后成了世界 XY;必须 rotation.x = π/2 放平。所有辅助对象(grid/axes/平面)都要显式校正朝向
拿官式则例套民居四合院正房做成筒瓦三砖五瓦大脊 —— 超规格,且违反导则 5.0.7民居合法性依据在《北京老城保护房屋修缮技术导则》(有条文号),不在则例。民居默认合瓦 + 清水脊 / 鞍子脊;筒瓦只给影壁 / 门楼 / 游廊 / 垂花门。新增第七态 [市级技术导则·原文]
把"修缮"写成自动规则想让程序按病害自动定做法定级(三类院落五类建筑)→ 诊断 → 选做法都是设计人判断,依赖现场勘察。引擎只做"按选定做法生成构件"这第 ④ 步;规则库 M10–M14 标 规则有据·引擎未做,不进求解器
墀头盘头的台阶标高取错盘头整组悬在墙外 353 mm,轴测里是半空几个小灰块台阶标高取连檐下皮(z_eave_tip − tile_H),不是檐枋下皮 —— 墀头面必须从台基一路通到连檐,墙只在连檐以上才外扩
石挑檐省层却不补出挑改用整石挑檐省掉枭/混/炉口后,天井只剩 71(应 ≈287),戗檐扑身错位挑檐石必须作为一层计入 cum(天井),不能只画石块不算出挑;见 pantou_layers(stone=True)
墀头"合模数"当成造新模数想新造一套尺寸模数基准已存在 = 小停泥砖厚 70(XIAOTINGNI_BRICK[2]);把看面宽/层高归到砖厚整数倍即可,别凭空造
飞椽问题想替规制拍板纠结小式到底有没有飞椽则例卷十七「小式无飞檐」vs 匠作「上檐出三分飞椽占一」两说并存 → 做成 has_fei 开关,默认从则例,不替规制定论
博风头当成整块方砖弧线在内部,看不出是头头是弧链围成的多段曲线凸块;砖边是被錾子剔掉的料,不是边界
小弧只画单侧半圆五个凸指少了一半,像链条文献说「向外侧和内侧画弧」=整圆(1大+4小=五个相切圆盘=菊花头)
博风板用 leg 图元686 的板宽跟着坡斜甩出去,盖住屋面板是竖板(板面平行山墙、板宽垂直坡面)→ 用 prism((y,z) 多边形沿 X 挤出)
板段各转各的坡角一变,两段下口张开 100 楔口,山面正投影一条白缝下口按角平分斜接,相邻段共用一条端缝(断言锁住)
燕尾枋按字面每根檩都做金檩那道从板下口探出,成一排小木块默认只在檐檩下一道;bofeng_yanwei 开关保留「全部出梢檩」说
博缝头凸出带面 / 方向写反转角看是一朵砖雕糊在博缝带上头与长身同平面同厚;长身末段先退头高,头顺坡(+_ey)补进去
悬山只出一套板板浮在屋面半空前山(y<0)/后山(y>0)是两面山,各挂一整套
砖博缝头漏了平移板头掉在山墙中部的地上build_bofengtou 的轮廓是局部坐标,须平移到安装位置
砖博缝与木博风板混做悬山同时出现砖博缝与木博风板三者互斥:硬山=砖博缝、悬山=木博风板、庑殿歇山=都没有
金边 25 是拍脑袋值石作金边(TAIBANG_INSET)与砖作花碱(退花碱 9)都无出处2026-11-17 按小明指定 + 国标归整:石作金边 25→10(阶条石比埋头宽 5~8 转引);砖作花碱 9→10(GB/T 51330-2019 7.4.1-3 明文 10~20,新增第八态 [国家标准·原文])。两者部位不同,不可混引
大式下出套到小式民居全模型用下出=上檐出×3/4(大式),四合院小式应为 4/5下出比例参数化 platform_out_ratio:母板默认 None→0.75(对表 24/24 不动),四合院三预设显式 0.8;model3d 同值传墀头定位,否则台明与墀头错位
山墙"直接落地"的错觉看到山墙脚贴台明,以为该落到室外地坪房屋山墙下碱从台明面 ±0.000 起,台明石包住墙脚;落到室外地坪是院墙做法。现状正确,勿改

6.5 母本反算校核(2026-11-16)

拿真图反算,结论见 out/母本反算校核报告.md。要点:

项母本实测(西倒座房)则例默认结论
举架檐步 0.549 / 脊步 0.6270.5 / 0.7不按则例:檐更陡、脊更平
步架1280 / 955(不等)均分 1118民居不等步架
总举高13021341只差 −2.9%,总高相近
五架梁250×200294×210(1.4d×d)引擎原假设偏高 15%
椽见方69.2柱径/3 = 70符合(柱径为推定值)

跑母本算例:

python -m engine.cli --preset muben

反算脚本 tools/check_muben.py 的输入是 E:\_cadwork\gu\geo_xdz_ex.jsonl(由 dump3.py 经 COM 提取),不依赖 AutoCAD 常驻。


6.6 母板 v1.1(2026-11-16,通则基准 · 则例原文校核版)

母板 = 完全按则例推导、不掺任何实测修正的零点模型。 后续所有方案(含实测改良版)都从它派生。

python -m engine.cli --preset muban --out out/muban
要点内容
数据实体presets/muban.json——改这个文件就换模型,不动代码
输入只 5 项檩数 5 / 柱高 3200 / 柱径 320 / 通进深 6400 / 面阔 3200+3840+3200
关键尺寸步架 1600(5 尺)、檐檩 3664(11.45 尺)、脊檩 5584(17.45 尺)、总举高 1920(6 尺)、上檐出 960(3 尺)
对表24 项关键尺寸全部通过(容差 0.5 mm),落 out/muban/母板对表.csv
清尺复算全部落在「整分」(0.1 寸 = 3.2 mm)网格上,能拿尺+寸+分直接核(有测试钉住)
则例复现卷24/26 算例 66/66 通过,见 out/则例算例复现报告.md
三层架构L0 通则层(不改)/ L1 尺度层(按项目改)/ L2 地域层(母板全空)

为什么要母板:以前拿实测母本反算,发现"对不上则例"时说不清是引擎错了还是民居不守则例。有了母板,偏差可以定位——母板全绿说明规则链没错,对不上就是地域做法差异。

v1.1 与 v1.0 的差别(2026-11-16 晚):拿到《工程做法》卷二十四/二十六原文后,v1.0 的 8 条推定值里有 4 条被直接推翻——小式无飞椽、檩径≠柱径、椽见方按檩径十分之三、垫板宽=檐枋高−1 寸。基准由 13 项重算为 24 项。详见 05_文献源核对_v1.0.md。

母板自检仍存的问题(望板厚、苫背厚、椽档两说冲突、面阔比例非硬条文),逐条见定义书 §8 与 05 文档 §5。

派生改良版(三步):

cp presets/muban.json presets/gaiban_xdz.json    # 1 复制
# 2 只改 L2 层:step_lens_mm / jiajia_override / beam_section_mm / column_*
python -m engine.cli --preset gaiban_xdz --out out/gaiban_xdz   # 3 跑,对表会报偏离通则几项

6.7 现成方案调研结论(2026-11-16)

看了六家:ACA-Builder(Blender 清官式)、GuCAD(建研院商业软件)、yingzao(宋式 Rhino)、chbim-prototype(开源 OpenSCAD)、threejs-architecture-effects(视觉)、ARCHICAD GDL 实践。

没有一家能直接用:或拿不到源码、或绑死宿主软件(Blender/Rhino/ARCHICAD/OpenSCAD)、或体系不对(宋式材份≠清式举架)、或成熟度只到檐柱。详见 03_现成方案调研_v0.1.md。

有两条值得抄:ACA-Builder 的八段式模块划分(台基→柱网→装修→斗科→梁架→椽架→翼角→瓦面)、chbim 的「缝编码 + 构件 JSON」数据模型。


7. 下一步(按优先级)

  1. 屋脊构件(正脊/垂脊/戗脊 + 瓦垄)—— 视觉收益最大,现在"没有脊"最不像古建
  2. 山面正身椽 —— 补上后庑殿/歇山四面才都完整
  3. 拔梢 / 扭脖建模 —— 椽尾真正做出斜切,这是"像不像木作"的分水岭
  4. 弧线檐口 —— 现在两段折线,换弧后翼角范围扩大 3~5%
  5. 改良版:在母板上只动 L2 层,验证"偏离通则几项"这个机制跑得通
  6. ~~山墙与博风板:现在山面是光口~~ ✅ 已完成(硬山山墙 + 砖博缝、悬山木博风板,见 11/15 文档)
  7. ~~翼角逐根(M3)~~ ✅ 已完成(见 10 文档),72~88 根全出
  8. ~~用母本真图反算校验~~ ✅ 已完成(见 §6.5),暴露并修掉 3 处假设
  9. ~~按通则做母板~~ ✅ 已完成(见 §6.6)
  10. 补母本缺口:柱径(需平面逐间量)、面阔与开间数、随梁构件
  11. 补缺口的规则:望板厚、椽档、瓜柱径、梁高 —— 回《工程做法则例》原文核
  12. 节点图输出、t8 提资边界(远期)

8. 免责与边界

  • 所有规则整理自《工程做法则例》大木小式做法的公开转引,正式出图前必须回原文逐条核,并标注条文位置。
  • 翼角三度的工匠口径(半椽档 / 撇半椽 / 8-10 拔梢)来自马炳坚著作转引,未见则例原文,规则库中标为 [未验证],不得与官刊口径混引。
  • 引擎算的是尺寸与位置,不是审批结论;合规性另走知识库 03_技术判据 那条线。
  • 不写 DWG、不驱动 CAD、不替代施工图设计。

v0.3 · 2026-11-17 · 翼角逐根 72 根落地 + 交互式网页(改参数实时重建)
v0.2 · 2026-11-16 · 母板已落地(13/13 对表),下一步做改良版与翼角