mcpField
I
inspect-glb

inspect-glb

github.com/playcanvas开发31319 次安装1 周前更新
代码仓库

关于 inspect-glb

inspect-glb 是用于在配置变换或动画前检查 GLB 模型文件的开发技能。它会报告边界和场景元数据，并标明哪些测量需要运行时确认。

主要功能

  1. 01检查尺寸、中心和地面偏移
  2. 02报告边界来源和姿势
  3. 03列出节点、片段、关节和动画目标
  4. 04标记需要运行时检查的情况

适用场景

  1. 01选择模型缩放和枢轴偏移
  2. 02识别动画名称和目标
  3. 03根据检查到的边界放置静态模型

安装

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

$npx skills add https://github.com/playcanvas/skills --skill inspect-glb

安装后在 Claude Code 中输入/inspect-glb确认已加载。

附带文件scripts/inspect.mjs

详细介绍

检查 GLB

请根据此技能的路径解析 scripts/inspect.mjs，并在选择变换或动画名称之前运行它。先筛选文件；不要把整个资源包都倾倒到上下文中。

node <skill-directory>/scripts/inspect.mjs public/models/*.glb

阅读输出

  • dims、center 和 groundOffset 分别给出统一缩放输入、枢轴偏移和 Y 轴落地位置。center.x 或 center.z 非零表示模型没有位于其根节点上。
  • boundsSource：只有当值为 vertices 时，才可依赖边界进行放置。accessor-minmax 对旋转节点的估算最多可能偏大 41%；incomplete 或 null 表示不要进行校准。boundsNotes 会说明原因。
  • boundsPose：static 和 default-morph 表示创作时的姿势；bind 表示蒙皮静止姿势。
  • requiresRuntimeCheck 表示存在变形、蒙皮或部分解码；请在应用中确认范围。
  • nodePaths、clips、joints 和 animationTargets 会用于 configure-animation。

边界无法证明朝向。请在运行中的应用里确认，并使用 calibrate-model 记录偏航角。运行时的 meshInstance.aabb 会对变形进行保守扩展，因此请根据检查得到的边界放置静态模型。

压缩文件

检查器可解码普通、交错、量化和稀疏缓冲区。对于 Draco、Meshopt 或外部缓冲区，请检查无损临时副本；不要使用 optimize，因为它会应用额外变换：

npx --yes @gltf-transform/[email protected] copy in.glb scratch.glb

Engine 无法加载 EXT_meshopt_compression；发布此类文件前，请参阅 load-assets。

评论

支持 Markdown