validate_vfp()

validate_vfp(path) -> dict[str, object]

校验 VFP 容器、目录 CRC、META/PAL0/VOX0、source hash 以及存在的标准缓存。它会恢复全部权威 VOX0，因此不应在 UI 主线程直接处理大文件。

参数	说明
path	待校验 .vfp 的 Path。

成功时返回 gridSize、paletteCount、chunkCount、sourceHash、vfpBytes 与 hasThumbnail、hasPreviewGlb、hasVbuf、hasRnd0、hasAnm0 等状态。任意不一致抛出 VfpError，没有“部分成功”结果。

from pathlib import Path
from voxelkit import validate_vfp
report = validate_vfp(Path("incoming.vfp"))
assert report["hasThumbnail"]