54 lines
2.4 KiB
Markdown
54 lines
2.4 KiB
Markdown
# 移除 RizomUV 流程设计
|
||
|
||
日期：2026-07-20
|
||
状态：已确认
|
||
|
||
## 背景与目标
|
||
|
||
RizomUV 本机始终未授权，减面实际一直走 seam 回退；UVPM4 排布集成后（spec：
|
||
`2026-07-20-uvpackmaster4-pack-design.md`），seam+UVPM4 路径质量已达标
|
||
（store 实测利用率 75.4%）。RizomUV 链路只剩启动失败重试的时间开销与弹窗干扰。
|
||
彻底移除 RizomUV 流程，减面默认 seam 展开 + UVPM4 排布。
|
||
|
||
## 范围
|
||
|
||
**删除文件（4 个，均只服务 rizom 链）：**
|
||
- `Tools/ModelTranslator/rizom_unwrap.py` — RizomUVLink 驱动
|
||
- `Tools/ModelTranslator/bl_uvgate.py` — rizom 输出质量门（`seam_fallback_label`
|
||
只为 rizom 回退标注存在，随宿主删除；`_do_unwrap` 内部自带质量门回退，不受影响）
|
||
- `Tools/ModelTranslator/tests/test_rizom_unwrap.py`
|
||
- `Tools/ModelTranslator/tests/test_bl_uvgate.py`
|
||
|
||
**`model_decimate.py` 简化：**
|
||
- `--unwrap` choices 改 `("seam", "smart")`，默认 `seam`；help 同步
|
||
- 删 `--rizom` 参数
|
||
- 删 rizom 三步编排分支（惰性导入 rizom_unwrap、bl_uvgate 调用整块），
|
||
只剩单次 `run_blender_script(bl_decimate)` 调用
|
||
- 模块 docstring 更新（默认 seam 展开 + UVPM4 排布）
|
||
|
||
**`bl_decimate.py` 清理：**
|
||
- 删 `main()` 的 `unwrap_mode == "none"` 分支（只供 rizom 链跳过展开），
|
||
直接 `uv_info = _do_unwrap(obj, unwrap_mode, warnings)`
|
||
|
||
**README：**
|
||
- 依赖节删 RizomUV 行
|
||
- 减面条目重写：默认锐边 seam 展开 + UVPM4 排布（质量门翻转 >2% 或重叠 >8%
|
||
回退 Smart UV Project），删除全部 rizom 相关文字（RizomUVLink/弹窗/license/
|
||
--rizom/静默空跑守卫）
|
||
|
||
**记忆清理：**
|
||
- 删除已过时的 `rizomuv-license-blocker` 记忆并同步 MEMORY.md 索引
|
||
|
||
**不变：** UVPM4 集成（`_uvpm_enable`/`_uvpm_repack`/`uvpm_mode_label`）、
|
||
质量门阈值、`model_bake.py`、`model_translator.py`。
|
||
|
||
## 验收
|
||
|
||
1. 单测全绿：`python -m unittest tests.test_bl_decimate tests.test_unity_assets`
|
||
（test_bl_bake/test_bl_convert 如存在纯逻辑测试一并跑）
|
||
2. 冒烟：`python model_decimate.py src/store.fbx --tris 3000`（默认路径）→
|
||
`模式=seam+uvpm`、利用率 ~75%、无 RizomUV 弹窗/警告
|
||
3. `--unwrap rizom` 报 argparse 参数非法
|
||
4. 仓库内（Tools/ModelTranslator）不再有 rizom 引用（大小写不敏感 grep 为零，
|
||
git 历史除外）
|