"""斗鱼活动只读查询的唯一入口。 账号角色、精英宝典状态、活动商品、积分、限兑商品、鱼翅和官方记录 都在这里调用 ``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", ]