From ac004fc4420b4d3c77d76a25307e296cbe577c9e Mon Sep 17 00:00:00 2001 From: yml Date: Fri, 20 Nov 2026 17:11:39 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D(=E5=8D=8A=E8=87=AA=E5=8A=A8?= =?UTF-8?q?=E5=B1=A5=E7=BA=A6):=20=E5=AE=A2=E6=88=B7=E7=BB=91=E5=AE=9A?= =?UTF-8?q?=E9=A1=B5=E4=B8=8D=E5=86=8D=E5=B1=95=E7=A4=BA=E8=99=8E=E7=89=99?= =?UTF-8?q?UID?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../CustomerFulfillmentPage.tsx | 44 ++----------------- ...stomer-fulfillment-binding-compare.test.ts | 7 ++- docs/履约配置/虎牙绑定协议解码与角色UID.md | 16 ++++--- docs/统一订单履约与财务模型-权威版.md | 9 ++-- 4 files changed, 24 insertions(+), 52 deletions(-) diff --git a/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx b/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx index c194fc29..51498b3f 100644 --- a/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx +++ b/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx @@ -1050,19 +1050,6 @@ export default function CustomerFulfillmentPage({ const pendingRoleName = bindingInfo?.pendingBindGameRole || selectedTask?.pendingBindGameRole || '' const bindingRoleName = pendingRoleName || currentRoleName - const accountUid = String(selectedTask?.huyaUid || '').trim() - const platformRoleUid = String( - bindingInfo?.platformGameRoleUid || selectedTask?.platformGameRoleUid || '', - ).trim() - const pendingPlatformRoleUid = String( - bindingInfo?.pendingPlatformGameRoleUid || selectedTask?.pendingPlatformGameRoleUid || '', - ).trim() - const targetRoleUid = String( - bindingComparison?.customerRoleId || selectedTask?.customerGameRoleId || '', - ).trim() - const platformRoleUidReference = platformRoleUid - ? `平台角色 UID ${platformRoleUid}` - : '平台未返回绑定角色 UID,当前仅按角色名与区服核验' const rebindUnchanged = bindingInfo?.rebindUnchanged === true // 换绑被虎牙拒绝或未生效时展示失败原因;若客户已把资料改成与平台当前角色一致, // 比对为 match,则回到正常提交流程,不再显示换绑失败。 @@ -1577,30 +1564,16 @@ export default function CustomerFulfillmentPage({ {bindingInfo?.bindGameAccount || selectedTask.bindGameAccount || '未获取'} -
- 虎牙账号 UID - {accountUid || '未获取'} -
当前绑定角色 {currentRoleName || '未识别到角色'}
-
- 目标角色 UID - {targetRoleUid || '未填写'} -
{pendingRoleName ? (
本次待确认角色 {pendingRoleName}
) : null} - {pendingPlatformRoleUid ? ( -
- 待确认角色 UID - {pendingPlatformRoleUid} -
- ) : null} ) : null} @@ -1811,14 +1784,9 @@ export default function CustomerFulfillmentPage({ 平台角色:{bindingComparison.boundZone || '区服未知'} ·{' '} {bindingComparison.boundRoleName || '角色未知'} - {platformRoleUid ? 平台角色 UID:{platformRoleUid} : null} - {pendingPlatformRoleUid ? ( - 待确认角色 UID:{pendingPlatformRoleUid} - ) : null} 已填资料:{bindingComparison.customerZone || '区服未填'} ·{' '} - {bindingComparison.customerRoleName || '角色未填'}(UID{' '} - {targetRoleUid || '未填'}) + {bindingComparison.customerRoleName || '角色未填'} 角色名称与区服一致后才能确认绑定;请重新扫码换绑,或上一步修改资料。 @@ -1840,11 +1808,7 @@ export default function CustomerFulfillmentPage({ type="success" showIcon message={bindingRoleName ? `已识别角色:${bindingRoleName}` : '已识别绑定角色'} - description={[ - bindingInfo?.bindGameAccount, - bindingInfo?.bindGameChannel, - targetRoleUid ? `目标角色 UID ${targetRoleUid}` : '', - ] + description={[bindingInfo?.bindGameAccount, bindingInfo?.bindGameChannel] .filter(Boolean) .join(' · ')} /> @@ -2015,7 +1979,7 @@ export default function CustomerFulfillmentPage({ {bindingComparison?.customerRoleName || '未填写'} - {bindingComparison?.customerRoleId || '未填写游戏角色 UID'} + {bindingComparison?.customerZone || '区服未填写'}
@@ -2030,7 +1994,7 @@ export default function CustomerFulfillmentPage({
{bindingComparison?.boundRoleName || '未识别到角色'} - {platformRoleUidReference} + {bindingComparison?.boundZone || '区服未识别'}
diff --git a/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts b/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts index 36dd4f23..e75cf171 100644 --- a/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts +++ b/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts @@ -92,7 +92,12 @@ test('二维码区明确只核验角色名与区服,UID 不参与绑定', () = assert.ok(source.includes('扫码后系统只核对角色名称与区服,UID 不参与绑定判定')) assert.ok(source.includes('游戏角色 UID 为必填留档,不参与绑定判定')) assert.ok(source.includes('本次待确认角色')) - assert.ok(source.includes('虎牙账号 UID')) + assert.ok(source.includes('登录账号')) + assert.ok(source.includes('当前绑定角色')) + assert.ok(!source.includes('虎牙账号 UID')) + assert.ok(!source.includes('目标角色 UID')) + assert.ok(!source.includes('待确认角色 UID')) + assert.ok(!source.includes('平台角色 UID:')) assert.ok(!source.includes('平台已返回加密角色标识')) assert.ok(!source.includes('平台加密标识已识别')) assert.ok(!source.includes('const bindingPendingUid')) diff --git a/docs/履约配置/虎牙绑定协议解码与角色UID.md b/docs/履约配置/虎牙绑定协议解码与角色UID.md index 30283ecb..811a09de 100644 --- a/docs/履约配置/虎牙绑定协议解码与角色UID.md +++ b/docs/履约配置/虎牙绑定协议解码与角色UID.md @@ -2,13 +2,13 @@ type: external-platform-protocol-reference description: 虎牙绑定 WUP/TAF 解码、角色字段、换绑时间与游戏角色 UID 边界。 status: reference -version: 1.2 +version: 1.3 updated_at: 2026-11-20 evidence_har: 11.20-虎牙换绑角色-1.har evidence_sha256: da089fb13d21ce120e1e6cdc522b456e2dfeae144e1f4a69916ebde025684a6e --- -# 虎牙绑定协议解码与角色 UID 参考 v1.2 +# 虎牙绑定协议解码与角色 UID 参考 v1.3 > 本文是外部平台协议和排障参考,不定义订单、履约、成本或财务业务口径。 > 业务口径仍以 [统一订单履约与财务模型-权威版](../统一订单履约与财务模型-权威版.md) 为准。 @@ -28,7 +28,7 @@ evidence_sha256: da089fb13d21ce120e1e6cdc522b456e2dfeae144e1f4a69916ebde025684a6 ### 2.1 本文版本 -当前版本:`1.2`。 +当前版本:`1.3`。 版本规则: @@ -319,10 +319,10 @@ gameOpenId | 身份 | 来源 | 用途 | 是否可展示 | | --- | --- | --- | --- | -| 虎牙账号 UID | 登录 Cookie / 登录响应 | WUP 请求身份 | 可展示账号 UID | +| 虎牙账号 UID | 登录 Cookie / 登录响应 | WUP 请求身份 | 客户页不展示,后台可展示 | | 虎牙 `roleId` | `gameRole.roleId` | 平台前后角色一致性判断 | 不展示 | -| 客户游戏角色 UID | 客户填写 | 必填订单资料,仅校验非空,不参与绑定核验 | 可展示为目标 UID | -| 平台游戏角色 UID | `gameSerial` / `extendInfo` 明确数值字段 | 可选观测和展示,不参与绑定门禁 | 仅真实返回时展示 | +| 客户游戏角色 UID | 客户填写 | 必填订单资料,仅校验非空,不参与绑定核验 | 客户页面不展示,后台可留档 | +| 平台游戏角色 UID | `gameSerial` / `extendInfo` 明确数值字段 | 可选观测和留档,不参与绑定门禁 | 客户页不展示,后台仅真实返回时展示 | | 腾讯 `gameRoleStr.roleId` | 腾讯角色接口 | 候选真实 UID,仅可选留档 | 需要先抓包确认 | 当前自动比对规则: @@ -333,7 +333,8 @@ gameOpenId 4. 客户 UID 与平台数值角色 UID 不同时,不影响角色名和区服决定的绑定结果。 5. 加密 `roleId` 只用于判断 current 与 pending 是否变化。 6. 没有真实平台 UID 时不得伪造,也不得声称已经拿到平台角色 UID。 -7. 平台数值 UID 可以展示和留档,但不得改变角色名、区服决定的绑定结果。 +7. 平台数值 UID 可以在后台展示和留档,但不得改变角色名、区服决定的绑定结果。 +8. 客户绑定页只展示登录账号名称、当前角色名和必要的待确认角色名,不展示任何账号或角色 UID 值。 只读审计命令: @@ -430,6 +431,7 @@ gameRoleStr | 版本 | 日期 | 变更 | | --- | --- | --- | +| 1.3 | 2026-11-20 | 客户绑定页移除虎牙账号 UID、目标角色 UID、平台角色 UID 和待确认角色 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 未调用 | diff --git a/docs/统一订单履约与财务模型-权威版.md b/docs/统一订单履约与财务模型-权威版.md index f9515a9a..fc0d7180 100644 --- a/docs/统一订单履约与财务模型-权威版.md +++ b/docs/统一订单履约与财务模型-权威版.md @@ -3,7 +3,7 @@ type: 权威架构与实施计划 description: 订单、内部 SKU、履约路由、履约执行、商品、成本与财务的唯一权威口径及重构计划。 tags: [订单, 内部SKU, 履约, 商品, 成本, 财务, 迁移] status: authoritative -version: 2.34 +version: 2.35 updated_at: 2026-11-20 --- @@ -756,9 +756,10 @@ has_active_cost - 虎牙三步进度固定为「填写游戏资料 → 登录虎牙账号 → 绑定游戏角色」,当前步骤高亮,已完成为勾选。 - 客户必填区服、游戏角色 UID 和角色名,未填全时不展示虎牙登录和绑定二维码;UID 只做非空校验和资料留档, 不校验格式或真实值。 -- 绑定角色页分别展示虎牙账号 UID、当前平台角色、本次待确认角色与客户资料;自动判定固定只比较角色名与 - 平台区服,角色名和区服一致才允许确认绑定。客户游戏角色 UID、平台可能返回的数值角色 UID 都不参与 - 绑定 verdict,也不与虎牙账号 UID 或加密 role token 比较;数值 UID 可展示和留档,不得把加密 role token +- 绑定信息区只展示登录虎牙账号名称、当前平台角色名,以及存在时的待确认角色名;客户页面不得展示 + 虎牙账号 UID、客户填写 UID、平台角色 UID 或待确认角色 UID。自动判定固定只比较角色名与平台区服, + 角色名和区服一致才允许确认绑定。客户游戏角色 UID、平台可能返回的数值角色 UID 都不参与绑定 verdict, + 也不与虎牙账号 UID 或加密 role token 比较;这些 UID 可在后台留档和排障,不得把加密 role token 显示成 UID; 不一致时固定显示「重新扫码换绑」「上一步修改资料」,换绑后仍不一致时以修改资料为主。 - 微博登录成功后直接展示微信/QQ 绑定入口;平台返回已绑定角色时直接进入等待客服,