ModelTranslator: 移除 RizomUV 流程设计文档
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.8
parent
9b3c818a99
commit
02d5754e7b
@@ -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 历史除外)
|
||||
Reference in New Issue
Block a user