优化(半自动履约): 精简虎牙扫码与绑定确认流程

This commit is contained in:
yml
2026-11-20 17:44:31 +08:00
parent ac004fc442
commit 0982993a6d
9 changed files with 364 additions and 353 deletions
@@ -335,6 +335,8 @@ gameOpenId
6. 没有真实平台 UID 时不得伪造,也不得声称已经拿到平台角色 UID。
7. 平台数值 UID 可以在后台展示和留档,但不得改变角色名、区服决定的绑定结果。
8. 客户绑定页只展示登录账号名称、当前角色名和必要的待确认角色名,不展示任何账号或角色 UID 值。
9. 第一步提交的角色名、区服和平台是唯一目标;验证一致时只显示页内
「确认绑定这个角色到虎牙」,不再弹核对弹窗,任一不一致时不显示确认按钮。
只读审计命令:
@@ -431,7 +433,7 @@ gameRoleStr
| 版本 | 日期 | 变更 |
| --- | --- | --- |
| 1.3 | 2026-11-20 | 客户绑定页移除虎牙账号 UID、目标角色 UID、平台角色 UID 和待确认角色 UID 展示,仅保留账号名称、角色名与区服 |
| 1.3 | 2026-11-20 | 客户绑定页改用深色紧凑二维码卡片并移除全部 UID 展示;取消确认弹窗,仅在第一资料与平台角色名、区服、平台一致时显示页内确认按钮 |
| 1.2 | 2026-11-20 | 客户游戏角色 UID 恢复为必填资料,但只校验非空;UID 格式、真实值和平台数值 UID 均不参与绑定核验 |
| 1.1 | 2026-11-20 | 业务核验规则收口为角色名和平台区服;客户游戏角色 UID 改为可选留档,平台数值角色 UID 只作可选观测,均不参与绑定门禁 |
| 1.0 | 2026-11-20 | 建立文档;完整解析虎牙绑定 WUP/TAF;确认 `roleId` 为不透明 token、`gameSerial` 和 `extendInfo` 为空;修正 `changeBindTime` 为下一次可换绑时间;确认腾讯侧存在 `gameRoleStr` 角色接口但本 HAR 未调用 |
@@ -3,7 +3,7 @@ type: 权威架构与实施计划
description: 订单、内部 SKU、履约路由、履约执行、商品、成本与财务的唯一权威口径及重构计划。
tags: [订单, 内部SKU, 履约, 商品, 成本, 财务, 迁移]
status: authoritative
version: 2.35
version: 2.36
updated_at: 2026-11-20
---
@@ -328,11 +328,13 @@ manual fulfillment
`gameRole.extendInfo` 中明确的数值角色 UID 时,可分别保存到 `platform_game_role_uid` /
`pending_platform_game_role_uid` 供展示和排障,同样不参与绑定门禁。当前实际响应可能不返回独立
数值 UID,页面不得由加密 token、账号 UID 或客户 UID 互相回填;
⑤ 客户确认前必须通过 outer/inner 双路查询得到本次 pending 角色;确认绑定必须先呈现 pending 角色,
自动判定固定只比较角色名与平台区服,客户明确提交后才调用 `confirmBindActAccount`,写后回查
current 角色与 pending 的角色名、区服和 role token 一致才能进入 `binding_status = confirmed`。
确认请求必须携带页面已核对的角色名、role token 与渠道快照,Connector 发现 pending 已变化时
拒绝写入;轮询和二维码刷新不得自动提交平台写操作。
⑤ 客户确认前必须通过 outer/inner 双路查询得到本次 pending 角色;第一步提交的角色名、区服和平台
是唯一目标资料,自动判定只比较这三项对应的角色名与平台区服。三项一致时,页面直接展示唯一主操作
「确认绑定这个角色到虎牙」,不得再弹出二次核对弹窗;任一项不一致时不得展示确认绑定按钮,只能
重新扫码换绑或修改资料。客户明确点击后才调用 `confirmBindActAccount`,写后回查 current 角色与
pending 的角色名、区服和 role token 一致才能进入 `binding_status = confirmed`。确认请求必须携带
页面已核对的角色名、role token 与渠道快照,Connector 发现 pending 已变化时拒绝写入;轮询和二维码
刷新不得自动提交平台写操作。
- 角色不一致时客户页固定提供两个动作:「重新扫码换绑」和「上一步修改资料」。
平台已有旧角色导致首次不一致、扫码绑定后不一致、换绑被虎牙拒绝或未生效时,以重新扫码换绑为主;
换绑后仍不一致时以「上一步修改资料」为主。取消「直接使用原角色」的快捷确认:
@@ -758,7 +760,8 @@ has_active_cost
不校验格式或真实值。
- 绑定信息区只展示登录虎牙账号名称、当前平台角色名,以及存在时的待确认角色名;客户页面不得展示
虎牙账号 UID、客户填写 UID、平台角色 UID 或待确认角色 UID。自动判定固定只比较角色名与平台区服,
角色名和区服一致才允许确认绑定。客户游戏角色 UID、平台可能返回的数值角色 UID 都不参与绑定 verdict,
角色名、区服和平台信息一致时,页面只显示「确认绑定这个角色到虎牙」一个主操作,不再使用确认弹窗;
任一项不一致时不显示确认按钮。客户游戏角色 UID、平台可能返回的数值角色 UID 都不参与绑定 verdict,
也不与虎牙账号 UID 或加密 role token 比较;这些 UID 可在后台留档和排障,不得把加密 role token
显示成 UID;
不一致时固定显示「重新扫码换绑」「上一步修改资料」,换绑后仍不一致时以修改资料为主。