Files
live-hub-py/web/backend/services/douyu_activity_query.py
T
yml 0220ef995f refactor(douyu): 统一活动查询与直播商品映射
- 收口斗鱼活动、商品、绑定信息和兑换资格查询
- 工作台改为复用统一客户端、快照与实时商品目录
- 补充活动查询与商品映射测试
2026-11-18 10:59:20 +08:00

310 lines
7.8 KiB
Python

"""斗鱼活动只读查询的唯一入口。
账号角色、精英宝典状态、活动商品、积分、限兑商品、鱼翅和官方记录
都在这里调用 ``DouyuActivityClient``。业务模块只消费归一化结果,不直接
拼接口参数或解析响应,避免工作台、协作台账和任务执行器各自漂移。
兑换、充值、锁定订单等写操作不在这里实现;它们继续由任务执行器负责。
"""
from __future__ import annotations
from dataclasses import dataclass
from typing import Any
from core.douyu import DouyuActivityClient
from core.douyu.cookie_utils import cookie_value
from .douyu_goods_service import serialize_goods
ERROR_MAX_LENGTH = 240
def activity_client(cookie: str = "") -> DouyuActivityClient:
"""创建统一活动客户端;空 Cookie 可用于公开商品目录查询。"""
return DouyuActivityClient(cookie)
def query_csrf(
client: DouyuActivityClient,
*,
refresh_subscribe: bool = False,
) -> str:
return client.acf_ccn(refresh_subscribe=refresh_subscribe)
def query_elite_user_info(
client: DouyuActivityClient,
*,
manual_id: str,
rid: str = "",
) -> dict[str, Any]:
return client.elite_user_info(manual_id=manual_id, rid=rid)
def query_bind_info(
client: DouyuActivityClient,
*,
act_alias: str,
v2: bool = False,
) -> dict[str, Any]:
return client.bind_info(act_alias=act_alias, v2=v2)
def query_esports_bind_info(
client: DouyuActivityClient,
*,
act_alias: str,
) -> dict[str, Any]:
return client.esports_bind_info(act_alias=act_alias)
def query_xpd_bind_info(
client: DouyuActivityClient,
*,
act_alias: str,
) -> dict[str, Any]:
return client.xpd_bind_info(act_alias=act_alias)
def query_gold_account(client: DouyuActivityClient) -> dict[str, Any]:
return client.gold_account()
def query_exchange_balance(client: DouyuActivityClient) -> dict[str, Any]:
return client.exchange_balance()
def query_activity_goods(
client: DouyuActivityClient,
*,
manual_id: str,
rid: str,
) -> list[dict[str, Any]]:
result = client.list_goods(manual_id=manual_id, rid=rid)
return [dict(item) for item in result.get("goods") or [] if isinstance(item, dict)]
def query_esports_goods_result(
client: DouyuActivityClient,
*,
manual_id: str,
rid: str,
) -> dict[str, Any]:
return client.list_esports_goods(manual_id=manual_id, rid=rid)
def query_esports_goods(
client: DouyuActivityClient,
*,
manual_id: str,
rid: str,
) -> list[dict[str, Any]]:
result = query_esports_goods_result(
client,
manual_id=manual_id,
rid=rid,
)
return [dict(item) for item in result.get("goods") or [] if isinstance(item, dict)]
def query_points(
client: DouyuActivityClient,
*,
uid: str,
ctn: str,
) -> dict[str, Any]:
return client.query_points(uid=uid, ctn=ctn)
def query_limited_goods_result(
client: DouyuActivityClient,
*,
manual_id: str,
rid: str,
) -> dict[str, Any]:
return client.query_limited_goods(manual_id=manual_id, rid=rid)
def query_limited_goods(
client: DouyuActivityClient,
*,
manual_id: str,
rid: str,
) -> list[dict[str, Any]]:
result = query_limited_goods_result(client, manual_id=manual_id, rid=rid)
return [
dict(item)
for item in result.get("limited_goods") or []
if isinstance(item, dict)
]
def query_exchange_records_result(
client: DouyuActivityClient,
*,
manual_id: str,
limit: int = 100,
offset: int = 0,
) -> dict[str, Any]:
return client.exchange_records(
manual_id=manual_id,
limit=limit,
offset=offset,
)
def query_exchange_records(
client: DouyuActivityClient,
*,
manual_id: str,
limit: int = 100,
offset: int = 0,
) -> list[dict[str, Any]]:
result = query_exchange_records_result(
client,
manual_id=manual_id,
limit=limit,
offset=offset,
)
return [
dict(item) for item in result.get("records") or [] if isinstance(item, dict)
]
def query_exchange_orders_result(
client: DouyuActivityClient,
*,
manual_id: str,
page: int = 1,
page_size: int = 10,
) -> dict[str, Any]:
return client.exchange_orders(
manual_id=manual_id,
page=page,
page_size=page_size,
)
def query_exchange_orders(
client: DouyuActivityClient,
*,
manual_id: str,
page: int = 1,
page_size: int = 10,
) -> list[dict[str, Any]]:
result = query_exchange_orders_result(
client,
manual_id=manual_id,
page=page,
page_size=page_size,
)
return [dict(item) for item in result.get("orders") or [] if isinstance(item, dict)]
@dataclass(frozen=True)
class DouyuEligibilityResult:
elite_user_info: dict[str, Any]
points: int
limited_goods: list[dict[str, Any]]
limited_ids: frozenset[str]
def query_exchange_eligibility(
client: DouyuActivityClient,
*,
cookie: str,
manual_id: str,
rid: str,
uid: str = "",
) -> DouyuEligibilityResult:
"""一次读取兑换资格需要的精英状态、积分和限兑商品。"""
ctn = query_csrf(client)
elite = query_elite_user_info(client, manual_id=manual_id, rid=rid)
resolved_uid = str(uid or cookie_value(cookie, "acf_uid") or "").strip()
points_result = query_points(client, uid=resolved_uid, ctn=ctn)
limited = query_limited_goods(client, manual_id=manual_id, rid=rid)
limited_ids = {
str(item.get("commodityId") or item.get("commodity_id") or "").strip()
for item in limited
}
limited_ids.discard("")
return DouyuEligibilityResult(
elite_user_info=elite,
points=int(points_result.get("points") or 0),
limited_goods=limited,
limited_ids=frozenset(limited_ids),
)
def query_account_overview(
client: DouyuActivityClient,
*,
manual_id: str,
rid: str,
act_alias: str,
with_goods: bool = True,
) -> dict[str, Any]:
"""账号只读探针,单项失败只进入 errors,不阻断其他查询。"""
elite: dict[str, Any] = {}
bind: dict[str, Any] = {}
gold: dict[str, Any] = {}
goods: list[dict[str, Any]] = []
errors: dict[str, str] = {}
try:
elite = query_elite_user_info(client, manual_id=manual_id, rid=rid)
except Exception as exc: # noqa: BLE001 - 外部接口边界
errors["elite"] = _error_text(exc)
try:
bind = query_bind_info(client, act_alias=act_alias)
except Exception as exc: # noqa: BLE001
errors["bind"] = _error_text(exc)
try:
gold = query_gold_account(client)
except Exception as exc: # noqa: BLE001
errors["gold"] = _error_text(exc)
if with_goods:
try:
goods = query_activity_goods(client, manual_id=manual_id, rid=rid)
except Exception as exc: # noqa: BLE001
errors["goods"] = _error_text(exc)
return {
"elite": elite,
"bind": bind,
"gold": gold,
"goods": goods,
"serialized_goods": [serialize_goods(item) for item in goods],
"errors": errors,
}
def _error_text(exc: BaseException) -> str:
return f"{type(exc).__name__}: {exc}"[:ERROR_MAX_LENGTH]
__all__ = [
"DouyuEligibilityResult",
"activity_client",
"query_account_overview",
"query_activity_goods",
"query_bind_info",
"query_csrf",
"query_elite_user_info",
"query_esports_bind_info",
"query_esports_goods",
"query_esports_goods_result",
"query_exchange_balance",
"query_exchange_eligibility",
"query_exchange_orders",
"query_exchange_orders_result",
"query_exchange_records",
"query_exchange_records_result",
"query_gold_account",
"query_limited_goods",
"query_limited_goods_result",
"query_points",
"query_xpd_bind_info",
]