16 · 方法论:格网法(傅熹年论断的可执行化)

编制:小明(建筑设计师)| 版本 v1.0 | 2026-11-20
定位:方法论层。回答「为什么尺寸是这么定出来的」,不回答「这个构件该多大」(后者归 L0 的 91 条 RULES)。
配套代码:engine/grid.py;校验器 tools/check_grid.py;反算数据 out/格网反算报告.md。


1. 问题:参数化凭什么不是「现代技术套古建」

工程对外一直有一个说法:「这不是用现代技术套古建,而是把古人的设计工具还回去」。
依据是傅熹年的格网法论断——古代建筑是在格网上按比例定位,不是靠尺规逐段量。

但这个说法此前是空的:翻遍全工程,找不到一处用格网法算出来的数、找不到一个能跑的函数、
找不到一次「拟合失败」的记录。它只是专家库里的一行 tag(tools/site_experts.py 傅熹年条)。

本项要做的是把这个空填上,并且必须让它有被打脸的机制——
如果一套方法只能证明自己、不能产生失败样本,它就不是方法,是自我催眠。


2. 文献:傅熹年原书论点(只写查得到的)

据 tools/site_experts.py 已登记的书目与学界公认表述(等级 [已验证·书目+观点],
原书页码逐条未核,见文末待补):

书目出处状态
《中国古代城市规划、建筑群布局及建筑设计方法研究》2001,中国建筑工业出版社书目已核,页码〔页码待补〕
《中国古代建筑史·元明卷》2001书目已核,页码〔页码待补〕
《傅熹年建筑史论文集》书目已核,页码〔页码待补〕

可确认的论点(转引,非原文逐字):

  1. 古代建筑设计的实际方法是在格网上按比例定位,不是靠尺规逐段量;平格、地盘格网是设计工具本身。
  2. 建筑群有模数化的总平面:院落的进深、面阔之间存在网格关系。

本项的立场:这两条是方法论假设,不是已在本工程证实的结论。
下面的算法只检验「现有算例是否与该假设不矛盾」,不宣称证明原书论点。
凡本文出现的数字,均来自本工程算例反算,不是从原书抄来的——原书页码补齐前,不得混引。


3. 算法:显式传格值,而不是搜索格值

3.1 接口(engine/grid.py)

@dataclass(frozen=True)
class GridFit:
    ok: bool
    unit_mm: float
    cells: tuple[float, ...]      # 每项格数 k
    resid_mm: tuple[float, ...]   # 每项残差
    max_resid_mm: float
    why: str                      # ok=True 为 "";失败必非空且分类

fit_grid(values_mm, unit_mm, *, max_cells=24, tol_mm=0.5) -> GridFit
fit_best(values_mm, candidates, **kw) -> GridFit

values_mm 构成固定为 bays_mm + [depth_mm, column_height_mm](5 项)。
柱径不参与拟合,只作格值:以柱径为格时,柱径自身 k 恒等于 1、残差恒 0,是无信息量的自证项。

3.2 三条硬约束

  1. 格数必须是小整数或半整数:k ∈ {0.5 的整数倍} 且 k ≤ max_cells。

允许半格是为了容纳「次间 = 明间 × 0.8」这类分数,但绝不允许 k = 11.538 蒙混过去。

  1. 容差 tol_mm = 0.5:与 README.md 母板对表容差一致。不用 1.0——那会让 1mm 级偏差被吞掉。
  2. 失败必须解释:why 区分 resid(残差超容差)与 cells(格数超上限)两类,

写清第几项、差多少毫米;绝不返回 None 静默丢弃样本。

3.3 ★ 为什么禁止在函数内部搜索格值(本项最关键的一条)

fit_grid 的 unit_mm 必须由调用方传入,函数自己不得试 100、150、200、250……。
这是实测出来的,不是理论洁癖:

卷棚那组 [2600, 3000, 2600] / 4800 / 2600 / 260(来自 presets/siheyuan_juanpeng.json),
以柱径 260 为格是 10 / 11.5 / 10 / 18.5 / 10,其中明间 k=11.5 残差 10.000mm、
进深 k=18.5 残差 10.000mm,明显不齐。(数据见报告 §二 S2 表)

但只要允许试 200mm,立刻变成 13 / 15 / 13 / 24 / 13 —— 全部整数、残差 0、
max_cells 刚好卡在 24 边界。这个「反例」当场消失,整项任务退化成自我证明。

机制已落盘为 --selftest 的 S6 探针,每次跑都打印:

S6 ✓ PROBE overfit_easy=YES cells=(13,15,13,24,13)  [探针,不计入通过率]

结论:「能凑出整数」不等于「用了格网」。格值是否有资格,取决于它有没有历史依据,
不取决于它凑不凑得上。因此候选集写死为闭集(见 §3.4),且不得加入 200/250/150。

3.4 候选格值闭集(三选,带出处)

候选值出处
柱径各 preset 的 column_dia_mm本工程既有模数口径:presets/*.json 的 _meta.modulus_chi 全部以「柱径 = 1」为基准
整尺320.0清尺 1 尺 = 320mm;《工程做法》以尺计
整寸32.0清尺 1 寸 = 32mm

不得新增第四个候选。要加必须先给出文献依据,并在报告里单列一行说明。本项未新增。

3.5 反向测试(--selftest)

判据由交接方给定,不由实现方自定(否则循环论证):

判据内容实测
S1固定 random.seed(20261119),200 组随机样本200 组 ✓
S2随机值须为浮点毫米且不是任何候选格值的整数/半整数倍异常 0 ✓
S3200 组中 ok=True 必须 0 组0 组 ✓
S4同批插入 20 组已知整格数据,ok=True 必须 20/2020/20 ✓
S5why 失败原因分类 resid 与 cells 各至少出现 1 次resid 200 / cells 200 ✓
S6(探针,不计入判定)卷棚用 unit_mm=200 必须打印 PROBE overfit_easy=YES cells=(13,15,13,24,13)YES ✓

随机性只出现在 --selftest 且 seed 固定;engine/grid.py 内无任何随机。


4. 反算结果(数字全部来自 out/格网反算报告.md)

4.1 样本独立性

报告首行原文:文件 7 · 独立尺度样本 2 · 候选 3。

按 (bays_mm, depth_mm, column_height_mm, column_dia_mm, purlin_count) 五元组去重:
7 个文件 / 2 套独立尺度样本(报告 §一)。

样本文件数尺度五元组
S16bays=[3200, 3840, 3200] / depth=6400 / 柱高=3200 / 柱径=320 / 檩=5
S21bays=[2600, 3000, 2600] / depth=4800 / 柱高=2600 / 柱径=260 / 檩=5

术语说明:这 6 个文件输入尺度参数相同、派生几何不同
(has_fei / tiptou_* / roof_finish 等字段确有差异),故 S1 的「6 个文件」是一套尺度样本的 6 次出现,
不是 6 个独立证据。若按文件数报「6 套通过」,就是一个证据重复 6 次。

4.2 S1:落在格网上(报告 §二 S1)

以柱径 320mm 为格:

尺寸项毫米格数 k残差 mm
次间3200100.000
明间3840120.000
次间3200100.000
进深6400200.000
柱高3200100.000

整尺 320mm 同样落格(k 同上);整寸 32mm 未落格(k=100, 120, 100, 200, 100,超出 max_cells=24)。
fit_best 判定:✓ 落格(柱径)。

4.3 S2:未落在格网上(报告 §二 S2、§三)

以柱径 260mm 为格:

尺寸项毫米格数 k残差 mm判定
次间2600100.000✓
明间300011.510.000✗ 残差超
次间2600100.000✓
进深480018.510.000✗ 残差超
柱高2600100.000✓

整尺 320mm 未落格(max_resid=40.000mm,k=8, 9.5, 8, 15, 8);
整寸 32mm 未落格(max_resid=8.000mm,k=81, 94, 81, 150, 81,超格数上限)。
fit_best 判定:✗ 全候选失败。

4.4 失败样本诊断(报告 §三)

S2 归 A 类·参数不合规矩,不是 B 类(格网法不适用)。证据:
以柱径 260mm 为格,5 项里 3 项落整/半格(次间 2600mm、次间 2600mm、柱高 2600mm),
另 2 项不落格;同组多数尺寸已按柱径模数取,唯独明间 3000mm 与进深 4800mm 没取齐。
属参数本身不齐——与格网法是否成立无关。

失败样本一个都不删。完整的三候选失败原因已写入报告 §三。

4.5 机器行

MARK grid_files=7 scale_samples=2 candidates=3 pass=1 fail=1

读法:7 个文件、2 套独立尺度样本、3 个候选;1 套落格、1 套未落格。
不是「6/7 通过」——那是重复计数。


5. 局限(这是本文的结论上限,不是脚注)

写成一个可检验命题,而不是「必要不充分」四个字:

命题 P:存在一个有历史依据的格值 M,使该建筑的主要尺寸都落在 M 的整数或半整数倍上。

本文检验的是 P 在 M ∈ {柱径, 整尺, 整寸} 这一有限闭集上是否成立,结果见 §4:
2 套独立尺度样本中,S1 在 M = 柱径(=整尺 320)上成立,S2 在三个候选上均不成立。

P 成立不等于「古人以格网设计」成立:若 M 只能在看过数据之后才挑得出,那就只是过拟合。
这就是为什么格值必须是显式传入的闭集、禁止在函数内搜索——S6 探针已证明,
一旦允许试 200mm,S2 那个「真反例」会当场变成完美整格。

因此本文的结论上限是:「现有算例与格网法不矛盾,且 M = 柱径这一口径有本工程既有的模数依据」,
不能写成「证明了傅熹年的格网论」。

反例(S2 / 卷棚)不推翻 P,只说明「以柱径为格」这一具体 M 不适用于该算例;
经 §4.4 诊断,该样本属 A 类参数不齐,本来就与格网法无关。

待补(不掩盖)

  • 傅熹年原书三部的具体页码与章节〔页码待补〕——当前只到「书目 + 学界公认观点」级别。
  • 独立尺度样本仅 2 套,其中落格 1 套。样本量不足以做统计推断,

本文只做「一致 / 不一致」的个案判定,不做覆盖率或显著性声明。

  • 候选闭集只含 3 个格值。若将来新增(如清尺半尺 160mm),必须先给文献依据并单列说明,

且要重跑 S6 探针确认没有把反例洗白。


6. 与 L0 / L1 分层的关系:为什么不进 91 条 RULES

层内容形态
L0 条文层91 条尺寸规定,每条有 formula + 出处 + 引擎落点「这个构件该多大」——有可对表的具体尺寸
L1 参数层5 个自变量 + 推导链「输入什么,怎么算」
方法论层(本文)格网法反算:fit_grid / fit_best + 本文件「为什么尺寸是这么定出来的」——程序性知识

方法论条目不进 engine/rules.py:那 91 条每条都有 formula(可对表的具体尺寸),
而方法论是程序性知识、没有 formula。塞进去会让 gen_rulebook / check_distill 的语义崩掉
(蒸馏表 R1–R5 的落点校验依赖每条规则都有可定位的公式与出处)。

本层与 L1 的接口只有一条:从 preset 读 5 个尺度参数,反算格数。
不修改任何 L0 规则、不改任何 presets/*.json、不改任何既有几何代码——本项是纯新增。


v1.0 · 2026-11-20 · 编制:小明(建筑设计师)
依据:engine/grid.py、tools/check_grid.py、out/格网反算报告.md、tools/site_experts.py 傅熹年条