开发与发布概览
这一部分面向维护 voxel-kit HAR、集成 Demo 或准备发布 OHPM 包的工程师。它不改变宿主项目的业务发布流程，而是定义 Voxel Kit 自身的构建、验证和扩展约束。
开发时最重要的三件事
- 公开 API 与内部渲染隔离：业务只能从包根
Index.ets导入稳定类型，不依赖Scene、Camera、Mesh 或内部 TaskPool 输入。 - 构建通过不等于渲染正确：
Component3D的首帧、手势、动画、光照和 Picker URI 必须通过真机验证。 - 格式缓存不是权威数据：调整 VFP 快速预览缓存时，始终保留
VOX0为权威源，明确缓存的校验和回退策略。
阅读路线
| 你要做的事 | 文档 |
|---|---|
| 构建 HAR、检查产物、准备上传 OHPM | 构建、验证与 OHPM 发布 |
| 新增 API、Reader/Convert/Edit 能力或修改渲染资源 | 维护与扩展规则 |
| 排查真机渲染、Picker、手势问题 | VoxelViewer 测试与排障 |
| 理解 VFP 缓存与可信边界 | VFP 可信边界 |
发布边界
当前对外 HAR 是只读预览和只读 VFP 容器读取包。编辑、转换和写回应以独立能力族/独立模块演进，不能通过暴露 Viewer 内部对象绕过边界。