Files
live-hub-py/tests/test_douyu_binding_state.py
T

592 lines
18 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""斗鱼腾讯角色绑定的统一状态与最新 HAR 协议测试。"""
from __future__ import annotations
from datetime import UTC, datetime
from typing import Any
import pytest
from core.douyu import DouyuActivityClient, DouyuActivityError
from web.backend.models import Account
from web.backend.services.account_binding import (
BIND_BOUND,
BIND_PENDING,
BIND_UNBOUND,
binding_pending_decision,
binding_role_from_result,
binding_snapshot,
derive_from_bind_info,
is_pending_binding_role,
is_role_change_cooling,
pending_binding_role_from_result,
role_change_available_at,
)
from web.backend.services.douyu_runner_bind import BindMixin
ACT_ALIAS = "20260120QYOOB"
LEGACY_ALIAS = "cjm"
ROLE_CONFIG = {
"legacy_act_alias": LEGACY_ALIAS,
"confirm_act_alias": ACT_ALIAS,
"bind_act_alias": ACT_ALIAS,
}
class _RolePicker(BindMixin):
pass
def _role_candidate(
alias: str,
role_name: str,
*,
bound_act: bool = False,
need_bind_act: bool = True,
) -> dict[str, Any]:
return {
"act_alias": alias,
"role_name": role_name,
"area_name": "微信",
"plat_name": "安卓(android)",
"is_bound_account": True,
"is_bound_role": True,
"is_bound_act": bound_act,
"need_bind_act": need_bind_act,
"need_bind_role": True,
}
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_existing_pending_role_is_baseline_not_new_scan_result():
old_role = "狗鼻子弗尼亚bd"
candidates = [
_role_candidate(LEGACY_ALIAS, old_role),
_role_candidate(ACT_ALIAS, old_role),
]
picker = _RolePicker()
baseline = picker._pick_baseline_bind_info(candidates, ROLE_CONFIG)
assert baseline is not None
assert baseline["act_alias"] == ACT_ALIAS
assert baseline["role_name"] == old_role
assert not is_pending_binding_role(
candidates[0],
baseline_role_name=old_role,
baseline_is_bound_act=False,
)
assert not is_pending_binding_role(
candidates[1],
baseline_role_name=old_role,
baseline_is_bound_act=False,
)
assert not is_pending_binding_role(
candidates[0],
baseline_role_name=old_role,
baseline_is_bound_act=True,
)
assert not is_pending_binding_role(
candidates[1],
baseline_role_name=old_role,
baseline_is_bound_act=True,
)
assert not is_pending_binding_role(
candidates[0],
baseline_role_name=old_role,
baseline_is_bound_act=True,
baseline_info=candidates[1],
)
def test_existing_action_alias_pending_is_confirmable_without_transition():
"""2026-11-22 成功 HAR:已有 bindAct=0 角色可直接确认。"""
role = "忧郁情潇藏心中"
baseline = _role_candidate(ACT_ALIAS, role, need_bind_act=True)
legacy = _role_candidate(LEGACY_ALIAS, role, need_bind_act=False)
activity = _role_candidate(ACT_ALIAS, role, need_bind_act=True)
picker = _RolePicker()
decision = binding_pending_decision(
activity,
baseline_role_name=role,
baseline_is_bound_act=False,
baseline_info=baseline,
actionable_aliases=[ACT_ALIAS],
)
selected = picker._pick_pending_role_info(
[legacy, activity],
prefer_aliases=[LEGACY_ALIAS, ACT_ALIAS],
baseline_role_name=role,
baseline_is_bound_act=False,
baseline_info=baseline,
actionable_aliases=[ACT_ALIAS],
)
assert decision["confirmable"] is True
assert decision["reason"] == "existing_actionable_pending"
assert selected is not None
assert selected["act_alias"] == ACT_ALIAS
def test_actionable_pending_without_baseline_is_confirmable():
role = "只为爱杰宝"
activity = _role_candidate(ACT_ALIAS, role, need_bind_act=True)
decision = binding_pending_decision(
activity,
actionable_aliases=[ACT_ALIAS],
)
assert decision["confirmable"] is True
assert decision["reason"] == "existing_actionable_pending"
def test_same_role_after_activity_bind_transition_is_pending():
old_role = "少和我较劲"
baseline = _role_candidate(ACT_ALIAS, old_role, bound_act=True)
after_scan = _role_candidate(ACT_ALIAS, old_role, bound_act=False)
assert is_pending_binding_role(
after_scan,
baseline_role_name=old_role,
baseline_is_bound_act=True,
baseline_info=baseline,
)
def test_same_bound_role_with_need_bind_act_is_not_confirmable_without_transition():
role = "少和我较劲"
baseline = _role_candidate(
ACT_ALIAS,
role,
bound_act=True,
need_bind_act=True,
)
candidate = _role_candidate(
ACT_ALIAS,
role,
bound_act=True,
need_bind_act=True,
)
decision = binding_pending_decision(
candidate,
baseline_role_name=role,
baseline_is_bound_act=True,
baseline_info=baseline,
actionable_aliases=[ACT_ALIAS],
)
assert decision["confirmable"] is False
assert decision["reason"] == "already_bound"
def test_pending_candidate_picker_ignores_unchanged_same_role():
old_role = "少和我较劲"
baseline = _role_candidate(ACT_ALIAS, old_role, bound_act=True)
legacy = _role_candidate(LEGACY_ALIAS, old_role, bound_act=False)
activity = _role_candidate(ACT_ALIAS, old_role, bound_act=True)
selected = _RolePicker()._pick_pending_role_info(
[legacy, activity],
prefer_aliases=[LEGACY_ALIAS, ACT_ALIAS],
baseline_role_name=old_role,
baseline_is_bound_act=True,
baseline_info=baseline,
)
assert selected is None
def test_pending_candidate_picker_accepts_same_alias_state_transition():
role = "少和我较劲"
baseline = _role_candidate(ACT_ALIAS, role, bound_act=True, need_bind_act=False)
after_scan = _role_candidate(ACT_ALIAS, role, bound_act=False, need_bind_act=True)
selected = _RolePicker()._pick_pending_role_info(
[after_scan],
prefer_aliases=[ACT_ALIAS],
baseline_role_name=role,
baseline_is_bound_act=True,
baseline_info=baseline,
actionable_aliases=[ACT_ALIAS],
)
assert selected is not None
assert selected["act_alias"] == ACT_ALIAS
def test_task_result_helpers_use_shared_same_role_transition_rule():
baseline = _role_candidate(ACT_ALIAS, "少和我较劲", bound_act=True)
stale = {
"role_name": "少和我较劲",
"baseline_role_name": "少和我较劲",
"baseline_is_bound_act": True,
"need_bind_act": False,
"is_bound_act": False,
"bind_ready_for_confirm": True,
"bind_confirmed": False,
"before_bind_info": baseline,
}
same_role_scanned = {
**stale,
"act_alias": ACT_ALIAS,
"need_bind_act": True,
"bind_ready_for_confirm": True,
}
assert pending_binding_role_from_result(stale) == ""
assert binding_role_from_result(stale) == ""
assert pending_binding_role_from_result(same_role_scanned) == "少和我较劲"
assert binding_role_from_result(same_role_scanned) == "少和我较劲"
def test_task_result_helpers_accept_existing_action_alias_pending():
activity = _role_candidate(ACT_ALIAS, "只为爱杰宝", need_bind_act=True)
result = {
**binding_snapshot(activity),
"act_alias": ACT_ALIAS,
"action_act_aliases": [ACT_ALIAS],
"before_bind_info": activity,
"baseline_role_name": "只为爱杰宝",
"bind_ready_for_confirm": True,
"bind_confirmed": False,
}
assert pending_binding_role_from_result(result) == "只为爱杰宝"
assert binding_role_from_result(result) == "只为爱杰宝"
def test_confirmed_new_role_replaces_account_current_role():
account = Account(
username="replace-role",
password="p",
email="replace-role@example.com",
email_password="ep",
status="active",
game_name="少和我较劲",
)
new_role = _role_candidate(ACT_ALIAS, "新的绑定角色", bound_act=True)
_RolePicker()._apply_bind_info_to_account(account, new_role)
assert account.game_name == "新的绑定角色"
def test_new_role_wins_when_cjm_and_activity_snapshots_differ():
old_role = "狗鼻子弗尼亚bd"
new_role = "我是火星人2222"
candidates = [
_role_candidate(LEGACY_ALIAS, old_role),
_role_candidate(ACT_ALIAS, new_role),
]
picker = _RolePicker()
selected = picker._pick_bind_info(
candidates,
baseline_role_name=old_role,
baseline_is_bound_act=False,
prefer_pending=True,
prefer_aliases=[LEGACY_ALIAS, ACT_ALIAS],
)
target = picker._pick_target_role_info(candidates, ROLE_CONFIG)
assert selected is not None
assert selected["act_alias"] == ACT_ALIAS
assert selected["role_name"] == new_role
assert target is not None
assert target["role_name"] == new_role
def test_changed_cjm_role_wins_over_old_bound_activity_role():
old_role = "狗鼻子弗尼亚bd"
new_role = "我是火星人2222"
candidates = [
_role_candidate(LEGACY_ALIAS, new_role),
_role_candidate(ACT_ALIAS, old_role, bound_act=True),
]
picker = _RolePicker()
target = picker._pick_target_role_info(candidates, ROLE_CONFIG)
assert target is not None
assert target["act_alias"] == LEGACY_ALIAS
assert target["role_name"] == new_role
def test_expected_role_never_falls_back_to_old_activity_role():
old_role = "狗鼻子弗尼亚bd"
new_role = "我是火星人2222"
candidates = [
_role_candidate(LEGACY_ALIAS, new_role),
_role_candidate(ACT_ALIAS, old_role),
]
picker = _RolePicker()
selected = picker._pick_role_info_for_aliases(
candidates,
[ACT_ALIAS, LEGACY_ALIAS],
required_role_name=new_role,
)
assert selected is not None
assert selected["act_alias"] == LEGACY_ALIAS
assert selected["role_name"] == new_role
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/bind"
assert qr["role_param_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"),
}
def test_confirm_bind_preserves_platform_cooldown_error_code(monkeypatch):
"""2026-11-22 失败 HAR:actBind 必须保留 -200001,不能只留中文消息。"""
client = DouyuActivityClient("acf_ccn=ctn")
monkeypatch.setattr(
client,
"acf_ccn",
lambda *, refresh_subscribe=True: "ctn",
)
payload = {
"error": -200001,
"msg": "该平台账号未到可换绑时间,请使用其他平台账号",
"data": None,
}
monkeypatch.setattr(
client,
"_request_json",
lambda *_args, **_kwargs: payload,
)
with pytest.raises(DouyuActivityError) as exc_info:
client.confirm_bind(ACT_ALIAS)
assert exc_info.value.code == -200001
assert exc_info.value.payload == payload
def test_get_bind_qr_falls_back_to_role_param_url(monkeypatch):
client = DouyuActivityClient("acf_ccn=ctn")
monkeypatch.setattr(
client,
"acf_ccn",
lambda *, refresh_subscribe=True: "ctn",
)
monkeypatch.setattr(
client,
"_request_json",
lambda *_args, **_kwargs: {
"error": 0,
"data": {"url": "https://livelink.example/role"},
},
)
qr = client.get_bind_qr(ACT_ALIAS)
assert qr["url"] == "https://livelink.example/role"
assert qr["game_role_bind_url"] == ""