Files

que01 b35b094ed2 docs: changelog 更新 — P0-P3 refactor + island_tree_01

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-30 09:22:04 +08:00

Changelog

2026-07-30

重构 Blender 脚本为 osmassets 包：generate_scene.py 从 1271 行缩减到 826 行 (-35%)，纯函数可脱离 Blender 测试 (42 个 unittest)
- osm.py — OSM 解析 / Projector / parse_height（无 bpy）
- geom.py — 平面几何纯函数（无 bpy）
- materials.py — Blender 材质创建
- mesh.py — MeshBatch / prism / roof / polyline
- catalog.py — 道路图层和材质规格的唯一定义源，含 cesium 导出参数
- 要素注册表：water.py / grass.py / scrub.py / tree.py，各导出一个 assemble() 函数
新增 parity 工具链：scene_digest.py + glb-digest.js + parity.js，两区域全 PARITY OK
接入 Poly Haven island_tree_01 真实扫描树模型：tree_style 新增 polyhaven 选项，181 棵树 113k tris + PBR 贴图
新增 blender/tools/ingest_tree.py 用于离线减面导出树模型
nantaizi-lake-innovation-valley 配置默认切换为 treeStyle: polyhaven

新增 reimport 阶段（scripts/reimport-gpkg.js），把 QGIS 手工修正过的 <area-id>.gpkg 回导为 osm2streets_web_out/*.geojson 并重建 osm2streets_scene.geojson / osm2streets_scene_style.json。手工修正流程从「ogr2ogr 循环 + 内联 node 脚本 + npm run build」三步压缩为一条命令：
```
npm run build -- --config config/areas/<area-id>.json --stages reimport,blender,cesium
```
reimport 先把全部图层导出到临时目录并逐个校验，全部通过才写回输出目录：ogr2ogr 对不存在的图层退出码非 0 但仍会留下 0 字节文件，逐图层直接覆盖会静默损坏数据。
intermediates 与 reimport 同时指定时直接报错：前者会用 OSM 重建 GeoPackage，正好抹掉后者要读回的手工修改。reimport 不含在 all 中。
新增 scripts/lib/scene-layers.js 作为 9 个渲染图层的唯一定义源（id、z_index、配色、描边宽度）。此前该表在合并场景、场景样式 JSON、生成的 QGIS 工程、README 手工流程中各有一份副本，改一处漏其余会导致图层叠放顺序错误并流入 Blender/Cesium。构建产物（GeoJSON、GeoPackage、.qgz 符号、样式 JSON）与改动前逐字节一致。

实验分支新增 Cesium 车辆巡航预览：从 OSM 可行驶 highway 提取 bounds 内路线，输出 <area-id>-vehicle-route.json，并在预览页中驱动车辆循环移动。
巡航路线从道路中心线向右偏移约 1.3 米，车辆模型改为无 logo 的轻量预览车。
车辆巡航预览支持多辆车同时行驶，并通过 Vehicle 下拉框选择 Follow 目标。
将项目主入口重构为区域资产管线：scripts/build-area.js。
新增 config/areas/nantaizi-lake-innovation-valley.json 和 config/areas/hanyang-block.json，支持按 OSM 输入生成独立输出目录。
npm run build 现在默认走区域资产管线；旧 QGIS 管线保留为 npm run build:qgis。
cesium 阶段会生成 <area-id>-cesium-preview.html 本地预览页。
修复 Blender 脚本对 --tree-style 和 --office-overrides 这类连字符参数的解析。

Blender 场景生成器通用化：generate_nantaizi.py → generate_scene.py
- 去除所有硬编码默认路径（--osm / --geojson / --output / --render 均为 CLI 必传）
- --geojson 改为可选参数，不传时回退到 OSM highway 折线
- --office-overrides 替代硬编码的 OFFICE_OVERRIDE_WAY_IDS
- export_cesium.py 同样去除硬编码默认路径，CLI 参数改为必传
config/default.json 路径改用占位符 /absolute/path/to/...
config/examples/template.json 新增 layerPrefix 和 blender 配置块
scripts/build-osm2streets-qgis.js 新增 layerPrefix 配置支持
包名改为 osm-gis-pipeline
文档全面更新为中文通用描述

Added configurable input/output paths through JSON config files.
Added config/default.json for /Users/que01/Downloads/osm.xml.
Added config/hanyang-block.json for /Users/que01/Desktop/汉阳区区块.osm.
Added config/examples/template.json for new areas.
Updated OSM node coordinate parsing to support both single-quoted and double-quoted XML attributes.
Verified QGIS outputs for both a smaller Overpass-style XML input and a larger JOSM-generated .osm input.