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 121bb276..c1a875b1 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 @@ -90,6 +90,16 @@ describe('虎牙角色比对', () => { assert.match(result.message, /区服/) }) + it('平台系统不一致时禁止确认', () => { + const result = compareBindingRole(task('落地盒子怪cc', '4212063544', '苹果Q区'), { + bindGameRole: '落地盒子怪cc', + bindGameRoleToken: HUYA_ROLE_TOKEN, + bindGameChannel: '安卓(android) · QQ', + }) + assert.equal(result.verdict, 'mismatch') + assert.match(result.message, /区服/) + }) + it('平台区服无法解析时判 unknown', () => { const result = compareBindingRole(task('落地盒子怪cc', '4212063544', '安卓Q区'), { bindGameRole: '落地盒子怪cc', diff --git a/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx b/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx index 51498b3f..65a5837e 100644 --- a/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx +++ b/apps/frontend/src/pages/customer-fulfillment/CustomerFulfillmentPage.tsx @@ -1,11 +1,12 @@ import { CheckCircleFilled, + CopyOutlined, ExclamationCircleOutlined, LoadingOutlined, QrcodeOutlined, ReloadOutlined, } from '@ant-design/icons' -import { App, Alert, Button, Image, Input, Modal, Select, Space, Spin } from 'antd' +import { App, Alert, Button, Image, Input, Select, Space, Spin } from 'antd' import QRCode from 'qrcode' import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from 'react' import { useLocation, useNavigate, useParams } from 'react-router' @@ -82,7 +83,6 @@ export default function CustomerFulfillmentPage({ const [huyaChallengeLoading, setHuyaChallengeLoading] = useState(false) const [bindingInfo, setBindingInfo] = useState(null) const [bindingLoading, setBindingLoading] = useState(false) - const [bindingConfirmOpen, setBindingConfirmOpen] = useState(false) const [bindingSecondsLeft, setBindingSecondsLeft] = useState(0) const [bindingQrImage, setBindingQrImage] = useState('') const [profileRoleName, setProfileRoleName] = useState('') @@ -94,7 +94,6 @@ export default function CustomerFulfillmentPage({ const lastBindingRefreshAtRef = useRef(0) const resettingBindingRef = useRef(false) const hydratingBindingRef = useRef(false) - const autoOpenedRoleRef = useRef('') const redirectingRef = useRef(false) const weiboBindingSyncRef = useRef(false) // Connector 重启或会话被回收后,绑定/确认接口会返回 huya_native_session_not_found。 @@ -188,11 +187,9 @@ export default function CustomerFulfillmentPage({ setSmsCountdown(0) setHuyaChallenge(null) setBindingInfo(null) - setBindingConfirmOpen(false) startingBindingRef.current = false lastBindingRefreshAtRef.current = 0 hydratingBindingRef.current = false - autoOpenedRoleRef.current = '' weiboBindingSyncRef.current = false setBindingSessionExpired(false) setBindingLoadError('') @@ -365,7 +362,6 @@ export default function CustomerFulfillmentPage({ } catch (error) { if (isConnectorSessionExpired(error)) { setBindingSessionExpired(true) - setBindingConfirmOpen(false) return } // 非会话错误不要静默:二维码区域会展示可重试的错误,避免一直转圈。 @@ -441,20 +437,6 @@ export default function CustomerFulfillmentPage({ selectedTask?.platform, ]) - useEffect(() => { - if (!bindingDecision?.canConfirmBinding) return - const key = `${selectedTask.id}:${ - bindingInfo?.pendingBindGameRoleToken || - bindingInfo?.bindGameRoleToken || - selectedTask.pendingBindGameRoleToken || - selectedTask.bindGameRoleToken || - '' - }` - if (autoOpenedRoleRef.current === key) return - autoOpenedRoleRef.current = key - setBindingConfirmOpen(true) - }, [bindingDecision, bindingInfo, selectedTask?.id]) - useEffect(() => { const url = bindingInfo?.qrUrl if (!url) { @@ -497,7 +479,6 @@ export default function CustomerFulfillmentPage({ setBindingSessionExpired(false) setBindingLoadError('') setBindingInfo(null) - setBindingConfirmOpen(false) setBindingSecondsLeft(0) window.scrollTo({ top: 0, behavior: 'smooth' }) } catch (error) { @@ -636,7 +617,6 @@ export default function CustomerFulfillmentPage({ ) setBindingInfo(response.data.binding) setBindingLoadError('') - setBindingConfirmOpen(false) const nextDecision = response.data.binding?.bindingDecision || response.data.task.bindingDecision if ( @@ -646,13 +626,10 @@ export default function CustomerFulfillmentPage({ nextDecision?.flowState === 'manual_review' ) { message.warning(nextDecision.message) - } else if (nextDecision?.canConfirmBinding) { - setBindingConfirmOpen(true) } } catch (error) { if (isConnectorSessionExpired(error)) { setBindingSessionExpired(true) - setBindingConfirmOpen(false) message.warning( selectedTask.platform === 'weibo' ? '微博登录已失效,请重新登录' @@ -678,11 +655,9 @@ export default function CustomerFulfillmentPage({ ) setBindingInfo(response.data.binding) setBindingLoadError('') - setBindingConfirmOpen(false) } catch (error) { if (isConnectorSessionExpired(error)) { setBindingSessionExpired(true) - setBindingConfirmOpen(false) message.warning('微博登录已失效,请重新登录') return } @@ -706,7 +681,7 @@ export default function CustomerFulfillmentPage({ ) } - async function handlePollBindingNow(openConfirm = false) { + async function handlePollBindingNow() { if (!selectedTask) return setBindingLoading(true) try { @@ -719,10 +694,8 @@ export default function CustomerFulfillmentPage({ setBindingLoadError('') if (selectedTask.platform === 'huya' && nextDecision) { if (nextDecision.canConfirmBinding) { - setBindingConfirmOpen(true) return } - setBindingConfirmOpen(false) if (nextDecision.flowState === 'confirmed') { message.success('平台绑定已确认,等待客服处理') return @@ -760,7 +733,6 @@ export default function CustomerFulfillmentPage({ return } // 微博仍以平台事实状态展示。 - if (openConfirm) setBindingConfirmOpen(false) const detail = nextBinding?.message || '' if (nextTask.bindingStatus === 'confirmed') { message.success('微博角色已绑定,等待客服处理') @@ -774,7 +746,6 @@ export default function CustomerFulfillmentPage({ } catch (error) { if (isConnectorSessionExpired(error)) { setBindingSessionExpired(true) - setBindingConfirmOpen(false) message.warning( selectedTask.platform === 'weibo' ? '微博登录已失效,请重新登录' @@ -801,7 +772,6 @@ export default function CustomerFulfillmentPage({ setTasks((current) => current.map((task) => (task.id === nextTask.id ? nextTask : task))) if (nextBinding) setBindingInfo(nextBinding) setBindingLoadError('') - setBindingConfirmOpen(false) if ( nextDecision?.flowState === 'rebind_blocked_account' || nextDecision?.flowState === 'rebind_blocked_target_role' || @@ -811,14 +781,12 @@ export default function CustomerFulfillmentPage({ return } if (nextDecision?.canConfirmBinding) { - message.success('已识别本次待确认角色,请核对后再确认绑定') return } message.info('尚未识别到新的待确认角色,请重新选择并刷新') } catch (error) { if (isConnectorSessionExpired(error)) { setBindingSessionExpired(true) - setBindingConfirmOpen(false) message.warning('虎牙登录会话已过期,请重新登录') return } @@ -858,7 +826,6 @@ export default function CustomerFulfillmentPage({ current.map((task) => (task.id === response.data.task.id ? response.data.task : task)), ) setBindingInfo(response.data.binding) - setBindingConfirmOpen(false) const nextDecision = response.data.binding?.bindingDecision || response.data.task.bindingDecision if (nextDecision?.flowState === 'confirmed') { @@ -874,11 +841,10 @@ export default function CustomerFulfillmentPage({ } catch (error) { if (isConnectorSessionExpired(error)) { setBindingSessionExpired(true) - setBindingConfirmOpen(false) message.warning('虎牙登录会话已过期,请重新登录') return } - message.error(error instanceof Error ? error.message : '提交平台绑定失败') + message.error(error instanceof Error ? error.message : '确认绑定失败') } finally { setBindingLoading(false) } @@ -892,9 +858,8 @@ export default function CustomerFulfillmentPage({ async function openProfileEditor() { if (!selectedTask) return if (resettingBindingRef.current) return - setBindingConfirmOpen(false) setProfileEditing(true) - // 资料步骤会隐藏绑定二维码与比对区,等 React 完成切换后再回到第一步顶部。 + // 资料步骤会隐藏绑定二维码与操作区,等 React 完成切换后再回到第一步顶部。 window.setTimeout(() => { document .getElementById('customer-binding-stage') @@ -1046,10 +1011,15 @@ export default function CustomerFulfillmentPage({ ].includes(bindingDecision.flowState), ) const bindingComparison = bindingDecision?.comparison || bindingInfo?.comparison || null + const bindingAccountName = String( + bindingInfo?.bindGameAccount || selectedTask?.bindGameAccount || '', + ).trim() const currentRoleName = bindingInfo?.bindGameRole || selectedTask?.bindGameRole || '' const pendingRoleName = bindingInfo?.pendingBindGameRole || selectedTask?.pendingBindGameRole || '' const bindingRoleName = pendingRoleName || currentRoleName + const bindingQrSource = bindingInfo?.qrImage || bindingQrImage || '' + const bindingQrReady = Boolean(bindingQrSource) const rebindUnchanged = bindingInfo?.rebindUnchanged === true // 换绑被虎牙拒绝或未生效时展示失败原因;若客户已把资料改成与平台当前角色一致, // 比对为 match,则回到正常提交流程,不再显示换绑失败。 @@ -1110,7 +1080,7 @@ export default function CustomerFulfillmentPage({ } if (!bindingDecision && selectedTask?.bindingStatus === 'role_ready') { if (!bindingComparison) return { tone: 'is-info', text: '正在核对平台角色,请稍候' } - return { tone: 'is-info', text: '平台角色与已填资料一致,请提交平台绑定' } + return { tone: 'is-info', text: '角色名与区服验证通过,可确认绑定' } } if ( !bindingDecision && @@ -1203,7 +1173,7 @@ export default function CustomerFulfillmentPage({

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

@@ -1553,16 +1523,16 @@ export default function CustomerFulfillmentPage({ {showBindingStage ? (
- {profileComplete && !profileEditing ? ( + {profileComplete && + !profileEditing && + (bindingAccountName || currentRoleName || pendingRoleName) ? (

绑定信息 (已登录虎牙账号)

登录账号 - - {bindingInfo?.bindGameAccount || selectedTask.bindGameAccount || '未获取'} - + {bindingAccountName || '未获取'}
当前绑定角色 @@ -1597,101 +1567,113 @@ export default function CustomerFulfillmentPage({
) : null} - {bindingBanner && !profileEditing ? ( + {bindingBanner && !profileEditing && !bindingQrVisible ? (
{bindingBanner.text}
) : null} {bindingQrVisible && !bindingSessionExpired && !profileEditing ? ( -
-

游戏角色绑定二维码

- {bindingInfo?.qrImage || bindingQrImage ? ( - 游戏角色绑定二维码 +
+
+ +

微信扫码绑定

+
+ {bindingQrReady ? ( +
+ 微信扫码绑定游戏角色 +
) : bindingLoadError ? ( -
-

绑定二维码加载失败

- {bindingLoadError} -
- - +
+
+

二维码加载失败

+ {bindingLoadError}
) : ( -
- - 正在生成绑定二维码... +
+
+ + 正在生成二维码 +
)}

{bindingInfo?.hasExistingBinding === false - ? '该虎牙账号还没有绑定游戏角色,请用微信扫码完成绑定' - : '请使用微信APP扫码进行游戏角色绑定'} + ? '使用微信扫码选择目标游戏角色' + : '使用微信扫码选择要换绑的角色'}

-

- 扫码后系统只核对角色名称与区服,UID 不参与绑定判定。 -

-

- {selectedTask?.bindingStatus === 'scanned' - ? rebindAccepted - ? '已向虎牙提交换绑,正在等待角色生效,请稍候刷新。' - : bindConfirmPending - ? '已向虎牙提交绑定,正在等待角色生效,请稍候刷新。' - : bindingInfo?.rebindRequested - ? '扫码后请在虎牙弹窗中选中目标角色;选好后点下方「核对平台角色」。' - : '请在微信中完成角色绑定确认,再点击下方按钮核对平台角色。' - : '扫码后请在微信确认框中核对目标角色。'} -

- {nextRebindText ? ( + {selectedTask?.bindingStatus === 'scanned' ? (

- 本次换绑成功后,下次可换绑:{nextRebindText}。 + {rebindAccepted || bindConfirmPending + ? '平台处理中,请刷新绑定状态' + : '已扫码,请核对平台角色'}

) : null} -

- {selectedTask?.bindingStatus === 'scanned' - ? bindingInfo?.message || '已扫码,等待角色生效' - : `建议 ${formatCountdown(bindingSecondsLeft)} 内完成扫码`} -

+
+ + {bindingSecondsLeft > 0 + ? `剩余 ${formatCountdown(bindingSecondsLeft)}` + : '有效期待更新'} + + {selectedTask?.bindingStatus === 'scanned' ? '等待核对' : '微信扫码'} +
- -
- {selectedTask?.bindingStatus === 'scanned' && - bindingInfo?.rebindRequested && - !rebindAccepted ? ( - + {bindingQrReady ? ( + selectedTask?.bindingStatus === 'scanned' && + bindingInfo?.rebindRequested && + !rebindAccepted ? ( + + ) : ( + + ) ) : ( )}
@@ -1745,7 +1727,7 @@ export default function CustomerFulfillmentPage({ message="请联系客服人工核实绑定角色" description={`两侧角色信息不完整,无法自动核对。请复制订单号 ${ orderNo || selectedTask?.orderNo || '' - } 联系客服,核实完成前请不要提交平台绑定。`} + } 联系客服,核实完成前无法确认绑定。`} /> ) : showRebindFailure ? ( - 角色名称与区服一致后才能确认绑定;请重新扫码换绑,或上一步修改资料。 + 角色名称、区服和平台信息一致后才能确认绑定;请重新扫码换绑,或上一步修改资料。 {nextRebindText ? ( 平台预计下次允许换绑:{nextRebindText} @@ -1820,58 +1802,61 @@ export default function CustomerFulfillmentPage({ size="large" className="customer-binding-confirm" loading={bindingLoading} - onClick={() => setBindingConfirmOpen(true)} + onClick={() => void handleConfirmBinding()} > - 提交平台绑定 + 确认绑定这个角色到虎牙 - ) : null} - {decisionRequiresRebind || decisionCanRefreshQr ? ( - - ) : null} - {decisionCanEditProfile ? ( - - ) : null} - {bindingNeedsSupport ? ( - - ) : null} - {decisionCanRefreshBinding ? ( - - ) : null} + ) : ( + <> + {decisionRequiresRebind || decisionCanRefreshQr ? ( + + ) : null} + {decisionCanEditProfile ? ( + + ) : null} + {bindingNeedsSupport ? ( + + ) : null} + {decisionCanRefreshBinding ? ( + + ) : null} + + )}
) : null} @@ -1916,90 +1901,6 @@ export default function CustomerFulfillmentPage({
) : null} - { - if (!bindingLoading) setBindingConfirmOpen(false) - }} - footer={ -
- {canConfirmDecision ? ( -
- - -
- ) : ( -
- - -
- )} - {bindingComparison?.verdict === 'mismatch' ? ( -

- {bindingComparison?.message || '两侧角色信息不一致,无法提交平台绑定'} -

- ) : bindingComparison?.verdict === 'unknown' ? ( -

两侧角色信息不完整,请联系客服核实

- ) : null} -
- } - destroyOnClose - > - -

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

-
-
-
- 您填写的角色 - -
- {bindingComparison?.customerRoleName || '未填写'} - {bindingComparison?.customerZone || '区服未填写'} -
-
-
- {pendingRoleName ? '本次待确认角色' : '平台当前角色'} - -
- {bindingComparison?.boundRoleName || '未识别到角色'} - {bindingComparison?.boundZone || '区服未识别'} -
-
-
-
- { - assert.ok(source.includes('if (!bindingDecision?.canConfirmBinding) return')) - assert.ok(source.includes('if (nextDecision?.canConfirmBinding) {')) +test('绑定确认只保留页内按钮,不再自动弹窗', () => { + assert.ok(!source.includes('customer-binding-modal')) + assert.ok(!source.includes('bindingConfirmOpen')) + assert.ok(!source.includes('setBindingConfirmOpen')) + assert.ok(!source.includes('handlePollBindingNow(true)')) assert.ok(!source.includes("bindingInfo.comparison.verdict === 'match'")) }) @@ -81,19 +84,39 @@ test('虎牙绑定只在二维码或平台生效等待态轮询,过期二维 assert.ok(!pollingSource.includes('bindingActions.has(')) }) -test('角色名和区服一致才出现确认绑定,不一致时展示原因', () => { - assert.ok(source.includes('确认绑定此角色')) +test('角色名和区服一致才显示页内确认按钮,不一致时展示原因', () => { + assert.ok(source.includes('确认绑定这个角色到虎牙')) assert.ok(source.includes('canConfirmDecision')) - assert.ok(source.includes('两侧角色信息不一致,无法提交平台绑定')) - assert.ok(source.includes('customer-binding-modal-error')) + assert.ok(source.includes('onClick={() => void handleConfirmBinding()}')) + assert.ok(source.includes('{canConfirmDecision ? (')) + const confirmBranchStart = source.indexOf('{canConfirmDecision ? (') + const confirmBranchEnd = source.indexOf(') : (', confirmBranchStart) + const confirmBranch = source.slice(confirmBranchStart, confirmBranchEnd) + assert.ok(confirmBranch.includes('确认绑定这个角色到虎牙')) + assert.ok(!confirmBranch.includes('刷新绑定二维码')) + assert.ok(!confirmBranch.includes('上一步修改资料')) + assert.ok(source.includes('平台角色与已填资料不一致')) + assert.ok(source.includes('角色名称、区服和平台信息一致后才能确认绑定')) + assert.ok(!styles.includes('.customer-binding-modal')) + assert.ok(!styles.includes('.customer-binding-compare')) }) -test('二维码区明确只核验角色名与区服,UID 不参与绑定', () => { - assert.ok(source.includes('扫码后系统只核对角色名称与区服,UID 不参与绑定判定')) - assert.ok(source.includes('游戏角色 UID 为必填留档,不参与绑定判定')) +test('虎牙二维码使用深色紧凑卡片并删除重复说明', () => { + assert.ok(source.includes('微信扫码绑定')) + assert.ok(source.includes('使用微信扫码选择目标游戏角色')) + assert.ok(source.includes('已扫码,核对角色')) + assert.ok(source.includes('customer-huya-qr-code')) + assert.ok(!source.includes('扫码后系统只核对角色名称与区服,UID 不参与绑定判定')) + assert.ok(!source.includes('游戏角色 UID 为必填留档,不参与绑定判定')) + assert.ok(!source.includes('本次换绑成功后,下次可换绑')) + assert.ok(huyaStyles.includes('.customer-auth-page.is-huya .customer-binding-qr-card')) + assert.ok(huyaStyles.includes('.customer-huya-qr-code')) + assert.ok(huyaStyles.includes('background: #202631')) assert.ok(source.includes('本次待确认角色')) assert.ok(source.includes('登录账号')) assert.ok(source.includes('当前绑定角色')) + assert.ok(source.includes('(bindingAccountName || currentRoleName || pendingRoleName)')) + assert.ok(source.includes('!bindingQrVisible')) assert.ok(!source.includes('虎牙账号 UID')) assert.ok(!source.includes('目标角色 UID')) assert.ok(!source.includes('待确认角色 UID')) diff --git a/apps/frontend/tests/customer-fulfillment-mobile.test.ts b/apps/frontend/tests/customer-fulfillment-mobile.test.ts index 81242655..ec0e2e1e 100644 --- a/apps/frontend/tests/customer-fulfillment-mobile.test.ts +++ b/apps/frontend/tests/customer-fulfillment-mobile.test.ts @@ -34,17 +34,17 @@ test('客户履约页必须覆盖 body 320px 最小宽度并使用 480px 移动 ) }) -test('客户履约页固定宽度弹窗必须收进手机视口', async () => { +test('虎牙验证弹窗必须收进手机视口', async () => { const [page, huya, css] = await Promise.all([ readFile(source('pages/customer-fulfillment/CustomerFulfillmentPage.tsx'), 'utf8'), readFile(source('pages/customer-fulfillment/HuyaChallengeModal.tsx'), 'utf8'), readFile(source('styles/customer/mobile.css'), 'utf8'), ]) - assert.match(page, /className="customer-binding-modal"/) + assert.ok(!page.includes('customer-binding-modal')) assert.match(huya, /className="customer-huya-challenge-modal"/) assert.match( css, - /\.customer-binding-modal,\s*\.customer-huya-challenge-modal\s*\{[^}]*width:\s*calc\(100vw - 24px\)\s*!important/s, + /\.customer-huya-challenge-modal\s*\{[^}]*width:\s*calc\(100vw - 24px\)\s*!important/s, ) }) diff --git a/docs/履约配置/虎牙绑定协议解码与角色UID.md b/docs/履约配置/虎牙绑定协议解码与角色UID.md index 811a09de..7a92b9fc 100644 --- a/docs/履约配置/虎牙绑定协议解码与角色UID.md +++ b/docs/履约配置/虎牙绑定协议解码与角色UID.md @@ -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 未调用 | diff --git a/docs/统一订单履约与财务模型-权威版.md b/docs/统一订单履约与财务模型-权威版.md index fc0d7180..e68a2c01 100644 --- a/docs/统一订单履约与财务模型-权威版.md +++ b/docs/统一订单履约与财务模型-权威版.md @@ -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; 不一致时固定显示「重新扫码换绑」「上一步修改资料」,换绑后仍不一致时以修改资料为主。