修复(半自动履约): 虎牙UID改为必填不校验
This commit is contained in:
@@ -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 和角色名/,
|
||||
)
|
||||
})
|
||||
})
|
||||
|
||||
@@ -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,
|
||||
|
||||
@@ -257,10 +257,12 @@ export function normalizeOrderNo(value: unknown): string {
|
||||
|
||||
/** 客户资料以 TASK_SELECT 合并后的字段为准:优先任务表,回退工单资料。 */
|
||||
export function hasCustomerProfile(
|
||||
task: Pick<TaskRow, 'customer_game_role' | 'customer_server_zone'>,
|
||||
task: Pick<TaskRow, 'customer_game_id' | 'customer_game_role' | 'customer_server_zone'>,
|
||||
): 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
|
||||
|
||||
@@ -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虎牙用户')
|
||||
|
||||
@@ -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({
|
||||
<p>
|
||||
{profileComplete
|
||||
? '修改目标角色资料后会重新核对虎牙账号当前绑定角色;角色名与区服一致后才能确认绑定。'
|
||||
: '第一步:请填写区服和角色名。游戏角色 UID 为选填资料,不参与绑定核验。'}
|
||||
: '第一步:请填写区服、游戏角色 UID 和角色名。UID 只做资料留档,不参与绑定核验。'}
|
||||
</p>
|
||||
<div className="customer-profile-form">
|
||||
<label className="customer-collect-label">
|
||||
@@ -1234,12 +1231,14 @@ export default function CustomerFulfillmentPage({
|
||||
placeholder="请选择区服"
|
||||
options={SERVER_ZONE_OPTIONS.map((value) => ({ value, label: value }))}
|
||||
/>
|
||||
<label className="customer-collect-label">游戏角色 UID(选填)</label>
|
||||
<label className="customer-collect-label">
|
||||
游戏角色 UID <span>*</span>
|
||||
</label>
|
||||
<Input
|
||||
className="customer-collect-input"
|
||||
value={profileRoleId}
|
||||
onChange={(event) => setProfileRoleId(event.target.value)}
|
||||
placeholder="选填,仅用于订单资料留档"
|
||||
placeholder="请输入游戏角色 UID,仅作资料留档"
|
||||
maxLength={64}
|
||||
inputMode="numeric"
|
||||
/>
|
||||
@@ -1587,7 +1586,7 @@ export default function CustomerFulfillmentPage({
|
||||
<strong>{currentRoleName || '未识别到角色'}</strong>
|
||||
</div>
|
||||
<div>
|
||||
<span>目标角色 UID(选填)</span>
|
||||
<span>目标角色 UID</span>
|
||||
<strong>{targetRoleUid || '未填写'}</strong>
|
||||
</div>
|
||||
{pendingRoleName ? (
|
||||
@@ -2005,7 +2004,7 @@ export default function CustomerFulfillmentPage({
|
||||
>
|
||||
<Space direction="vertical" size={14} style={{ width: '100%' }}>
|
||||
<p style={{ margin: 0 }}>
|
||||
请核对角色名称与区服。游戏角色 UID 为选填留档,不参与绑定判定。
|
||||
请核对角色名称与区服。游戏角色 UID 为必填留档,不参与绑定判定。
|
||||
</p>
|
||||
<div className="customer-binding-compare">
|
||||
<div className="customer-binding-compare-side">
|
||||
@@ -2016,7 +2015,7 @@ export default function CustomerFulfillmentPage({
|
||||
</Button>
|
||||
</div>
|
||||
<strong>{bindingComparison?.customerRoleName || '未填写'}</strong>
|
||||
<em>{bindingComparison?.customerRoleId || '未填写游戏角色 UID(不影响绑定)'}</em>
|
||||
<em>{bindingComparison?.customerRoleId || '未填写游戏角色 UID'}</em>
|
||||
</div>
|
||||
<div className="customer-binding-compare-side">
|
||||
<div className="customer-binding-compare-head">
|
||||
|
||||
@@ -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 <span>*</span>'))
|
||||
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('平台已返回加密角色标识'))
|
||||
|
||||
@@ -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'))
|
||||
|
||||
@@ -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 未调用 |
|
||||
|
||||
+19
-16
@@ -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_*` 字段的删除迁移。
|
||||
|
||||
Reference in New Issue
Block a user