SearchApi

def get_hotkey(self):
    """获取热搜词列表."""
    return self._build_request(
        "music.musicsearch.HotkeyService",
        "GetHotkeyForQQMusicMobile",
        {"search_id": get_searchID()},
    )

def complete(self, keyword: str):
    """搜索词补全建议.

    Args:
        keyword: 关键词.
    """
    return self._build_request(
        "music.smartboxCgi.SmartBoxCgi",
        "GetSmartBoxResult",
        {
            "search_id": get_searchID(),
            "query": keyword,
            "num_per_page": 0,
            "page_idx": 0,
        },
    )

async def quick_search(self, keyword: str) -> dict[str, Any]:
    """快速搜索 (直接返回解析后的 JSON 数据).

    Args:
        keyword: 关键词.

    Returns:
        dict[str, Any]: 搜索结果字典.
    """
    resp = await self._client.request(
        "GET",
        "https://c.y.qq.com/splcloud/fcgi-bin/smartbox_new.fcg",
        params={"key": keyword},
    )
    resp.raise_for_status()
    return resp.json()["data"]

def general_search(
    self,
    keyword: str,
    page: int = 1,
    num: int = 15,
    searchid: str | None = None,
    page_start: dict[str, Any] | None = None,
    *,
    highlight: bool = True,
):
    """综合搜索.

    Args:
        keyword: 关键词.
        page: 页码.
        num: 每页返回数量.
        searchid: 搜索会话 ID.
        page_start: 上一页分页游标对象.
        highlight: 是否高亮关键词.
    """
    param: dict[str, Any] = {
        "searchid": searchid or get_searchID(),
        "search_type": 100,
        "page_num": num,
        "query": keyword,
        "page_id": page,
        "highlight": highlight,
        "grp": True,
    }
    if page_start is not None:
        param["page_start"] = page_start

    return self._build_request(
        "music.adaptor.SearchAdaptor",
        "do_search_v2",
        param,
        response_model=GeneralSearchResponse,
        pager_meta=PagerMeta(
            strategy=MultiFieldContinuationStrategy(
                lambda params, response, adapter: {
                    **cast("dict[str, Any]", params),
                    "searchid": response.searchid,
                    "page_id": response.nextpage,
                    "page_start": cast("dict[str, Any]", adapter.get_cursor(response)),
                },
                context_name="general_search",
            ),
            adapter=ResponseAdapter(
                has_more_flag=lambda response: response.nextpage != -1,
                cursor="nextpage_start",
            ),
        ),
    )

def search_by_type(
    self,
    keyword: str,
    search_type: int | SearchType = SearchType.SONG,
    num: int = 10,
    page: int = 1,
    searchid: str | None = None,
    *,
    highlight: bool = True,
):
    """类型搜索.

    固定使用 Android 平台.

    Args:
        keyword: 关键词.
        search_type: 搜索类型.
        num: 返回结果数量.
        page: 页码.
        searchid: 搜索会话 ID.
        highlight: 是否高亮关键词.
    """
    normalized_search_type = int(SearchType(search_type))
    return self._build_request(
        "music.search.SearchCgiService",
        "DoSearchForQQMusicMobile",
        {
            "searchid": searchid or get_searchID(),
            "query": keyword,
            "search_type": normalized_search_type,
            "num_per_page": num,
            "page_num": page,
            "highlight": highlight,
            "grp": True,
        },
        platform=Platform.ANDROID,
        response_model=SearchByTypeResponse,
        pager_meta=PagerMeta(
            strategy=PageStrategy(page_key="page_num", page_size=num, start_page=page),
            adapter=ResponseAdapter(
                has_more_flag=lambda r: getattr(r, "nextpage", -1) != -1,
                total="total_num",
            ),
        ),
    )