账号、登录、服务器与角色基础
0. 本篇结论与阅读边界（WEN-8 draft）
本篇是 B1-A 文档整理草稿。固定文档来源为 ec43be0e13c8624cfafd36c0fd803f3b89733fff 的 features/account-server-login.md；原审核声明为 ready_for_split / canonical_candidate，保留为历史事实，整理稿状态为 draft。原规则、参考图和验收清单是候选要求，不能视为已批准规则或已执行验证。账号原 ready_for_split 仅表示已有拆分审核来源，不启动 SDK 实现。
先由基础系统入口查看初始化、入口、红点和开放规则归属，以及来源、合并追溯和待裁定问题。本文负责自己的功能规则；引用其他功能的共用规则时不再复制。代码/配置与游戏运行现状未在本批重新核对，缺证见系统入口。
1. 功能定位
该功能是 Project2 的入口底座，负责客户端启动后的版本校验、账号登录、服务器列表、服务器选择、角色创建/登录、角色快照下发和长连接回调。玩家价值是稳定进入游戏并恢复所有长期数据；业务价值是支撑账号留存、分服运营、版本灰度和后续全部系统初始化。
2. 范围
In Scope：版本请求、登录请求、服务器列表、服务器状态、角色创建、角色登录、角色快照、角色改名、头像修改、心跳/回调、服务器白名单、客户端版本控制。
Out of Scope：单个子系统的具体数据规则、支付账号绑定、客服账号迁移、平台外账号体系。
3. 玩家入口、解锁与提示
玩家启动 App 后进入 loading/login 流程。角色存在则登录，角色不存在则创建角色；服务器状态、白名单、客户端版本和开服时间影响准入。玩家是否可见服务器列表、是否手动选服尚待裁定，不能把“选择或进入”当作同时支持两种模式的已确认需求。
4. 核心玩家流程与登录冲突
下列为固定来源原流程（含选服）的整理保留，不是本批选定的正式规则；第 3、4 步与 ACCOUNT-SERVER-LOGIN-R-002 单服免选服候选冲突。共同部分为启动/版本、会话、服务器准入、角色创建或登录、快照和大厅初始化；服务器准入校验不等于玩家需要手动选服。
- 客户端启动，检查版本和资源。
- 玩家使用 token 或平台账号登录。
- 客户端拉取服务器列表和服务器状态。
- 玩家选择服务器并发起角色登录或创建。
- 后端返回角色基础数据和各系统快照。
- 客户端初始化主界面、模型、红点和长连接。
B1-A-Q01：单服免选服与原流程选服
| 两侧来源 | 固定版本与原审核声明 | 内容与事实边界 |
|---|---|---|
| 本篇原第 3、4 节及第 6.2 节、第 7.1/7.3 节 | ec43be0e13c8624cfafd36c0fd803f3b89733fff；ready_for_split / canonical_candidate | 原流程拉取列表、由玩家选择服务器，UI 覆盖列表；属于候选流程，未取得运行证据 |
本篇 ACCOUNT-SERVER-LOGIN-R-002、操作矩阵、第 6.3 节及第 13 节 | 同一固定版本、同一原审核声明 | 所有玩家同服、页面无需选服；单服规则仍待制作人确认 |
split/task-split.yaml SDK-002 验收、split/task-list.md | 同一固定版本；split reviewed，2026-07-22 / project-hub-codex；producer_approval: pending | 条件化描述单服候选和制作人确认多服后的流程，仅为原审核来源，不裁定冲突、不重发 brief |
影响：玩家进入步骤、服务器列表/选择 UI、准入提示、相关 contract 和埋点验收范围可能不同；原资料的列表/选服不能直接解释为当前游戏已实现能力。待用户裁定：本批目标产品版本采用单服直入还是玩家选服？单服时哪些列表/推荐/选择内容应删除，哪些仅保留服务端准入？若采用选服，需另行确认多服范围、角色列表与 UI，不能在文档整理中扩充。裁定前同时保留原流程和单服候选的来源；不实现双模式、不自行把任何一侧转为批准规则。
5. 核心规则
5.1 登录、服务器与初始化规则
ACCOUNT-SERVER-LOGIN-R-001：登录必须由后端校验 token、设备和服务器合法性。ACCOUNT-SERVER-LOGIN-R-002：当前候选产品规则为所有玩家同服，无需在页面中选择服务器；若后续有多服需求，再增加服务器选择流程。ACCOUNT-SERVER-LOGIN-R-003：服务器可展示、可进入、维护、白名单、审核服、开服时间应由 server service 控制。ACCOUNT-SERVER-LOGIN-R-004：JoinResponse是大厅各模型初始化入口；新增子系统必须明确是否进入角色快照。ACCOUNT-SERVER-LOGIN-R-005：长连接回调不能直接信任客户端本地状态，必须以服务端事件为准。
5.2 角色基础能力入口与校验
ACCOUNT-SERVER-LOGIN-R-006：改名、角色销毁、头像等角色基础能力必须受后端校验。ACCOUNT-SERVER-LOGIN-R-007：改名和改头像功能首次进入游戏即开启，入口位于玩家信息面板。ACCOUNT-SERVER-LOGIN-R-008：玩家可通过玩家信息面板改名按钮执行改名。首次改名免费，之后每次消耗固定数量钻石；钻石不足提示“钻石不足”。
5.3 改名输入与失败反馈
ACCOUNT-SERVER-LOGIN-R-009：名称支持大小写英文字母、数字、简繁体汉字，不支持符号和空格。简繁中文候选上限为 7 个字符，英文候选上限为 15 个字符。ACCOUNT-SERVER-LOGIN-R-010：名称需要校验长度、重复、敏感字符和非法符号。失败提示需区分名称不支持符号或空格、名称过长、名称重复、名称中出现敏感字符；成功提示改名成功。
5.4 头像解锁与展示
ACCOUNT-SERVER-LOGIN-R-011：改头像当前仅支持使用已解锁英雄头像。默认头像为初始英雄头像；英雄解锁后才可作为头像使用。ACCOUNT-SERVER-LOGIN-R-012：头像修改后提示头像已更改；头像列表按英雄 ID 顺序展示，未解锁头像灰化并显示锁头。
5.5 操作矩阵
| 操作 | 关联规则 | 前置条件 | 成功结果 | 失败场景 | 玩家反馈 | 状态权威 |
|---|---|---|---|---|---|---|
| 使用 SDK / token 登录 | ACCOUNT-SERVER-LOGIN-R-001 | 版本、渠道、设备和凭据满足准入 contract | 建立服务端会话并进入服务器准入阶段 | token 失效、渠道或设备不合法、网络超时 | 显示可本地化失败原因，并允许安全重试或重新授权 | Backend |
| 进入目标服务器 | ACCOUNT-SERVER-LOGIN-R-002、ACCOUNT-SERVER-LOGIN-R-003 | 服务器可进入且版本、维护、白名单、开服时间校验通过 | 进入角色创建或角色登录 | 维护、白名单拒绝、版本不匹配、未开服 | 显示对应原因；单服模式不得出现无意义选服步骤 | Backend |
| 创建或登录角色 | ACCOUNT-SERVER-LOGIN-R-004、ACCOUNT-SERVER-LOGIN-R-005 | 会话和服务器准入有效 | 返回角色基础数据与系统快照，客户端完成大厅初始化 | 快照缺字段、重复创建、长连接中断 | 阻止进入不完整大厅，给出重试或重新登录提示 | Backend |
| 修改名称 | ACCOUNT-SERVER-LOGIN-R-006、ACCOUNT-SERVER-LOGIN-R-008 至 ACCOUNT-SERVER-LOGIN-R-010 | 已进入游戏；输入合法；非首次改名时钻石足够 | 名称、消耗和界面展示一致更新 | 钻石不足、名称过长/重复/敏感/含非法字符、重复提交 | 区分失败原因；成功提示“改名成功” | Backend |
| 修改头像 | ACCOUNT-SERVER-LOGIN-R-006、ACCOUNT-SERVER-LOGIN-R-007、ACCOUNT-SERVER-LOGIN-R-011、ACCOUNT-SERVER-LOGIN-R-012 | 已进入游戏且目标英雄头像已解锁 | 当前头像更新并提示“头像已更改” | 头像未解锁、重复提交、会话失效 | 未解锁项保持灰态/锁头；失败不改变当前头像 | Backend |
6. UI 状态与交互
6.1 界面图与交互说明
以下图片为待评审参考图，已按图片锚点和附近文字绑定到页面/状态；状态均为 仅参考，最终布局、尺寸、按钮位置和视觉风格以制作人/UI 评审确认为准。
图 01：常规登录界面
- 图状态：仅参考
- 关联页面 / 状态：常规登录界面
- 关联交互 / 状态说明：常规登录界面；展示游戏logo；展示背景图
图 02：名称钻石修改界面
- 图状态：仅参考
- 关联页面 / 状态：名称钻石修改界面
- 关联交互 / 状态说明：名称钻石修改界面；第二次改名，会出现左侧界面，按钮会标出改名价格；关闭后返回个人信息界面
图 03：个人信息入口
- 图状态：仅参考
- 关联页面 / 状态：个人信息入口
- 关联交互 / 状态说明：Role_01；PortraitUnlock_01；阿扎尔；UI设定；个人信息入口；点击主界面左上角头像，打开个人信息界面；个人信息界面
图 04：个人信息界面
- 图状态：仅参考
- 关联页面 / 状态：个人信息界面
- 关联交互 / 状态说明：个人信息界面；个人信息界面展示玩家当前头像、名称、战斗力、关卡进度；名称更改入口、头像更改入口
图 05：名称免费修改界面
- 图状态：仅参考
- 关联页面 / 状态：名称免费修改界面
- 关联交互 / 状态说明：名称免费修改界面；首次改名免费，点击免费按钮，即可改名；关闭后返回个人信息界面
9 张多目标草稿图因上下文不匹配本功能，未插入本页。 1 张 EMF 格式草稿图因浏览器不可直接显示，暂未映射；如需保留，需先转成 PNG/JPEG。
6.2 页面结构与交互
需要覆盖启动加载、登录中、服务器列表、服务器状态、进入失败、版本过低、维护、白名单拒绝、网络重试和登录超时。所有失败态必须给出玩家可理解提示。
常规登录界面需要展示游戏 logo、背景图、进入游戏前的版本/资源检测进度和当前版本号。若当前版本需要热更新或换包，先进入版本更新流程，成功后再进入登录和主界面。
个人信息入口为主界面左上角头像。个人信息界面展示当前头像、名称、战斗力和关卡进度，并提供名称更改入口和头像更改入口。头像修改界面展示头像预览、当前使用勾选标志、已解锁头像、未解锁灰态/锁头、选中框和解锁途径提示。首次免费改名界面按钮显示免费；后续改名界面按钮显示钻石价格。
6.3 UI 页面状态表
| 页面 / 弹窗 | 状态 | 触发条件 | 可操作项 | 空 / 错误 / 加载表现 |
|---|---|---|---|---|
| 启动 / 版本检测 | 检测中、热更新、需换包、失败、完成 | App 启动或重新检查版本 | 重试、跳转更新、退出 | 展示进度和当前版本；失败时给出可理解原因 |
| SDK 登录 | 未授权、授权中、成功、失败、超时 | 版本检测通过后请求平台授权 | 登录、重试、重新授权 | 授权中禁用重复提交；失败和超时保留恢复入口 |
| 服务器准入 | 单服直入、维护、白名单拒绝、未开服、版本不匹配 | 登录会话建立后 | 进入、重试、返回登录 | 单服直入为候选；列表/选服与原流程冲突，见 B1-A-Q01；错误态显示服务端权威原因 |
| 角色初始化 | 创建中、快照加载中、完成、失败、断线 | 服务器准入通过后 | 重试、重新登录 | 快照不完整时不得进入可交互大厅；长连接失败给出恢复提示 |
| 个人信息 | 加载中、可操作、数据失败 | 点击主界面左上角头像 | 改名、改头像、关闭 | 展示当前头像、名称、战斗力和关卡进度；失败时不展示过期可编辑状态 |
| 改名弹窗 | 首次免费、付费、提交中、校验失败、钻石不足、成功 | 点击名称更改入口 | 输入、确认、取消 | 按失败原因提示；提交中禁止重复点击；关闭后回到个人信息 |
| 头像弹窗 | 当前选中、已解锁可选、未解锁、提交中、成功、失败 | 点击头像更改入口 | 选择、确认、取消 | 未解锁头像灰化并显示锁头；当前头像显示勾选；失败不改变当前头像 |
7. 配置、数据与 Contract
本节只记录策划案需要的逻辑数据与跨部门 contract，不预设物理配置表、协议文件、service 文件或 仓库落点。正式命名、字段名、接口名、协议对象名、文件名和仓库落点进入执行前由 Work Package 的 contract-registry.yaml、execution brief 和对应执行任务确认。
7.1 策划数据需求
策划数据需求只描述逻辑数据域、逻辑字段或规则语义，不等同于配置表字段名、协议字段名或数据库字段名。正式字段命名进入 contract-registry.yaml、execution brief 和对应执行任务确认。
| 数据域 | 逻辑字段 / 规则 | 设计含义 | 必填 / 边界 | 产出责任 |
|---|---|---|---|---|
| 账号登录准入 | token 来源、设备标识、渠道、版本、维护状态、白名单规则 | 定义登录凭据、设备、渠道、客户端版本和准入条件 | 进入执行前补齐默认值、边界和可选性 | Planning / Backend |
| 服务器展示与进入条件 | 服务器名称、展示状态、维护状态、开服时间、审核服、推荐规则 | 定义玩家看到的服务器状态和是否可进入 | 进入执行前补齐默认值、边界和可选性 | Planning / Backend |
| 角色基础资料 | 默认名称、默认头像、改名消耗、名称校验、头像解锁来源 | 定义角色名、头像、改名和头像解锁规则 | 进入执行前补齐默认值、边界和可选性 | Planning |
7.2 运行时数据与接口需求
| Contract | 设计含义 | 使用方 | 说明 |
|---|---|---|---|
| 登录会话 | 校验登录凭据并建立玩家会话 | 服务端 / 客户端 | 服务端校验 token、设备、版本和服务器合法性 |
| 角色快照初始化 | 玩家进入大厅时同步基础数据和子系统快照 | 服务端 / 客户端 | 新增子系统需明确是否进入初始快照 |
| 改名与改头像操作 | 处理角色基础资料变更 | 服务端 / 客户端 | 后端校验消耗、重复名、敏感词和头像拥有状态 |
7.3 跨部门 Contract 命名清单
| Contract 类型 | 逻辑对象 | 命名状态 | 阻塞阶段 | 说明 |
|---|---|---|---|---|
| 配置数据 | 服务器状态、版本准入、改名消耗、头像解锁规则 | 待 PLAN 确认 | PLAN 前 | 不预设物理配置表名 |
| 协议 / API | 登录、进入游戏、心跳、服务器列表、改名、改头像 | 待 PLAN 确认 | 执行前 | 由服务端 / UI brief 确认正式命名 |
| 错误码 | token 失效、服务器维护、白名单拒绝、名称重复、敏感词命中、钻石不足 | 待 PLAN 确认 | 执行前 | 需要对应玩家提示 |
| 语言 Key | 登录失败、维护提示、改名成功/失败、头像更换提示 | 待 PLAN 确认 | 执行前 | 进入语言 brief |
| 埋点事件 | 登录、进入大厅、改名、改头像 | 待 PLAN 确认 | PLAN 前 | 由 analytics 方案确认 |
8. 系统边界
| 方向 | 负责内容 | 备注 |
|---|---|---|
| Planning | 逻辑数据、数值、文本需求、资源需求 | 进入执行前由 PL 任务细化 |
| 服务端 | 协议、校验、持久化、奖励发放、幂等与安全 | 仅相关功能需要 |
| 客户端 | UI、交互、表现、本地状态、红点和跳转 | 仅相关功能需要 |
| 美术 | 图标、模型、特效、音频和导出资源 | 仅相关功能需要 |
| Ops / GM | 后台配置、运营投放、公告、补偿和数据看板 | 仅相关功能需要 |
客户端与表现
AppMain/Infrastructure/LoginAppMain/Features/Loading
美术与音频需求
需要启动加载图、登录背景、服务器状态标识、错误弹窗和重试按钮。账号入口音效按产品要求补充。
9. 数值、经济与奖励
该功能不直接产出经济奖励，但角色创建可能涉及初始资源、初始英雄、初始关卡和新手礼包，需要从角色初始化配置中确认。
10. 异常、安全与运营边界
10.1 异常与安全
账号登录、服务器状态、白名单、版本、角色销毁和生产服务器操作均属于高风险边界。不得由客户端决定角色关键数据。生产服白名单、开服时间、审核状态调整必须人工确认。
10.2 埋点与运营
建议记录启动、版本失败、登录成功/失败、服务器选择、角色创建、进入主界面耗时、断线重连和白名单拒绝。
11. Feature Relations 与回归范围
Feature Relations
| 目标功能 | 关系 | 强度 | 影响 |
|---|---|---|---|
main-entry-red-dot | unlocks | hard | 角色快照和主界面初始化完成后，入口与红点系统才能建立初始状态。 |
character-hero | shares_contract | hard | 初始英雄和英雄解锁状态决定默认头像及可选头像集合。 |
item-resource | shares_contract | hard | 付费改名的钻石消耗必须使用服务端权威资源扣减 contract。 |
analytics-tracking | writes | soft | 启动、授权、登录、进入大厅、改名、改头像和失败原因需要统一埋点语义。 |
| 其余角色子系统 | unlocks | hard | JoinResponse 或等价快照完成后，各系统才能恢复长期数据并进入可交互状态。 |
回归范围
以 Feature Relations 影响功能、核心玩家流程、配置与系统边界为基础；进入执行前由 PLAN / QA brief 细化最小回归范围。
12. 验收标准
12.1 关键验收结论
原文要求新账号、老账号、服务器维护、版本不匹配、白名单限制、断线重连、角色快照初始化和主界面进入均有验证；本批未取得对应执行证据，不表示这些项目已验证通过。新增子系统接入时必须验证 JoinResponse 兼容。
补充验收：首次免费改名、付费改名、钻石不足、名称字符集、长度限制、重复名、敏感字符、改名成功、默认头像、已解锁英雄头像可选、未解锁头像灰态、当前头像勾选和头像修改成功均需验证。
12.2 规则验收清单
-
ACCOUNT-SERVER-LOGIN-R-001：登录必须由后端校验 token、设备和服务器合法性。 -
ACCOUNT-SERVER-LOGIN-R-002：当前候选产品规则为所有玩家同服，无需在页面中选择服务器；若后续有多服需求，再增加服务器选择流程。 -
ACCOUNT-SERVER-LOGIN-R-003：服务器可展示、可进入、维护、白名单、审核服、开服时间应由 server service 控制。 -
ACCOUNT-SERVER-LOGIN-R-004：JoinResponse是大厅各模型初始化入口；新增子系统必须明确是否进入角色快照。 -
ACCOUNT-SERVER-LOGIN-R-005：长连接回调不能直接信任客户端本地状态，必须以服务端事件为准。 -
ACCOUNT-SERVER-LOGIN-R-006：改名、角色销毁、头像等角色基础能力必须受后端校验。 -
ACCOUNT-SERVER-LOGIN-R-007：改名和改头像功能首次进入游戏即开启，入口位于玩家信息面板。 -
ACCOUNT-SERVER-LOGIN-R-008：玩家可通过玩家信息面板改名按钮执行改名。首次改名免费，之后每次消耗固定数量钻石；钻石不足提示“钻石不足”。 -
ACCOUNT-SERVER-LOGIN-R-009：名称支持大小写英文字母、数字、简繁体汉字，不支持符号和空格。简繁中文候选上限为 7 个字符，英文候选上限为 15 个字符。 -
ACCOUNT-SERVER-LOGIN-R-010：名称需要校验长度、重复、敏感字符和非法符号。失败提示需区分名称不支持符号或空格、名称过长、名称重复、名称中出现敏感字符；成功提示改名成功。 -
ACCOUNT-SERVER-LOGIN-R-011：改头像当前仅支持使用已解锁英雄头像。默认头像为初始英雄头像；英雄解锁后才可作为头像使用。 -
ACCOUNT-SERVER-LOGIN-R-012：头像修改后提示头像已更改；头像列表按英雄 ID 顺序展示，未解锁头像灰化并显示锁头。
12.3 执行层验收
- 如填写操作矩阵，成功路径、失败场景、玩家反馈和状态权威均已覆盖。
- 如填写 UI 页面状态表，页面 / 弹窗状态均已覆盖，或明确标记为
N/A。 - Section 7 中标记为 PLAN 前或执行前阻塞的 contract 已在
contract-registry.yaml、execution brief 或执行任务中确认。 - 相关 Feature Relations 回归通过。
13. 待澄清问题 / Open Questions
| 问题 | 类型 | 阻塞程度 | 责任人 | 需确认时间 | 当前处理 |
|---|---|---|---|---|---|
| SDK / token 的渠道范围、游客转正、账号绑定、账号注销和跨设备恢复是否纳入首批交付？ | 规则 / 技术 | blocking | Producer / Planning / Backend / Frontend | PLAN 前 | 由 SDK-001 冻结首批账号 contract；未确认能力不得由实现侧猜测。 |
| 当前单服候选规则是否正式确认；是否保留多服列表、跨服角色列表和选服 UI？ | 规则 / UI | blocking | Producer / Planning | PLAN 前 | 原文按单服候选估算的声明保留为来源；两侧冲突见 B1-A-Q01，本批不做估算或实现授权。 |
| 审核服、灰度服、白名单、维护和开服时间的运营角色、审批与变更入口是什么？ | 运营 / 安全 | blocking | Producer / Ops / Backend | 执行前 | 只定义服务端准入 contract；不得在 planning issue 中修改生产配置或 game-server state。 |
| 改名敏感词库、重复名作用域和字符长度计算口径是什么？ | 规则 / 本地化 | blocking | Producer / Planning / Backend | PLAN 前 | 由 SDK-001 固化逻辑口径、错误码和语言文案 contract。 |
| 登录、个人信息、改名和头像参考图是否作为最终布局基准？ | UI / 美术 | non-blocking | Producer / UI reviewer | UI brief 前 | 当前图片均为 仅参考；实现前需生成 ui-handoff 或记录无需 prefab / art 变更的 Producer-approved rationale。 |
13.1 原 SDK 拆分审核来源（历史声明）
以下保留原拆分声明；本任务仅整理文档，不据此发布 brief、创建实现任务或启动 SDK 执行。历史控制面词汇不改变 WEN-8 的 Linear 原生状态与人工审核流程。
- reviewed split 位于
split/task-split.yaml；SDK reviewed split 任务清单及split/briefs/执行简报提供 Producer review 入口。 SDK-001先冻结 SDK 登录、单/多服、角色基础、错误码和语言 contract；SDK-002与SDK-003只消费已审核 contract，不得从既有代码或配置反推缺失产品规则。SDK-002与SDK-003是两个可独立验收、独立排期和独立回滚的 producer-facing 结果；每个 execution issue 内部可以包含 Planning、Backend、Frontend、Integration 和 QA steps，不按 repo 再拆 issue。- 本次文档 review 不等于 Producer 对 split preview 或产品规则的批准；Producer 点击“开始执行”前不得创建 execution issues。
14. 变更记录
| 日期 | 版本 | 修改人 | 变更摘要 |
|---|---|---|---|
| 2026-10-13 | B1-A draft | AutoDev Symphony | WEN-8 整理规则归属、来源状态与待裁定项；原审核事实保留，不修改游戏行为或发布 SDK brief。 |
| 2026-07-22 | v0.3 | Hub Codex | 补齐操作矩阵、UI 状态矩阵、Feature Relations、阻塞问题与拆分就绪约束，并生成 reviewed split。 |
| 2026-06-16 | v0.2 | Codex | 补充规则编号、操作矩阵、UI 状态表、逻辑字段和执行层验收锚点 |
| 2026-06-16 | v0.1 | Codex | 按新版功能策划案模板重排章节；保留既有规则内容并映射参考图 |
7.1 界面图与交互说明
暂无