OPEN SCHEMA · 1.0.0
Observation Session
Schema。
机器可读的 JSON Schema 与面向人的字段说明。用于校验导出、研究导入和独立工具实现。
01 / ROOT
根字段。
字段类型说明
schemaVersionstring · required语义化结构版本，当前为 1.0.0。idUUID · requiredSession 的稳定标识。stateenum · requireddraft、active 或 completed。observedAtobject · required事件开始、可选结束时间与时区偏移。createdAt / updatedAtdate-time · required记录生命周期时间，不替代实际观察时间。02 / EVIDENCE
四层证据。
evidence 是必需对象，包含 raw、statements、measurements 和 machineNotes 四个数组。数组可以为空，但不能把一种来源写进另一层。
数组关键字段边界
rawid, kind, capturedAt, hash原始媒体与派生副本分别成项。statementsid, recordedAt, text保存观察者原文与语言。measurementsid, kind, value, unit带采样时间、精度与来源。machineNotesid, analyzer, version, text不得使用“confirmed”等身份结论。03 / DIRECTION TRACK
方向采样。
directionTracks 中的每条轨迹记录参考北、采样点与设备姿态语境。每个 sample 必须有时间、0–360° 方位角和 −90–90° 仰角；不确定性字段以度为单位。
"samples": [{
"recordedAt": "2026-07-10T21:47:22+08:00",
"azimuthDegrees": 222.4,
"elevationDegrees": 18.1,
"azimuthUncertaintyDegrees": 2.4
}]04 / PRIVACY
位置与公开边界。
privacy.locationMode 为 hidden、approximate 或 precise。模糊位置必须给出 precisionMeters；隐藏模式不应包含坐标。publication 只描述经用户确认的公开副本及其字段，不改变私有 Session。
05 / VALIDATION
校验与兼容。
Schema 使用 JSON Schema Draft 2020-12。未知根字段会被拒绝，以便尽早发现拼写错误；各证据项预留 extensions 对象供命名空间扩展。补丁版本只做兼容性澄清，新增可选字段提升次版本，破坏性变更提升主版本。
SHA-256 哈希用于检查内容一致性，不证明媒体真实性、拍摄时间或来源身份。Schema 校验通过也不等于记录已核实。