# UVpack / Lightmap 自研工具 — 开发进展汇报

> 汇报日期：2026-09-30 ｜ 版本：插件 v2.16.0（2026-09-29 发布）
> 说明：本文面向管理与美术团队，技术术语均在括号内做白话解释。

---

## 一、这是什么

我们在为 Blender 制作一套**自研的 UV 自动排布工具（UVpack）**，替代按席位付费的商业工具 UVPM4。

- **UV 排版**：把模型表面"摊开"后摆进一张贴图里。摆得越满、越整齐，同样分辨率下贴图越清晰。用"利用率 %"衡量（好比装箱：同样一卡车，装 74% 还是 95%）。
- **Lightmap UV**：光照烘焙（把光影"烤"进贴图，让游戏运行时不用实时算光）需要一套专门的 UV。它的质量直接决定光影有没有"漏光、鬼影"。
- **档位系统**：场景里每个物体按重要程度有高/中/低精度档（贴图分辨率不同），工具已支持按档自动分配。

一句话：**美术在 Blender 里点一下，工具自动完成原来要手动做几小时的 UV 排布和 Lightmap 工作，且质量可持续迭代提升。**

---

## 二、本月已完成成果

| 成果 | 数字 | 对团队意味着什么 |
|---|---|---|
| 插件功能版本迭代 | v2.11 → **v2.16.0**（一个月内 5 个版本） | 迭代速度健康，每周都有可用的改进版 |
| Lightmap 打包换代 | 换用自研打包后 **11/12 测试模型成功，排布质量平均 +51.7 个百分点** | Lightmap 从"凑合能用"到"明显更好"，直接提升烘焙质量 |
| 人工接缝工作流 | 新增"必切 / 建议 / 禁切"三类标记，美术画线 → 工具照做 | 美术可以干预关键缝隙，结果可控、可预期 |
| 密度均匀度优化（ARAP 松弛） | 54/54 测试模型全部改善，中位不均匀度 0.0475 → 0.0126，耗时几乎不变 | 贴图空间分配更均匀，减少"有的地方糊、有的地方浪费" |
| 结构保护（A 阶段） | 58 个测试模型的硬表面直角边 **99.03% 保住** | 排布不再破坏硬表面结构，减少返工 |
| 质量护栏体系 | 自动回归测试 + 指纹校验 + 负面结果存档 | 每次升级都有"体检报告"，坏了立即发现，不重复踩坑 |

**与商业工具的诚实对比**（小模型口径，同测试方法）：
自研 74.0% vs 商业 76.5%，**差距 2.5 个百分点**；有效性上自研 12/12 全部成功，商业内置方案只有 6/12。**在中型资产上已具备替代能力。**

---

## 三、当前差距（不美化）

| 对比对象 | 差距 | 说明 |
|---|---|---|
| 人工排布（同一打包器口径） | 管状物 **-36.9pt**、有机体 -30.0pt、硬表面 -10.1pt | 首次在正确口径下测得的真实差距 |
| 商业工具 UVPM4 | 模型越复杂差距越大：中型 -12pt → 超大型（约 1500 个部件）**-44pt** | 排版算法在规模上升时结构性落后 |
| 速度 | 慢 6~7 倍（大模型） | 商业工具用 14 线程并行，我们目前单线程——这是明确可追的工程差距，不是算法差距 |

结论：**小中型资产已可用已好用；管状物和超大型模型还不行，这是接下来攻坚重点。**

---

## 四、后续计划（按优先级）

| 阶段 | 内容 | 预期收益 |
|---|---|---|
| P0 管状物攻坚 | 解决"管子沿环切不开"的底层问题（管状差距与它同源） | 管状 -36.9pt 是最大的一块可挽回空间 |
| P1 Lightmap 碎片治理收尾 | 小碎块自动合并（已实现三档分辨率自适应），收尾验收 | 解除利用率上限，烘焙质量再上一档 |
| P1 决策项：ARAP 是否默认开启 | 有一例模型从"有效"变"失败"，需业务拍板 | 54/54 改善但存在极端案例，默认值待定 |
| P2 性能追赶 | 打包引擎多线程化 | 追平商业工具 6~7 倍的速度差 |
| P2 UV 编辑器修缮 | 修完剩余 6 个"按点焊接"类历史工具 | 编辑器功能全面可靠 |

---

## 五、风险与依赖

1. **测试基线更换**（9/29 换为 58 模型新基线）：新旧数据不能直接比较，后续所有指标以新基线为准，已做两版引擎逐位一致性复核。
2. **负面结果存档**：6 个"试过没用"的方向已记录归档，避免团队重复投入。
3. **平台差异**：Windows 版为最新，macOS 版未同步重编，跨平台发布前需补齐。

---

*数据来源：uvpack/dev 的 HANDOFF.md、ROADMAP.md、AI_CONTEXT.md、lightmap 执行计划及 2026-09 批量实测记录（A/B 均为同文件同口径对比）。*
