docs: Archive osmassets refactor plan

This commit is contained in:
2026-08-03 12:12:49 +08:00
parent 0b8195b43f
commit 68829214fb
8 changed files with 90 additions and 118 deletions

View File

@@ -85,7 +85,7 @@ def assemble(ring, [way_id,] scene_xmin, scene_xmax, scene_ymin, scene_ymax,
### 加一种新 OSM 要素
目标形态`docs/refactor-plan.md`**新增一个模块 + 注册一行,不改 `build()`**。
目标形态:**新增一个模块 + 注册一行,不改 `build()`**。
1. 新建 `osmassets/<feature>.py`,写 `assemble(...)`,签名照抄上面
2. 只 import 需要的:`from osmassets.geom import clip_polygon`
@@ -176,7 +176,7 @@ export_cesium.py # 优先读 material custom property
否则新生成的 `.blend` 不会自带契约
- `catalog.py` 仍属纯 Python 层,不能 import `bpy`;序列化发生在 `materials.py`
- `"Office White Metal Facade"` 在四张表里都有,但 `catalog` 里**已无此材质**
`docs/refactor-plan.md` 记为缺陷 D1。它只能作为旧 `.blend` 回退兼容存在,
历史上记为缺陷 D1。它只能作为旧 `.blend` 回退兼容存在,
不要迁回新契约源
**改材质名时**`catalog.MATERIALS` + `catalog.ROAD_LAYERS` + 四张旧回退表全部

View File

@@ -57,7 +57,7 @@ node scripts/parity.js compare control-1 control-2 # 必须全绿
没做这步就开始改代码,你会分不清一个差异是"重构引入的 bug"还是"本来就每次都不一样"。
已完成的 control 结论`docs/refactor-plan.md`
已完成的 control 结论:
- `.blend` **结构摘要两次完全一致** ← 这是主校验信号,可信
- `.blend` 文件 sha256 不一致
@@ -147,7 +147,7 @@ capturedAt / durationMs / label
## 风险高的改动要分次提交
`docs/refactor-plan.md` 对风险最高的一期写着
要素注册表这类高风险重构必须按要素分次提交
> 逐要素分次提交,每次单独跑 parity。
@@ -155,9 +155,9 @@ capturedAt / durationMs / label
---
## 当前重构进度`docs/refactor-plan.md`
## 当前重构进度
那份计划是**临时工作文档**P3 收尾后会并入 changelog 并删除。当前状态
临时施工计划已删除;长期状态以本指南和 `docs/changelog.md` 为准
| 期 | 内容 | 状态 |
|---|---|---|