mcpField
F
fit-repair-optimizer

fit-repair-optimizer

github.com/roble3创意与媒体128801 次安装2 周前更新
代码仓库

关于 fit-repair-optimizer

fit-repair-optimizer 是用于 3D 模型验证失败后的修复规划技能,面向需要按依赖关系修正模型的创作者。它将检查结果整理为带有阶段、阻塞项和验收门槛的可执行队列。

主要功能

  1. 01按阶段排列修复顺序
  2. 02判断任务能否并行
  3. 03检查多视图源图冲突
  4. 04为修复项定义字段与验收门槛
  5. 05重复失败时转交技能改进流程

适用场景

  1. 01将验证问题转为修复队列
  2. 02安排几何、UV 与材质修复
  3. 03处理不同视图模板之间的冲突

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/roble3/cc-blender-skill --skill fit-repair-optimizer

安装后在 Claude Code 中输入/fit-repair-optimizer确认已加载。

附带文件scripts/fit_repair_queue.py

详细介绍

Fit 修复优化器

此技能可将验证失败转换为可执行的修复队列。源模板是约定;当前模型可随时舍弃。

决策:顺序修复还是并行修复?

当失败之间存在耦合时,使用顺序修复:

  1. 标准视图 / 源冲突尚未解决。
  2. 正面轮廓或部件数量不符合要求。
  3. 几何尺寸不符合要求,导致无法信任 UV。
  4. 纹理区域边界取决于几何变化。
  5. 光照 / 外观取决于最终材质布局。

仅在写入范围互不重叠的独立工作轨道上使用并行修复:

  • 几何制作方案 / 摆放调整;
  • 图集区域分类;
  • 材质 / 外观校准;
  • 验证工具改进。

不要并行处理会同时编辑同一 Blender 制作方案、对象变换或 UV 分配文件的两项任务。

强制修复顺序

0 source-conflict / multiview-rigidity gate
1 structural part count
2 front silhouette and landmarks
3 side/back/top depth and projection
4 UV/texture region fit
5 material/light/look calibration
6 export and final validation

如果较早阶段未通过,可以分析后续阶段,但不得将其定稿。

源冲突检查关卡

修复前,使用 multiview-constraint-solver 检查模板是否可以同时满足。如果同一物理轴在不同视图中的比例互不兼容,请编写冲突报告,并要求制定规范策略:

  • 正面 + 侧面为准;
  • 正面 + 顶面为准;
  • 修正模板图纸;
  • 仅使用按视图分别制作的欺骗性渲染,而非刚性 3D 模型。

修复队列架构

每个修复项都必须包含:

  • id
  • stage
  • view_scope
  • failure
  • measured_delta
  • proposed_action
  • write_scope
  • parallel_group
  • blocked_by
  • acceptance_gate

技能缺口规则

如果同一失败重复出现两次,请停止并在再次重建前调用 quality-refinement-autoloop。自循环必须收集证据、诊断缺失的方法,将经验整理为通用且可发布的指导,修补相关技能、验证技能栈,然后带着新的修复队列返回此处。常见的路由方式:

  • 几何不匹配 → contour-to-mesh、orthographic-registration 或此技能;
  • UV / 纹理不匹配 → atlas-uv-fitting;
  • 光照不匹配 → 在 blender-lighting 中添加 / 校准外观指导,或使用外观校准技能;
  • 验证不匹配 → multiview-fit-loop / reference-analysis-validator。

输出

编写项目修复计划,例如 ALIGNMENT_REPAIR_QUEUE.json,以及便于阅读的 ALIGNMENT_REPAIR_METHOD.md。

评论

支持 Markdown