SuperAPI AI 工具集

multiview-constraint-solver

设计与创作

查看项目

更新于 10-15 18:09

技能介绍

用途

Multiview Constraint Solver 用于在重建 3D 模型之前,检查正视图、侧视图、背视图、顶视图等正交参考模板之间是否存在尺寸冲突,并判断这些视图能否由同一个刚性 Blender 模型满足。当参考图彼此不一致时,渲染器无法让同一个刚性网格同时满足相互不兼容的正交尺寸,除非允许针对特定视图进行欺骗处理。因此该技能被定位为“在另一次重建之前”使用的约束求解前置步骤。

主要能力

  • 正交模板冲突检测
  • 权威视图策略(canonical view policy)选择
  • 刚性模型与视图专用欺骗方案(rigid-vs-cheat-view)的决策
  • 正视图、侧视图、顶视图之间的尺寸比例比较
  • 重建前的来源协商(source-of-truth negotiation)

使用方式

在首次调用 Blender 之前,应阅读 ../text-to-blender/references/mcp-backends.md。官方 MCP 优先用于共享能力;整个任务中应保持所选后端不变。配方中的工具名称属于客户端或旧版示例,需要通过该参考文件及其 agent-host 指南进行映射。

工作流程

  1. 将每个参考视图统一到共同的轴约定:
    • front(正视图):宽度 X,高度 Z
    • side(侧视图):深度 Y,高度 Z
    • top(顶视图):宽度 X,深度 Y
    • back(背视图):宽度 X,高度 Z
  2. 测量可见身体的包围盒(bbox),不要测量标签、背景或光环,除非它们属于模型契约的一部分。
  3. 比较共享轴:
    • 正视图宽度 vs 顶视图宽度
    • 正/背视图高度 vs 侧视图高度
    • 侧视图深度 vs 顶视图深度
  4. 若比例差异超出容差,写出冲突报告并选择策略:
    • front_side_canonical:以正视图品牌识别和侧视图深度/高度为权威
    • front_top_canonical:以正视图品牌识别和顶视图占地轮廓为权威
    • corrected_templates_required:不应声称任何刚性重建可达到最终贴合
    • view_specific_cheats:允许分离的相机/视图变体,而非单一刚性资产
  5. 在进行任何几何、UV 或光照工作之前,将所选策略输入 fit-repair-optimizer。

硬性门槛

  • 在权威策略存在之前,不要重新开始建模。
  • 不要把顶视图中的光环或上下文当作身体深度。
  • 除非用户明确要求近似风格化折中,不要对相互矛盾的尺寸取平均值。
  • 将部件数量分歧与包围盒分歧分开记录。

脚本

scripts/view_constraint_report.py 读取包含各视图身体包围盒的 JSON 文件,输出共享轴兼容性以及建议的权威策略。

适用场景

  • 正视图、侧视图、顶视图等参考图之间的正交模板冲突检测
  • 需要制定权威视图策略时
  • 需要决定使用刚性模型还是视图专用欺骗方案时
  • 需要比较正视图、侧视图、顶视图之间的尺寸比例时
  • 在重建之前协商来源权威性时

限制

该技能的输入依赖各视图身体包围盒的 JSON 数据,需通过 scripts/view_constraint_report.py 处理。它不接受相互矛盾的尺寸取平均值,除非用户明确要求近似风格化折中。关于具体收费、价格、支持平台及完整安装命令,资料中暂未提供。