# Fruit Pop 主游戏 ## 运行与界面 - Welcome 保持启动入口。两步游客认证成功后,获取同游客的独占存档权限,恢复本地游戏并加载 Orchard 场景;依赖就绪后 loading 收满并同步切入首屏。 - Orchard 为独立 1080×1920 场景。主界面、5 列裁切窗口、动态数字、8 组弹窗和操作按钮均为已保存的独立节点;运行时更新已有节点,不创建整套 UI。 - 正常状态按主参考图排版。自动状态使用与免费旋转相同结构的 AUTO SPINS/数字/LEFT 横幅,STOP 完成本局后停止。免费状态使用独立 CURRENT WIN/TOTAL WIN 区,锁下注和主按钮。 - 所有新增切图、字体、图集和工程目录均重新命名;assets/orchard 下绑定 86 张切图,符号目录为 emblems,弹窗为 dialogs,字体为 typefaces。amber-numerals.fnt 内 page 指向 amber-glyph-atlas.png,包含 0–9、逗号、小数点。WIN、BET、累计金额和横幅次数使用该字体;免费触发大数字使用 celebration-numerals,领取弹窗金额按参考改为白色金额加COINS单位。 - 每日金币包含可领取与已领取美术状态、UTC 倒计时。帮助页由实际赔率表和赔付线数据生成,不使用整张参考图覆盖。 ## 代码职责 - SlotsMath:10 符号权重、20 条固定线、每线最优赔付、SCATTER 及免费列转换。 - GameSession:下注、金币、每日赠币、免费阶段与结算快照;对外读取为深拷贝。 - GameRepository:单 JSON 快照、校验与读回、旧版本冲突及同页重入保护。 - OrchardRuntime:认证游客作用域、均匀加密随机、浏览器独占存档锁和场景预载。 - AutoSpinQueue:尚未开始的普通局队列;不保存或恢复自动旋转。 - OrchardView:输入、三态界面、动画时序及屏幕适配。 - ReelPresentation:只展示已提交结果,离开裁切区后回收符号,中奖线与免费列提示。 - OrchardDialogs:设置、自动配置、每日领取、余额不足、免费触发/结果、规则、错误恢复。 - OrchardAuthoring/OrchardComposer:仅通过显式编辑开关批量排版,保存后节点可独立修改。 ## 规则与存档 按根目录 fruit-pop-rules-v1.md 实现。初始 100,000 金币、默认总下注 2,000,普通旋转每局扣一次;结果、扣款、奖金和 pending 在同一快照提交。动画中刷新仅重放 pending,不重抽或重复派奖。 3/4/5 个及以上 SCATTER 分别奖励 8/12/16 次免费旋转。免费局沿用触发下注,每局均匀选择一列,将其中非 SCATTER 转 WILD,不再触发免费。累计只包含免费局奖金,结果窗不重复发钱。 每 UTC 日领取 20,000 一次,旧日期或倒退时钟不能再次领取同一/更早日期。真实权威校时和跨设备同步尚无服务协议,本版为本机金币存档。 真实浏览器入口先取得 Web Locks 独占权限,同游客其他文档不能同时写档。读取损坏或不确定保存会阻止继续并保留原档;确认提示后返回登录重新恢复,不重赠初始金币。需要支持 Web Locks 的安全浏览器环境,当前不支持原生运行。 ## 验证 - pnpm@11.17.0 安装,pnpm typecheck 通过,88 项测试通过。 - 包含全部赔付线与普通符号的 3/4/5 连、WILD 最优/全 WILD、SCATTER、列转换、免费锁注、原子扣奖、pending 恢复、坏档/写失败/并发、UTC 日奖、自动队列、字体引用及保存场景契约。 - 发布页真实两步认证进入主游戏,存档恢复保留领取后的余额;服务偶发超时可重试。 - 自动 25 次启动显示剩余 24,STOP 完成本局后停止;每日领取 +20,000,重复点击无二次入账。 - 内存隔离测试存档完整执行免费触发、8 局转换及结果确认,累计与余额增量一致,自动未恢复;未修改真实存档的概率或免费状态。 - 540×960、390×844、390×640、844×390 检查主控件与常用弹窗边界均在可见区域内。 - 同源独立文档共享存储时,已有独占锁使第二文档抢锁失败,存档未变。集成浏览器新顶层页面使用隔离存储,未将它误认为共享存档测试。 - 主游戏首版输出 build/web-mobile-orchard-delivery;本轮弹窗修正版输出 build/web-mobile-dialog-reference-release,七种状态与视觉差异详见 dialog-reference-review.md。修正版类型检查、106项测试和构建均通过。 无音频素材,音乐和音效仅保存偏好,尚无实际音轨;震动按浏览器能力执行。未构建原生包或进行真机测试。规则中的理论 RTP 保持设计值,不代表本轮完成了正式数学认证。