用途:从命令行批量压缩 GLB/glTF 三维模型,适合写 shell 脚本或在 CI 中压缩模型资源。
主要能力:支持 glob 模式、多档预设、网格简化比例(-s 0-1)与批处理;可保留节点层级与名称(-k)。预设包括 default(保守保留细节)、balanced(中等动画量化,24 Hz 重采样)、aggressive(强动画量化,15 Hz,适合角色)、max(激进+超级压缩+更低顶点精度)。
用法:glb-compressor <files...> [options]。常用选项:-o/--output <dir> 输出目录(默认与输入同目录并加 -compressed 后缀)、-p/--preset <name>、-s/--simplify <0-1>、-k/--keep-nodes、-f/--force 覆盖、-q/--quiet、--json、-h、-V。示例:glb-compressor model.glb;glb-compressor *.glb -f -p balanced;bun run cli -- model.glb -p aggressive -o ./compressed/。退出码:0 全部成功,1 一个或多个文件失败或简化比例非法,2 解析或约束错误(如未知预设)。
处理流程为六阶段:清理、几何、GPU、动画、纹理(转 WebP,最大 1024x1024)、最终压缩(优先 gltfpack,否则 meshopt WASM)。若模型含蒙皮,会自动跳过 flatten、join、weld、mergeByDistance、reorder、quantize 与 auto-decimate,避免破坏骨骼层级。依赖 gltfpack(可选,在 $PATH 中则优先使用)与 sharp(纹理压缩)。安装方式与平台、收费等信息暂未提供。