古建木作参数化工具箱 · 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_mm | 6400 | 前后檐檩中到中(通进深) | 设计给定 |
purlin_count | 5 | 檩数,只收 5/7/9/11 | 则例 |
column_height_mm | 3000 | 檐柱高:柱脚到柱头上皮 | 设计给定 |
column_dia_mm | 柱高/10 | 柱径 | 则例 无斗拱「径按高十分之一」 |
rafter_mm | 柱径/3 | 椽见方 | 则例「见方按柱径三分之一」 |
rafter_spacing_mm | 2×椽见方 | 椽中距 | 缺口项(暂按净距=椽径) |
eave_out_mm | 0.3×柱高 | 上檐出(总平出) | 则例 |
tile_system / tile_kind / tile_no | 布瓦 筒瓦 2# | 瓦种瓦号 | 布瓦规格来自科普词条,须以封样为准 |
wakou_no | 头号 | 瓦口档(头号/二号/三号) | 则例 |
plank_thick_mm | 18 | 望板厚 | 缺口项 |
daub_thick_mm | 30 | 苫背厚 | 缺口项(仅影响几何,不影响结构) |
purlin_overhang_mm | 0 | 檩山出(硬山=0,悬山可给) | 设计给定 |
step_lens_mm | None | 不等步架(每侧各步,檐→脊)。给了就以实测为准,depth_mm 自动改为 2×各步之和 | 西倒座房实测:1280 / 955 |
jiajia_override | None | 覆盖举架成数(长度须=每侧步数) | 允许设计微调;母本 0.549 / 0.627 |
beam_section_mm | None | 梁断面 [高, 厚],覆盖则例断面链(默认 厚 = 柱径+2寸、高 = 厚+2寸) | 西倒座房引注 250×200 |
roof_form | yingshan | 屋顶形式:yingshan 硬山 / xuanshan 悬山 / wudian 庑殿 / xieshan 歇山 | 只有 hip 形式才出翼角 |
tui_shan | True | 庑殿/歇山是否推山(每山自金步起逐层递减一成) | 《营造算例》转引,算例 2/2 复现 |
shou_shan_purlin | 1 | 歇山收山的檩数口径(两解并存,引擎不替原文拍板) | 见 09 文档 §2 |
jiaxie_mode | vernacular | 加斜口径: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.627 | 0.5 / 0.7 | 不按则例:檐更陡、脊更平 |
| 步架 | 1280 / 955(不等) | 均分 1118 | 民居不等步架 |
| 总举高 | 1302 | 1341 | 只差 −2.9%,总高相近 |
| 五架梁 | 250×200 | 294×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. 下一步(按优先级)
- 屋脊构件(正脊/垂脊/戗脊 + 瓦垄)—— 视觉收益最大,现在"没有脊"最不像古建
- 山面正身椽 —— 补上后庑殿/歇山四面才都完整
- 拔梢 / 扭脖建模 —— 椽尾真正做出斜切,这是"像不像木作"的分水岭
- 弧线檐口 —— 现在两段折线,换弧后翼角范围扩大 3~5%
- 改良版:在母板上只动 L2 层,验证"偏离通则几项"这个机制跑得通
- ~~山墙与博风板:现在山面是光口~~ ✅ 已完成(硬山山墙 + 砖博缝、悬山木博风板,见
11/15文档) - ~~翼角逐根(M3)~~ ✅ 已完成(见
10文档),72~88 根全出 - ~~用母本真图反算校验~~ ✅ 已完成(见 §6.5),暴露并修掉 3 处假设
- ~~按通则做母板~~ ✅ 已完成(见 §6.6)
- 补母本缺口:柱径(需平面逐间量)、面阔与开间数、随梁构件
- 补缺口的规则:望板厚、椽档、瓜柱径、梁高 —— 回《工程做法则例》原文核
- 节点图输出、t8 提资边界(远期)
8. 免责与边界
- 所有规则整理自《工程做法则例》大木小式做法的公开转引,正式出图前必须回原文逐条核,并标注条文位置。
- 翼角三度的工匠口径(半椽档 / 撇半椽 / 8-10 拔梢)来自马炳坚著作转引,未见则例原文,规则库中标为
[未验证],不得与官刊口径混引。 - 引擎算的是尺寸与位置,不是审批结论;合规性另走知识库
03_技术判据那条线。 - 不写 DWG、不驱动 CAD、不替代施工图设计。
v0.3 · 2026-11-17 · 翼角逐根 72 根落地 + 交互式网页(改参数实时重建)
v0.2 · 2026-11-16 · 母板已落地(13/13 对表),下一步做改良版与翼角