VF 格式介绍

VF（Voxel Format）是一种用于描述体素模型的开放式文本格式。它通过简单、直观的 JSON 数据结构表达体素空间、颜色信息和模型基础属性。

VF 的目标不是成为最终渲染格式，而是成为体素内容生产流程中的基础数据格式。它关注的是：这个体素模型由什么组成。

GRID模型尺寸

COLORS颜色调色板

DATA三维体素数据

{
  "grid_size": 32,
  "colors": {
    "A": "#0C1014",
    "B": "#1A2536"
  },
  "data": [
    [[".", "A", "A"]]
  ]
}

其中，grid_size 定义体素空间大小，colors 定义颜色映射，data 定义每个空间位置对应的体素。. 表示空气，其他字符索引 colors 中的颜色。

1. 为什么需要 VF

AI 生成、用户创作、图片转换和自动化工具都会产生体素内容。它们需要一种简单、开放、易生成、易修改、易理解的中间表示。

传统体素格式往往偏向软件内部存储、游戏引擎使用或二进制交换；直接生成和修改二进制格式对 AI 与创作工具并不友好。VF 的 JSON 结构使 AI、开发者和用户都能直接创建、审阅、修改与版本管理体素数据。

2. VF 的特点

2.1 人类可读

VF 使用 JSON。无需专用工具，开发者即可查看网格尺寸、调色板和体素字符矩阵，也可以直接编辑颜色或体素内容。

2.2 适合作为 AI 输出格式

AI 更擅长生成结构化文本。一个“创建像素风小猫”的请求可先生成 cat.vf，再编译为面向应用的 cat.vfp。

2.3 适合作为编辑中间格式

VF 可作为编辑器工作文件、AI 生成结果、网络传输格式和版本管理格式。它保持创作层的透明度，不要求创作过程理解缓存或 GPU 布局。

3. VF 与 VFP 的关系

VF 与 VFP 属于同一体素生态的不同层级：VF 是源格式，VFP 是由源数据编译得到的高性能资产包。

SOURCEVFVoxel Format · JSON 源数据

→

COMPILEVFP Compiler规范化、封装与缓存生成

→

PACKAGEVFP发布与运行时资产包

对比	VF	VFP
定位	体素源格式	体素资产发布格式
关注点	描述模型是什么	让模型高效运行
编码	JSON / UTF-8	可随机访问的二进制容器
适合场景	创作、生成、交换、调试	分发、加载、渲染、编辑加速
典型文件	cat.vf	cat.vfp

VFP 在 VF 所表达的体素内容之上，增加 Chunk 索引、贪心合面缓存、GPU 顶点数据、动画数据、预览资源和校验信息。VF 是推荐上游格式，但 VFP 也可以由扫描、导入器、程序化生成或其他工具直接生成。

4. 编译流程

AI / 用户 / 编辑器↓VF：Voxel Format↓VFP Compiler↓VFP：Voxel Format Package↓Rendering / AR / Game

VF 属于创作阶段；VFP 属于发布和运行阶段。将二者分开，既保留文本格式的可读与可编辑性，也避免把性能优化复杂性带入源文件。

5. 为什么不直接使用 VFP

两者的目标不同。若所有场景都直接操作 VFP，AI 生成、人工修改和开放交换都会变得更复杂。VF 只需表达“颜色 + 数据”，而 VFP 负责“性能 + 工程化”。

6. VF、VFP、VWFP 三层体系

VF：Voxel Format↓VFP：Voxel Format Package↓VWFP：Voxel World Format Package（未来规划）

• VF 回答：一个体素模型的数据是什么？
• VFP 回答：一个体素资产如何高效运行？
• VWFP 回答：多个体素资产如何组成一个世界？

VF 希望成为 AI 时代体素内容创作的通用源格式，让体素内容像 Markdown 或 JSON 一样以简单、开放的方式被创建、交换和演化；VFP 则将它转化为可用于真实应用的高性能数字资产。