O1.12.2Machine-readable export设计研究
导出格式的机器可读性决定能否迁移到其他服务
别名: 机器可读导出 · 可互操作导出 · data export schema
概念解释
机器可读导出（machine-readable export）使用软件能稳定解析、字段含义有文档且数据类型明确的格式，使另一个服务无需人工抄录即可处理。JSON、CSV 或 XML 只是语法容器；若标识符不稳定、时间和单位不明、关系被压平成展示文本，文件仍难以迁移。真正的可携性还需要语义互操作，即接收方能把字段映射到等价对象与关系。
机制
迁移要重建的不只是值，还有结构、顺序、引用和上下文。专有编码、未说明枚举、缺失时区或附件与元数据分离，会让解析成功但意义改变。模式版本没有固定说明时，同一导入器会随导出变化而失效。机器可读性通过显式模式、稳定键、标准类型与版本兼容降低转换不确定性；开放文件扩展名本身不能提供这些保证。
怎么研究
互操作测试应选择独立团队，仅依据公开文档构建导入器，再用覆盖空值、非拉丁文字、时区、附件、关系和大数据量的夹具测往返保真。指标包括解析失败、字段损失、关系断裂、单位错误和人工修复时间。验证器只能证明语法符合模式，不能证明接收服务中的用户意义保持；需加入任务级比较和抽样人工核对。
边界
并非所有服务都有一一对应的数据模型，语义损失有时不可避免；应在导出中保留原值与说明，而不是假造映射。通用标准可能覆盖核心对象，却跟不上领域特有功能。人类可读预览仍有价值，但应作为机器文件的伴随层而非替代物。包含二进制媒体时，可用清单与稳定相对引用组织多个文件。
怎么落地
- 选择有明确字符编码、类型和嵌套规则的开放格式，并发布字段字典、枚举、单位、时区和版本策略。
- 保留稳定对象标识与关系，附件通过清单、校验值和相对路径关联，不把关键结构藏在文件名中。
- 提供模式文件、示例与自动验证器，并在不破坏旧导入器的前提下演进版本。
- 让未参与导出开发的团队实现导入并执行往返测试；比较记录数、关系、时间、内容与附件校验值，任何静默丢失都必须修复或明确报告。