# 合成大福来 · v2.0需求与运行说明

## 产品与主题
面向TOP登陆少年粉丝的合成水果H5游戏。保留粉色韩系波点、原三列与手机竖屏布局、用户提供的六张原始PNG,新增透明杨桃与椰子素材。文案包含“陪TOP纠缠到世界毁灭”“TransfOrm Project”“要一起见证沸腾人生”“福来生成记”“把每一次相遇,都变成更远大前程的起点”。

本版新增共享账号、战绩与排行榜,需要网络与服务端,不再是完全离线单机版。依照用户确认,采用普通玩家注册登录并公开给粉丝;微信登录暂不接入。首次创建玩家账号,设置昵称并选择头像;个人资料中可修改昵称或上传头像。

## 游戏规则
水果等级依次为西瓜、橘子、苹果、蓝莓、柠檬、杨桃、椰子、山竹。相同水果碰撞升级,支持连锁;不同水果只发生碰撞。前五级逐级缩小,山竹保持原最大尺寸;杨桃、椰子、山竹只由合成获得。动态掉落三个阶段的基础权重分别为70/25/4.3/0.5/0.2%、63/27/8.5/1/0.5%、55/30/12/2/1%,重复时轻微降权;柠檬始终保留正概率。生成橘子/苹果/蓝莓/柠檬/杨桃/椰子/山竹分别得10/25/60/150/220/300/400分。

显示半尺寸38/54/72/92/116/146,均为第一版2倍。根据果肉主体校准圆形碰撞体,不将PNG透明画布、叶片和梗当成实心碰撞区;保留原图字节与比例。容器360×560、警戒线y=104;新投放入场保护,持续越线1.5秒判负。大水果出生区受阻时从容器上方入场;上方入口也受阻时不消费水果。

手机按住拖动至少6个屏幕像素再松手投放,轻点不投放;多指不抢占,取消、失去捕获、切后台和重开取消手势。电脑左键或方向键+空格/回车。投放冷却420ms。固定240Hz、每步12轮求解、速度限制、摩擦与边界保护优先保证稳定。碰撞体为果肉圆形近似,不承诺每个凹凸边缘完全吻合。

## 结算与音效
合成一个山竹(主题名大福来)即胜利,结算语“恭喜你登陆成功”。失败结算语“这局不算”。合成弹跳、扩散与分数动画保留。
- 不同等级的有效撞击:duang,限流避免静止堆叠连续发声。
- 相同水果合成:魔法音效。
- 最终生成大福来:英文nice音效(本地合成语音WAV)。
- 失败结束:电量耗尽式下降音效。
音效总开关保留,取消音色试听选择。后台暂停游戏模拟与音效上下文。

## BGM
右上角改为背景音乐播放器,支持歌单切换、播放/暂停、单曲循环、音量,和游戏音效开关分开。歌单由bgm.json配置,使用用户提供的歌曲名与可播放音频直链;当前尚未收到实际歌曲和音源,歌单为空并明确提示,不能宣称已接入TOP歌曲。可先选择本地音乐,不上传本地音频。浏览器需要玩家点击播放,音源访问限制及自动播放限制应显示提示。

## 玩家账号与头像
新玩家只需填写不重名的昵称(1—16字)和恰好6位数字密码,可保留开头的0;昵称作为登录名,不再填写单独账号。默认自动选择一个小熊头像,注册时也可切换。旧账号及原密码继续兼容,旧战绩、福来数与耍赖卡保留。密码服务端采用PBKDF2 SHA-256、独立随机盐与100000轮;会话令牌使用随机值、哈希存储,HttpOnly/Secure/SameSite=Lax Cookie,有效期30天。写接口校验同源与玩家归属,注册/登录限流。昵称头像会展示于排行榜。未配置邮箱重置或微信OAuth,不提供假微信登录入口。

系统头像为黄色、蓝色、红色、橙色、绿色、紫色六种不同熊身配色。在注册页和个人资料均可切换,上传自定义头像后也可以随时切回任一种系统头像。上传图片由浏览器裁成192×192 WebP,最大64KB,存入R2。昵称、账号、统计与会话存入D1。退出不清除服务器存档;重新登录可恢复最近同步的活跃局。

## 福来统计与耍赖卡
服务器验证结算成功后,累计福来数+1,重复提交同一局不重复奖励。每累计5个尚未用于兑换的福来,可手动兑换1张耍赖卡,累计总数保留;“已用于兑换数”单独记录。兑换请求有幂等编号,防止重试重复兑换。

结算保存后,可使用1张卡清空盘面重来,起始累计分=上一局的累计结算分,新局再得分继续累加。每局只能创建一次续局,重复操作不重复扣卡。胜利或失败后均可使用。普通重开从0分开始;使用卡和普通重开的区别在结算页明确展示。保存战绩期间禁用重开,避免奖励尚未保存就被放弃。

## 排行榜与校验
共享排行榜展示前10位玩家头像、昵称、最高累计结算分。每位玩家只占一条,分数降序,同分按首次达到该分的时间、玩家ID排序;不展示账号或密码数据,不填充虚拟玩家。

随机种子由服务端产生,客户端记录带物理步编号的投放。服务器以同一物理引擎重放校验,忽略客户端声称的得分;约每5秒同步,单批最多7200步。网络积压超过30秒暂停模拟,等待同步。断点保存、结算奖励、兑换、扣卡均校验身份与幂等。此机制防止直接修改提交分数和重复领奖,不等同完整反机器人系统。

## 部署与文件
前端dist/;后端worker/api.mjs;数据库db/schema.ts,Drizzle生成迁移位于drizzle/;scripts/build.mjs打包单Worker并内嵌静态原图,避免外部素材依赖。D1逻辑绑定DB、R2逻辑绑定BUCKET。构建npm run build;部署沿用现有Sites项目。source.zip由服务端按当前源码生成,包含前后端、原始素材、迁移和测试,不包含运行数据或密钥。

本版使用普通玩家账号是用户确认的登录方案;站点平台的管理与访问控制继续由Sites维护。公开访问按用户明确授权设置。

## 验收边界
自动化覆盖见测试报告。浏览器实机触控、听感和视觉表现仍需真实设备验收;当前没有受支持cua_repl.js,未绕用其他浏览器工具。TOP歌曲接入等待用户音源;微信登录按用户选择暂不实施。

昵称用作登录标识,修改后用新昵称登录。昵称键按NFKC与小写规范化,避免兼容字符及大小写造成重名;新增可空唯一字段保留旧账号数据,不回填或删除已有玩家。旧账号可在登录页使用原账号和原密码。