spec/ —— majojson 牌谱格式规范

状态：✅ 已迁入 majojson-replay-format.md——主项目内部规范的产品中立化改写版（§0~§8 + 载荷字段参考 + 四玩法要点 + 改写说明）；天凤互操作段按计划拆至 interop/，样例由 examples/ 真实导出物承担。

迁入物与改写口径

来源是现行权威的内部规范（§0~§9 + 牌码文法 + 校验清单，已经过一轮逐条复审验证）。改写原则：

  1. 去掉产品内部引用：源码文件行号引用、版本号叙事、app 内部行为描述——读者不需要装 app，也不需要读原始实现源码。
  2. 保留全部规范性内容：范围与命名、设计铁律、顶层结构、majo 段、载荷帧必需字段校验清单、解析策略与错误码、往返不变式、版本演进规则、整局多手容器（format 2）。天凤互操作段（源 §5）不留在规范里，独立成文至 interop/。
  3. 口径中立化：面向「生成方 / 消费方」陈述义务（如源文「服务端校验口径」改写为生成方校验义务），不预设任何特定实现。
  4. 样例外置：规范附录中的骨架示意样例，由 examples/ 的真实导出物替换，规范内只引用路径。

章节骨架（迁入后对齐源规范）

章节 内容
§0 范围与命名 format 1 / format 2、majojson 名称与媒体类型
§1 设计原则 铁律；「帧快照式」载荷的定位（每动作全量状态，对渲染器友好）
§2 顶层结构  
§3 majo 段 顶层字段 / meta / replay 载荷 / 生成方校验义务
§4 载荷帧的必需字段 校验清单——tools/ 最小 reader 的验收依据
§5 解析策略 步骤与错误码；天凤段完全不参与导入
§6 往返不变式 导入后必须成立的机器化不变式
§7 版本演进规则  
§8 整局多手容器 format 2：fail-closed 校验、手级导航、mjai 导出口径