Vfp 检查与校验 API

inspect()

asset.inspect() -> dict[str, object]

返回轻量库存：gridSize、chunkSize、solidVoxelCount、fileBytes、sections 和 caches。sections[tag] 含 count、storedBytes、rawBytes；caches 标示 THMB、PRVW、VBUF、PMSH、RND0、ANM0 是否存在。

适合文件列表和日志，不是安全校验。

validate()

asset.validate() -> dict[str, object]

等价于 validate_vfp(asset.path)。验证目录、CRC、META/PAL0/VOX0、source hash 和存在的标准缓存。成功返回报告；任一不一致抛出 VfpError。

if asset.validate()["hasThumbnail"]:
    asset.extract_thumbnail("thumb.png")