Adopt Shapespark vegetation assets

assets/models/SOURCES.md

@@ -1,47 +1,21 @@
-# 树模型资产来源
+# 植物模型资产来源
 
-`assets/models/` 下的树模型是第三方素材，**已 gitignore**，不随仓库分发。
-干净 checkout 缺这些文件时 `tree.assemble()` 返回 0，`generate_scene.py`
-自动回落到 `natural` 样式，构建不会失败。
+`assets/models/custom/shapespark_plants/` 保存从 Shapespark low-poly plants kit
+拆分出的植物资产。每个植物目录包含：
 
-放置路径见 `blender/osmassets/tree.py` 顶部的常量。
+- `model.gltf`
+- `model.bin`
+- `preview.png`
 
-## apple（`--tree-style apple`）
+贴图统一放在 `assets/models/custom/shapespark_plants/textures/`，由各个 glTF
+相对引用。`manifest.json` 记录每个拆分资产的类别、几何指标、材质名和预览图路径。
 
-- 名称：RedDeliciousApple（SpeedTree 工具导出）
-- 路径：`assets/models/speedtree/apple_low/`
-  - `RedDeliciousApple.obj` — 4475 tris，单网格
-  - `RedDeliciousApple.mtl` — 已重写，见文件内注释
-  - `textures/apple_color_2k.png` — 由原始 4096² PNG 降采样，**必须保留 alpha 通道**，
-    57% 的像素是抠掉的叶片卡片
-  - `textures/apple_normal_2k.png` — 同上降采样
+当前管线使用：
 
-原始素材另有 `.fbx` / `.cgf` / `.st` / `.tif` 以及 `_SS` / `_Subsurface` 贴图，
-管线不用，未收录。
+- `tree-01-*`、`tree-02-*`、`tree-03-*`：`--tree-style shapespark` 的 12 个确定性树变体
+- `bush-03`：`natural=scrub` 边缘 bush 实例
+- `grass-01`、`grass-02`、`grass-03`：`landuse=grass` 草坪草簇
 
-降采样命令（原始 4k 贴图 16MB + 20MB，降到 2k 后 4.3MB + 4.7MB）：
-
-```bash
-sips -Z 2048 -s format png <原始>_Color.png  --out textures/apple_color_2k.png
-sips -Z 2048 -s format png <原始>_Normal.png --out textures/apple_normal_2k.png
-```
-
-## fattree（`--tree-style fattree`）
-
-- 名称：fat tree，作者署名 Lyrog（付费素材）
-- 路径：`assets/models/lyrog/fattree/`
-  - `fattree.blend` — 取其中名为 `fattree` 的对象，2238 tris
-  - `textures/fat_tree.png` — 原文件名带空格（`fat tree.png`），已改为下划线
-
-源 .blend 里的贴图路径是 `//fat tree.png`，只在原始目录下能解析；
-运行时不依赖它，`tree.py` 会丢掉源材质并按上面的路径重建一个 Principled 材质。
-该 .blend 里另有两个 `plant` 对象（灌木），管线未使用。
-
-## 已移除
-
-`polyhaven/island_tree_01`（76MB）已于 2026-07-31 删除，连同 `--tree-style polyhaven`
-和 `blender/tools/ingest_tree.py`。原因见 `docs/changelog.md`：该文件的 `*_LOD1`
-对象不是完整的树，而是给几何节点散布用的枝叶碎片。
-若要重新取用，Poly Haven 上是 CC0：https://polyhaven.com/a/island_tree_01
-
-`polyhaven/shrub_02` 仍在使用（草丛散布），不受影响。
+旧的 SpeedTree apple、Lyrog fattree、Poly Haven `shrub_02`、原始高模
+`custom/bush` 和 rejected `custom/bush_low` 已删除。相关实验结论保留在
+`docs/changelog.md` 和归档 Trellis 任务中。