ModelTranslator: README/spec/plan 记录 UVPM 弃用启发式、只留旋转15°

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-21 16:18:56 +08:00
parent 4f18c770c1
commit 6087ce3598
3 changed files with 11 additions and 1 deletions
@@ -259,3 +259,7 @@ Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>"
 - **占位符**：探针脚本、`_uvpm_set`、常量、各命令均为完整内容。属性名标注"以 Task 1 为准"是 spike-first 设计的必要性质（执行时由 Task 1 输出定稿），非未决占位——`hasattr` 守卫保证即便名字有出入也不崩，Task 3 Step 2 的"属性不存在"警告会兜住并要求回改。
 - **类型/命名一致**：`_uvpm_set(p, name, value, warnings)`（Task 2 Step 2 定义，Step 3 调用一致）；常量 `UVPM_ROTATION_STEP`/`UVPM_HEURISTIC_TIME`（Task 2 Step 1 定义，Step 3 使用一致）；`p` 即 `scene.uvpm4_props.default_main_props`（与现有 `_uvpm_repack` 一致）。
 - **已知风险**：UVPM4 属性名/取值由 Task 1 探针定；启发式若需特定 `pack_op_type` 在 Task 2 据实调整；薄条几何天然限制上限，验收以"明显上升"而非硬数字（spec 一致）。
+
+## 执行修订（2026-07-21）
+
+Task 3 端到端验证暴露：**UVPM 启发式在 headless 下随机崩溃引擎**（well1500 3/3、gargoyle 1/2）。经 systematic-debugging 确认根因为 heuristic（rotation 无辜），且崩溃非确定。用户裁定：**弃用启发式，只留 rotation_step=15**。`_uvpm_repack` 移除重试/启发式，回到单次 UVPM(rotation 15)。最终：gargoyle 52.3→55.6%、well1500 稳定 +uvpm，零崩溃、确定性。
@@ -105,3 +105,9 @@ _uvpm_set(p, "heuristic_search_time", UVPM_HEURISTIC_TIME, warnings)
 - 属性名/取值一律以第 1 节探针结论为准；spike 未确认前不写死具体名。
 - `_uvpm_set` 的 `hasattr` 守卫是关键：防止版本差异把整个 UVPM 排布拖垮。
 - 若探针发现启发式需要非 `'0'` 的 `pack_op_type` 或专门 `mode_id`，在计划中据实调整并在 README 注明。
+
+## 实现修订（2026-07-21，系统调试后）
+
+实现中发现 **UVPM 启发式搜索在 headless 下会随机崩溃引擎进程**（`Error: Engine process died unexpectedly`）：well1500 崩 3/3、gargoyle 崩 1/2（同模型重跑结果不一致），旋转步进无辜。启发式因此不可靠、且使输出非确定。
+
+**最终落地**：弃用启发式，只保留 `rotation_step=15`（稳定、零崩溃、确定性）。实测利用率提升较小但可靠——gargoyle 3000（`--max-overlap 0.15`）52.3%→**55.6%**，well1500 5000 稳定 `+uvpm`。移除 `_uvpm_pack_once`/重试与 `UVPM_HEURISTIC_TIME`；`_uvpm_repack` 回到单次 UVPM（rotation 15）。验收从"明显上升"下修为"稳定小幅上升且零崩溃/确定性"。