# 应用类型与登录规则

平台标识platform与登录方式loginMethod分开保存，但当前产品按发行平台固定对应，不由操作系统或快捷方式决定，不新增登录方式或自动合并账号。

| 应用类型/入口 | platform | loginMethod | 登录规则 |
|---|---|---|---|
| TapTap内H5 | taptap | taptap | 优先自动登录，需要时TapTap官方授权；tap.login→code2Session→自定义会话 |
| TapTap小游戏 | taptap | taptap | 平台登录；tap.login→code2Session→自定义会话 |
| TapTap桌面发行端 | taptap | taptap | 优先自动登录，需要时TapTap客户端或官方登录页，按该运行环境官方协议验身 |
| TapTap游戏桌面快捷入口 | taptap | taptap | 沿用实际打开的游戏运行环境，不绕过登录和读档 |
| 微信小游戏及桌面图标 | wechat | wechat | 优先自动登录，必要时按微信运行环境走官方登录/授权 |
| 独立App | app | password | 登录名密码注册/登录 |

TapTap发行的桌面程序不能仅因在电脑运行就归为App密码登录；独立App仍为登录名密码。非TapTap发行的App形态游戏保留原有app/password要求，游戏与独立非游戏App公共服务仍分开。

## 交互与官方授权

登录交互规则：微信小游戏（含桌面图标）、TapTap内H5、TapTap桌面发行端与桌面快捷入口优先校验/复用有效登录态并自动登录；无有效登录态或平台要求授权时，允许走对应平台官方流程。TapTap可按实际运行环境跳转TapTap客户端或官方登录页，完成后回到游戏；微信小游戏使用其实际微信运行环境允许的官方登录/授权，不擅自改成网站扫码OAuth。需要官方授权不等于登录失败，不禁止必要的官方登录按钮/页面，也不强制每次重复授权。取消、认证失败或读档失败时仅提供实际状态及重新登录/重试，不提供密码、游客、试玩或离线兜底。TapTap桌面发行端仍是taptap/taptap，微信桌面图标仍是wechat/wechat；操作系统和快捷方式不决定登录方式。TapTap小游戏保留平台登录，独立App仍为app/password及登录名密码。后端必须验证真实凭据、会话和进度归属，不信任客户端自报成功；给出前端配合契约，不擅自修改未授权业务工程。

TapTap平台内H5与TapTap小游戏使用tap.login()取得一次性code，经自己的游戏后端与公共服务调用code2Session（jscode2session）验身并建立自定义会话。其他桌面运行环境必须按实际平台官方支持的凭据和服务端验身协议接入，不强套H5 API，不编造授权地址或回调。桌面快捷入口沿用实际打开的运行环境。平台密钥和session_key只留后端，不下发或直接作为业务会话；上述受门禁约束的入口须后端认证及在线读档成功才进入。

自动登录中、需要官方登录/授权、等待授权返回、后端认证中、在线读档中、错误/重试与可进入应分别处理。缺少可自动使用的凭据不是只能报错的终态，允许提供必要的官方登录按钮。授权返回后验证真实凭据与业务会话，不能只根据客户端成功标记进入游戏。

## 在线进度门禁

在线入口门禁（强制适用于微信小游戏及其桌面图标、TapTap内H5、TapTap桌面发行端及桌面快捷入口）：优先自动登录；需要用户操作时走对应平台官方登录/授权，返回后由后端验证凭据并建立有效业务会话，成功读取本人在线进度后才能进入游戏。需要授权是合法中间状态，允许显示官方登录入口；不能把打开授权页或前端声称成功当作认证完成。取消/拒绝授权、认证失败或读档失败时留在门禁外，显示真实状态和重新登录/重试，禁止本机试玩、游客、离线降级、缓存或默认空档绕过，所有路由与快捷入口都受同一门禁约束。读档失败不等于新玩家；仅服务端确认新玩家后完成受控幂等在线初始化，确认在线初始进度可用后进入。会话失效停止依赖身份的玩法和进度写入，重新认证并读取/核对在线进度后恢复，不无限重试或反复初始化。独立App仍使用登录名密码，本次不为App新增云存档。详见共享目录docs/在线登录与进度门禁.md。规则发布不代表具体游戏已完成联调。

完整状态及失败处理见[在线登录与进度门禁](在线登录与进度门禁.md)。TapTap小游戏保留原有平台登录要求，本轮不额外扩大其在线读档门禁。不得把进度接口缺失当成新玩家，不以本地缓存代替服务端确认。

## 后端开发边界

后端开发角色交付官方授权、凭据提交、后端认证、在线读档、会话失效恢复的前端配合契约，不擅自修改其他业务工程。类型明确不再询问是否改用其他登录；配置冲突报告并纳入目标工程计划。

仅允许现有password/wechat/taptap三种登录方式，不增加手机号、验证码、邮箱、游客或密码备用入口。账号隔离、统一用户ID公式保持不变。底层API可选范围不构成启用许可。

本次规则不新增运行API字段、数据库字段或平台枚举，不部署服务。具体桌面授权协议及真实凭据获取必须按实际平台官方能力核验；安装和角色问答不代表真实平台联调成功。