ecapi-sdk 3.7.1__tar.gz → 3.7.3__tar.gz

{ecapi_sdk-3.7.1 → ecapi_sdk-3.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ecapi-sdk
-Version: 3.7.1
+Version: 3.7.3
 Summary: ECAPI SDK for Python
 Author: EaseCation
 License: MIT

{ecapi_sdk-3.7.1 → ecapi_sdk-3.7.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ecapi-sdk"
-version = "3.7.1"
+version = "3.7.3"
 description = "ECAPI SDK for Python"
 readme = "README.md"
 requires-python = ">=3.9"

{ecapi_sdk-3.7.1 → ecapi_sdk-3.7.3}/src/ecapi_sdk/client.py

@@ -4,6 +4,9 @@ from __future__ import annotations
 import asyncio
 import inspect
 import json
+import mimetypes
+from pathlib import Path
+from uuid import uuid4
 from dataclasses import dataclass
 from typing import Any, Callable, Dict, Mapping, Optional, Sequence, Tuple, Union
 from urllib.error import HTTPError, URLError
@@ -21,6 +24,61 @@ REQUEST_OPTION_KEYS = {"body", "headers", "response_type", "auth"}
 DEFAULT_BASE_URL = "https://api.easecation.net"
 
 
+class _MultipartBody:
+    """Stream ordinary files without buffering a large ZIP in memory."""
+    def __init__(self, payload: Mapping[str, Any], binary_fields: Sequence[str]) -> None:
+        self.boundary = "ecapi-" + uuid4().hex
+        self.parts = []
+        self.length = 0
+        for name, value in payload.items():
+            if value is None:
+                continue
+            if not name.replace("_", "").isalnum():
+                raise ValueError("Invalid multipart field name")
+            prefix = f'--{self.boundary}\r\nContent-Disposition: form-data; name="{name}"'
+            if name in binary_fields:
+                if isinstance(value, Path):
+                    if not value.is_file():
+                        raise ValueError("Upload path must be an ordinary file")
+                    filename, data, size = value.name, value, value.stat().st_size
+                elif isinstance(value, tuple) and len(value) == 2 and isinstance(value[0], str) and isinstance(value[1], bytes):
+                    filename, data = value
+                    size = len(data)
+                else:
+                    raise TypeError("Binary fields require pathlib.Path or (filename, bytes)")
+                if any(c in filename for c in '\r\n\0'):
+                    raise ValueError("Invalid upload filename")
+                filename = filename.replace('"', '%22').replace('\\', '%5C')
+                mime = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+                prefix += f'; filename="{filename}"\r\nContent-Type: {mime}'
+            else:
+                data = (str(value).lower() if isinstance(value, bool) else str(value)).encode("utf-8")
+                size = len(data)
+            prefix = (prefix + "\r\n\r\n").encode("utf-8")
+            self.parts.append((prefix, data, size))
+            self.length += len(prefix) + size + 2
+        self.suffix = f"--{self.boundary}--\r\n".encode("ascii")
+        self.length += len(self.suffix)
+
+    def __iter__(self):
+        for prefix, data, size in self.parts:
+            yield prefix
+            if isinstance(data, Path):
+                with data.open("rb") as handle:
+                    remaining = size
+                    while remaining:
+                        chunk = handle.read(min(65536, remaining))
+                        if not chunk:
+                            raise OSError("Upload file changed while reading")
+                        remaining -= len(chunk)
+                        yield chunk
+                    if handle.read(1):
+                        raise OSError("Upload file changed while reading")
+            else:
+                yield data
+            yield b"\r\n"
+        yield self.suffix
+
 class ECAPIError(Exception):
     def __init__(self, message: str, status: int, payload: Any, url: str) -> None:
         resolved_message = _extract_error_message(payload) or message
@@ -224,7 +282,11 @@ class _HttpClient:
                     merged_headers["Authorization"] = f"Bearer {token}"
 
         request_data: Optional[bytes] = None
-        if body is not None:
+        if isinstance(body, _MultipartBody):
+            merged_headers["Content-Type"] = "multipart/form-data; boundary=" + body.boundary
+            merged_headers["Content-Length"] = str(body.length)
+            request_data = body
+        elif body is not None:
             content_type = merged_headers.get("Content-Type", "")
             if not content_type:
                 merged_headers["Content-Type"] = "application/json"
@@ -487,6 +549,7 @@ class AdminAPI(_BaseApi):
         self.operation_log = AdminOperationLogAPI(http)
         self.overwatch_case = AdminOverwatchCaseAPI(http)
         self.overwatch_supervisor = AdminOverwatchSupervisorAPI(http)
+        self.parkour = AdminParkourAPI(http)
         self.permission = AdminPermissionAPI(http)
         self.player_data = AdminPlayerDataAPI(http)
         self.player_merchandise = AdminPlayerMerchandiseAPI(http)
@@ -494,6 +557,7 @@ class AdminAPI(_BaseApi):
         self.player_wallet = AdminPlayerWalletAPI(http)
         self.punishment = AdminPunishmentAPI(http)
         self.source_account_binding = AdminSourceAccountBindingAPI(http)
+        self.sp_workbench = AdminSpWorkbenchAPI(http)
         self.vote_reward_mail = AdminVoteRewardMailAPI(http)
 
 class AdminAccountAPI(_BaseApi):
@@ -562,6 +626,15 @@ class AdminOverwatchSupervisorAPI(_BaseApi):
         """修改监管者资格"""
         return self._patch(f"/admin/overwatch-supervisors/{quote(str(ecid), safe='')}", payload, **kwargs)
 
+class AdminParkourAPI(_BaseApi):
+    def clear_community_scores(self, ecid: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """清除社区版逐关成绩"""
+        return self._post(f"/admin/players/{quote(str(ecid), safe='')}/parkour/community-score-clears", payload, **kwargs)
+
+    def preview_community_score_clear(self, ecid: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """预览社区版逐关成绩清除范围"""
+        return self._get(f"/admin/players/{quote(str(ecid), safe='')}/parkour/community-score-clear-preview", query, **kwargs)
+
 class AdminPermissionAPI(_BaseApi):
     def delete_entitlement(self, ecid: str, entitlementKey: str, **kwargs: Any) -> Any:
         """删除玩家权益"""
@@ -660,6 +733,10 @@ class AdminPunishmentAPI(_BaseApi):
         """解除处罚"""
         return self._delete(f"/admin/players/{quote(str(ecid), safe='')}/punishments/{quote(str(type), safe='')}", query, **kwargs)
 
+    def set_parkour_punishment(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """设置老版跑酷天堂成绩惩罚"""
+        return self._post(f"/punishments/parkour", payload, **kwargs)
+
 class AdminSourceAccountBindingAPI(_BaseApi):
     def bind_account_player(self, xuid: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
         """绑定或改绑来源账号到玩家"""
@@ -677,11 +754,53 @@ class AdminSourceAccountBindingAPI(_BaseApi):
         """解绑玩家名下全部来源账号"""
         return self._delete(f"/admin/players/{quote(str(ecid), safe='')}/source-accounts", None, **kwargs)
 
+class AdminSpWorkbenchAPI(_BaseApi):
+    def capabilities(self, **kwargs: Any) -> Any:
+        """只读查询 SP 专用进度执行能力"""
+        return self._get(f"/admin/sp/progress/capabilities", None, **kwargs)
+
+    def progress(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """执行 SP 专用标准值进度修正"""
+        return self._post(f"/admin/sp/progress/operations", payload, **kwargs)
+
 class AdminVoteRewardMailAPI(_BaseApi):
     def create(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
         """创建投票奖励邮件"""
         return self._post(f"/admin/vote-reward-mails", payload, **kwargs)
 
+class AnnouncementsAPI(_BaseApi):
+    def create(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """新建公告"""
+        return self._post(f"/admin/announcements", payload, **kwargs)
+
+    def get(self, id: str, **kwargs: Any) -> Any:
+        """读取公告管理详情"""
+        return self._get(f"/admin/announcements/{quote(str(id), safe='')}", None, **kwargs)
+
+    def list(self, **kwargs: Any) -> Any:
+        """读取服内生效公告"""
+        return self._get(f"/announcements", None, **kwargs)
+
+    def list_get(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """查询公告管理列表"""
+        return self._get(f"/admin/announcements", query, **kwargs)
+
+    def move(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """原子移动公告顺序"""
+        return self._post(f"/admin/announcements/{quote(str(id), safe='')}/move", payload, **kwargs)
+
+    def remove(self, id: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """公告移入回收站"""
+        return self._delete(f"/admin/announcements/{quote(str(id), safe='')}", query, **kwargs)
+
+    def restore(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """恢复公告"""
+        return self._post(f"/admin/announcements/{quote(str(id), safe='')}/restore", payload, **kwargs)
+
+    def update(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """修改公告"""
+        return self._patch(f"/admin/announcements/{quote(str(id), safe='')}", payload, **kwargs)
+
 class AuditAPI(_BaseApi):
     def get_admin_logs(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
         """查询管理员操作日志"""
@@ -732,6 +851,88 @@ class AuthAPI(_BaseApi):
         """刷新 Token"""
         return self._post(f"/auth/refresh", payload, **kwargs)
 
+class CatalogAPI(_BaseApi):
+    def __init__(self, http: _HttpClient) -> None:
+        super().__init__(http)
+        self.sync = CatalogSyncAPI(http)
+
+    def batch_update_products(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """批量设置商品价格、稀有度或状态"""
+        return self._post(f"/catalog/products/batch-update", payload, **kwargs)
+
+    def change_product_status(self, id: Union[int, float], payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """商品状态流转"""
+        return self._post(f"/catalog/products/{quote(str(id), safe='')}/status", payload, **kwargs)
+
+    def create_product(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """新建商品"""
+        return self._post(f"/catalog/products", payload, **kwargs)
+
+    def create_type(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """新建商品类型"""
+        return self._post(f"/catalog/types", payload, **kwargs)
+
+    def delete_products(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """移入商品回收站"""
+        return self._post(f"/catalog/products/batch-delete", payload, **kwargs)
+
+    def export_by_type(self, typeId: str, **kwargs: Any) -> Any:
+        """按类型导出 CodeFunCore 商品配置 JSON"""
+        return self._get(f"/catalog/export/{quote(str(typeId), safe='')}", None, **kwargs)
+
+    def get_product_detail(self, id: Union[int, float], **kwargs: Any) -> Any:
+        """获取商品详情"""
+        return self._get(f"/catalog/products/{quote(str(id), safe='')}", None, **kwargs)
+
+    def get_suit_parts(self, id: Union[int, float], **kwargs: Any) -> Any:
+        """获取套装部件列表"""
+        return self._get(f"/catalog/products/{quote(str(id), safe='')}/parts", None, **kwargs)
+
+    def list_products(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """分页查询商品列表"""
+        return self._get(f"/catalog/products", query, **kwargs)
+
+    def list_published_products(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """分页查询正式服已上架商品"""
+        return self._get(f"/catalog/published-products", query, **kwargs)
+
+    def list_types(self, **kwargs: Any) -> Any:
+        """获取商品类型列表"""
+        return self._get(f"/catalog/types", None, **kwargs)
+
+    def replace_suit_parts(self, id: Union[int, float], payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """整体替换套装部件列表"""
+        return self._put(f"/catalog/products/{quote(str(id), safe='')}/parts", payload, **kwargs)
+
+    def restore_products(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """恢复回收站商品"""
+        return self._post(f"/catalog/products/batch-restore", payload, **kwargs)
+
+    def update_product(self, id: Union[int, float], payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """更新商品"""
+        return self._put(f"/catalog/products/{quote(str(id), safe='')}", payload, **kwargs)
+
+    def update_type(self, typeId: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """更新商品类型"""
+        return self._put(f"/catalog/types/{quote(str(typeId), safe='')}", payload, **kwargs)
+
+class CatalogSyncAPI(_BaseApi):
+    def apply(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """把选中商品写入当前工作区商品文件"""
+        return self._post(f"/catalog-sync/apply", payload, **kwargs)
+
+    def conflicts(self, **kwargs: Any) -> Any:
+        """列出被多个分支关联的商品"""
+        return self._get(f"/catalog-sync/conflicts", None, **kwargs)
+
+    def diff(self, **kwargs: Any) -> Any:
+        """工作区商品文件与 catalog 生成结果的键级 diff"""
+        return self._get(f"/catalog-sync/diff", None, **kwargs)
+
+    def suggestions(self, **kwargs: Any) -> Any:
+        """当前工作区的商品同步建议"""
+        return self._get(f"/catalog-sync/suggestions", None, **kwargs)
+
 class GameLogAPI(_BaseApi):
     def get_disaster_events(self, **kwargs: Any) -> Any:
         """获取灾难事件字典"""
@@ -773,6 +974,10 @@ class GameLogAPI(_BaseApi):
         """分页查询游戏玩家记录"""
         return self._get(f"/game-logs/players", query, **kwargs)
 
+    def get_ze_statistics(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """生化大逃杀大盘统计"""
+        return self._get(f"/game-logs/zombieescape/statistics", query, **kwargs)
+
 class EchoMelandAPI(_BaseApi):
     def add_favorite(self, worldId: Union[int, float], ecid: str, **kwargs: Any) -> Any:
         """添加玩家家园收藏"""
@@ -888,11 +1093,289 @@ class LogOrderExchangeAPI(_BaseApi):
         """分页查询兑换日志"""
         return self._get(f"/order-exchange-logs", query, **kwargs)
 
+class LotteryAPI(_BaseApi):
+    def cancel(self, id: str, **kwargs: Any) -> Any:
+        """取消不再需要的模拟"""
+        return self._post(f"/lottery/simulations/{quote(str(id), safe='')}/cancel", None, **kwargs)
+
+    def convert(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """预览转换旧抽奖配置"""
+        return self._post(f"/lottery/convert", payload, **kwargs)
+
+    def copy(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """复制为独立文件"""
+        return self._post(f"/lottery/nodes/{quote(str(id), safe='')}/copy", payload, **kwargs)
+
+    def create(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """新建抽奖文件或目录"""
+        return self._post(f"/lottery/nodes", payload, **kwargs)
+
+    def document(self, id: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """读取当前或历史文件原文"""
+        return self._get(f"/lottery/documents/{quote(str(id), safe='')}", query, **kwargs)
+
+    def download(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """下载单文件或完整配置文件组"""
+        return self._post(f"/lottery/downloads", payload, **kwargs)
+
+    def history(self, id: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """浏览文件保存历史"""
+        return self._get(f"/lottery/documents/{quote(str(id), safe='')}/revisions", query, **kwargs)
+
+    def nodes(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """列出抽奖文件与目录"""
+        return self._get(f"/lottery/nodes", query, **kwargs)
+
+    def preview(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """解释下一抽的候选与保底"""
+        return self._post(f"/lottery/preview", payload, **kwargs)
+
+    def product_options(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """解析所选商品的抽奖发放规格"""
+        return self._post(f"/lottery/product-options", payload, **kwargs)
+
+    def restore(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """把历史内容恢复成新版本"""
+        return self._post(f"/lottery/documents/{quote(str(id), safe='')}/restore", payload, **kwargs)
+
+    def save(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """手动保存YAML并创建历史版本"""
+        return self._put(f"/lottery/documents/{quote(str(id), safe='')}", payload, **kwargs)
+
+    def simulation(self, id: str, **kwargs: Any) -> Any:
+        """查询抽奖模拟任务执行状态与奖励统计"""
+        return self._get(f"/lottery/simulations/{quote(str(id), safe='')}", None, **kwargs)
+
+    def simulations(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """查看最近的模拟记录"""
+        return self._get(f"/lottery/simulations", query, **kwargs)
+
+    def start(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """提交异步模拟"""
+        return self._post(f"/lottery/simulations", payload, **kwargs)
+
+    def templates(self, **kwargs: Any) -> Any:
+        """选择抽奖箱与公共池模板"""
+        return self._get(f"/lottery/templates", None, **kwargs)
+
+    def update_node(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """重命名、移动或移入/恢复回收站"""
+        return self._patch(f"/lottery/nodes/{quote(str(id), safe='')}", payload, **kwargs)
+
+    def validate(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """检查配置、商品引用及公共池依赖"""
+        return self._post(f"/lottery/validate", payload, **kwargs)
+
+class MinecraftDeveloperAPI(_BaseApi):
+    def __init__(self, http: _HttpClient) -> None:
+        super().__init__(http)
+        self.messages = MinecraftMessagesAPI(http)
+        self.mobile_mods = MinecraftMobileModsAPI(http)
+
+    def apply_self_test(self, edition: str, projectId: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """申请手游自测"""
+        return self._post(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/self-test-applications", payload, **kwargs)
+
+    def cancel_self_test(self, edition: str, projectId: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """取消手游自测"""
+        return self._delete(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/self-test-applications/current", query, **kwargs)
+
+    def connect_session(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """连接官方登录会话"""
+        return self._put(f"/mcdev/auth/session", payload, **kwargs)
+
+    def disconnect_session(self, **kwargs: Any) -> Any:
+        """断开 ECAPI 的网易会话"""
+        return self._delete(f"/mcdev/auth/session", None, **kwargs)
+
+    def download_mobile_package(self, edition: str, projectId: str, **kwargs: Any) -> Any:
+        """下载手游资源包"""
+        return self._get(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/mobile-package", None, response_type="bytes", **kwargs)
+
+    def get_project(self, edition: str, projectId: str, **kwargs: Any) -> Any:
+        """获取开发者项目"""
+        return self._get(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}", None, **kwargs)
+
+    def get_project_status(self, edition: str, projectId: str, **kwargs: Any) -> Any:
+        """查询项目异步状态"""
+        return self._get(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/status", None, **kwargs)
+
+    def get_review_feedback(self, edition: str, projectId: str, **kwargs: Any) -> Any:
+        """查询项目审核意见"""
+        return self._get(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/review-feedback", None, **kwargs)
+
+    def get_session(self, **kwargs: Any) -> Any:
+        """查询网易账号连接状态"""
+        return self._get(f"/mcdev/auth/session", None, **kwargs)
+
+    def list_player_feedbacks(self, edition: str, projectId: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """查询项目玩家反馈"""
+        return self._get(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/player-feedbacks", query, **kwargs)
+
+    def list_project_orders(self, edition: str, projectId: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """查询项目订单"""
+        return self._get(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/orders", query, **kwargs)
+
+    def list_projects(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """列出开发者项目"""
+        return self._get(f"/mcdev/projects", query, **kwargs)
+
+    def publish_online(self, edition: str, projectId: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """上架审核通过项目"""
+        return self._post(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/online-publications", payload, **kwargs)
+
+    def replace_resource_pack(self, edition: str, projectId: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """上传并替换资源包"""
+        payload = _MultipartBody(payload, ['package'])
+        return self._post(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/resource-packs", payload, **kwargs)
+
+    def revoke_review(self, edition: str, projectId: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """撤销网易审核"""
+        return self._delete(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/review-submissions/current", query, **kwargs)
+
+    def submit_review(self, edition: str, projectId: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """提交网易审核"""
+        return self._post(f"/mcdev/projects/{quote(str(edition), safe='')}/{quote(str(projectId), safe='')}/review-submissions", payload, **kwargs)
+
+class MinecraftMessagesAPI(_BaseApi):
+    def detail(self, messageId: str, **kwargs: Any) -> Any:
+        """读取审核消息正文"""
+        return self._get(f"/mcdev/messages/{quote(str(messageId), safe='')}", None, **kwargs)
+
+    def list(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """分页查询审核与打包消息"""
+        return self._get(f"/mcdev/messages", query, **kwargs)
+
+    def mark_read(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """标记指定审核消息已读"""
+        return self._post(f"/mcdev/message-read-receipts", payload, **kwargs)
+
+    def unread(self, **kwargs: Any) -> Any:
+        """查询审核消息未读数量"""
+        return self._get(f"/mcdev/messages/unread-count", None, **kwargs)
+
+class MinecraftMobileModsAPI(_BaseApi):
+    def apply_self_test(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """申请手机组件自测"""
+        return self._post(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/self-test-applications", payload, **kwargs)
+
+    def cancel_self_test(self, id: str, **kwargs: Any) -> Any:
+        """取消手机组件自测"""
+        return self._delete(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/self-test-applications/current", None, **kwargs)
+
+    def create(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """创建手机组件"""
+        return self._post(f"/mcdev/mobile-mods", payload, **kwargs)
+
+    def detail(self, id: str, **kwargs: Any) -> Any:
+        """读取手机组件编辑内容"""
+        return self._get(f"/mcdev/mobile-mods/{quote(str(id), safe='')}", None, **kwargs)
+
+    def feedback(self, id: str, **kwargs: Any) -> Any:
+        """读取手机组件审核意见"""
+        return self._get(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/review-feedback", None, **kwargs)
+
+    def list(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """分页查询手机组件"""
+        return self._get(f"/mcdev/mobile-mods", query, **kwargs)
+
+    def metadata(self, **kwargs: Any) -> Any:
+        """读取手机组件编辑规则"""
+        return self._get(f"/mcdev/mobile-mods/metadata", None, **kwargs)
+
+    def preview_asset(self, id: str, assetId: str, **kwargs: Any) -> Any:
+        """读取手机组件素材"""
+        return self._get(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/assets/{quote(str(assetId), safe='')}/content", None, response_type="bytes", **kwargs)
+
+    def preview_upload(self, uploadId: str, **kwargs: Any) -> Any:
+        """预览已上传图片"""
+        return self._get(f"/mcdev/mobile-mods/uploads/{quote(str(uploadId), safe='')}/content", None, response_type="bytes", **kwargs)
+
+    def revoke_review(self, id: str, **kwargs: Any) -> Any:
+        """撤销手机组件审核"""
+        return self._delete(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/review-submissions/current", None, **kwargs)
+
+    def status(self, id: str, **kwargs: Any) -> Any:
+        """查询手机组件处理状态"""
+        return self._get(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/status", None, **kwargs)
+
+    def submit_review(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """提交手机组件审核"""
+        return self._post(f"/mcdev/mobile-mods/{quote(str(id), safe='')}/review-submissions", payload, **kwargs)
+
+    def update(self, id: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """保存手机组件修改"""
+        return self._patch(f"/mcdev/mobile-mods/{quote(str(id), safe='')}", payload, **kwargs)
+
+    def upload(self, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """上传手机组件素材"""
+        payload = _MultipartBody(payload, ['file'])
+        return self._post(f"/mcdev/mobile-mods/uploads", payload, **kwargs)
+
+class OSSAPI(_BaseApi):
+    def get_ze_content(self, fileName: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """读取 ZE OSS 配置内容"""
+        return self._get(f"/managed-objects/ze/content/{quote(str(fileName), safe='')}", query, **kwargs)
+
+    def get_zvs_reload_content(self, fileName: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """读取 ZVS Reload OSS 配置内容"""
+        return self._get(f"/managed-objects/zvs-reload/content/{quote(str(fileName), safe='')}", query, **kwargs)
+
+    def list_ze(self, **kwargs: Any) -> Any:
+        """列出 ZE OSS 配置"""
+        return self._get(f"/managed-objects/ze", None, **kwargs)
+
+    def list_ze_versions(self, fileName: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """查询 ZE OSS 配置版本"""
+        return self._get(f"/managed-objects/ze/versions/{quote(str(fileName), safe='')}", query, **kwargs)
+
+    def list_zvs_reload(self, **kwargs: Any) -> Any:
+        """列出 ZVS Reload OSS 配置"""
+        return self._get(f"/managed-objects/zvs-reload", None, **kwargs)
+
+    def list_zvs_reload_versions(self, fileName: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """查询 ZVS Reload OSS 配置版本"""
+        return self._get(f"/managed-objects/zvs-reload/versions/{quote(str(fileName), safe='')}", query, **kwargs)
+
+    def preview_ze_sync(self, mapKey: str, **kwargs: Any) -> Any:
+        """预览 bbdev Node-RED 到正式 OSS 的 ZE 同步"""
+        return self._get(f"/managed-objects/ze/{quote(str(mapKey), safe='')}/sync-preview", None, **kwargs)
+
+    def publish_ze_from_bbdev(self, mapKey: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """从 bbdev Node-RED 发布 ZE 配置到正式 OSS"""
+        return self._post(f"/managed-objects/ze/{quote(str(mapKey), safe='')}/publish-from-bbdev", payload, **kwargs)
+
+    def update_ze_content(self, fileName: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """更新 ZE OSS 配置内容"""
+        return self._put(f"/managed-objects/ze/content/{quote(str(fileName), safe='')}", payload, **kwargs)
+
+    def update_zvs_reload_content(self, fileName: str, payload: Mapping[str, Any], **kwargs: Any) -> Any:
+        """更新 ZVS Reload OSS 配置内容"""
+        return self._put(f"/managed-objects/zvs-reload/content/{quote(str(fileName), safe='')}", payload, **kwargs)
+
+class ParkourAPI(_BaseApi):
+    def get_level_detail(self, levelId: Union[int, float], **kwargs: Any) -> Any:
+        """获取跑酷关卡详情"""
+        return self._get(f"/parkour/levels/{quote(str(levelId), safe='')}", None, **kwargs)
+
+    def get_level_leaderboard(self, levelId: Union[int, float], query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """获取跑酷关卡排行榜"""
+        return self._get(f"/parkour/levels/{quote(str(levelId), safe='')}/leaderboard", query, **kwargs)
+
+    def get_levels(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """分页查询跑酷关卡"""
+        return self._get(f"/parkour/levels", query, **kwargs)
+
+    def get_tracks(self, **kwargs: Any) -> Any:
+        """获取跑酷赛道列表"""
+        return self._get(f"/parkour/tracks", None, **kwargs)
+
 class PlayerAPI(_BaseApi):
     def __init__(self, http: _HttpClient) -> None:
         super().__init__(http)
         self.entitlement = PlayerEntitlementAPI(http)
         self.leaderboard = PlayerLeaderboardAPI(http)
+        self.parkour = PlayerParkourAPI(http)
         self.rank_score = PlayerRankScoreAPI(http)
         self.score = PlayerScoreAPI(http)
         self.source_account = PlayerSourceAccountAPI(http)
@@ -915,7 +1398,7 @@ class PlayerAPI(_BaseApi):
         return self._get(f"/players/{quote(str(ecid), safe='')}/farm/freshness-batches", query, **kwargs)
 
     def get_farm_overview(self, ecid: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
-        """查询 EC 农场 S1 完整总览"""
+        """查询 EC 农场总览（S1 与 S2 核心状态）"""
         return self._get(f"/players/{quote(str(ecid), safe='')}/farm/overview", query, **kwargs)
 
     def get_farm_summary(self, ecid: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
@@ -970,6 +1453,10 @@ class PlayerAPI(_BaseApi):
         """分页查询玩家邀请记录"""
         return self._get(f"/players/{quote(str(ecid), safe='')}/referrals", query, **kwargs)
 
+    def resolve(self, nickid: str, **kwargs: Any) -> Any:
+        """解析举报匿名身份"""
+        return self._get(f"/admin/nickname-sessions/{quote(str(nickid), safe='')}", None, **kwargs)
+
     def search(self, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
         """查询玩家搜索命中列表"""
         return self._get(f"/players", query, **kwargs)
@@ -988,6 +1475,19 @@ class PlayerLeaderboardAPI(_BaseApi):
         """批量查询排行榜数据"""
         return self._get(f"/leaderboards/scores", query, **kwargs)
 
+class PlayerParkourAPI(_BaseApi):
+    def get_recent_scores(self, ecid: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """获取玩家最近的跑酷成绩"""
+        return self._get(f"/players/{quote(str(ecid), safe='')}/parkour/recent-scores", query, **kwargs)
+
+    def get_summary(self, ecid: str, **kwargs: Any) -> Any:
+        """获取玩家跑酷总览"""
+        return self._get(f"/players/{quote(str(ecid), safe='')}/parkour/summary", None, **kwargs)
+
+    def get_track_progress(self, ecid: str, trackKey: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
+        """获取玩家单条赛道的逐关进度"""
+        return self._get(f"/players/{quote(str(ecid), safe='')}/parkour/tracks/{quote(str(trackKey), safe='')}", query, **kwargs)
+
 class PlayerRankScoreAPI(_BaseApi):
     def get_history(self, ecid: str, query: Optional[QueryParams] = None, **kwargs: Any) -> Any:
         """查询玩家历史赛季段位数据"""
@@ -1389,11 +1889,17 @@ class ECAPIClient:
     ) -> None:
         self._http = _HttpClient(base_url, auth, timeout_seconds, default_headers, auth_provider)
         self.admin = AdminAPI(self._http)
+        self.announcements = AnnouncementsAPI(self._http)
         self.audit = AuditAPI(self._http)
         self.auth = AuthAPI(self._http)
+        self.catalog = CatalogAPI(self._http)
         self.game_log = GameLogAPI(self._http)
         self.homeland = EchoMelandAPI(self._http)
         self.log = LogAPI(self._http)
+        self.lottery = LotteryAPI(self._http)
+        self.minecraft_developer = MinecraftDeveloperAPI(self._http)
+        self.oss = OSSAPI(self._http)
+        self.parkour = ParkourAPI(self._http)
         self.pit2 = PIT2API(self._http)
         self.player = PlayerAPI(self._http)
         self.replay = ReplayAPI(self._http)