Voxel Kit for Python

voxelkit 0.7.2 是 VFP 1.3 的 Python SDK。当前公开 API 覆盖 PixForge JSON → VFP 编译、VFP 容器/权威数据读取、严格验证、可选 MATL/Rig/XEXT/THMB 读取，以及 VFP ↔ 可编辑 GLTI MP4。

from voxelkit import Vfp, compile_json, validate_vfp

任务	入口
JSON 编译 VFP	compile_json()、compile_vfp()、Vfp.compile()
打开与目录读取	Vfp.parse()、section_tags()、entries()、read_section()
权威数据	manifest()、palette()、voxels()、validate()
可选格式数据	materials()、rig()、extensions()、thumbnail()
GLTI 交付/恢复	GltiExporter.export()、GltiPackageReader

SDK 当前不公开 Vfp.from_vox()、inspect()、export_json()、to_vox()、extract_glb()、extract_thumbnail() 或 rebuild_caches()；不要按旧文档调用这些名称。缩略图通过 thumbnail() 返回内存字节，PRVW 通过 read_section("PRVW") 读取。

VOX0 + PAL0 是可编辑资产的权威来源。VBUF、PMSH、RND0、ANM0、PRVW、THMB 都是可删除派生数据。GLTI 只有嵌入原始 VFP 时才可恢复；视频和 GLB 不会被反推成体素源。