需要把纹理图集 1:1 贴合到 Blender…

当纹理包必须与 Blender 模型 1:1 对齐、贴图看起来错位/拉伸、或附带 alpha 贴花与 lightmap 时，检测图集区域并把每个部件映射到各自的 UV 矩形或投影 UV 面。

适用场景

解决思路

1. 运行 `scripts/atlas_region_detector.py` 检测 basecolor/decal/aura 图集的候选区域。
2. 在 `atlas_regions.json` 中用语义化名称命名各区域。
3. 为每个 mesh 创建或激活 UV map。
4. 把局部 0-1 的 UV 重映射到匹配的图集矩形内。
5. 审计 GLB/导出材质的节点图，确认由 Principled BSDF + Image Texture 节点构成。
6. 导出前渲染贴图叠加（texture overlay）做验证。
7. 图集纹理必须按区域映射，绝不把整张图集直接套到每一个结构 mesh 上。
8. 正面（hero）表面使用前投影 UV 或源区域矩形。
9. 侧面/背面使用各自的 UV 岛或程序化/烘焙填充。
10. roughness、bump、normal、AO、lightmap 图像一律标记为 `Non-Color`。
11. Alpha 贴花必须使用 alpha 连接的材质，且不要使用黑色底板平面。
12. 基础 GLB 不应包含参考平面或可选的 aura，除非明确要求。
13. 不要盲目把 emissive/roughness/bump/lightmap 图像接到每个图集映射部件上：先验证补充贴图与 basecolor 具有相同的 UV 布局和语义区域；若其中包含 aura 点、引导标记、lightmap 团块或部件之外的装饰，就对该 mesh 断开连接，改用常量 roughness/bump 加显式的边缘/发光几何。
14. 创建 `atlas_part_map.json`，把每个结构部件名绑定到恰好一个图集区域，或声明为 `procedural/no_texture`。
15. 从 basecolor/decal/lightmap 检测候选区域。
16. 拒绝装饰性/aura/合成预览区域，除非目标本身就是 context/aura。
17. 按角色、长宽比和相对尺寸匹配结构部件。
18. 在自动 UV 分配之前手动重命名有歧义的区域。
19. 在连接 roughness/bump/emission/lightmap 之前，验证补充贴图共享同一区域布局。
20. 不要把整片 rosette/合成图集区域映射到单独的花瓣上；除非该 mesh 本身就是一整张 rosette 平面，单个 mesh 必须使用单个源区域。
21. 用 `scripts/atlas_region_mapper.py` 依据长宽比/尺寸相似度提出 部件→图集区域 的映射，但其输出只当作草稿，语义命名仍然优先。

适用边界 · 注意事项

• 不需要与源纹理包 1:1 锁定时（例如只是随意上色），不必做逐区域 UV 拟合。
• 补充贴图的 UV 布局或语义区域与 basecolor 不一致时，不要把该补充贴图接入图集映射部件。
• 目标 mesh 本身就是单张花瓣/整片 rosette 平面时，不要按部件再拆分区域。