mock 规范总纲
第0条（基线）本目录一切数字以 20260918 磁盘实测为准；旧数引用禁止。产品源码与文档冲突时以源码为准并即时修正文档。
第1条（构成）本目录文档分二级：
（一）框架级：README.md（本文件，总纲与注册表）、PRINCIPLES.md（原则）、WHY_AND_HOW.md（原理与边界）、ARCHITECTURE.md（框架架构）、INTERFACE_MAP.md（引擎接口映射）。
（二）系统级：mahjong/（CRASH/ROUTE/SETTLE 语义）、mahjong_ui/（UI 行为）、smallgame/（畅玩阁）、automatch/（自动匹配）。
第2条（权威顺序）冲突必须按下列顺序裁决，高序优先：
（一）产品源码 > 本目录全部文档。
（二）系统级文档 > 框架级文档；同一语义只允许一处定义，其他文档必须引用。
（三）PRINCIPLES.md > 其余框架级文档。
（四）mock/LINUX.md > 本目录文档（运行事实）。
第3条（入口）AI 使用入口为 mock/AI_GUIDE.md；运行方式只允许引用 mock/LINUX.md（Linux 唯一权威）与 mock/README.md 第10节（Windows 唯一权威）；本目录禁止复制命令与路径示例。
第4条（系统语义注册表）
| 文档 | 系统 | 语义范围 | 测试目录 |
|---|---|---|---|
mahjong/CRASH_SEMANTICS.md |
麻将服务器 | 崩溃类型 1-7、补偿/回滚、退款校验链、幂等点 | tests/mahjong/、tests/exp/ |
mahjong/ROUTE_SEMANTICS.md |
麻将服务器 | 节点间路由转发链失败回退与错误传播 | tests/mahjong/route/ |
mahjong/SETTLE_SEMANTICS.md |
麻将服务器与客户端 | 结算链：token、WAL、冻结退款、反回归 | tests/mahjong/settle/、settle_amount/、settle_extreme/ |
mahjong_ui/UI_BEHAVIOR.md |
麻将 UI | 面板、控件、几何、动画、音频、事件 | tests/mahjong_ui/ |
smallgame/LAW_MAPPING.md |
畅玩阁 | 物理定律到验证资产映射 | tests/smallgame/ |
automatch/LAW_MAPPING.md |
自动匹配 | 物理定律到验证资产映射 | tests/automatch/ |
其他接入系统（ateam、killcount、market、changwange、huashan）无语义文档；测试目录见各 tests/<system>/INDEX.md。
第5条（新增系统程序）
（一）在 docs/ 下建小写系统名目录。
（二）按语义维度拆分，文件名后缀限于 *_SEMANTICS.md（服务端）、*_BEHAVIOR.md（UI）、*_LAW_MAPPING.md（定律映射）。
（三）在本文件第4条登记文档、系统、语义范围、测试目录，四项缺一不可。
（四）测试置 tests/<system>/，并在该目录 INDEX.md 登记类目。
第6条（文档纪律）
（一）禁止叙述、铺垫、自我指称与重复段落；条文只允许规范句。
（二）禁止命令与绝对路径；只允许登记路径本身。
（三）数字必须磁盘实测；未重测旧数必须删除或标注"待重测"。
（四）引用行号前必须复核现码；未复核引用只允许以符号（函数名、字段名、协议名）给出。
（五）同一语义跨文档重复时，必须删除重复侧并改引用权威文档。