landmark-fit-repair

用途

Landmark Fit Repair 用于对源锁定（source-locked）的 Blender 模型进行地标级校验与修复。包围盒（Bbox）和 IoU 对于最终吉祥物/Logo 匹配来说过于粗糙，本技能将命名特征的漂移转化为配方（recipe）编辑，从而实现更精细的对齐。

适用场景包括：地标校验、特征点增量计算、控制点修复、面部/眼睛/微笑对齐、叶尖对齐、光环环拟合、迭代式配方参数更新。

地标类别

structural_tip：外部部件尖端与极值点；
shell_corner：面部/外壳/边缘的角点；
feature：眼睛、微笑、眉毛、贴花；
ring：光环中心/半径/点；
depth_marker：侧面/背面/顶部厚度标记。

工作流程

为源参考定义地标 JSON。
检测或渲染对应的产品地标。
按名称和视图进行比较。
将增量转换为修复动作：移动边界控制点、缩放单个组件、平移特征曲线、调整深度或调整光环半径。
从配方重建；不要在没有更新配方/清单的情况下手工编辑最终几何体。

硬性门槛

当命名结构地标超出容差时，不允许最终导出。
面部特征必须与身体轮廓分开校验。
光环/上下文地标不得影响基础 GLB 的验收。

脚本

scripts/landmark_fit_report.py 比较两个命名地标 JSON 文件并输出修复增量。

地标 JSON 模式

{
  "schema": "landmarks.v1",
  "image_size": [width, height],
  "landmarks": [
    {"view":"front", "name":"leaf_top_tip", "class":"structural_tip", "x":627, "y":130}
  ]
}

对于部件掩码，可从极值生成初始地标：上/下/左/右、质心以及轮廓拐点。然后在修复前将它们重命名为语义名称。

使用方式与后端

在首次调用 Blender 之前，请阅读 ../text-to-blender/references/mcp-backends.md。优先使用官方 MCP 处理共享能力；在整个任务中保持所选后端不变。配方中的工具名称是客户端/旧版示例：请通过该参考及其 agent-host 指南进行映射。

限制

关于具体收费、价格、支持平台、效果指标等信息，资料中暂未提供。