快速入门
Voxel Kit 是围绕体素内容建立的开发工具集：VF 用于创作与交换，VFP 用于发布和运行时资产封装。
Python voxelkit 是单一的 VFP 编译与读取 SDK；HarmonyOS Kit 在此基础上提供 ArkUI 内的预览、编辑、Native 编译和导出能力。
先理解三层能力
| 层级 | 解决的问题 | 从哪里开始 |
|---|---|---|
| 格式 | 体素内容如何表达、封装和验证 | VF 格式介绍 与 VFP 格式介绍 |
| Python Kit | 在服务端、CLI 与离线任务中编译 PixForge JSON、读取、校验并提取 VFP 区段 | Voxel Kit for Python |
| HarmonyOS Kit | 在 ArkUI 中读取 VFP，并将 JSON / VFP 交给 VoxelViewer 预览 | Voxel Kit for HarmonyOS |
按任务选择入口
- 如果你正在设计资产链路，请从 VFP 格式 开始，并继续阅读技术标准。
- 如果你要在 Python 服务、CLI 或离线任务中处理 VFP，请阅读 Voxel Kit for Python。
- 如果你要在 HarmonyOS 应用中读取 VFP 或展示模型，请阅读 Voxel Kit for HarmonyOS。
- 如果你要确认 HarmonyOS Kit 的版本更新、升级影响或已修复问题，请阅读 HarmonyOS 版本与变更。
- 如果你已有具体问题，请访问 开发者支持。
推荐阅读顺序
- 了解 VF 与 VFP 的职责边界。
- 根据运行环境选择 Python Kit 或 HarmonyOS Kit；Python Kit 公开 JSON → VFP、读取、校验和 GLTI 打包/恢复，HarmonyOS Kit 还可直接预览、编辑，并提供 JSON/VOX Native 编译。
- 在接入前确认是否只需要预览，还是需要完整权威数据验证。
- 涉及编辑、发布或可信资产处理时，回到 VFP 技术标准中的
VOX0、Source Hash 和验证器规范。
文档约定
文档中的格式块和代码片段用于说明工作流。实际接入时，请以当前发布包内的类型声明和版本说明为准。