AIC-Project/docs/superpowers/specs/2026-07-20-remove-rizomuv-design.md

移除 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 历史除外）