Files
2026-11-20 20:32:40 +08:00

44 lines
4.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 保持设计值,不代表本轮完成了正式数学认证。