v0 plus附加功能

- 新增 unlockmusic.py：解锁（解禁）歌曲 + 解禁 Master / Re:Master 难度，整个流程复用 upsert.py 的 run()
- 买票前置闸门 api/ChargeGuard.py：必须先跑过 GetUserCharge，且同进程只允许买一次
- buy_ticket.py 票源改为 GetUserCharge，不再调用 GetGameCharge
- UpsertUserAll 与买票的冷却统一为 15 秒
- api/ 文件名统一 PascalCase（文件名 = 函数名）
- 项目改名 Astral，README 加 Logo、鸣谢与开发者说明
- 自检 284 项

api/GetUserFavoriteItem.py

@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*-
+"""
+GetUserFavoriteItem.py —— 取用户收藏曲目/对手（GetUserFavoriteItemApi）
+================================================================================
+
+取玩家收藏的乐曲（kind=1）或收藏的对手（kind=2）。
+
+对应接口：GetUserFavoriteItemApi
+请求体  ：UserFavoriteItemRequestVO（userId + kind + nextIndex + maxCount=100
+                                    + isAllFavoriteItem）
+响应    ：{userId, kind, length, nextIndex, userFavoriteItemList:[{orderId,id}]}
+依据    ：source/Assembly-CSharp/Net.VO.Mai2/UserFavoriteItemRequestVO.cs
+          source/2026-10-05.log:93,107  真机 kind=2 与 kind=1 各一次
+
+★ 字段名是 kind（不是 itemKind），别写错。
+
+调用示例：
+    from api import GetUserFavoriteItem, GetUserFavoriteItemAll
+"""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from config import CLIENT_ID, TIMEOUT_MS
+
+from .LogSetup import log_info
+from .MaimaiNet import MaimaiNetClient
+from .UserGetterCommon import _get, UserFavoriteItemRequestVO, get_all_pages
+
+#: kind 取值
+FAVORITE_ITEM_KIND_MUSIC = 1     # 收藏乐曲
+FAVORITE_ITEM_KIND_RIVAL = 2     # 收藏对手
+
+
+def GetUserFavoriteItem(
+    user_id: int,
+    kind: int = FAVORITE_ITEM_KIND_MUSIC,
+    *,
+    next_index: int = 0,
+    is_all_favorite_item: bool = False,
+    client_id: str = CLIENT_ID,
+    timeout_ms: Optional[int] = None,
+    client: Optional[MaimaiNetClient] = None,
+) -> Dict[str, Any]:
+    """
+    取用户收藏项（单页，对应 GetUserFavoriteItemApi）。
+
+    参数：
+        user_id: 用户 ID（必填）
+        kind:    1=收藏乐曲 2=收藏对手（默认 1）
+
+    返回：
+        原始响应 dict，含 userFavoriteItemList
+    """
+    log_info("取用户收藏项：user_id=" + str(user_id) + " kind=" + str(kind)
+             + " next_index=" + str(next_index))
+    return _get(
+        "GetUserFavoriteItemApi",
+        UserFavoriteItemRequestVO(
+            userId=user_id, kind=kind, nextIndex=next_index,
+            maxCount=100, isAllFavoriteItem=is_all_favorite_item,
+        ),
+        user_id, client_id=client_id, timeout_ms=timeout_ms, client=client,
+    )
+
+
+def GetUserFavoriteItemAll(
+    user_id: int,
+    kind: int = FAVORITE_ITEM_KIND_MUSIC,
+    *,
+    is_all_favorite_item: bool = False,
+    client_id: str = CLIENT_ID,
+    timeout_ms: Optional[int] = None,
+    client: Optional[MaimaiNetClient] = None,
+) -> Dict[str, Any]:
+    """
+    取用户收藏项（自动翻页取全）。
+
+    返回：
+        {"userFavoriteItemList": [...]}
+    """
+    log_info("取用户收藏项（全量）：user_id=" + str(user_id) + " kind=" + str(kind))
+    items = get_all_pages(
+        "GetUserFavoriteItemApi", user_id, "userFavoriteItemList",
+        body_factory=lambda ni: UserFavoriteItemRequestVO(
+            userId=user_id, kind=kind, nextIndex=ni or 0,
+            maxCount=100, isAllFavoriteItem=is_all_favorite_item),
+        client_id=client_id, timeout_ms=timeout_ms, client=client,
+    )
+    log_info("收藏项获取完成：" + str(len(items)) + " 条")
+    return {"userFavoriteItemList": items}