diff --git a/apps/backend/src/services/semi-auto/semi-auto-binding-role.test.ts b/apps/backend/src/services/semi-auto/semi-auto-binding-role.test.ts index d36993ef..121bb276 100644 --- a/apps/backend/src/services/semi-auto/semi-auto-binding-role.test.ts +++ b/apps/backend/src/services/semi-auto/semi-auto-binding-role.test.ts @@ -49,12 +49,13 @@ describe('区服解析', () => { describe('虎牙角色比对', () => { it('角色名和区服一致即可确认,客户角色 UID 不与账号 UID 或加密 token 比对', () => { - const result = compareBindingRole(task('落地盒子怪cc', '4212063544', '安卓Q区'), { + const result = compareBindingRole(task('落地盒子怪cc', 'uid-not-number', '安卓Q区'), { bindGameRole: '落地盒子怪cc', bindGameRoleToken: HUYA_ROLE_TOKEN, bindGameChannel: '安卓(android) · QQ', }) assert.equal(result.verdict, 'match') + assert.equal(result.customerRoleId, 'uid-not-number') assert.equal(result.boundRoleIdKind, 'huya_role_token') assert.equal(result.verificationBasis, 'role_name_zone') }) @@ -143,24 +144,43 @@ describe('虎牙角色比对', () => { }) describe('客户角色资料校验', () => { - it('角色名和区服齐全时,游戏角色 UID 可以留空', () => { + it('游戏角色 UID 必填但不校验格式', () => { + assert.throws( + () => + normalizeCustomerProfile({ + roleName: '落地盒子怪cc', + roleId: ' ', + serverZone: '安卓Q区', + }), + /请完整填写区服、游戏角色 UID 和角色名/, + ) + const profile = normalizeCustomerProfile({ roleName: '落地盒子怪cc', - roleId: '', + roleId: 'uid-not-number', serverZone: '安卓Q区', }) assert.deepEqual(profile, { roleName: '落地盒子怪cc', - roleId: '', + roleId: 'uid-not-number', serverZone: '安卓Q区', }) assert.equal( hasCustomerProfile({ + customer_game_id: 'uid-not-number', customer_game_role: '落地盒子怪cc', customer_server_zone: '安卓Q区', }), true, ) + assert.equal( + hasCustomerProfile({ + customer_game_id: '', + customer_game_role: '落地盒子怪cc', + customer_server_zone: '安卓Q区', + }), + false, + ) }) it('清理空白并保留纯数字游戏角色 UID', () => { @@ -176,13 +196,6 @@ describe('客户角色资料校验', () => { }) }) - it('游戏角色 UID 非数字时拒绝保存', () => { - assert.throws( - () => normalizeCustomerProfile({ roleName: '落地盒子怪cc', roleId: 'abc123' }), - /只能是数字/, - ) - }) - it('缺区服时拒绝保存', () => { assert.throws( () => normalizeCustomerProfile({ roleName: '落地盒子怪cc', roleId: '4212063544' }), @@ -193,7 +206,7 @@ describe('客户角色资料校验', () => { it('角色名称为空时拒绝保存', () => { assert.throws( () => normalizeCustomerProfile({ roleName: ' ', roleId: '', serverZone: '安卓Q区' }), - /请完整填写区服和角色名/, + /请完整填写区服、游戏角色 UID 和角色名/, ) }) }) diff --git a/apps/backend/src/services/semi-auto/semi-auto-customer-service.ts b/apps/backend/src/services/semi-auto/semi-auto-customer-service.ts index aa79719f..32f5ce55 100644 --- a/apps/backend/src/services/semi-auto/semi-auto-customer-service.ts +++ b/apps/backend/src/services/semi-auto/semi-auto-customer-service.ts @@ -111,20 +111,14 @@ export function normalizeCustomerProfile(input: CustomerProfileInput = {}) { const serverZone = String(input.serverZone ?? '') .trim() .slice(0, 100) - if (roleId && !/^\d+$/.test(roleId)) { - throw createHttpError('游戏角色 UID 只能是数字', { - statusCode: 400, - errorCode: 'semi_auto_profile_role_id_invalid', - }) - } if (!CUSTOMER_SERVER_ZONES.has(serverZone)) { throw createHttpError('区服只能选择 苹果Q区 / 苹果V区 / 安卓Q区 / 安卓V区', { statusCode: 400, errorCode: 'semi_auto_profile_server_zone_invalid', }) } - if (!roleName || !serverZone) { - throw createHttpError('请完整填写区服和角色名', { + if (!roleName || !roleId || !serverZone) { + throw createHttpError('请完整填写区服、游戏角色 UID 和角色名', { statusCode: 400, errorCode: 'semi_auto_profile_required', }) @@ -134,7 +128,8 @@ export function normalizeCustomerProfile(input: CustomerProfileInput = {}) { /** * 半自动订单没有 work_orders,客户资料在授权页 /c/<订单号>(虎牙)或 /d/<订单号>(微博)收集。 - * 虎牙先保存目标角色名和区服,再登录账号;游戏角色 UID 可选留档,不参与绑定核验。 + * 虎牙先保存目标角色名、区服和 UID,再登录账号;UID 只做资料收集,不校验格式, + * 也不参与绑定核验。 */ export async function savePublicTaskProfile( orderNoInput: unknown, diff --git a/apps/backend/src/services/semi-auto/semi-auto-task-core.ts b/apps/backend/src/services/semi-auto/semi-auto-task-core.ts index 9fc2726f..ab7b3d3d 100644 --- a/apps/backend/src/services/semi-auto/semi-auto-task-core.ts +++ b/apps/backend/src/services/semi-auto/semi-auto-task-core.ts @@ -257,10 +257,12 @@ export function normalizeOrderNo(value: unknown): string { /** 客户资料以 TASK_SELECT 合并后的字段为准:优先任务表,回退工单资料。 */ export function hasCustomerProfile( - task: Pick, + task: Pick, ): boolean { return Boolean( - String(task.customer_game_role || '').trim() && String(task.customer_server_zone || '').trim(), + String(task.customer_game_id || '').trim() && + String(task.customer_game_role || '').trim() && + String(task.customer_server_zone || '').trim(), ) } @@ -431,7 +433,12 @@ export function displayStatus(task: TaskRow, decision = resolveTaskHuyaBindingDe return status('processing', '处理中', 'operator', '客服继续履约') } if (bindingPolicy.requiresCustomerProfile && !hasCustomerProfile(task)) { - return status('waiting_profile', '待客户填写资料', 'customer', '客户填写区服和角色名') + return status( + 'waiting_profile', + '待客户填写资料', + 'customer', + '客户填写区服、游戏角色 UID 和角色名', + ) } if (task.login_status === 'authenticated') { if (task.platform === 'huya' && decision) { @@ -747,7 +754,7 @@ export function assertHuyaTask(task: TaskRow) { /** * 半自动订单没有工单时,客户资料在登录后由 /c/<订单号> 收集; * 任务表为空但工单素材已有资料时,TASK_SELECT 会合并回退字段。 - * 进入绑定/确认/换绑前必须已有角色名和区服;游戏角色 UID 可选。 + * 进入绑定/确认/换绑前必须已有角色名、区服和 UID;UID 不参与绑定核验。 */ export function assertCustomerProfileReady(task: TaskRow) { if (!getAccountBindingPolicy(task.platform).requiresCustomerProfile) return diff --git a/apps/backend/src/services/semi-auto/semi-auto-task.integration.test.ts b/apps/backend/src/services/semi-auto/semi-auto-task.integration.test.ts index 7f8ccdac..c31f2fd0 100644 --- a/apps/backend/src/services/semi-auto/semi-auto-task.integration.test.ts +++ b/apps/backend/src/services/semi-auto/semi-auto-task.integration.test.ts @@ -1394,11 +1394,20 @@ test( orderId = result.orderId configId = result.configId + await expectErrorCode( + () => + savePublicTaskProfile(orderNo, result.taskId, { + roleName: 'Mock虎牙角色', + serverZone: '安卓V区', + }), + 'semi_auto_profile_required', + ) const saved = await savePublicTaskProfile(orderNo, result.taskId, { roleName: 'Mock虎牙角色', + roleId: 'UID-not-number', serverZone: '安卓V区', }) - assert.equal(saved.task.customerGameRoleId, '') + assert.equal(saved.task.customerGameRoleId, 'UID-not-number') assert.equal(saved.task.loginStatus, 'waiting_login') assert.equal(saved.task.displayStatus.label, '等待客户授权') @@ -1427,7 +1436,7 @@ test( assert.equal(tasks[0]?.executionStatus, 'waiting_customer') assert.equal(tasks[0]?.displayStatus.label, '等待客户绑定角色') assert.equal(tasks[0]?.customerGameRoleName, 'Mock虎牙角色') - assert.equal(tasks[0]?.customerGameRoleId, '') + assert.equal(tasks[0]?.customerGameRoleId, 'UID-not-number') assert.equal(tasks[0]?.credentialSource, 'sms') assert.ok(tasks[0]?.huyaUid) assert.equal(tasks[0]?.platformNickname, 'Mock虎牙用户') diff --git a/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx b/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx index c23e5cbd..c194fc29 100644 --- a/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx +++ b/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx @@ -116,10 +116,11 @@ export default function CustomerFulfillmentPage({ ), ) const isWeibo = selectedTask?.platform === 'weibo' - // 虎牙流程:填写资料(区服/角色名,UID 可选)→ 登录 → 绑定角色。 + // 虎牙流程:填写资料(区服/UID/角色名)→ 登录 → 绑定角色。 // 资料齐全前不生成绑定二维码,避免客户在资料缺失时先绑错角色。 const profileComplete = Boolean( String(selectedTask?.customerServerZone || '').trim() && + String(selectedTask?.customerGameRoleId || '').trim() && String(selectedTask?.customerGameRoleName || '').trim(), ) @@ -930,18 +931,14 @@ export default function CustomerFulfillmentPage({ async function handleSaveProfile() { if (!selectedTask) return - if (!profileServerZone.trim() || !profileRoleName.trim()) { - message.warning('请完整填写区服和角色名') + if (!profileServerZone.trim() || !profileRoleId.trim() || !profileRoleName.trim()) { + message.warning('请完整填写区服、游戏角色 UID 和角色名') return } if (!SERVER_ZONE_OPTIONS.includes(profileServerZone.trim())) { message.warning('请选择区服') return } - if (profileRoleId.trim() && !/^\d+$/.test(profileRoleId.trim())) { - message.warning('游戏角色 UID 只能是数字') - return - } setProfileSaving(true) try { const response = await saveCustomerTaskProfile(orderNo, selectedTask.id, { @@ -1220,7 +1217,7 @@ export default function CustomerFulfillmentPage({

{profileComplete ? '修改目标角色资料后会重新核对虎牙账号当前绑定角色;角色名与区服一致后才能确认绑定。' - : '第一步:请填写区服和角色名。游戏角色 UID 为选填资料,不参与绑定核验。'} + : '第一步:请填写区服、游戏角色 UID 和角色名。UID 只做资料留档,不参与绑定核验。'}

- 目标角色 UID(选填) + 目标角色 UID {targetRoleUid || '未填写'}
{pendingRoleName ? ( @@ -2005,7 +2004,7 @@ export default function CustomerFulfillmentPage({ >

- 请核对角色名称与区服。游戏角色 UID 为选填留档,不参与绑定判定。 + 请核对角色名称与区服。游戏角色 UID 为必填留档,不参与绑定判定。

@@ -2016,7 +2015,7 @@ export default function CustomerFulfillmentPage({
{bindingComparison?.customerRoleName || '未填写'} - {bindingComparison?.customerRoleId || '未填写游戏角色 UID(不影响绑定)'} + {bindingComparison?.customerRoleId || '未填写游戏角色 UID'}
diff --git a/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts b/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts index ca706b41..36dd4f23 100644 --- a/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts +++ b/apps/frontend/tests/customer-fulfillment-binding-compare.test.ts @@ -50,17 +50,18 @@ test('虎牙客户页固定先填写资料,再登录并绑定角色', () => { assert.ok(source.includes('(isWeibo || profileComplete) &&')) }) -test('资料完整只要求区服和角色名,游戏角色 UID 可选', () => { +test('资料完整要求区服、角色名和 UID,但 UID 不做格式校验', () => { const profileStart = source.indexOf('const profileComplete = Boolean(') const profileEnd = source.indexOf('\n\n const load =', profileStart) const profileSource = source.slice(profileStart, profileEnd) assert.ok(profileSource.includes('customerServerZone')) + assert.ok(profileSource.includes('customerGameRoleId')) assert.ok(profileSource.includes('customerGameRoleName')) - assert.ok(!profileSource.includes('customerGameRoleId')) - assert.ok(source.includes('请完整填写区服和角色名')) - assert.ok(source.includes('游戏角色 UID 为选填资料,不参与绑定核验')) - assert.ok(source.includes('游戏角色 UID(选填)')) - assert.ok(source.includes('if (profileRoleId.trim() && !/^\\d+$/.test(profileRoleId.trim()))')) + assert.ok(source.includes('请完整填写区服、游戏角色 UID 和角色名')) + assert.ok(source.includes('UID 只做资料留档,不参与绑定核验')) + assert.ok(source.includes('游戏角色 UID *')) + assert.ok(!source.includes('游戏角色 UID 只能是数字')) + assert.ok(!source.includes('!/^\\d+$/.test(profileRoleId.trim())')) }) test('登录和绑定专用同步阶段暂停整单轮询', () => { @@ -89,7 +90,7 @@ test('角色名和区服一致才出现确认绑定,不一致时展示原因', test('二维码区明确只核验角色名与区服,UID 不参与绑定', () => { assert.ok(source.includes('扫码后系统只核对角色名称与区服,UID 不参与绑定判定')) - assert.ok(source.includes('游戏角色 UID 为选填留档,不参与绑定判定')) + assert.ok(source.includes('游戏角色 UID 为必填留档,不参与绑定判定')) assert.ok(source.includes('本次待确认角色')) assert.ok(source.includes('虎牙账号 UID')) assert.ok(!source.includes('平台已返回加密角色标识')) diff --git a/apps/frontend/tests/customer-fulfillment-rebind-return.test.ts b/apps/frontend/tests/customer-fulfillment-rebind-return.test.ts index ccba5c6f..1f6ca480 100644 --- a/apps/frontend/tests/customer-fulfillment-rebind-return.test.ts +++ b/apps/frontend/tests/customer-fulfillment-rebind-return.test.ts @@ -39,7 +39,7 @@ test('取消直接使用原角色的快捷确认路径', () => { test('点击上一步修改资料会回到第一步并隐藏绑定区', () => { // 步骤条把编辑资料视为第一步,即使资料原本已完整。 assert.ok(source.includes('profileEditing || !profileComplete')) - assert.ok(source.includes("'第一步:请填写区服和角色名")) + assert.ok(source.includes("'第一步:请填写区服、游戏角色 UID 和角色名")) assert.ok(source.includes('返回绑定角色')) // 资料步骤隐藏二维码、失败提示和比对操作,避免与第二步混在一起。 assert.ok(source.includes('!profileEditing')) diff --git a/docs/履约配置/虎牙绑定协议解码与角色UID.md b/docs/履约配置/虎牙绑定协议解码与角色UID.md index 5b4c42de..30283ecb 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.1 +version: 1.2 updated_at: 2026-11-20 evidence_har: 11.20-虎牙换绑角色-1.har evidence_sha256: da089fb13d21ce120e1e6cdc522b456e2dfeae144e1f4a69916ebde025684a6e --- -# 虎牙绑定协议解码与角色 UID 参考 v1.1 +# 虎牙绑定协议解码与角色 UID 参考 v1.2 > 本文是外部平台协议和排障参考,不定义订单、履约、成本或财务业务口径。 > 业务口径仍以 [统一订单履约与财务模型-权威版](../统一订单履约与财务模型-权威版.md) 为准。 @@ -28,7 +28,7 @@ evidence_sha256: da089fb13d21ce120e1e6cdc522b456e2dfeae144e1f4a69916ebde025684a6 ### 2.1 本文版本 -当前版本:`1.1`。 +当前版本:`1.2`。 版本规则: @@ -321,17 +321,19 @@ gameOpenId | --- | --- | --- | --- | | 虎牙账号 UID | 登录 Cookie / 登录响应 | WUP 请求身份 | 可展示账号 UID | | 虎牙 `roleId` | `gameRole.roleId` | 平台前后角色一致性判断 | 不展示 | -| 客户游戏角色 UID | 客户填写 | 可选订单资料留档 | 可展示为目标 UID | +| 客户游戏角色 UID | 客户填写 | 必填订单资料,仅校验非空,不参与绑定核验 | 可展示为目标 UID | | 平台游戏角色 UID | `gameSerial` / `extendInfo` 明确数值字段 | 可选观测和展示,不参与绑定门禁 | 仅真实返回时展示 | | 腾讯 `gameRoleStr.roleId` | 腾讯角色接口 | 候选真实 UID,仅可选留档 | 需要先抓包确认 | 当前自动比对规则: -1. 角色名和区服必须一致。 -2. 客户游戏角色 UID 和平台数值角色 UID 都不参与绑定 verdict;UID 缺失、不同或未返回都不阻断绑定。 -3. 加密 `roleId` 只用于判断 current 与 pending 是否变化。 -4. 没有真实 UID 时不得伪造,也不得声称已经拿到平台角色 UID。 -5. 平台数值 UID 可以展示和留档,但不得改变角色名、区服决定的绑定结果。 +1. 客户必须填写角色名、区服和游戏角色 UID;UID 为空时不能进入登录或绑定阶段。 +2. 角色名和平台区服必须一致,才能通过自动绑定判定。 +3. 客户游戏角色 UID 只校验非空,不校验数字格式或真实值,也不参与绑定 verdict。 +4. 客户 UID 与平台数值角色 UID 不同时,不影响角色名和区服决定的绑定结果。 +5. 加密 `roleId` 只用于判断 current 与 pending 是否变化。 +6. 没有真实平台 UID 时不得伪造,也不得声称已经拿到平台角色 UID。 +7. 平台数值 UID 可以展示和留档,但不得改变角色名、区服决定的绑定结果。 只读审计命令: @@ -428,5 +430,6 @@ gameRoleStr | 版本 | 日期 | 变更 | | --- | --- | --- | +| 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 26c5b218..f9515a9a 100644 --- a/docs/统一订单履约与财务模型-权威版.md +++ b/docs/统一订单履约与财务模型-权威版.md @@ -3,7 +3,7 @@ type: 权威架构与实施计划 description: 订单、内部 SKU、履约路由、履约执行、商品、成本与财务的唯一权威口径及重构计划。 tags: [订单, 内部SKU, 履约, 商品, 成本, 财务, 迁移] status: authoritative -version: 2.33 +version: 2.34 updated_at: 2026-11-20 --- @@ -318,16 +318,16 @@ manual fulfillment - 半自动任务必须在 manual 渠道判定、人工配置保存/重匹配或 Carrier 补配成功后按订单项主动物化, 不能依赖客户先打开 `/c/<订单号>` 或客服先打开半自动任务列表。后台和客户页的幂等回填仅作为兜底。 - 虎牙客户页流程固定为「填写资料 → 登录虎牙账号 → 绑定角色 → 客服处理」: - ① 必填资料为区服和角色名,二者必须先保存;未填全时不得展示虎牙登录或生成绑定二维码, - 页面状态显示「待客户填写资料」。游戏角色 UID 是选填订单资料,不阻断登录、绑定或完成履约; + ① 客户资料必填区服、游戏角色 UID 和角色名,三项齐全后才能展示虎牙登录或生成绑定二维码, + 页面状态显示「待客户填写资料」。游戏角色 UID 只校验非空,不校验数字格式或真实值; ② 虎牙账号 UID(`huya_uid`)只用于 WUP/RPC 请求身份,与客户填写的游戏角色 UID 没有任何对应关系, 禁止互相回退或比较; ③ 虎牙 `gameRole.roleId` 是 40 位加密 opaque token,只可在 Connector 内部用于判断前后两次查询 是否仍是同一角色;客户页、管理端和历史摘要不得展示该标识,也不得把它当角色 UID; - ④ 客户填写的游戏角色 UID 只作可选留档;平台返回 `gameSerial` 或 `gameRole.extendInfo` 中明确的 - 数值角色 UID 时,可分别保存到 `platform_game_role_uid` / `pending_platform_game_role_uid` - 供展示和排障,但不得纳入绑定 verdict。当前实际响应可能不返回独立数值 UID,页面不得由加密 token、 - 账号 UID 或客户 UID 互相回填; + ④ 客户填写的游戏角色 UID 必填留档,但不参与绑定 verdict;平台返回 `gameSerial` 或 + `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`。 @@ -405,8 +405,9 @@ manual fulfillment - 半自动履约状态采用与斗鱼领取一致的同步原则:客户操作、Connector 回调和后台操作都是状态快照输入, 统一由一个状态收敛服务在任务行锁内写入正式字段并追加事件;多个入口不得各自拼接或覆盖状态。 - 账号绑定能力由平台声明,不由页面或业务服务按平台散落判断。虎牙、斗鱼、微博均为 `game_role`: - 虎牙必需字段为 `roleName / serverZone`;客户游戏角色 UID 和平台可能返回的独立数值游戏角色 UID - 都只作可选留档,不启用额外 `roleId` 核验,`gameRole.roleId` 加密 token 本身也不参与客户资料比对; + 虎牙客户资料收集必须有 `roleName / roleId / serverZone`,其中 `roleId` 只校验非空; + 绑定比对仍固定只使用 `roleName / serverZone`。客户游戏角色 UID 和平台可能返回的独立数值游戏角色 UID + 都不启用额外核验,`gameRole.roleId` 加密 token 本身也不参与客户资料比对; 斗鱼必需字段 `roleName / serverZone`,由 live-hub 查询和提交换绑; 微博必需字段 `roleName`,由 order_site 查询,微信/QQ 扫码完成绑定或换绑,不要求客户重复填写角色资料。 公共策略还必须声明 `confirmationMode` 与 `rebindMode`:虎牙、斗鱼为客户资料比对确认, @@ -753,7 +754,8 @@ has_active_cost ``` - 虎牙三步进度固定为「填写游戏资料 → 登录虎牙账号 → 绑定游戏角色」,当前步骤高亮,已完成为勾选。 -- 必填资料为区服和角色名,未填全时不展示虎牙登录和绑定二维码;游戏角色 UID 为选填留档,不影响门禁。 +- 客户必填区服、游戏角色 UID 和角色名,未填全时不展示虎牙登录和绑定二维码;UID 只做非空校验和资料留档, + 不校验格式或真实值。 - 绑定角色页分别展示虎牙账号 UID、当前平台角色、本次待确认角色与客户资料;自动判定固定只比较角色名与 平台区服,角色名和区服一致才允许确认绑定。客户游戏角色 UID、平台可能返回的数值角色 UID 都不参与 绑定 verdict,也不与虎牙账号 UID 或加密 role token 比较;数值 UID 可展示和留档,不得把加密 role token @@ -1214,8 +1216,9 @@ pending 角色快照、`role_identity_source` 与 `verification_basis`。 加密 role token 与数值角色 UID 是两个独立字段,任何情况下都不得互相回填。数值角色 UID 仅作可选展示和 排障留档,不进入绑定 verdict。 迁移 `169` 增加客户游戏角色资料字段(`customer_game_role_name` / `customer_game_role_id` / -`customer_game_server_zone`),并允许从工单素材回退合并;其中角色名和区服必填,`customer_game_role_id` -为可选留档。客户页流程收敛为「填写资料 → 登录 → 绑定角色」,必填资料未填全不得展示登录或绑定二维码。 +`customer_game_server_zone`),并允许从工单素材回退合并;当前客户资料要求角色名、UID 和区服三项齐全, +其中 `customer_game_role_id` 只校验非空,不校验格式。客户页流程收敛为 +「填写资料 → 登录 → 绑定角色」,必填资料未填全不得展示登录或绑定二维码。 迁移 `170` 增加半自动全链路报文日志,客户页、管理端和外部 Connector 共用同一追踪口径; 虎牙角色自动比对固定为角色名与区服;账号 UID、加密 role token、客户游戏角色 UID、平台数值角色 UID 四类身份禁止混用,后两者不参与绑定门禁。 @@ -1239,8 +1242,8 @@ pending 角色快照、`role_identity_source` 与 `verification_basis`。 6. 半自动平台负责客户登录、账号 CK 获取和游戏角色绑定;微博支持手机号登录、易盾二次验证、 完整域名 Cookie 保存、会话恢复、游戏角色查询和微信/QQ 扫码绑定;虎牙支持客户手动触发的 短信验证码登录和扫码登录。 - 虎牙客户必须先填写区服 / 角色名,再登录账号并进入绑定;游戏角色 UID 可选留档,虎牙账号 UID - 只用于登录请求。角色名与平台区服一致后,客户确认本次 pending 角色才可提交平台绑定;客户填写的 - UID 与平台可能返回的数值角色 UID 不参与自动判定。不一致时只能重新扫码换绑或返回上一步修改资料, - 不提供直接使用原角色的快捷确认。 + 虎牙客户必须先填写区服 / 游戏角色 UID / 角色名,再登录账号并进入绑定;客户 UID 必填但不校验格式, + 虎牙账号 UID 只用于登录请求。角色名与平台区服一致后,客户确认本次 pending 角色才可提交平台绑定; + 客户填写的 UID 与平台可能返回的数值角色 UID 不参与自动判定。不一致时只能重新扫码换绑或返回 + 上一步修改资料,不提供直接使用原角色的快捷确认。 7. 观察期结束后,再单独发布兼容表、旧脚本别名和 `legacy_*` 字段的删除迁移。