diff --git a/docs/superpowers/specs/2026-07-20-remove-rizomuv-design.md b/docs/superpowers/specs/2026-07-20-remove-rizomuv-design.md new file mode 100644 index 00000000..a6f4492d --- /dev/null +++ b/docs/superpowers/specs/2026-07-20-remove-rizomuv-design.md @@ -0,0 +1,53 @@ +# 移除 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 历史除外)