# 第二卷 · 独乐寺观音阁

本地研究模型，2026-10-13。未发布、未提交、未推送。

## 选题结论与研究身份

继续观音阁。公开的王一臻、徐怡涛《辽代建筑营造“大尺”与尺度构成研究》（《故宫博物院院刊》2023 年第 12 期，印刷页 24 起）直接提供测绘汇编、层间落柱图和纵横剖面，足以组织三段柱架、空井、环廊、铺作方向和歇山屋架。完整文物数字复原的证据仍不足：没有取得每类铺作、每根梁架及隐蔽榫卯的授权测绘详图。因此模型是有证据边界的空间研究，不能用于修缮或加工。

主要来源：https://www.dpm.org.cn/Uploads/File/2023/12/19/u658143342065c.pdf

检索并查看了 PDF 第 6、7、12 页，即印刷页 29、30、35。表一、二、四是测绘成果汇编；图六、七是作者在原剖面上标注的**理想尺度分析**。本模型只从图像读结构关系，不把理想整数尺换算值当成实测值。论文资料基础为 1998 年修缮成果，平坐缺项参照 1960 年测绘。图三底图出自杨新《蓟县独乐寺》页 248，图六七底图来自页 249；这些原书页未直接取得。扫描件只供本地研究，没有再发布。

## 原书映射

合法公开图书馆书目：https://jp.tfswufe.edu.cn/opac/book/6e9f981091a93b2b6cca6c406a9af6f6

楼庆西著《美轮美奂：中国建筑装饰艺术》，中国建筑工业出版社，2014.10，ISBN 9787112143085，246 页。书目确认不等于正文核对。未找到可核对本卷相关章节的合法公开全文；不使用来源不明的扫描下载站。用户给出的英文名 *The Art of Decoration in Traditional Chinese Architecture* 保留为系列说明，尚未核实出版对应关系。

|原书位置|问题|交互|补充证据|状态|
|---|---|---|---|---|
|版本书目已核，章节页码图号待补|楼阁体量与装饰依附位置|全貌、层间、栏杆及藻井位置|表一二四、图三六七|独立补充研究|
|待核对|铺作、檐口与山面边界|四跳节点、屋架开关、搏风点选|同上|不声称已按原书完成|

## 坐标、参数及精度

米制；Y 向上，X 正向东，Z 正向南（前檐）。三层柱头中心线分别生成；图表中同一开间多次测值没有平均，选择值不等于确定南北面逐柱映射。下表为代码实际参数；每个构件另带稳定 ID、类型、图层、位置、尺度、朝向、证据状态与来源。可在页面点选说明中阅读，在 `model.js` 中追溯。

|参数|代码值 m|基准、出处|状态与用途|
|---|---|---|---|
|下层面阔五段|3.350 / 4.320 / 4.665 / 4.325 / 3.340|柱头；页29表一|文献数据选取；左右方向指定为模型假设|
|下层进深四段|3.350 / 3.690 / 3.710 / 3.340|柱头；表一|同上；不得解读为柱脚测量|
|平坐面阔五段|2.980 / 4.310 / 4.540 / 4.310 / 2.980|表一括号中的1960年值|文献明确的参考资料；1998年缺项|
|平坐进深四段|2.980 / 3.700 / 3.700 / 2.980|1960年参考值|同上；不是1998年的非对称记录|
|上层面阔五段|2.940 / 4.360 / 4.460 / 4.370 / 2.950|表一选取|文献数据；方向映射及规则化待核定|
|上层进深四段|2.940 / 3.650 / 3.630 / 2.950|表一选取|同上|
|三层平柱高|4.010 / 2.500 / 2.735|页29表二，前檐值|文献明确；统一到整圈属于推定|
|铺作层高|2.010 / 1.650 / 2.175|页30表四|文献明确的控制值；局部构件层位推定|
|出跳合计|1.640 / 1.130 / 1.840|页30表四|文献明确；四等分是比例推定，不表示真实各跳相等|
|三层柱脚标高|0.550 / 6.570 / 10.720|底台 + 柱高 + 铺作层合计|比例推定；非抄平测量|
|上屋脊举高|4.780|表四|文献明确；曲线与各槫位置推定|
|上屋檐口及脊标高|15.630 / 20.410|层高控制值累计|比例推定；大木架相对高约19.86m，非表四20.03m的精确复原|
|屋面半宽 / 半深|11.700 / 8.840|由橑檐槫距外加教学檐出|比例推定；不等于柱网或槫中心距|
|下屋檐裙起点|平坐外柱圈；Y=9.050|图三、六七形态|图像判读；屋角举折待核定|
|叉柱开口|宽0.230，深0.420|图三形态|比例推定；横木宽0.220，高0.420，仅配合演示|
|柱径、栱长、椽距、瓦垄|见model.js显式参数|无逐件资料|比例推定|

表一选取值相加得到下屋 20.000 × 14.090、上屋 19.080 × 13.170 m；表四总体报告为下屋 20.040 × 14.090、上屋 19.150 × 13.198 m。未用缩放强行消除此差异。原资料可能具有测向、平均、抄平及测绘基准差别，待原测绘核对。本模型沿选取的分段控制线建模，总体误差明确保留。

## 空间与节点实现

- 每层外圈18、内圈10的拓扑；空井中不填柱、楼板或层间通长梁。用柱头坐标控制垂直柱身，未表达侧脚、生起、变形与逐柱截面。
- 各层柱、阑额、内圈普拍枋、梁和独立楼板可拾取。上层内圈南面中央阑额保留缺口。三层柱网同属一个观察图层，分层展开不是三层顺序拆卸。
- 叉柱脚以两片弧形脚、完整上段与穿过开口的承接横木表达。局部拆合沿Y方向分开。关系来自图三，槽口长度、榫肩与真实端头加工未复原。
- 正身铺作以四跳水平华栱及后尾重建，没有复制佛光寺的双下昂。内槽出跳与后尾、横栱、斗槽简化；没有声称覆盖二十余种真实斗拱。
- 转角用独立双向短栱及斜向角栱表达方向，不重叠两个完整正身模型。**仍是方向骨架**，未解决真实角昂、抹角栱和梁枋互锁。补间只做稀疏轮廓，不作逐攒清单。
- 环廊中央留空，西侧留梯孔；西侧两段折返楼梯为图像关系示意。宽、步数、起止点待核定。模型未表现观音塑像，只研究其贯通空间。
- 上屋长坡、下部山坡、上部三角山墙分别生成。中间横架与端横架分别设尺度，脊槫仅覆盖屋脊段；端架不采用穿过山坡的通长上梁。下屋屋面为环形檐裙，不以完整第二座屋顶封住内部。
- 槫、椽、下檐支撑、角梁、搏风、瓦垄可单独观察；瓦垄和曲线椽以几何分段绘制，分段数量不是文物件数。
- 栏杆分件，藻井只放置可关闭的空间轮廓。八边平面为**待核定占位**，不能当作已测绘平面。无纹样、雕刻、彩画、壁画、鸱吻复原。后加八根擎檐柱未建，因本卷着重辽代骨架；画面不代表当前现状全貌。

## 查看器复用与限制

保留第一卷目录及既有代码。第二卷复用 vendored Three.js / OrbitControls 及第一卷查看器交互逻辑，卷内数据与几何完全独立。依赖为 Three.js 0.186.1（官方 npm 包，MIT），版本、来源和许可证见 `../vendor/README.md` 与 `../vendor/LICENSE`；原材质纹理是程序生成，没有使用扫描图、照片或第三方模型资产。

七步学习、五个预设视角、逐层开关、自然材质/分色、双轴正反移动剖切、整体和节点展开、拾取、键盘视角、关键构件选择器、复位、减少动画与WebGL失败恢复。自动按可见几何包围盒适配展开取景；剖切不生成封口，不表示力学分析。教学分色不代表历史配色。关键构件选择器可代替精确鼠标拾取，但不是完整文物清单。

## 必须保留的未决问题

1. 正身、转角、内槽和补间逐攒测绘详图及真实后尾与槽口关系。
2. 原修缮成果柱脚/柱头坐标、侧脚、生起、抄平标高和方向对应。
3. 各层叉柱真实落点、开口尺寸、下层梁栱穿越和暗榫连接。
4. 屋架逐架测绘、槫中心标高、翼角及下屋檐裙连接。
5. 栏杆原构与更替时期、藻井平面及纹样、彩画和壁画年代；目前不重建。
6. 原书正文的合法访问与逐页映射。

## 验证

`node --test chinese-architecture/dule/tests/model.test.js chinese-architecture/tests/model.test.js`：14项通过。回归覆盖柱圈与收退、空井留空、端部屋架不穿屋面、叉柱槽配合、局部四跳、不带入第一卷下昂、记录与矩阵有效性。测试证明代码不变量，不证明文物精度。

浏览器与截图记录见 `VALIDATION.md`；预览保存在 `previews/`。

## 正式卷更新 04 · 2026-10-15（当前状态）

本轮已修改 `dule/` 正式入口；仍为本地研究模型，未提交、推送或发布网站。以上2026-10-13说明与旧验收保留作为基线；本节列明其后变化。启动时 git 状态干净，既有研究与原始记录均保留。新快照在 `study/history/04-baseline/`。

### 采用与拒绝

- **连续屋面**：复用第二轮全坡向生成器，替换上下两重旧望板/细圆条瓦垄；覆盖上屋长坡、山坡、下檐环带、脊线、独立瓦口和底瓦。正式参数 `PRODUCTION_ROOF` 明确关闭翼角改形（upperWing/lowerWing均为0），沿原卷曲面与柱网，不改檩椽矩阵。0.28m瓦距、0.31m排距、0.43m长度与截面仍为本阁试验比例，不是测绘值。
- **方向修正**：望板条带不同轴向/符号原先产生朝下三角形，现逐三角朝上；保留双面材质以便看薄壳背面，但不以双面材质掩盖错误绕序。四坡向与下檐中央留空有回归检查。承檐轨迹保留在purlins层，覆盖层随roof拆解，不冒充真实拼缝或卯口。
- **下檐局部**：采用既有 `applyPairedReach`，累积出跳由0.410/0.820/1.230/1.640改为0.420/0.840/1.240/1.640m。依据论文印刷30页表四的两组合计0.84/0.80m；各组内等分仍推定。正式整阁逐攒铺作未推广该局部。
- **上檐局部**：第三步增加上下檐节点选择；上檐复用既有两华栱、两下昂方向诊断。依据论文印刷35页注2“两下昂高为一跳”，及表四0.85/0.99m成对出跳。倾角0.20rad、矩形昂身、后尾、截面和斗槽均未实测。按构件tier拆分实例批次，选中框以实例矩阵乘世界矩阵随拆合移动；整阁上檐仍简化。
- **拾取与清单**：嵌套屋面沿全部父链判断有效可见性，隐藏屋面不再进入拾取候选；活动records与实际实例同步，替换层的旧记录不计为活动构件。原柱圈、空井、层间楼板、叉柱等ID及矩阵保留。
- **材料/光照**：瓦和脊采用研究中的中性灰；曝光1.25、半球光1.8、补光0.65为阅读调光值。新增换向主光控件，不是现场光学测量或历史原色认证。
- **交互修正**：拖动拆解滑杆同步取消未完成的相机动画，防止旧动画覆盖新取景；复位同时恢复默认光照。`data-settled`供验收等待相机/阻尼稳定；上檐节点的说明、事实、状态与实际几何同步。

本轮重新阅读本地论文文本中印刷29页数据来源、35页注2及既有RESEARCH；官方PDF此次web请求超时，未声称取得新的逐件测绘。原图三、图六七的关系、表格基准及1998/1960资料差异沿用已登记的来源边界。

**未采用**：研究E的翼角0.78/0.58m及相应椽端改形，尚缺全长/有限支承面和独立机位校准；研究F的对称侧围护、八根现状细支柱和系统字匾额，不并入辽构骨架。保留研究页A/B/C/E/F同机位新截图；E/F为比较候选，不据其画面接受全部几何。隐藏接头、真实叉柱卯口、逐攒互锁、藻井平面、脊饰和彩画均未补造。

### 实景图录与联动

新增4张，许可和原始Commons imageinfo见共享 `photos/assets.json` / `photos/records/commons-metadata.json`；逐图原片SHA1/SHA256、各衍生图哈希在 `study/runs/04-delivery/photo-assets.json`。

|照片|作者 / 日期 / 许可|覆盖与联动|边界|
|---|---|---|---|
|独乐寺观音阁2020.jpg，5870×3602|ScareCriterion12 / 2020-05-04 / CC BY-SA 4.0|正面；步骤0整阁|树木香炉遮挡，未确定修缮分期|
|独乐寺观音阁正面1.JPG，4288×2848|Hat600 / 2013-10-04 / CC BY-SA 3.0|正面；步骤0整阁；同一步保留选图|不把跨年色差当材料变化|
|Guanyin Pavilion of Dule Temple.JPG，5184×3456|Xin (Halazhang) / 2014-07-16 / CC BY-SA 4.0|斜侧含山面；步骤4屋架|非纯侧立面；罗盘方向未核，左上邻殿不作构件证据|
|独乐寺观音阁“观音之阁”匾.jpg，1702×1276|Patrick20242023 / 2024-01-08 / CC BY 4.0|上檐匾与铺作；步骤2、实际node=upper|来源原片分辨率较低，未增细；局部为方向诊断|

四图均目视核对为观音阁；按拍摄当时现状展示，不说成984年原貌。未取得纯侧面、背面、室内空井、真实叉柱与榫卯近照；检索到的“山门侧面和背后的观音阁”及山门转角铺作不选作本阁侧/背与节点。未以缺图为由配入其他殿阁。来源站一次429的Retry-After=1秒，等待超过要求后重试成功，原错误记录保留。

原始JPEG保持字节；thumb/display/full WebP分别生成，保留原像素上限与ICC（如有），没有生成式增细、改色或移物。16个独立内容哈希R2对象均防覆盖写入并逐对象读回校验；12个本地WebP没有被gitignore排除。命令行公开HTTP本轮16次均403；当前IAB四张高清均从公开R2 URL解码，网络上下文结果分开保留，不声称所有客户端CDN恢复。12个本地尺寸另在真实浏览器全部解码。网站未发布。

本轮验收、源码哈希和截图见 `VALIDATION.md` 与 `study/runs/04-delivery/`。本地入口：http://localhost:8765/chinese-architecture/dule/ 。


## 图像补充05 · 2026-10-15

本轮把观音阁图录从4项扩为10项：新增EditQ于2023-03-19拍摄的4000×3000内景（CC BY-SA 4.0），及1932年《中国营造学社汇刊》第3卷第2期独乐寺专号的5页历史摄影图版（Commons标示PD-scan / PD-China-1996，公有领域）。全图录共32项。历史页分别为PDF第79、87、90、93、96页，涵盖西面各层斗栱、内槽、梯口周边、上层转角、观音像及上层内部；不是5张新拍摄照片。保留整页原图注，不裁切、不生成式增细，不把刊载年份当拍摄日期。逐图摄影署名未确认，不能全部归给梁思成。

原刊203页、6,407,670字节，SHA256 `7ecfaeaa2014ce9ac568d100a568b7c0eda07515f2e25787f9432a79362a0314`。从PDF的单幅整页扫描提取原生像素，原刊PDF逐字节保留；工具增加严格的`commons-pdf-page`分支与独立报告路径。现状内景有脚手架遮挡；历史西面为局部，历史节点不证明精确叉柱卯口，空井图不证明模型藻井纹样。上层转角图片回到第五步整阁语境，不映射到正身局部冒充准确转角复原。本轮未改模型几何。

新资料来自Commons英文子分类Avalokitesvara Pavilion及原始公有领域期刊。研究、逐页联系表、原始元数据与选图记录在`study/runs/05-photo-search/`；页面验收在`study/runs/05-delivery/`。原04目录及历史报告均保留。

仍缺：可核验并可再分发的当代背面、完整纯侧立面、无遮挡空井与精确隐蔽节点。新华社2026-07-22内景照片未取得再分发许可，只链接原站；多肉闹海2026-05-22组图标注“图十 观音阁北面”，当前页面只返回前9图，只保留追踪入口，不计入取得的背面照片。没有用无许可网络图或AI补图冒充实景。