mock 规范总纲

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条(文档纪律)

(一)禁止叙述、铺垫、自我指称与重复段落;条文只允许规范句。

(二)禁止命令与绝对路径;只允许登记路径本身。

(三)数字必须磁盘实测;未重测旧数必须删除或标注"待重测"。

(四)引用行号前必须复核现码;未复核引用只允许以符号(函数名、字段名、协议名)给出。

(五)同一语义跨文档重复时,必须删除重复侧并改引用权威文档。

相关推荐
IT大白鼠13 小时前
当 AI 开始自动化渗透:FBI ARTEX 警报的防守对策
运维·人工智能·自动化
惜.己13 小时前
Java结合idea简单使用Playwright
java·开发语言·自动化
wflynn13 小时前
Google 观察到首个全自动化网络攻击,AI 框架已能独立完成漏洞利用
ai·技术
zdr尽职尽责14 小时前
终端工具凭空消失:Codex + GPT-6 的一次完整排障复盘
数据库·gpt·学习·ai
用户951794225102915 小时前
Agent Harness 工程(I5):权限与沙箱——让否决改变控制流
llm·agent
ClouGence16 小时前
复杂后台流程怎么做自动化测试?零代码方案实战分享
测试
佛系18916 小时前
从服务端日志精确分离搜索抓取、监控探测与真实流量的实操清单
ai·大模型·seo·geo·结构化数据·indexnow
LSDlsdoo18 小时前
冷却液与油污飞溅工况下,国产接近开关怎么选?五步工程化选型方法
其他·自动化
一起学安全技术21 小时前
拆大模型 11|大模型面试拷问:12 问逐层拆
人工智能·ai·语言模型·面试·职场和发展·求职招聘