幻彩迷阵 本地登录注册模块测试说明

一、入口与流程
从 Main 场景启动预览。加载完成后显示登录弹窗，登录成功进入原游戏首页，再点击“开始游戏”进入棋盘。
注册新账号 → 确定 → 实名认证 → 确定 → 适龄提示 → 确定 → 防沉迷通知 → 确定 → 返回登录。
注册后中断认证，可用该账号再次登录继续认证。已认证测试账号直接登录。
重开/刷新预览回到登录，可更换测试账号；不会自动登录。

二、测试账号
全部密码：123456。完整30个账号见本目录“账号清单.txt”。账号与参考Word一致。
空白：0钻石，1级，最高分0。
低级：100钻石，1级。
中级：20000钻石，8级。
高级：200000钻石，17级。
实际等级会按关卡表上限裁剪。每次新开一局从对应测试等级及该等级起始分数开始。
本游戏道具消耗钻石，未实现装备/服装系统，因此高级档通过充足钻石体验现有道具。
钻石、最高分和设置按账号单独保存，首次登录初始化，后续登录不重置。原游客存档不覆盖。

三、注册与模拟实名
账号：6—20位字母、数字或下划线；密码：6—20位非空白字符；确认密码必须一致。
姓名输入2—20位中文，支持姓名中间的间隔号。
身份证输入18位号码，末位支持数字、X或x。校验长度、字符、出生日期、非零顺序码和校验码。
仅本地格式校验，不核验姓名与号码是否匹配、证件是否真实签发或行政区划是否有效。
以下为按格式构造的测试样例，不代表真实身份：
成年：110101200001010010
未满8岁：11010120200101001X
8至未满16岁：110101201401010014
16至未满18岁：110101200901010016
年龄按中国时区及当前测试时钟计算。姓名、完整证件号不存储；新注册账号保存出生日期和认证状态，便于动态计算周岁。内置测试账号年龄固定。
未接入公安实名认证、后台账户、短信或实际支付。密码只为离线原型而本地保存，不用于生产认证。

四、时段与充值
游戏界面不提供测试时钟，AuthRuntime不启用testControls，预览和构建均使用真实时间。时钟注入仅供assets以外的自动验证脚本使用。
内部脚本可构造AuthService(store,true,wallNow)，覆盖允许、禁止、节假日和到点场景，不在玩家界面提供入口。日期按中国时区判断。
未成年人只允许周五至周日及本地配置的2026年法定节假日20:00（含）至21:00（不含）登录。节假日表在AuthPolicy.ts，后续年份需要维护。
测试时钟持续推进。独立会话组件每0.5秒检查，切回前台重新检查；棋盘、暂停和商城均受限制。到21点或当日累计达到1小时后关闭游戏并返回登录通知。
每日时长每5秒及切后台/退出时保存，重登继续累计。异常关闭可能丢失最后一个保存周期；本地时钟与存档不具备服务端可信性，仅用于单设备单实例验证。
成年账号不限该时段。未成年时段外登录显示通知，确定后回到登录。
充值规则按参考文档模拟：未满8岁禁止；8至未满16岁单次50元、每月200元；16至未满18岁单次100元、每月400元。
月累计按账号和中国时区自然月保存。金额使用整数分；余额、累计及订单一次写入，失败不发放。同一订单重复提交不重复发放；取消不计入累计。
商品以统一目录为准；打开确认及最终提交均检查会话与额度，过期窗口、未知商品、损坏的账本均拒绝购买。
未成年账号需在真实允许时段登录；非开放时段可运行tests/auth/auth.test.cjs检查完整分龄及交易规则。

五、维护与检查
AuthService.ts：账号、注册、模拟实名、时间与充值规则，不依赖Cocos。
AuthRuntime.ts：Cocos本地存储适配和会话实例。
AuthPolicy.ts：时区、每日时长和2026年节假日日历。
AuthSessionGuard.ts：独立于棋盘的持续会话检查和退出。
RechargeCatalog.ts：统一商品价格与钻石数量，商城目录从这里导出。
AuthPanel.ts：全部弹窗外观、输入框及流程；无需修改已有prefab。
项目根目录 tests/auth/auth.test.cjs：自动验证脚本；执行 node tests/auth/auth.test.cjs。测试放在assets外，避免Cocos把Node测试依赖编入游戏。
测试脚本默认使用本机 Cocos 3.8.7 附带 TypeScript；其他机器可设置 TYPESCRIPT_PATH 指向TypeScript包。
集成点：AppMgr加载完成入口、UserStorageData独立存档、UserModel起始档位、RechargePanel充值校验、s_loadingPanel隐藏已完成的进度条。
本地键前缀 prism.auth.；更改内置账号及初始档位请修改 AuthService.ts。
如果编辑器预览未反映文件更新，请回到Cocos等待资源导入，然后重新启动预览。

六、验收建议
1. 空账号、错误密码、重复账号、两次密码不一致均有提示。
2. 完整注册流程逐步走到登录，期间不提前进入游戏；关闭认证后能继续认证。
3. 成年高级账号登录，检查200000初始钻石和17级起始档位。
4. 禁止时段下未成年人登录被拦截；允许时段可进入。
5. wcnr001充值6元被拦截；wcnr004充值68元被拦截；wcnr007充值128元被拦截。
6. 对8至未满16岁账号充值36元5次和6元3次，累计198元；再充值6元应被拦截。16至未满18岁账号充值68元5次、36元1次和6元4次，累计400元；再充值6元应被拦截。
7. 更换账号不共享钻石与最高分，重新登录原账号保留变更。
8. 在真实开放时段即将结束时登录未成年账号；到点后应撤销会话、关闭游戏并显示通知，确定后回到登录。自动验证脚本通过注入时钟覆盖此场景。
9. 2026-10-19实测预览中wcnr004已累计模拟购买198元，wcnr007已累计400元；本次浏览器已有存档可改用同组wcnr005、wcnr008验证零起始额度。新设备首次使用仍为初始值。

七、交付文档与生产边界
最新文档在output/anti-addiction/修订版，包含《幻彩迷阵》账号表和游戏防沉迷系统说明，已更新界面截图及对外文案；公司为北京尼卡数娱科技有限公司。外层旧文档因Word占用而保留，不是当前版本。
本实现不连接任何实名认证、支付或账号后端；不得作为正式生产安全认证。上线需服务端可信时间、跨设备累计、支付回调验签、幂等发货及官方实名接入。
