SuperAPI AI 工具集

closed-surface-uv-coverage

设计与创作

查看项目

更新于 10-15 15:11

技能介绍

用途

closed-surface-uv-coverage 是一个面向 Blender 的 UV 与材质覆盖检查技能,用于确保封闭网格或挤出类资产在所有可见表面上都有真实贴图或材质覆盖,尤其是正面端盖、背面端盖与侧壁。它针对一种常见误判:模型从正面看似乎已经贴图,但实际只是投影的正面图像或曲线叠加,转到旋转展示时背面端盖没有贴图,或侧壁只有纯色。

主要能力

技能在 look-dev 前先对可见表面进行分类:front_cap(正面贴图/贴花)、back_cap(背面贴图、背面线稿或烘焙/程序化填充)、sidewall(连接前后的深度面,需要独立 UV 参数化或程序化材质)、overlay_context(HUD/光环/圆圈等叠加层,不计入模型表面覆盖)。

它要求创建按表面的 UV:正面/背面端盖可将局部 X/Z 投影到 UV 0–1,或映射到正反面图集矩形;侧壁可将周长弧长映射到 U,将深度/前后坐标映射到 V;若缺少干净的侧面贴图,可使用程序化侧面材质加烘焙辉光/边缘条,并记录该决定。

它还要求为背面端盖与侧壁网格面分配真实表面材质,即这些网格面本身要有材质节点、活动 UV 或生成坐标。曲线、平面可用于边缘点缀,但不能替代表面填充。

验证环节要求抽样旋转展示帧:正面、45°、侧视/边缘、背视、反向 45°和静止位。背面与侧面帧必须显示表面填充,而不是仅有轮廓。

使用方式

技能的工作流包括:审计当前覆盖情况,列出网格材质槽、UV 层、图像纹理节点,以及正/背/侧材质索引对应的面数;拒绝只叠加层的修复方案;创建按表面的 UV;分配真实表面材质;验证旋转展示帧;最后输出 surface_coverage_report.json,说明哪些表面是图像贴图、程序化、烘焙或有意留空。可运行脚本 scripts/surface_texture_coverage_audit.py 对选中网格对象审计 UV 层、材质图像节点、面材质数量以及仅叠加层的警告模式。文中提及 MCP 后端:在首次调用 Blender 之前,应阅读 ../text-to-blender/references/mcp-backends.md;共享能力优先使用官方 MCP,并在整个任务中保持所选后端一致。配方中的工具名是客户端/旧版示例,需要通过该参考及其 agent-host 指南进行映射。

适用场景与限制

适用于封闭或挤出资产的全表面纹理覆盖、侧壁 UV、背面端盖 UV、封闭网格 UV 覆盖审计、贴图填充验证、侧背面旋转展示 QA,以及用真实表面材质替代投影叠加。该技能应在几何体锁定之后、最终材质/外观/动画验收之前使用,与 blender-uv-texturing 和 atlas-uv-fitting 互补:前两者解释 UV/材质设置,本技能强制检查完整可见表面覆盖。验收门槛包括:背面端盖网格面须有图像或程序化材质并声明 UV/生成坐标策略,不能仅有独立曲线;侧壁网格面须有带 UV/生成坐标的侧壁材质与可见深度处理;叠加/上下文集合不计入覆盖计数;QA 联络表需包含背面与边缘帧。