文档/Machine Schemas

格式规范

Machine Schemas

OCTX v0.1 的 JSON Schema Draft 2020-12 与语义校验边界。

OCTX v0.1 使用 JSON Schema Draft 2020-12 校验单条 JSON 结构:

JSONL 文件逐行使用对应 record schema。所有 schema 允许未知可选字段,以满足向前兼容和 round-trip 要求。

JSON Schema 只负责单个 JSON object 的结构约束。以下内容必须由 OCTX 语义校验器完成:

  • ZIP 路径、条目类型和资源上限。
  • 文件清单完整性和路径唯一性。
  • 至少一篇 OKF Concept Document。
  • UUID 在 Package 中的唯一性。
  • JSONL 跨记录引用和关系组合唯一性。
  • Event 层级、循环和 level。
  • SAG-Structured 完整覆盖。
  • Arrow schema 与向量覆盖。
  • Arrow IPC 消息边界、批次数量、行数、向量值总量,以及 vectors v0.1 禁止 body compression 的约束。
  • 逐文件 SHA-256 和 Package Digest。

规范来源: