VoxelKit Reader 是什么

VoxelKit Reader 是面向 VFP 1.3 的读取 SDK。它将 VFP 的 Header、Footer、DIR0 目录、区段 CRC、RLE8 体素解码和 sourceHash 规则封装为稳定的 Python 接口。调用方不需要自行计算区段偏移或处理二进制端序。

Reader 的定位是“可信读取边界”。任何进入应用的外部 VFP，先由 Reader 进行结构与权威内容校验；只有校验成功后，业务代码才把体素、调色板或导出结果交给渲染器、转换器或资源库。

它适合下面两类系统：一类是只需要查看与导出的工具，例如资产浏览器和命令行转换器；另一类是有编辑功能的应用，其中 Reader 只负责把文件转成内存数据，编辑状态由应用自己的文档模型管理。

Reader 不持有后台线程、缓存数据库或网络连接。每次 VfpReader.open() 都围绕一个本地路径创建独立对象，因此适合放进任务 worker 或隔离进程。并发策略、租户隔离和对象生命周期应由宿主应用决定。

非目标

Reader 不会生成 VFP，不会原地修改 VFP，也不承诺理解每一个未来缓存区段。这样可以使读取包保持小、可审计，并允许编译器以私有实现独立演进。