# Fruit Pop 游客登录 当前实现登录场景、两步游客认证、本地会话保存、loading 和 Orchard 主游戏。主游戏说明见 orchard-gameplay.md。 ## 场景与美术 - 启动场景为 assets/Welcome.scene;项目设计分辨率为 1080×1920。 - WelcomeComposition 下的 BrandMark、FruitArrangement、GuestAccess 是独立可编辑节点。 - 使用未裁剪透明切图,位置和尺寸来自新版 1080×1920 参考图的多尺度像素匹配。 - OrchardBackdrop 使用装饰背景,位于主体之后;长短屏等比覆盖,不拉伸前景。 - Canvas 保存尺寸为 1080×1920,位置为 (540, 960),根 Widget 已取消旧屏幕尺寸对齐。 - GuestReassurance、PrivacyLink、TermsLink 和 LegalDivider 为独立可编辑文字;链接带下划线。 - 导入后的目录和图片已重新命名;原始美术文件保持不变。 - WelcomeViewport 对长屏固定宽度、短屏固定高度,完整保留画布并避免切图变形。 ## 模块职责 / Module responsibilities - GuestContracts:类型、端口与固定错误消息 / Types, ports and fixed error messages. - GuestSignature:白名单字段的 HMAC-SHA256 签名 / HMAC-SHA256 signing of allowed fields. - GuestHttpClient:请求、响应、超时和取消 / Requests, responses, deadlines and cancellation. - GuestSessionStore:独立身份命名空间及会话提交 / Isolated identity namespace and session persistence. - GuestLoginService:两步认证编排 / Two-step authentication orchestration. - GuestLoginPresenter:交互状态、防连点及生命周期 / Interaction state, duplicate-click prevention and lifecycle. - GuestRuntime:连接平台、配置与依赖 / Connect platform capabilities, configuration and dependencies. - GuestLoginView:场景控件绑定与展示 / Scene bindings and state rendering. - GuestLegalLinks:法律链接独立交互,未配置网址时仅提示 / Independent legal links with honest missing-URL feedback. - WelcomeLayoutAuthoring:显式编辑校准,不在运行时生成界面 / Explicit editor calibration without runtime UI generation. - WelcomeViewport:画布适配 / Viewport adaptation. ## 协议与配置 按已确认要求沿用参考项目 HTTPS 服务、VeryWellSlots 服务端 pkg 与本机签名配置。 本机 common-key/common_key.json 已复制至本项目并加入忽略规则;测试不读取该文件。 1. POST /account/v2/guest/login:携带 X-Timestamp、X-Nonce、X-Sign,不携带 Authorization。 2. POST /account/login:使用同一个 guest_id 与 pkg,不携带签名头,取得完整 token 后保存。 签名使用 LF 分隔的六行,空 uid 为第五行;字段按键排序、false 参与签名、无额外 URL 编码。 每次按钮登录重新认证;游客身份保持不变,nonce 重新生成,不复用缓存 token 作为认证成功。 本地存储前缀为 fruit-pop.auth,按服务地址与产品隔离。重登失败不覆盖旧成功会话。 首次调用者拥有同一服务实例的合并请求及其取消信号;界面层禁止并发提交。 点击游客按钮后由独立 StartupLoadingView 展示同场景 loading 层。认证成功时发出不含 token 的 guest-authenticated 事件;默认继续准备游戏,纯认证模式收满后恢复 Signed in successfully. 落点并发出 startup-preparation-ready 事件。 默认等待认证成功、存档恢复和 Orchard 场景依赖后自动切入游戏;关闭 transitionToGame 可保留纯认证模式。详见 startup-loading.md。 ## 验证记录 - pnpm@11.17.0 安装;类型检查、离线行为测试与布局契约测试。 - web-mobile 发布构建成功,输出 build/web-mobile-guest-login。 - 发布页真实游客认证:两步接口均 HTTP 200,界面进入认证成功状态,身份与保存会话一致。 - 真实服务存在响应波动,后续一次请求达到超时;按钮恢复可重试,不把失败显示为成功。 - 发布页注入验签失败响应:固定提示、恢复按钮、旧会话保留;测试完成恢复真实网络实现。 - 540×960、390×844、390×640 及横向窗口完成运行时结构检查,切图不拉伸且完整可见。 当前验收范围为网页发布版。没有生成原生子工程或 Android 安装包;原生安全随机、网络适配及真机验证留到对应阶段。 客户端签名材料会进入编译产物;忽略本机文件只防止误提交,不表示客户端密钥不可提取。 ## 新版参考图修复 - 改用完整装饰背景,重新校准 Logo、水果和更宽的游客按钮。 - 加入 No account needed 和法律链接;尚无真实政策网址时显示固定提示,不虚构跳转。 - 登录状态提示移至说明文字与法律链接之间。 - 已同步保存画布与项目设计分辨率;类型、布局和行为验证在本轮重新执行。 - 最终发布目录为 build/web-mobile-welcome-revised;类型检查和 15 项测试全部通过。 - 新版发布页两步真实游客认证均返回 HTTP 200,认证完成状态和会话保存通过核对。 - 540×960、390×844、390×640 核对前景完整、不变形、背景覆盖完整;法律链接点击提示正确。 - 自动验收页处于隐藏状态时会暂停帧回调,仅测试页面临时恢复调度;该处理未进入项目代码或构建产物。 - 旧输出目录重建曾因 ENOTEMPTY 失败;改用新的最终目录成功构建,未删除旧产物。