refactor(douyu): 统一腾讯角色绑定协议与状态判断

This commit is contained in:
yml
2026-11-18 10:59:20 +08:00
parent 9958e4ab7d
commit 8a58f2857d
14 changed files with 1681 additions and 215 deletions
+15 -10
View File
@@ -1291,22 +1291,27 @@ class TestDeriveFromBindInfo:
== BIND_BOUND
)
def test_role_flag_is_the_only_signal(self):
"""**只看 is_bound_role** —— 这一列问的是「角色绑没绑」。
曾经用 is_bound_act 做兜底("避免漏掉已绑但没回角色名的"),
那是把"活动维度"当成"角色维度"。实测那些判为 bound 的账号
**100% 都有角色名**,证明 is_bound_role 本身就够用。
"""
def test_bind_act_is_the_final_confirmation_signal(self):
"""最新抓包:bindRole 只是选中角色,actBind 后 bindAct 才是最终绑定。"""
from web.backend.services.account_binding import (
BIND_BOUND,
BIND_PENDING,
derive_from_bind_info,
)
assert (
derive_from_bind_info(
{"is_bound_role": True, "is_bound_act": False, "role_name": "x"}
)
== BIND_PENDING
)
assert derive_from_bind_info({"is_bound_role": True}) == BIND_BOUND
# 只有 act 没有 role → **推不出角色结论**,保持 unknown(别拿活动当角色)
assert derive_from_bind_info({"is_bound_act": True}) is None
assert derive_from_bind_info({"is_bound_act": "1"}) is None
# 新接口的最终绑定以 bindAct 为准。
assert (
derive_from_bind_info({"is_bound_role": False, "is_bound_act": True})
== BIND_BOUND
)
assert derive_from_bind_info({"is_bound_act": "1"}) == BIND_BOUND
def test_unbound_when_role_flag_explicitly_false(self):
from web.backend.services.account_binding import (
+227
View File
@@ -0,0 +1,227 @@
"""斗鱼腾讯角色绑定的统一状态与最新 HAR 协议测试。"""
from __future__ import annotations
from datetime import UTC, datetime
from typing import Any
from core.douyu import DouyuActivityClient
from web.backend.services.account_binding import (
BIND_BOUND,
BIND_PENDING,
BIND_UNBOUND,
binding_snapshot,
derive_from_bind_info,
is_role_change_cooling,
role_change_available_at,
)
ACT_ALIAS = "20260120QYOOB"
def _payload(
*,
bind_account: int,
bind_role: int,
bind_act: int,
role_name: str = "",
area_name: str = "",
plat_name: str = "",
wait_time: int = 0,
can_change_time: int = 0,
) -> dict[str, Any]:
return {
"error": 0,
"msg": "请求正常",
"data": {
"bindAccount": bind_account,
"bindRole": bind_role,
"bindAct": bind_act,
"needBindRole": 1,
"needBindAct": 1,
"txAct": {
"txActId": 16046,
"gameId": "cjm",
"gameName": "和平精英",
"bindType": 1,
"channelType": 3,
},
"gameAccount": (
{"bindType": 2, "type": "wx", "faceuri": "", "nick": "微信用户"}
if bind_account
else None
),
"gameRole": (
{
"roleName": role_name,
"areaName": area_name,
"platName": plat_name,
"partitionName": "",
}
if role_name
else None
),
"isGranted": 0,
"canChangeRole": 0,
"changeRoleWaitTime": wait_time,
"canChangeTime": can_change_time,
},
}
def _parse(payload: dict[str, Any]) -> dict[str, Any]:
return DouyuActivityClient("")._parse_bind_info(
payload,
act_alias=ACT_ALIAS,
api_version="v2",
)
def test_unbound_wait_time_is_not_a_real_cooldown():
parsed = _parse(
_payload(
bind_account=0,
bind_role=0,
bind_act=0,
wait_time=2_592_000,
)
)
snapshot = binding_snapshot(parsed)
assert derive_from_bind_info(parsed) == BIND_UNBOUND
assert snapshot["bind_confirmed"] is False
assert snapshot["is_change_cooling"] is False
assert is_role_change_cooling(parsed) is False
assert role_change_available_at(parsed) is None
def test_scanned_role_is_pending_until_act_bind():
parsed = _parse(
_payload(
bind_account=1,
bind_role=1,
bind_act=0,
role_name="巫师基尔斯84",
area_name="微信",
plat_name="苹果(iOS)",
wait_time=2_592_000,
)
)
snapshot = binding_snapshot(parsed)
assert derive_from_bind_info(parsed) == BIND_PENDING
assert snapshot["bind_phase"] == "role_ready"
assert snapshot["bind_ready_for_confirm"] is True
assert snapshot["bind_confirmed"] is False
assert snapshot["is_change_cooling"] is False
assert snapshot["role_name"] == "巫师基尔斯84"
assert snapshot["game_channel"] == "微信 / 苹果(iOS)"
def test_act_bind_is_the_single_final_bound_signal():
can_change_time = 1_795_449_600
parsed = _parse(
_payload(
bind_account=1,
bind_role=1,
bind_act=1,
role_name="狗鼻子弗尼亚bd",
area_name="微信",
plat_name="安卓(android)",
wait_time=539_342,
can_change_time=can_change_time,
)
)
snapshot = binding_snapshot(parsed)
available_at = role_change_available_at(
parsed,
checked_at=datetime(2026, 11, 17, tzinfo=UTC),
)
assert derive_from_bind_info(parsed) == BIND_BOUND
assert snapshot["bind_phase"] == "confirmed"
assert snapshot["bind_confirmed"] is True
assert snapshot["is_change_cooling"] is True
assert snapshot["can_change_role"] is False
assert available_at == datetime.fromtimestamp(can_change_time, tz=UTC)
def test_binding_response_has_role_identity_but_no_game_uid():
parsed = _parse(
_payload(
bind_account=1,
bind_role=1,
bind_act=1,
role_name="狗鼻子弗尼亚bd",
area_name="微信",
plat_name="安卓(android)",
wait_time=539_342,
can_change_time=1_795_449_600,
)
)
assert parsed["role_name"] == "狗鼻子弗尼亚bd"
assert parsed["area_name"] == "微信"
assert parsed["plat_name"] == "安卓(android)"
assert parsed["game_id"] == "cjm"
assert parsed["game_name"] == "和平精英"
assert not {"role_id", "game_uid", "openid", "open_id", "uin"} & parsed.keys()
def test_latest_elite_binding_endpoints_are_used_once():
assert DouyuActivityClient.ROLE_PARAM_API == (
"https://www.douyu.com/wgapi/ordnc/live/memberthird/tencent/bindRoleParam"
)
assert DouyuActivityClient.BIND_INFO_API == (
"https://www.douyu.com/wgapi/ordnc/live/memberthird/tencent/bindInfo"
)
assert DouyuActivityClient.BIND_API == (
"https://www.douyu.com/wgapi/ordnc/live/memberthird/tencent/actBind"
)
def test_qr_and_confirm_requests_follow_latest_har(monkeypatch):
calls: list[dict[str, Any]] = []
client = DouyuActivityClient("acf_ccn=ctn")
monkeypatch.setattr(
client,
"acf_ccn",
lambda *, refresh_subscribe=True: "ctn",
)
def request_json(method: str, url: str, source: str, **kwargs: Any):
calls.append(
{
"method": method,
"url": url,
"source": source,
**kwargs,
}
)
if url.endswith("/bindRoleParam"):
return {
"error": 0,
"data": {
"url": "https://livelink.example/role",
"gameRoleBindUrl": "https://livelink.example/bind",
},
}
return {"error": 0, "msg": "请求正常", "data": {}}
monkeypatch.setattr(client, "_request_json", request_json)
qr = client.get_bind_qr(ACT_ALIAS)
confirmed = client.confirm_bind(ACT_ALIAS)
assert qr["url"] == "https://livelink.example/role"
assert qr["game_role_bind_url"] == "https://livelink.example/bind"
assert confirmed["ctn"] == "ctn"
assert calls[0]["method"] == "get"
assert calls[0]["url"].endswith("/bindRoleParam")
assert calls[0]["params"] == {"actAlias": ACT_ALIAS}
assert calls[1]["method"] == "post"
assert calls[1]["url"].endswith("/actBind")
assert calls[1]["files"] == {
"actAlias": (None, ACT_ALIAS),
"ctn": (None, "ctn"),
}
+3
View File
@@ -32,6 +32,9 @@ class FakeClient:
def bind_info(self, **_):
return {
"is_bound_account": True,
"is_bound_role": True,
"is_bound_act": True,
"role_name": "角色A",
"area_name": "微信",
"plat_name": "苹果(iOS)",