@easecation/ecapi-sdk 0.1.3 → 3.0.4

package/dist/apis.js

@@ -1,606 +1,1041 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SystemApi = exports.PullConfigApi = exports.MonitorApi = exports.SpamDetectorApi = exports.AuditApi = exports.EaseChatApi = exports.BroadcastApi = exports.GlobalKVApi = exports.CfgLangApi = exports.LobbyApi = exports.ServersApi = exports.CountApi = exports.ItemApi = exports.StageApi = exports.StageLogApi = exports.OrderApi = exports.LogApi = exports.PermissionApi = exports.BanApi = exports.PunishApi = exports.AdminApi = exports.PlayerApi = exports.PlayerVoteApi = exports.PlayerYearSummaryApi = exports.PlayerMerchandiseApi = exports.PlayerTasksApi = exports.PlayerScoreApi = exports.UserApi = void 0;
-/**
- * Shared low-level HTTP wrappers used by all API groups.
- * These helpers keep auth/header/retry behavior consistent across modules.
- */
+exports.UserApi = exports.SystemApi = exports.StageLogApi = exports.StageApi = exports.ServersApi = exports.PunishApi = exports.PullConfigApi = exports.PlayerYearSummaryApi = exports.PlayerVoteApi = exports.PlayerTasksApi = exports.PlayerScoreApi = exports.PlayerRankScoreApi = exports.PlayerMerchandiseApi = exports.CutoffLeaderboardApi = exports.PlayerApi = exports.PermissionApi = exports.OrderApi = exports.SpamDetectorApi = exports.MonitorApi = exports.LogApi = exports.LobbyApi = exports.ItemApi = exports.GlobalKVApi = exports.GamelogApi = exports.EaseChatApi = exports.CountApi = exports.CfgLangApi = exports.BroadcastApi = exports.AuthApi = exports.AuditApi = exports.AdminApi = void 0;
 class BaseApi {
     constructor(http) {
         this.http = http;
     }
-    get(path, query, options) {
-        return this.http.request("GET", path, { ...options, query });
-    }
-    post(path, body, options) {
-        return this.http.request("POST", path, { ...options, body });
-    }
-    put(path, body, options) {
-        return this.http.request("PUT", path, { ...options, body });
-    }
-    patch(path, body, options) {
-        return this.http.request("PATCH", path, { ...options, body });
-    }
-    delete(path, query, options) {
-        return this.http.request("DELETE", path, { ...options, query });
-    }
 }
-class UserApi extends BaseApi {
-    /**
-     * Get current user profile.
-     * Note: backend expects Authorization token for this endpoint in some deployments.
-     */
-    getMe(query, options) {
-        return this.get("/user/me", query, options);
-    }
-    loginByPassword(payload, options) {
-        return this.post("/user/auth", payload, options);
+class AdminApi extends BaseApi {
+    /** 删除邮件 🔐 **权限要求**: `mail` — 邮件系统权限
+       *
+       * 按邮件 ID 删除指定服内邮件，删除成功时返回 deleted=true；邮件不存在时返回 NOT_FOUND。 需要权限：`mail`。 */
+    deleteMail(mailId, options) {
+        return this.http.request('DELETE', `/admin/mail/${encodeURIComponent(String(mailId))}`, { ...options });
+    }
+    /** 分页查询管理员操作日志 🔐 **权限要求**: `game_admin` — 管理操作统计
+       *
+       * 按统一分页参数 current/pageSize 查询管理员操作日志，可按操作者、目标玩家和时间范围筛选，并可开启封禁历史合并解析。 需要权限：`game_admin`。 */
+    getOperationLogs(query, options) {
+        return this.http.request('GET', `/admin/operations`, { ...options, query });
     }
-    loginByOauth2(payload, options) {
-        return this.post("/user/oauth2", payload, options);
+    /** 查询操作日志统计 🔐 **权限要求**: `game_admin` — 管理操作统计
+       *
+       * 按时间范围统计管理员操作日志，响应 data.statistics 返回操作者、操作类型和操作次数聚合结果。 需要权限：`game_admin`。 */
+    getOperationStatistics(query, options) {
+        return this.http.request('GET', `/admin/operations/statistic`, { ...options, query });
     }
-    refreshToken(payload, options) {
-        return this.post("/user/refresh", payload, options);
+    /** 分页查询 Overwatch 案件 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询 Overwatch 监管案件；提供 recordId 时返回该回放对应的单个案件结果。 需要权限：`player_info`。 */
+    getOverwatchCase(query, options) {
+        return this.http.request('GET', `/admin/overwatch`, { ...options, query });
     }
-    /**
-     * Get current user's OpenID.
-     * May return 404 if OpenID context is unavailable for current auth mode.
-     */
-    getOpenId(query, options) {
-        return this.get("/user/openid", query, options);
+    /** 分页查询设备封禁日志 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 按统一分页参数 current/pageSize 查询 Prism 设备封禁历史记录，可按设备 ID 筛选；无 punish_device 权限时会隐藏设备敏感信息。 需要权限：`punish`。 */
+    getPrismDeviceBanLog(query, options) {
+        return this.http.request('GET', `/admin/prism-device-ban-log`, { ...options, query });
     }
-    /** List all registered users (admin-scoped endpoint). */
-    listAll(query, options) {
-        return this.get("/user/all", query, options);
+    /** 设置设备封禁状态 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 按设备 ID 执行 Prism 设备封禁或解封；hours 为 -1 时表示解除封禁。 需要权限：`punish`。 */
+    prismDeviceBan(payload, options) {
+        return this.http.request('POST', `/admin/prism-device-ban`, { ...options, body: payload });
     }
-    updatePermissions(payload, options) {
-        return this.put("/user/permissions", payload, options);
+    /** 发送邮件 🔐 **权限要求**: `mail` — 邮件系统权限
+       *
+       * 向指定玩家发送服内邮件，可携带金币、钻石、经验和道具附件；邮件创建成功后会异步发送飞书通知，通知失败不影响邮件创建。 需要权限：`mail`。 */
+    sendMail(payload, options) {
+        return this.http.request('POST', `/admin/mail`, { ...options, body: payload });
     }
-    /** Query user detail by user id. */
-    getById(id, query, options) {
-        return this.get(`/user/${encodeURIComponent(id)}`, query, options);
+    /** 添加 Overwatch 案件 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 将指定回放记录创建或更新为 Overwatch 监管案件，可同时写入案件状态、目标玩家、处罚信息、难度和评审配置。 需要权限：`punish`。 */
+    upsertOverwatchCase(payload, options) {
+        return this.http.request('POST', `/admin/overwatch`, { ...options, body: payload });
     }
 }
-exports.UserApi = UserApi;
-class PlayerScoreApi extends BaseApi {
-    /**
-     * Get player score summary.
-     * Common required query: `nick`, `game`.
-     */
-    getScore(query, options) {
-        return super.get("/player/score", query, options);
-    }
-    /** Get player score stages. Common required query: `nick`. */
-    getStages(query, options) {
-        return super.get("/player/score/stages", query, options);
-    }
-    /**
-     * Get top ranking records.
-     * Common required query: `game`, `score_type`, `deadline_type`, `limit`, `is_ascending`.
-     */
-    getTop(query, options) {
-        return super.get("/player/score/top", query, options);
-    }
-    deleteTop(query, options) {
-        return super.delete("/player/score/top", query, options);
-    }
-    getConfig(query, options) {
-        return super.get("/player/score/config", query, options);
+exports.AdminApi = AdminApi;
+class AuditApi extends BaseApi {
+    /** 查询管理员操作日志 🔐 **权限要求**: `audit` — 审计权限
+       *
+       * 按统一分页参数 current/pageSize 查询管理员操作审计日志，可按操作类型、高风险标记、操作者、时间范围和操作状态筛选。 需要权限：`audit`。 */
+    getAdminLogs(query, options) {
+        return this.http.request('GET', `/audits/admin`, { ...options, query });
     }
-    getLeaderboard(query, options) {
-        return super.get("/player/score/leaderboard", query, options);
+    /** 查询用户认证日志 🔐 **权限要求**: `audit` — 审计权限
+       *
+       * 按统一分页参数 current/pageSize 查询用户认证审计日志，可按时间范围、操作者、客户端 IP、HTTP 方法、认证方式和操作状态筛选。 需要权限：`audit`。 */
+    getAuthLogs(query, options) {
+        return this.http.request('GET', `/audits/auth`, { ...options, query });
     }
-}
-exports.PlayerScoreApi = PlayerScoreApi;
-class PlayerTasksApi extends BaseApi {
-    /**
-     * List tasks for one player.
-     * Common required query: `current`, `pageSize`.
-     */
-    list(ecid, query, options) {
-        return this.get(`/player/${encodeURIComponent(ecid)}/tasks`, query, options);
+    /** 查询配置管理日志 🔐 **权限要求**: `audit` — 审计权限
+       *
+       * 按统一分页参数 current/pageSize 查询配置管理审计日志，可按配置类型、操作类型、操作者、时间范围和操作状态筛选。 需要权限：`audit`。 */
+    getConfigLogs(query, options) {
+        return this.http.request('GET', `/audits/config`, { ...options, query });
     }
-    create(ecid, payload, options) {
-        return this.post(`/player/${encodeURIComponent(ecid)}/tasks`, payload, options);
+    /** 查询权限管理日志 🔐 **权限要求**: `audit` — 审计权限
+       *
+       * 按统一分页参数 current/pageSize 查询权限管理审计日志，可按目标玩家、权限类型、操作类型、操作者、时间范围和操作状态筛选。 需要权限：`audit`。 */
+    getPermissionLogs(query, options) {
+        return this.http.request('GET', `/audits/permission`, { ...options, query });
     }
-    update(ecid, taskId, payload, options) {
-        return this.put(`/player/${encodeURIComponent(ecid)}/tasks/${encodeURIComponent(taskId)}`, payload, options);
+    /** 查询玩家操作日志 🔐 **权限要求**: `audit` — 审计权限
+       *
+       * 按统一分页参数 current/pageSize 查询玩家操作审计日志，可按目标玩家、操作类型、HTTP 方法、操作者、时间范围和操作状态筛选。 需要权限：`audit`。 */
+    getPlayerLogs(query, options) {
+        return this.http.request('GET', `/audits/player`, { ...options, query });
     }
-    deleteOne(ecid, taskId, query, options) {
-        return this.delete(`/player/${encodeURIComponent(ecid)}/tasks/${encodeURIComponent(taskId)}`, query, options);
+    /** 查询处罚操作日志 🔐 **权限要求**: `audit` — 审计权限
+       *
+       * 按统一分页参数 current/pageSize 查询处罚审计日志，可按目标玩家、处罚类型、处罚时长范围、操作者、时间范围和操作状态筛选。 需要权限：`audit`。 */
+    getPunishmentLogs(query, options) {
+        return this.http.request('GET', `/audits/punishment`, { ...options, query });
     }
 }
-exports.PlayerTasksApi = PlayerTasksApi;
-class PlayerMerchandiseApi extends BaseApi {
-    /**
-     * List merchandise items for one player.
-     * Common required query: `current`, `pageSize`.
-     */
-    list(ecid, query, options) {
-        return this.get(`/player/${encodeURIComponent(ecid)}/merchandise`, query, options);
-    }
-    create(ecid, payload, options) {
-        return this.post(`/player/${encodeURIComponent(ecid)}/merchandise`, payload, options);
+exports.AuditApi = AuditApi;
+class AuthApi extends BaseApi {
+    /** 获取用户 OpenId 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 从当前认证上下文解析用户 ID，并以 openId 字段返回。 需要权限：`AUTHENTICATED`。 */
+    getOpenId(options) {
+        return this.http.request('GET', `/auth/open-id`, { ...options });
+    }
+    /** 创建 OAuth2 登录会话 使用从 Nexa 授权服务器获取的一次性 code 换取 IAM Token；redirectUri 按 {FRONTEND_DOMAIN}/user/oauth2 生成，必须与前端发起 IAM 登录时的回调地址一致。 需要权限：`PUBLIC`。 */
+    loginByOauth2(payload, options) {
+        return this.http.request('POST', `/auth/oauth2`, { ...options, body: payload });
     }
-    update(ecid, idItem, payload, options) {
-        return this.put(`/player/${encodeURIComponent(ecid)}/merchandise/${encodeURIComponent(idItem)}`, payload, options);
+    /** 创建密码登录会话 使用后台用户名和密码登录，成功后返回后台控制台访问 Token；密码仅用于认证，不会写入响应或审计详情。 需要权限：`PUBLIC`。 */
+    loginByPassword(payload, options) {
+        return this.http.request('POST', `/auth/login`, { ...options, body: payload });
     }
-    deleteOne(ecid, idItem, query, options) {
-        return this.delete(`/player/${encodeURIComponent(ecid)}/merchandise/${encodeURIComponent(idItem)}`, query, options);
+    /** 刷新 Token 使用 Refresh Token 换取新的 IAM Access Token，响应仅返回 IAM 返回的标准 token 字段。 需要权限：`PUBLIC`。 */
+    refreshToken(payload, options) {
+        return this.http.request('POST', `/auth/refresh`, { ...options, body: payload });
     }
 }
-exports.PlayerMerchandiseApi = PlayerMerchandiseApi;
-class PlayerYearSummaryApi extends BaseApi {
-    /** Get year summary basic info. Common required query: `ecid` (optional `year`). */
-    getBasicInfo(query, options) {
-        return this.get("/player/year-summary/basic-info", query, options);
-    }
-    getLoginStats(query, options) {
-        return this.get("/player/year-summary/login-stats", query, options);
+exports.AuthApi = AuthApi;
+class BroadcastApi extends BaseApi {
+    /** 查询 Broadcast 差异 🔐 **权限要求**: `broadcast` — 广播管理权限
+       *
+       * 比较测试服和正式服 Broadcast 配置差异，返回仅测试服存在、仅正式服存在以及两边均存在但语言字段不同的消息。 需要权限：`broadcast`。 */
+    compare(options) {
+        return this.http.request('GET', `/broadcast-diffs`, { ...options });
+    }
+    /** 创建 Broadcast 🔐 **权限要求**: `broadcast` — 广播管理权限
+       *
+       * 在测试服创建新的 Broadcast 广播消息，至少需要提供一个语言字段。 需要权限：`broadcast`。 */
+    create(payload, options) {
+        return this.http.request('POST', `/broadcast`, { ...options, body: payload });
     }
-    getGameStats(query, options) {
-        return this.get("/player/year-summary/game-stats", query, options);
+    /** 删除 Broadcast 🔐 **权限要求**: `broadcast` — 广播管理权限
+       *
+       * 删除指定的广播消息；记录不存在时仍返回成功，响应中的 deleted 为 false。 需要权限：`broadcast`。 */
+    deleteOne(msg, query, options) {
+        return this.http.request('DELETE', `/broadcast/${encodeURIComponent(String(msg))}`, { ...options, query });
     }
-    getRankData(query, options) {
-        return this.get("/player/year-summary/rank-data", query, options);
+    /** 创建 Broadcast 部署 🔐 **权限要求**: `broadcast` — 广播管理权限
+       *
+       * 将请求体中选择的 Broadcast 差异项从测试服同步到正式服，支持创建或更新指定语言字段。 需要权限：`broadcast`。 */
+    deploy(payload, options) {
+        return this.http.request('POST', `/broadcast-deployments`, { ...options, body: payload });
     }
-    getCurrencyData(query, options) {
-        return this.get("/player/year-summary/currency-data", query, options);
+    /** 获取单个 Broadcast 按广播消息标识 msg 查询单条 Broadcast 配置，并按 env 返回测试服或正式服语言文本。 需要权限：`PUBLIC`。 */
+    getOne(msg, query, options) {
+        return this.http.request('GET', `/broadcast/${encodeURIComponent(String(msg))}`, { ...options, query });
     }
-    getSocialData(query, options) {
-        return this.get("/player/year-summary/social-data", query, options);
+    /** 分页查询 Broadcast 列表 按统一分页参数 current/pageSize 查询 Broadcast 广播消息配置，可按消息标识或语言文本模糊搜索，并可选择 test/prod 环境。 需要权限：`PUBLIC`。 */
+    list(query, options) {
+        return this.http.request('GET', `/broadcast`, { ...options, query });
     }
-}
-exports.PlayerYearSummaryApi = PlayerYearSummaryApi;
-class PlayerVoteApi extends BaseApi {
-    /** Process vote rewards. Common required query: `players` (semicolon-separated). */
-    processRewards(query, options) {
-        return this.get("/player/vote", query, options);
+    /** 更新 Broadcast 🔐 **权限要求**: `broadcast` — 广播管理权限
+       *
+       * 按消息标识 msg 更新测试服 Broadcast 配置，可修改 msg 或任意语言字段。 需要权限：`broadcast`。 */
+    update(msg, payload, options) {
+        return this.http.request('PUT', `/broadcast/${encodeURIComponent(String(msg))}`, { ...options, body: payload });
     }
 }
-exports.PlayerVoteApi = PlayerVoteApi;
-/** Player-related endpoints and nested modules. */
-class PlayerApi extends BaseApi {
-    constructor(http) {
-        super(http);
-        this.score = new PlayerScoreApi(http);
-        this.tasks = new PlayerTasksApi(http);
-        this.merchandise = new PlayerMerchandiseApi(http);
-        this.yearSummary = new PlayerYearSummaryApi(http);
-        this.vote = new PlayerVoteApi(http);
-    }
-    /** Get online/runtime player info. Common required query: `name`. */
-    getInfo(query, options) {
-        return this.get("/player/info", query, options);
-    }
-    /** Search ECID by nickname/ecid keyword. Common required query: `name`. */
-    searchEcid(query, options) {
-        return this.get("/player/searchecid", query, options);
-    }
-    /** Get player profile data. Common required query: `ecid`. */
-    getUserData(query, options) {
-        return this.get("/player/userdata", query, options);
-    }
-    /** Query NetEase player data. Common required query: `name`. */
-    queryNetease(query, options) {
-        return this.get("/player/querynetease", query, options);
-    }
-    setRankLevel(payload, options) {
-        return this.post("/player/ranklevel", payload, options);
-    }
-    clearRespackCache(query, options) {
-        return this.delete("/player/respack/cache", query, options);
-    }
-    /** Get wallet info. Common required query: `ecid`. */
-    getWallet(query, options) {
-        return this.get("/player/wallet", query, options);
-    }
-    listGamingTags(query, options) {
-        return this.get("/player/gaming-tag", query, options);
-    }
-    operateGamingTag(payload, options) {
-        return this.post("/player/gaming-tag", payload, options);
-    }
-    /** Get recent play history. Common required query: `ecid`. */
-    getLastPlayed(query, options) {
-        return this.get("/player/last-played", query, options);
-    }
-    /** Get stage records. Common required query: `ecid`, `start`, `end`. */
-    getStageRecord(query, options) {
-        return this.get("/player/stage/record", query, options);
-    }
-    /** Get player head icon as binary image data. Common required query: `ecid`. */
-    getHeadicon(query, options) {
-        return this.http.request("GET", "/player/headicon", {
-            ...options,
-            query,
-            responseType: "arrayBuffer",
-        });
-    }
-    /** Get player skin as binary image data. Common required query: `ecid`. */
-    getSkin(query, options) {
-        return this.http.request("GET", "/player/skin", {
-            ...options,
-            query,
-            responseType: "arrayBuffer",
-        });
-    }
-    batchNeteaseNicknames(payload, options) {
-        return this.post("/player/neteasenicknames", payload, options);
-    }
-    /** Get player binding info. Common required query: `ecid`. */
-    getBinding(query, options) {
-        return this.get("/player/binding", query, options);
-    }
-    resetBinding(payload, options) {
-        return this.post("/player/reset-binding", payload, options);
-    }
-    updateBinding(payload, options) {
-        return this.post("/player/update-binding", payload, options);
-    }
-    updateUserData(nick, payload, options) {
-        return this.post(`/player/update/${encodeURIComponent(nick)}`, payload, options);
+exports.BroadcastApi = BroadcastApi;
+class CfgLangApi extends BaseApi {
+    /** 查询语言配置差异 🔐 **权限要求**: `cfglang` — 多语言配置管理功能
+       *
+       * 比较指定语言配置表在测试服和正式服的差异，返回仅测试服存在、仅正式服存在以及两边均存在但语言字段不同的条目。 需要权限：`cfglang`。 */
+    compare(query, options) {
+        return this.http.request('GET', `/language-config-diffs`, { ...options, query });
+    }
+    /** 创建语言配置条目 🔐 **权限要求**: `cfglang` — 多语言配置管理功能
+       *
+       * 在指定语言配置表中创建新的测试服语言条目，至少需要提供配置键和可选语言文本。 需要权限：`cfglang`。 */
+    create(table, payload, options) {
+        return this.http.request('POST', `/language-configs/${encodeURIComponent(String(table))}/entries`, { ...options, body: payload });
+    }
+    /** 删除语言配置条目 🔐 **权限要求**: `cfglang` — 多语言配置管理功能
+       *
+       * 按路径参数 table 和 key 删除测试服语言配置条目。 需要权限：`cfglang`。 */
+    deleteOne(table, key, options) {
+        return this.http.request('DELETE', `/language-configs/${encodeURIComponent(String(table))}/entries/${encodeURIComponent(String(key))}`, { ...options });
+    }
+    /** 创建语言配置部署 🔐 **权限要求**: `cfglang` — 多语言配置管理功能
+       *
+       * 将请求体中选择的语言配置差异项从测试服同步到正式服，支持创建或更新指定语言字段。 需要权限：`cfglang`。 */
+    deploy(payload, options) {
+        return this.http.request('POST', `/language-config-deployments`, { ...options, body: payload });
     }
-    updatePassword(ecid, payload, options) {
-        return this.post(`/player/password/${encodeURIComponent(ecid)}`, payload, options);
+    /** 分页查询语言配置 按统一分页参数 current/pageSize 查询语言配置，可选择配置表和 test/prod 环境，并支持按 key 精确筛选或 search 模糊搜索；table=all 时返回 sourceTable。 需要权限：`PUBLIC`。 */
+    list(query, options) {
+        return this.http.request('GET', `/cfglang`, { ...options, query });
     }
-    /** Get password hash by ecid. */
-    getPasswordHash(ecid, query, options) {
-        return this.get(`/player/password/${encodeURIComponent(ecid)}`, query, options);
+    /** 更新语言配置条目 🔐 **权限要求**: `cfglang` — 多语言配置管理功能
+       *
+       * 按配置表和 key 更新测试服语言配置条目，可修改任意语言字段。 需要权限：`cfglang`。 */
+    update(table, key, payload, options) {
+        return this.http.request('PATCH', `/language-configs/${encodeURIComponent(String(table))}/entries/${encodeURIComponent(String(key))}`, { ...options, body: payload });
     }
 }
-exports.PlayerApi = PlayerApi;
-class AdminApi extends BaseApi {
-    sendMail(payload, options) {
-        return this.post("/admin/mail", payload, options);
-    }
-    prismDeviceBan(payload, options) {
-        return this.post("/admin/prism-device-ban", payload, options);
-    }
-    getPrismDeviceBanLog(query, options) {
-        return this.get("/admin/prism-device-ban-log", query, options);
-    }
-    upsertOverwatchCase(payload, options) {
-        return this.post("/admin/overwatch", payload, options);
-    }
-    /** Query overwatch case. Common required query: `record_id`. */
-    getOverwatchCase(query, options) {
-        return this.get("/admin/overwatch", query, options);
+exports.CfgLangApi = CfgLangApi;
+class CountApi extends BaseApi {
+    /** 查询历史玩家数 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 按时间范围查询历史玩家数记录，可通过 types 指定一个或多个玩家数类型，并用 maxPoints 控制每条时间序列的最大采样点数。 需要权限：`AUTHENTICATED`。 */
+    getHistory(query, options) {
+        return this.http.request('GET', `/counts/history`, { ...options, query });
     }
-    /** Query admin operation logs. Common required query: `start`/`end` or `target_nick`. */
-    getOperationLogs(query, options) {
-        return this.get("/admin/operation", query, options);
+    /** 查询最新玩家数 查询各玩家数类型的最新记录，可通过 types 指定类型；服务会自动过滤超过 30 分钟的过期数据。 需要权限：`PUBLIC`。 */
+    getLatest(query, options) {
+        return this.http.request('GET', `/counts/latest`, { ...options, query });
     }
-    /** Query admin operation statistics. Common required query: `start`, `end`. */
-    getOperationStatistics(query, options) {
-        return this.get("/admin/operation/statistic", query, options);
+    /** 获取可用类型 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 查询数据库中已记录过的全部玩家数类型，用于历史和最新玩家数接口的 types 参数。 需要权限：`AUTHENTICATED`。 */
+    getTypes(options) {
+        return this.http.request('GET', `/counts/types`, { ...options });
     }
 }
-exports.AdminApi = AdminApi;
-class PunishApi extends BaseApi {
-    hack(payload, options) {
-        return this.post("/punish/hack", payload, options);
-    }
-    ban(payload, options) {
-        return this.post("/punish/ban", payload, options);
-    }
-    unban(payload, options) {
-        return this.post("/punish/unban", payload, options);
-    }
-    mute(payload, options) {
-        return this.post("/punish/mute", payload, options);
-    }
-    unmute(payload, options) {
-        return this.post("/punish/unmute", payload, options);
+exports.CountApi = CountApi;
+class EaseChatApi extends BaseApi {
+    /** 创建订阅 🔐 **权限要求**: `easechat` — EaseChat权限
+       *
+       * 创建 EaseChat webhook 频道订阅；当指定频道收到消息时会转发到请求体中的 URL，并返回订阅 ID、频道和是否已有同频道订阅。 需要权限：`easechat`。 */
+    createSubscription(payload, options) {
+        return this.http.request('POST', `/easechat/subscriptions`, { ...options, body: payload });
     }
-    warn(payload, options) {
-        return this.post("/punish/warn", payload, options);
+    /** 删除订阅 🔐 **权限要求**: `easechat` — EaseChat权限
+       *
+       * 通过订阅 ID 删除 EaseChat webhook 订阅，响应返回被删除订阅的 ID、名称和频道。 需要权限：`easechat`。 */
+    deleteSubscription(subscriptionId, options) {
+        return this.http.request('DELETE', `/easechat/subscriptions/${encodeURIComponent(String(subscriptionId))}`, { ...options });
     }
-    kick(payload, options) {
-        return this.post("/punish/kick", payload, options);
+    /** 分页查询订阅 🔐 **权限要求**: `easechat` — EaseChat权限
+       *
+       * 按统一分页参数 current/pageSize 查询当前所有 EaseChat webhook 频道订阅。 需要权限：`easechat`。 */
+    listSubscriptions(query, options) {
+        return this.http.request('GET', `/easechat/subscriptions`, { ...options, query });
     }
-    clearDegree(payload, options) {
-        return this.post("/punish/clear-degree", payload, options);
+    /** 发送 HLABA 消息 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 通过控制台身份向 EaseChat Helper 频道发送 HLABA 消息，响应返回发送人、展示名和实际发送文本。 需要权限：`AUTHENTICATED`。 */
+    sendHlaba(payload, options) {
+        return this.http.request('POST', `/easechat/hlaba`, { ...options, body: payload });
     }
-    overwatch(payload, options) {
-        return this.post("/punish/overwatch", payload, options);
+}
+exports.EaseChatApi = EaseChatApi;
+class GamelogApi extends BaseApi {
+    /** 获取灾难事件字典 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 从 cfgLanguage 中读取 disasters.name.* 多语言配置，返回灾难事件 ID、中文名和英文名，可用于展示玩家累计事件统计。 需要权限：`player_info`。 */
+    getDisasterEvents(options) {
+        return this.http.request('GET', `/game-logs/disasters/events`, { ...options });
+    }
+    /** 获取单局灾难对局详情 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 根据 stageId 查询 disasters 单局玩家记录、存活/击杀汇总。 需要权限：`player_info`。 */
+    getDisasterMatchDetails(stageId, options) {
+        return this.http.request('GET', `/game-logs/disasters/matches/${encodeURIComponent(String(stageId))}`, { ...options });
+    }
+    /** 分页查询灾难对局日志 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 基于 MySQL logPlayerScore 与 logStageAction 查询指定玩家参与过的 disasters 对局；必须提供 ecid，可按对局时间范围筛选。 需要权限：`player_info`。 */
+    getDisasterMatches(query, options) {
+        return this.http.request('GET', `/game-logs/disasters/matches`, { ...options, query });
+    }
+    /** 获取玩家灾难点数与灾级 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 从 dataItem 中 category=disasters 的玩家条目读取灾级/星级、点数候选字段、每日统计和 col.<event>.enc/sur 累计事件统计，并关联灾难事件字典。 需要权限：`player_info`。 */
+    getDisasterPlayerStats(ecid, options) {
+        return this.http.request('GET', `/game-logs/disasters/players/${encodeURIComponent(String(ecid))}/stats`, { ...options });
+    }
+    /** 获取游戏列表 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询 MongoDB 数据库，返回所有包含日志数据的游戏代号；响应 data.games 为游戏代号列表。 需要权限：`player_info`。 */
+    getGames(options) {
+        return this.http.request('GET', `/game-logs/games`, { ...options });
+    }
+    /** 获取单局对局详情 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 根据查询参数 game 和路径参数 sessionId 查询单局对局详情，返回对局基础数据、参与玩家数据和可解析的事件明细。 需要权限：`player_info`。 */
+    getMatchDetails(sessionId, query, options) {
+        return this.http.request('GET', `/game-logs/matches/${encodeURIComponent(String(sessionId))}`, { ...options, query });
+    }
+    /** 分页查询对局记录 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 从 game 指定的 Mongo 日志集合查询全局对局记录；可按玩家 ECID 筛选，并按对局起止时间与查询时间范围是否重叠筛选。 需要权限：`player_info`。 */
+    getMatches(query, options) {
+        return this.http.request('GET', `/game-logs/matches`, { ...options, query });
+    }
+    /** 获取 Pit 会话详情 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 根据 Pit 会话文档 ID 查询单次 Pit 会话详情，返回服务器、加入时间和参与玩家记录。 需要权限：`player_info`。 */
+    getPitSessionDetails(id, options) {
+        return this.http.request('GET', `/game-logs/pit-sessions/${encodeURIComponent(String(id))}`, { ...options });
+    }
+    /** 分页查询 Pit 会话列表 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询 Pit 会话记录，支持按服务器名称、玩家 ECID 筛选，并按会话加入到离开时间与查询时间范围是否重叠筛选。 需要权限：`player_info`。 */
+    getPitSessions(query, options) {
+        return this.http.request('GET', `/game-logs/pit-sessions`, { ...options, query });
+    }
+    /** 分页查询游戏玩家记录 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询指定游戏的玩家记录；时间筛选按玩家记录 Mongo 文档 ObjectId 时间近似过滤。 需要权限：`player_info`。 */
+    getPlayers(query, options) {
+        return this.http.request('GET', `/game-logs/players`, { ...options, query });
     }
 }
-exports.PunishApi = PunishApi;
-class BanApi extends BaseApi {
-    ban(payload, options) {
-        return this.post("/ban", payload, options);
+exports.GamelogApi = GamelogApi;
+class GlobalKVApi extends BaseApi {
+    /** 创建 GlobalKV 🔐 **权限要求**: `globalkv` — GlobalKV全局配置管理权限
+       *
+       * 创建新的 GlobalKV 键值配置；可设置 TTL，overwrite=false 时如果键已存在则返回冲突错误。 需要权限：`globalkv`。 */
+    create(payload, options) {
+        return this.http.request('POST', `/globalkv`, { ...options, body: payload });
     }
-    clearDegree(payload, options) {
-        return this.post("/ban/clear-degree", payload, options);
+    /** 创建 GlobalKV 批量删除任务 🔐 **权限要求**: `globalkv` — GlobalKV全局配置管理权限
+       *
+       * 批量删除请求体中的多个 GlobalKV 键名，返回成功删除数量、失败数量和原始键名列表。 需要权限：`globalkv`。 */
+    deleteBatch(payload, options) {
+        return this.http.request('POST', `/globalkv-deletion-jobs`, { ...options, body: payload });
+    }
+    /** 删除单个 GlobalKV 🔐 **权限要求**: `globalkv` — GlobalKV全局配置管理权限
+       *
+       * 删除指定的键值对；键不存在时仍返回成功，响应中的 deleted 为 false。 需要权限：`globalkv`。 */
+    deleteOne(key, options) {
+        return this.http.request('DELETE', `/globalkv/${encodeURIComponent(String(key))}`, { ...options });
+    }
+    /** 获取单个 GlobalKV 🔐 **权限要求**: `globalkv` — GlobalKV全局配置管理权限
+       *
+       * 按键名读取单个 GlobalKV 配置，返回字符串值、剩余 TTL、Redis 数据类型和大小数据。 需要权限：`globalkv`。 */
+    getOne(key, options) {
+        return this.http.request('GET', `/globalkv/${encodeURIComponent(String(key))}`, { ...options });
+    }
+    /** 分页查询 GlobalKV 列表 🔐 **权限要求**: `globalkv` — GlobalKV全局配置管理权限
+       *
+       * 按统一分页参数 current/pageSize 查询 GlobalKV 配置，支持按键名模糊搜索、Redis pattern 匹配、值类型筛选和 key/value/length 排序。 需要权限：`globalkv`。 */
+    list(query, options) {
+        return this.http.request('GET', `/globalkv`, { ...options, query });
     }
-    parkourPunish(query, payload, options) {
-        return this.http.request("POST", "/ban/parkour-punish", {
-            ...options,
-            query,
-            body: payload,
-        });
+    /** 更新 GlobalKV 🔐 **权限要求**: `globalkv` — GlobalKV全局配置管理权限
+       *
+       * 按键名更新已存在的 GlobalKV 字符串值；传入 ttl 时重设过期时间，不传 ttl 时保留原有过期状态。 需要权限：`globalkv`。 */
+    update(key, payload, options) {
+        return this.http.request('PUT', `/globalkv/${encodeURIComponent(String(key))}`, { ...options, body: payload });
     }
 }
-exports.BanApi = BanApi;
-class PermissionApi extends BaseApi {
-    /** Get player permission. Common required query: `ecid`. */
-    getPermission(query, options) {
-        return super.get("/permission", query, options);
-    }
-    upsert(payload, options) {
-        return this.post("/permission", payload, options);
+exports.GlobalKVApi = GlobalKVApi;
+class ItemApi extends BaseApi {
+    /** 获取所有商品类型配置 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 读取商品类型配置并按类型分组返回，商品项、兑换配置和动画映射均以数组形式输出；lang 参数当前仅记录请求语言，不改变返回的配置键文本。 需要权限：`AUTHENTICATED`。 */
+    getCommodity(query, options) {
+        return this.http.request('GET', `/items`, { ...options, query });
     }
-    deleteOne(query, options) {
-        return this.delete("/permission", query, options);
+}
+exports.ItemApi = ItemApi;
+class LobbyApi extends BaseApi {
+    /** 查询大厅运行列表 🔐 **权限要求**: `lobby` — 查询和管理大厅运行状态
+       *
+       * 通过 RMI 查询当前大厅实例列表，可按大厅类型和 bigId 筛选；响应 data.lobbies 包含大厅 ID、类型、在线人数和可用状态。 需要权限：`lobby`。 */
+    list(query, options) {
+        return this.http.request('GET', `/lobby`, { ...options, query });
     }
 }
-exports.PermissionApi = PermissionApi;
+exports.LobbyApi = LobbyApi;
 class LogApi extends BaseApi {
-    /** Query action log. Common required query: `start`, `end`, `ecid`. */
+    /** 分页查询玩家行为记录 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 从 MongoDB 查询玩家行为日志；可按玩家 ECID、时间范围、事件类别和事件类型筛选。 需要权限：`player_info`。 */
     getAction(query, options) {
-        return this.get("/log/action", query, options);
-    }
-    getChat(query, options) {
-        return this.get("/log/chat", query, options);
+        return this.http.request('GET', `/logs/action`, { ...options, query });
     }
+    /** 分页查询登录日志 🔐 **权限要求**: `player_senstive_info` — 查看或维护玩家 IP、设备 ID 等敏感资料
+       *
+       * 按统一分页参数 current/pageSize 查询用户登录认证日志，可按玩家 ECID、认证动作和时间范围筛选。 需要权限：`player_senstive_info`。 */
     getAuth(query, options) {
-        return this.get("/log/auth", query, options);
+        return this.http.request('GET', `/logs/auth`, { ...options, query });
     }
-    /** Query teaming log. Common required query: `start`, `end`, `current`, `ecid`. */
-    getTeaming(query, options) {
-        return this.get("/log/teaming", query, options);
-    }
-    getLatestTeaming(query, options) {
-        return this.get("/log/latestTeaming", query, options);
+    /** 分页查询聊天日志 🔐 **权限要求**: `chat_log` — 查看玩家聊天记录功能
+       *
+       * 按统一分页参数 current/pageSize 从 MongoDB 查询聊天日志；可按聊天类型、时间范围、位置、发送者和消息内容筛选。 需要权限：`chat_log`。 */
+    getChat(query, options) {
+        return this.http.request('GET', `/logs/chat`, { ...options, query });
     }
-    /** Query command log. Common required query: `start`, `end`, `current`, `ecid`. */
+    /** 分页查询命令使用日志 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 从 SLS 查询指定玩家在时间范围内的命令使用日志，并返回查询处理统计数据。 需要权限：`player_info`。 */
     getCommand(query, options) {
-        return this.get("/log/command", query, options);
+        return this.http.request('GET', `/logs/command`, { ...options, query });
+    }
+    /** 获取最新组队日志 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询最近 24 小时内的最新组队日志。 需要权限：`player_info`。 */
+    getLatestTeaming(query, options) {
+        return this.http.request('GET', `/logs/latest-teaming`, { ...options, query });
     }
+    /** 分页查询玩家邮件日志 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询玩家邮件记录，可按收件人 ECID 和读取时间范围筛选；返回邮件基础数据和格式化后的附件内容。 需要权限：`player_info`。 */
     getMail(query, options) {
-        return this.get("/log/mail", query, options);
+        return this.http.request('GET', `/logs/mail`, { ...options, query });
+    }
+    /** 分页查询组队日志 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 从 SLS 查询指定玩家在时间范围内的组队日志，并返回查询处理统计数据。 需要权限：`player_info`。 */
+    getTeaming(query, options) {
+        return this.http.request('GET', `/logs/teaming`, { ...options, query });
     }
 }
 exports.LogApi = LogApi;
-class OrderApi extends BaseApi {
-    /** Query delivery status. Common required query: `key`, `ecid`. */
-    getDeliver(query, options) {
-        return this.get("/order/deliver", query, options);
+class MonitorApi extends BaseApi {
+    constructor(http) {
+        super(http);
+        this.spamDetector = new SpamDetectorApi(http);
     }
-    /** Query order logs. Common required query: `ecid`. */
-    getLogs(query, options) {
-        return this.get("/order/logs", query, options);
+}
+exports.MonitorApi = MonitorApi;
+class SpamDetectorApi extends BaseApi {
+    /** 查询刷屏检测器统计数据 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 查询刷屏检测器的累计玩家数、消息数、活跃模式、近期告警、关键词配置和高频刷屏玩家排行。 需要权限：`punish`。 */
+    getStats(options) {
+        return this.http.request('GET', `/monitor/spam-detector/stats`, { ...options });
+    }
+    /** 获取刷屏检测器状态 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 查询当前刷屏检测器的开关状态、启动时间、运行配置、累计处理统计、近期告警和性能指标。 需要权限：`punish`。 */
+    getStatus(options) {
+        return this.http.request('GET', `/monitor/spam-detector/status`, { ...options });
+    }
+    /** 创建刷屏检测器重启任务 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 创建一个刷屏检测器重启任务；如需只读取状态请使用刷屏检测器状态接口。 需要权限：`punish`。 */
+    restart(payload, options) {
+        return this.http.request('POST', `/monitor/spam-detector/restarts`, { ...options, body: payload });
+    }
+    /** 更新刷屏检测器运行状态 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 更新刷屏检测器的运行开关，响应返回最新状态、配置和统计数据。 需要权限：`punish`。 */
+    setState(payload, options) {
+        return this.http.request('PUT', `/monitor/spam-detector/state`, { ...options, body: payload });
+    }
+    /** 更新刷屏检测器配置 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 更新刷屏检测器的阈值、时间窗口、关键词、频道和冷却配置，不改变当前运行开关状态。 需要权限：`punish`。 */
+    updateConfig(payload, options) {
+        return this.http.request('PATCH', `/monitor/spam-detector/config`, { ...options, body: payload });
     }
-    /** Query exchange logs. Common required query: `ecid`, `from`, `to`. */
-    getExchangeLogs(query, options) {
-        return this.get("/order/exchange-logs", query, options);
+}
+exports.SpamDetectorApi = SpamDetectorApi;
+class OrderApi extends BaseApi {
+    /** 创建下载任务 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 创建指定时间范围内所有玩家的兑换日志下载任务，响应返回任务 ID 和初始状态。 需要权限：`player_info`。 */
+    createDownloadTask(payload, options) {
+        return this.http.request('POST', `/orders/downloads`, { ...options, body: payload });
+    }
+    /** 查询订单发货状态 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询网易玩家的订单发货信息；响应 data.orders 为订单发货状态列表。 需要权限：`player_info`。 */
+    getDeliver(query, options) {
+        return this.http.request('GET', `/order-deliveries`, { ...options, query });
     }
-    /** Get download task count. Common required query: `from`, `to`. */
+    /** 获取下载总条数 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 获取指定时间范围内所有玩家的兑换日志总条数，用于创建下载任务前估算数据量。 需要权限：`player_info`。 */
     getDownloadCount(query, options) {
-        return this.get("/order/download/count", query, options);
+        return this.http.request('GET', `/orders/downloads/count`, { ...options, query });
+    }
+    /** 查询下载任务状态 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定下载任务的当前状态和下载链接，任务未完成时下载链接可能为空。 需要权限：`player_info`。 */
+    getDownloadStatus(downloadId, options) {
+        return this.http.request('GET', `/orders/downloads/${encodeURIComponent(String(downloadId))}`, { ...options });
     }
-    createDownloadTask(query, payload, options) {
-        return this.http.request("POST", "/order/download/create", {
-            ...options,
-            query,
-            body: payload,
-        });
+    /** 分页查询兑换日志 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询指定玩家在指定时间范围内的兑换记录。 需要权限：`player_info`。 */
+    getExchangeLogs(query, options) {
+        return this.http.request('GET', `/orders/exchange-logs`, { ...options, query });
     }
-    /** Get one download task status. Common required query: `downloadId`. */
-    getDownloadStatus(query, options) {
-        return this.get("/order/download/status", query, options);
+    /** 分页查询订单日志 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 从 logOrders 表查询指定玩家的网易订单日志。 需要权限：`player_info`。 */
+    getLogs(query, options) {
+        return this.http.request('GET', `/orders/logs`, { ...options, query });
     }
+    /** 分页查询下载任务 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询兑换日志下载任务列表。 需要权限：`player_info`。 */
     listDownloadTasks(query, options) {
-        return this.get("/order/download/list", query, options);
+        return this.http.request('GET', `/orders/downloads`, { ...options, query });
     }
 }
 exports.OrderApi = OrderApi;
-class StageLogApi extends BaseApi {
-    list(query, options) {
-        return this.get("/stage/log/list", query, options);
-    }
-    query(query, options) {
-        return this.get("/stage/log/query", query, options);
+class PermissionApi extends BaseApi {
+    /** 删除玩家权益 🔐 **权限要求**: `permission` — 权限管理权限
+       *
+       * 删除指定玩家路径 entitlementKey 对应的单项权益，响应返回删除状态和删除记录数量。 需要权限：`permission`。 */
+    deleteOne(ecid, entitlementKey, options) {
+        return this.http.request('DELETE', `/players/${encodeURIComponent(String(ecid))}/entitlements/${encodeURIComponent(String(entitlementKey))}`, { ...options });
+    }
+    /** 获取玩家权益 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 根据玩家 ECID 查询其所有权益信息。响应 data.entitlements 为权益列表，每项包含权限标识、等级、过期时间和元数据。 需要权限：`player_info`。 */
+    getPermission(ecid, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/entitlements`, { ...options });
+    }
+    /** 创建或更新玩家权益 🔐 **权限要求**: `permission` — 权限管理权限
+       *
+       * 为指定玩家创建新权益或更新现有权益；路径 entitlementKey 是权益标识，请求体提供等级、过期时间和元数据，响应返回实际执行的是 created 还是 updated。 需要权限：`permission`。 */
+    upsert(ecid, entitlementKey, payload, options) {
+        return this.http.request('PUT', `/players/${encodeURIComponent(String(ecid))}/entitlements/${encodeURIComponent(String(entitlementKey))}`, { ...options, body: payload });
     }
 }
-exports.StageLogApi = StageLogApi;
-class StageApi extends BaseApi {
+exports.PermissionApi = PermissionApi;
+class PlayerApi extends BaseApi {
     constructor(http) {
         super(http);
-        this.logs = new StageLogApi(http);
-    }
-    getTypes(query, options) {
-        return this.get("/stage/types", query, options);
-    }
-    create(payload, options) {
-        return this.post("/stage/create", payload, options);
+        this.cutoffLeaderboard = new CutoffLeaderboardApi(http);
+        this.merchandise = new PlayerMerchandiseApi(http);
+        this.rankScore = new PlayerRankScoreApi(http);
+        this.score = new PlayerScoreApi(http);
+        this.tasks = new PlayerTasksApi(http);
+        this.vote = new PlayerVoteApi(http);
+        this.yearSummary = new PlayerYearSummaryApi(http);
     }
-    /** Query stage info by filters such as game/state/runtimeid/requestid. */
+    /** 批量获取玩家展示名 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 批量查询玩家展示名；输入 ECID 列表后按请求顺序返回 names 数组，优先使用网易真实昵称，缺失时回退为原始 ECID。 需要权限：`AUTHENTICATED`。 */
+    batchNeteaseNicknames(payload, options) {
+        return this.http.request('POST', `/players/netease-nicknames`, { ...options, body: payload });
+    }
+    /** 删除资源包缓存 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 删除指定玩家的资源包缓存，返回 existed 表示删除前缓存文件是否存在。 需要权限：`player_info`。 */
+    clearRespackCache(ecid, options) {
+        return this.http.request('DELETE', `/players/${encodeURIComponent(String(ecid))}/resource-pack/cache`, { ...options });
+    }
+    /** 批量创建 GamingTag 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 为一个或多个玩家创建 GamingTag。ecids 使用字符串数组，count 不传时默认为 0，响应 data.tags 为创建结果。 需要权限：`player_info`。 */
+    createGamingTags(payload, options) {
+        return this.http.request('POST', `/players/gaming-tags`, { ...options, body: payload });
+    }
+    /** 查询玩家绑定的网易账号 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定玩家 ECID 当前绑定的网易账号列表及双向关系。返回结果中的 xuid 表示网易账号标识；该接口只读，不会修改绑定。 需要权限：`player_info`。 */
+    getBinding(ecid, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/netease-accounts`, { ...options });
+    }
+    /** 分页查询 EC 农场赛季积分消耗 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询指定玩家在 EC 农场赛季中的积分消耗记录；当前数据源为 farm_season_point_spend。 需要权限：`player_info`。 */
+    getFarmSeasonPointSpends(ecid, query, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/farm/season-point-spends`, { ...options, query });
+    }
+    /** 获取玩家头像图片 直接返回指定玩家的 PNG 头像图片流，不使用统一 JSON 响应包裹；支持通过 frame 控制是否带边框、size 控制头像尺寸。 需要权限：`PUBLIC`。 */
+    getHeadicon(ecid, query, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/headicon`, { ...options, query, responseType: 'arrayBuffer' });
+    }
+    /** 查询玩家服内状态 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按 displayName 通过 ecRMI 查询玩家当前服内状态，返回在线状态、服务器/大厅/房间位置和离线时间等运行时数据；依赖服务不可用时返回 SERVICE_UNAVAILABLE。 需要权限：`player_info`。 */
     getInfo(query, options) {
-        return this.get("/stage/info", query, options);
+        return this.http.request('GET', `/players/info`, { ...options, query });
+    }
+    /** 获取最近游戏记录 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 获取指定玩家最近参与的游戏记录，count 最大 100；响应 data.records 返回游戏类型、房间 ID、击杀、助攻、胜负、地图和游戏显示名等字段。 需要权限：`player_info`。 */
+    getLastPlayed(ecid, query, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/last-played`, { ...options, query });
+    }
+    /** 查询网易账号当前绑定的玩家 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 从单个网易账号视角查询它当前绑定到哪个玩家 ECID。路径参数 xuid 表示网易账号标识；服务端会按网易账号绑定关系查询，不表示设备或 Xbox 账号。 需要权限：`player_info`。 */
+    getNeteaseAccountPlayer(xuid, options) {
+        return this.http.request('GET', `/netease-accounts/${encodeURIComponent(String(xuid))}/player`, { ...options });
+    }
+    /** 获取用户密码哈希 🔐 **权限要求**: `password_update` — 账号密码更新权限
+       *
+       * 获取指定玩家当前密码哈希值；这是敏感维护接口，仅限密码维护权限调用。 需要权限：`password_update`。 */
+    getPasswordHash(ecid, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/password`, { ...options });
+    }
+    /** 获取玩家皮肤数据 直接返回指定玩家的原始 PNG 皮肤图片流，不使用统一 JSON 响应包裹。 需要权限：`PUBLIC`。 */
+    getSkin(ecid, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/skin`, { ...options, responseType: 'arrayBuffer' });
+    }
+    /** 分页查询玩家关卡记录 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询指定玩家在时间范围内的回放关卡记录，并返回同场玩家 ECID 列表。 需要权限：`player_info`。 */
+    getStageRecord(ecid, query, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/stage/record`, { ...options, query });
+    }
+    /** 获取玩家基础数据 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定玩家的金币、钻石、经验、VIP、邮箱、封禁状态、设备列表和等级经验；lastIp 仅在调用方具备玩家敏感资料权限时返回。 需要权限：`player_info`。 */
+    getUserData(ecid, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/data`, { ...options });
+    }
+    /** 获取玩家钱包 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 获取指定玩家钱包中各币种余额列表，响应 data.items 为钱包条目；如需查看奖励点券批次、剩余额度和过期时间，请使用玩家钱包批次资源。 需要权限：`player_info`。 */
+    getWallet(ecid, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/wallet`, { ...options });
+    }
+    /** 分页查询玩家钱包批次 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询指定玩家的钱包批次，默认返回奖励点券 free_credits 的有效批次、剩余额度、过期时间、批次状态和预计消耗顺序。 需要权限：`player_info`。 */
+    getWalletLots(ecid, query, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/wallet/lots`, { ...options, query });
+    }
+    /** 查询 GamingTag 管理列表 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询 GamingTag 管理列表，支持按玩家 ECID 和标签内容模糊筛选，并可指定排序方向。 需要权限：`player_info`。 */
+    listAllGamingTags(query, options) {
+        return this.http.request('GET', `/players/gaming-tags`, { ...options, query });
+    }
+    /** 获取玩家 GamingTag 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询指定玩家当前拥有的 GamingTag，响应 data.data 为标签条目列表。 需要权限：`player_info`。 */
+    listGamingTags(ecid, query, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/gaming-tags`, { ...options, query });
+    }
+    /** 添加玩家 GamingTag 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 为指定玩家添加一个 GamingTag，标签内容来自请求体 tag，响应 data.tags 为创建结果；删除单个标签时请使用同一标签资源的 DELETE 接口。 需要权限：`player_info`。 */
+    operateGamingTag(ecid, payload, options) {
+        return this.http.request('POST', `/players/${encodeURIComponent(String(ecid))}/gaming-tags`, { ...options, body: payload });
+    }
+    /** 查询网易账号搜索命中列表 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 按网易展示名精确查询匹配的网易账号 ECID，响应 data.accounts 为匹配账号列表。该接口查询的是网易账号名称索引，不是玩家 ECID 绑定关系；绑定关系请使用玩家网易账号绑定资源或网易账号当前玩家资源。 需要权限：`AUTHENTICATED`。 */
+    queryNetease(query, options) {
+        return this.http.request('GET', `/netease-accounts`, { ...options, query });
+    }
+    /** 删除玩家 GamingTag 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 删除指定玩家路径 tag 对应的单个 GamingTag，响应 data 返回玩家 ECID、标签和实际删除数量 deletedCount。 需要权限：`player_info`。 */
+    removeGamingTag(ecid, tag, options) {
+        return this.http.request('DELETE', `/players/${encodeURIComponent(String(ecid))}/gaming-tags/${encodeURIComponent(String(tag))}`, { ...options });
+    }
+    /** 解绑玩家名下全部网易账号 🔐 **权限要求**: `player_senstive_info` — 查看或维护玩家 IP、设备 ID 等敏感资料
+       *
+       * 解绑指定玩家 ECID 当前绑定的全部网易账号。底层会把每个账号的绑定恢复为默认账号态，并可能踢出原玩家、迁移仍有效的处罚状态；适用于从玩家详情页批量清理网易账号绑定。 需要权限：`player_senstive_info`。 */
+    resetBinding(ecid, options) {
+        return this.http.request('DELETE', `/players/${encodeURIComponent(String(ecid))}/netease-accounts`, { ...options });
+    }
+    /** 解绑网易账号当前玩家 🔐 **权限要求**: `player_senstive_info` — 查看或维护玩家 IP、设备 ID 等敏感资料
+       *
+       * 只按网易账号标识解绑当前玩家绑定，不要求调用方先知道它绑定在哪个 ECID。底层会把该账号恢复为默认账号态，并可能踢出原玩家、迁移仍有效的处罚状态；适合从账号维度重置单个绑定。 需要权限：`player_senstive_info`。 */
+    resetNeteaseAccountPlayer(xuid, options) {
+        return this.http.request('DELETE', `/netease-accounts/${encodeURIComponent(String(xuid))}/player`, { ...options });
+    }
+    /** 解绑玩家名下单个网易账号 🔐 **权限要求**: `player_senstive_info` — 查看或维护玩家 IP、设备 ID 等敏感资料
+       *
+       * 只解绑指定玩家 ECID 名下的一个网易账号。服务端会先校验该 xuid 当前确实绑定在路径中的 ecid 下，再将该账号恢复为默认账号态；如果账号不属于该玩家，会返回未找到，避免误解绑其他玩家。 需要权限：`player_senstive_info`。 */
+    resetSingleBinding(ecid, xuid, options) {
+        return this.http.request('DELETE', `/players/${encodeURIComponent(String(ecid))}/netease-accounts/${encodeURIComponent(String(xuid))}`, { ...options });
+    }
+    /** 查询玩家搜索命中列表 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按关键词模糊搜索玩家，返回 ecidSearch、neteaseSearch、xboxBindingSearch 三组结果，分别表示 ECID 直接命中、网易账号命中和 XBOX 绑定关系命中。 需要权限：`player_info`。 */
+    searchEcid(query, options) {
+        return this.http.request('GET', `/players`, { ...options, query });
+    }
+    /** 设置玩家 VIP 等级 🔐 **权限要求**: `ranklevel` — 用户等级和VIP等级管理功能
+       *
+       * 设置指定玩家的 VIP 等级和到期时间，返回已写入的等级、到期时间和 updated 状态；玩家不存在或写入失败时返回对应业务错误。 需要权限：`ranklevel`。 */
+    setRankLevel(ecid, payload, options) {
+        return this.http.request('PUT', `/players/${encodeURIComponent(String(ecid))}/rank-level`, { ...options, body: payload });
+    }
+    /** 绑定或改绑网易账号到玩家 🔐 **权限要求**: `player_senstive_info` — 查看或维护玩家 IP、设备 ID 等敏感资料
+       *
+       * 将路径中的网易账号绑定到请求体里的玩家 ECID；如果该网易账号已经绑定到其他玩家，则会改绑到新的 ECID。该接口只操作一个网易账号，适合按账号维度新增、修正或迁移绑定关系。 需要权限：`player_senstive_info`。 */
+    updateBinding(xuid, payload, options) {
+        return this.http.request('PUT', `/netease-accounts/${encodeURIComponent(String(xuid))}/player`, { ...options, body: payload });
+    }
+    /** 更新玩家 GamingTag 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 更新指定玩家的单个 GamingTag。路径 tag 表示原标签；请求体 tag 可改名，不传则保留原标签；count 可更新标签数量。 需要权限：`player_info`。 */
+    updateGamingTag(ecid, tag, payload, options) {
+        return this.http.request('PUT', `/players/${encodeURIComponent(String(ecid))}/gaming-tags/${encodeURIComponent(String(tag))}`, { ...options, body: payload });
+    }
+    /** 更新用户密码 🔐 **权限要求**: `password_update` — 账号密码更新权限
+       *
+       * 更新指定玩家的 128 字符密码哈希，不接收明文密码；更新成功后会重置所有设备绑定并返回操作说明。 需要权限：`password_update`。 */
+    updatePassword(ecid, payload, options) {
+        return this.http.request('PUT', `/players/${encodeURIComponent(String(ecid))}/password`, { ...options, body: payload });
     }
-    /** Query stage DB id. Common required query: `runtime-id`. */
-    getDbId(query, options) {
-        return this.get("/stage/db-id", query, options);
+    /** 更新用户数据 🔐 **权限要求**: `player_senstive_info` — 查看或维护玩家 IP、设备 ID 等敏感资料
+       *
+       * 只更新请求体中显式传入的玩家数据字段，支持金币、钻石、经验和邮箱；email 传 null 时清空邮箱。 需要权限：`player_senstive_info`。 */
+    updateUserData(ecid, payload, options) {
+        return this.http.request('PUT', `/players/${encodeURIComponent(String(ecid))}`, { ...options, body: payload });
     }
 }
-exports.StageApi = StageApi;
-class ItemApi extends BaseApi {
-    getCommodity(query, options) {
-        return this.get("/item/commodity", query, options);
+exports.PlayerApi = PlayerApi;
+class CutoffLeaderboardApi extends BaseApi {
+    /** 获取 Cutoff 排行榜 读取 Redis 中的 Cutoff 排行榜，按统一分页参数 current/pageSize 返回数据。 需要权限：`PUBLIC`。 */
+    getLeaderboard(query, options) {
+        return this.http.request('GET', `/players/cutoff-leaderboard`, { ...options, query });
+    }
+    /** 获取玩家 Cutoff 排名 获取指定玩家在 Cutoff 排行榜中的排名和分数；未上榜时 rank 为 null，score 为 0。 需要权限：`PUBLIC`。 */
+    getPlayerRank(ecid, query, options) {
+        return this.http.request('GET', `/players/cutoff-leaderboard/${encodeURIComponent(String(ecid))}/rank`, { ...options, query });
     }
 }
-exports.ItemApi = ItemApi;
-class CountApi extends BaseApi {
-    getHistory(query, options) {
-        return this.get("/count/history", query, options);
+exports.CutoffLeaderboardApi = CutoffLeaderboardApi;
+class PlayerMerchandiseApi extends BaseApi {
+    /** 创建玩家道具 🔐 **权限要求**: `mail` — 邮件系统权限
+       *
+       * 为指定玩家添加新的商品道具记录，道具分类和道具 ID 来自请求体。 需要权限：`mail`。 */
+    create(ecid, payload, options) {
+        return this.http.request('POST', `/players/${encodeURIComponent(String(ecid))}/merchandise`, { ...options, body: payload });
     }
-    getLatest(query, options) {
-        return this.get("/count/latest", query, options);
+    /** 删除玩家道具 🔐 **权限要求**: `mail` — 邮件系统权限
+       *
+       * 通过玩家 ECID、道具分类和道具 ID 定位并删除指定商品道具记录。 需要权限：`mail`。 */
+    deleteOne(ecid, category, itemId, options) {
+        return this.http.request('DELETE', `/players/${encodeURIComponent(String(ecid))}/merchandise/${encodeURIComponent(String(category))}/${encodeURIComponent(String(itemId))}`, { ...options });
     }
-    getTypes(query, options) {
-        return this.get("/count/types", query, options);
+    /** 查询玩家商品道具 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询指定玩家的商品道具记录，可按道具分类、道具 ID 前缀和道具数据值精确筛选。 需要权限：`player_info`。 */
+    list(ecid, query, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/merchandise`, { ...options, query });
+    }
+    /** 更新玩家道具 🔐 **权限要求**: `mail` — 邮件系统权限
+       *
+       * 通过玩家 ECID、道具分类和道具 ID 定位道具，并更新该道具的数据值。 需要权限：`mail`。 */
+    update(ecid, category, itemId, payload, options) {
+        return this.http.request('PUT', `/players/${encodeURIComponent(String(ecid))}/merchandise/${encodeURIComponent(String(category))}/${encodeURIComponent(String(itemId))}`, { ...options, body: payload });
     }
 }
-exports.CountApi = CountApi;
-class ServersApi extends BaseApi {
-    list(query, options) {
-        return this.get("/servers", query, options);
+exports.PlayerMerchandiseApi = PlayerMerchandiseApi;
+class PlayerRankScoreApi extends BaseApi {
+    /** 查询段位等级配置 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 查询段位等级阈值配置；查询参数 game 为 casual 或 versus 时返回 config，game 为 all 时返回 configs 映射。 需要权限：`AUTHENTICATED`。 */
+    getConfig(query, options) {
+        return this.http.request('GET', `/players/rank-score/config`, { ...options, query });
     }
-    getStatistics(query, options) {
-        return this.get("/servers/statistics", query, options);
+    /** 查询玩家段位进度 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定玩家在指定赛季和模式下的当前段位、当前分数、到下一星/小段/大段所需分数以及阈值明细。 需要权限：`player_info`。 */
+    getProgress(query, options) {
+        return this.http.request('GET', `/players/rank-score/progress`, { ...options, query });
     }
-    getMainstackEvent(query, options) {
-        return this.get("/servers/mainstack-event", query, options);
+    /** 查询玩家段位分 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定玩家在指定赛季的段位分；查询参数 game 为 casual 或 versus 时返回 single，game 为 all 时返回 all 列表。 需要权限：`player_info`。 */
+    getScore(query, options) {
+        return this.http.request('GET', `/players/rank-score`, { ...options, query });
     }
 }
-exports.ServersApi = ServersApi;
-class LobbyApi extends BaseApi {
-    list(query, options) {
-        return this.get("/lobby/list", query, options);
+exports.PlayerRankScoreApi = PlayerRankScoreApi;
+class PlayerScoreApi extends BaseApi {
+    /** 删除玩家分数 🔐 **权限要求**: `score` — 玩家积分和排行榜管理功能
+       *
+       * 从指定游戏、分数类型和周期的排行榜中删除指定玩家的分数记录。 需要权限：`score`。 */
+    deleteTop(query, options) {
+        return this.http.request('DELETE', `/players/score/top`, { ...options, query });
     }
-}
-exports.LobbyApi = LobbyApi;
-class CfgLangApi extends BaseApi {
-    list(query, options) {
-        return this.get("/cfglang", query, options);
+    /** 获取分数配置 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 读取积分排行榜配置表，响应 data.configs 返回游戏标识、分数类型、周期、奖励名次范围和奖励邮件配置。 需要权限：`AUTHENTICATED`。 */
+    getConfig(options) {
+        return this.http.request('GET', `/players/score/config`, { ...options });
     }
-    compare(query, options) {
-        return this.get("/cfglang/compare", query, options);
+    /** 批量查询排行榜数据 根据积分排行榜配置批量读取各游戏和分数类型的 Redis 排行榜前 20 名；响应 data.groups 按游戏、分数类型和周期分组，可按查询参数 game 筛选。 需要权限：`PUBLIC`。 */
+    getLeaderboard(query, options) {
+        return this.http.request('GET', `/players/score/leaderboard`, { ...options, query });
     }
-    deploy(payload, options) {
-        return this.post("/cfglang/deploy", payload, options);
+    /** 获取玩家指定榜单名次 查询某个 ECID 在指定游戏、榜单/分数类型和时间维度中的排名与分数，例如 disasters + WIN + DAY 或起床击杀月榜；响应会返回 Redis 榜单键 game#scoreType#deadlineType、是否上榜、分数来源和 rank/total 百分位。 需要权限：`PUBLIC`。 */
+    getRank(query, options) {
+        return this.http.request('GET', `/players/score/rank`, { ...options, query });
     }
-    create(query, payload, options) {
-        return this.http.request("POST", "/cfglang", { ...options, query, body: payload });
+    /** 获取玩家分数 查询指定玩家在某个游戏中的实时积分数据；可按 scoreType 和 deadlineType 进一步筛选，响应 data.scores 为分数记录列表。 需要权限：`PUBLIC`。 */
+    getScore(query, options) {
+        return this.http.request('GET', `/players/score`, { ...options, query });
     }
-    update(query, payload, options) {
-        return this.http.request("PATCH", "/cfglang", { ...options, query, body: payload });
+    /** 获取玩家历史对局分数 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 根据玩家 ECID 和游戏类型查询历史对局分数记录，响应 data.records 返回击杀、助攻、胜负、地图、房间 ID、创建时间和销毁时间。 需要权限：`AUTHENTICATED`。 */
+    getStages(query, options) {
+        return this.http.request('GET', `/players/score/stages`, { ...options, query });
     }
-    deleteOne(query, options) {
-        return this.delete("/cfglang", query, options);
+    /** 分页查询排行榜前 N 名 按统一分页参数 current/pageSize 查询指定游戏、分数类型和周期的排行榜数据。 需要权限：`PUBLIC`。 */
+    getTop(query, options) {
+        return this.http.request('GET', `/players/score/top`, { ...options, query });
     }
 }
-exports.CfgLangApi = CfgLangApi;
-class GlobalKVApi extends BaseApi {
-    list(query, options) {
-        return this.get("/globalkv", query, options);
-    }
-    getOne(key, query, options) {
-        return this.get(`/globalkv/${encodeURIComponent(key)}`, query, options);
-    }
-    create(payload, options) {
-        return this.post("/globalkv", payload, options);
+exports.PlayerScoreApi = PlayerScoreApi;
+class PlayerTasksApi extends BaseApi {
+    /** 创建玩家任务 🔐 **权限要求**: `mail` — 邮件系统权限
+       *
+       * 为指定玩家创建新的任务记录，任务分类和任务 ID 来自请求体。 需要权限：`mail`。 */
+    create(ecid, payload, options) {
+        return this.http.request('POST', `/players/${encodeURIComponent(String(ecid))}/tasks`, { ...options, body: payload });
     }
-    update(key, payload, options) {
-        return this.put(`/globalkv/${encodeURIComponent(key)}`, payload, options);
+    /** 删除玩家任务 🔐 **权限要求**: `mail` — 邮件系统权限
+       *
+       * 通过玩家 ECID、任务分类和任务 ID 定位并删除指定任务记录。 需要权限：`mail`。 */
+    deleteOne(ecid, category, taskId, options) {
+        return this.http.request('DELETE', `/players/${encodeURIComponent(String(ecid))}/tasks/${encodeURIComponent(String(category))}/${encodeURIComponent(String(taskId))}`, { ...options });
     }
-    deleteOne(key, query, options) {
-        return this.delete(`/globalkv/${encodeURIComponent(key)}`, query, options);
+    /** 查询玩家任务 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 按统一分页参数 current/pageSize 查询指定玩家的任务记录，可按任务分类、任务 ID 前缀和任务数据精确筛选。 需要权限：`player_info`。 */
+    list(ecid, query, options) {
+        return this.http.request('GET', `/players/${encodeURIComponent(String(ecid))}/tasks`, { ...options, query });
     }
-    deleteBatch(payload, options) {
-        return this.http.request("DELETE", "/globalkv", { ...options, body: payload });
+    /** 更新玩家任务 🔐 **权限要求**: `mail` — 邮件系统权限
+       *
+       * 通过玩家 ECID、任务分类和任务 ID 定位任务，并更新该任务的数据字段。 需要权限：`mail`。 */
+    update(ecid, category, taskId, payload, options) {
+        return this.http.request('PUT', `/players/${encodeURIComponent(String(ecid))}/tasks/${encodeURIComponent(String(category))}/${encodeURIComponent(String(taskId))}`, { ...options, body: payload });
     }
 }
-exports.GlobalKVApi = GlobalKVApi;
-class BroadcastApi extends BaseApi {
-    list(query, options) {
-        return this.get("/broadcast", query, options);
+exports.PlayerTasksApi = PlayerTasksApi;
+class PlayerVoteApi extends BaseApi {
+    /** 创建投票奖励邮件 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 为指定玩家发放五星好评奖励邮件。players 使用字符串数组；启用 enableNeteaseLookup 时会先按网易昵称解析到玩家 ECID，响应 data.results 返回逐个玩家的处理结果。 需要权限：`AUTHENTICATED`。 */
+    processRewards(payload, options) {
+        return this.http.request('POST', `/players/vote/rewards`, { ...options, body: payload });
     }
-    compare(query, options) {
-        return this.get("/broadcast/compare", query, options);
+}
+exports.PlayerVoteApi = PlayerVoteApi;
+class PlayerYearSummaryApi extends BaseApi {
+    /** 查询年度总结基础资料 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定玩家年度总结的基础资料，包括 ECID、展示名、注册时间、皮肤与几何数据。 需要权限：`player_info`。 */
+    getBasicInfo(query, options) {
+        return this.http.request('GET', `/players/year-summary/basic-info`, { ...options, query });
     }
-    deploy(payload, options) {
-        return this.post("/broadcast/deploy", payload, options);
+    /** 获取货币与消费数据 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定玩家当前货币余额，以及目标年份内的充值订单次数。 需要权限：`player_info`。 */
+    getCurrencyData(query, options) {
+        return this.http.request('GET', `/players/year-summary/currency-data`, { ...options, query });
     }
-    getOne(msg, query, options) {
-        return this.get(`/broadcast/${encodeURIComponent(msg)}`, query, options);
+    /** 获取游戏统计 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定玩家在目标年份的游戏分数聚合与回放统计；分数指标按 scoreType 聚合。 需要权限：`player_info`。 */
+    getGameStats(query, options) {
+        return this.http.request('GET', `/players/year-summary/game-stats`, { ...options, query });
     }
-    create(payload, options) {
-        return this.post("/broadcast", payload, options);
+    /** 获取登录统计 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定玩家在目标年份的登录天数、首次登录、最早/最晚登录时间和在线时长统计。 需要权限：`player_info`。 */
+    getLoginStats(query, options) {
+        return this.http.request('GET', `/players/year-summary/login-stats`, { ...options, query });
     }
-    update(msg, payload, options) {
-        return this.put(`/broadcast/${encodeURIComponent(msg)}`, payload, options);
+    /** 获取段位与积分数据 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定玩家年度总结使用的 S8 竞技与休闲段位快照。 需要权限：`player_info`。 */
+    getRankData(query, options) {
+        return this.http.request('GET', `/players/year-summary/rank-data`, { ...options, query });
     }
-    deleteOne(msg, payload, options) {
-        return this.http.request("DELETE", `/broadcast/${encodeURIComponent(msg)}`, {
-            ...options,
-            body: payload,
-        });
+    /** 获取社交数据 🔐 **权限要求**: `player_info` — 查看玩家资料、游戏记录和只读状态
+       *
+       * 查询指定玩家当前好友数量，以及目标年份内的组队次数和最常组队玩家。 需要权限：`player_info`。 */
+    getSocialData(query, options) {
+        return this.http.request('GET', `/players/year-summary/social-data`, { ...options, query });
     }
 }
-exports.BroadcastApi = BroadcastApi;
-class EaseChatApi extends BaseApi {
-    sendHlaba(payload, options) {
-        return this.post("/easechat/hlaba", payload, options);
-    }
-    listSubscriptions(query, options) {
-        return this.get("/easechat/subscriptions", query, options);
-    }
-    createSubscription(payload, options) {
-        return this.post("/easechat/subscriptions", payload, options);
-    }
-    deleteSubscription(query, options) {
-        return this.delete("/easechat/subscriptions", query, options);
+exports.PlayerYearSummaryApi = PlayerYearSummaryApi;
+class PullConfigApi extends BaseApi {
+    /** 创建服务器配置同步任务 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 创建服务器配置同步任务，触发服务器在 /etc/easecation/config-server 执行 git pull。 需要权限：`AUTHENTICATED`。 */
+    pull(payload, options) {
+        return this.http.request('POST', `/config-sync-jobs`, { ...options, body: payload });
     }
 }
-exports.EaseChatApi = EaseChatApi;
-class AuditApi extends BaseApi {
-    getAuthLogs(query, options) {
-        return this.get("/audit/auth", query, options);
+exports.PullConfigApi = PullConfigApi;
+class PunishApi extends BaseApi {
+    /** 清空玩家违规次数 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 删除指定玩家的违规次数资源，响应返回清空操作的执行状态。 需要权限：`punish`。 */
+    clearDegree(ecid, options) {
+        return this.http.request('DELETE', `/players/${encodeURIComponent(String(ecid))}/punishment-degree`, { ...options });
+    }
+    /** 创建处罚 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 对指定玩家执行处罚操作，支持多种处罚类型（HACK、BAN、MUTE、WARNING、KICK、FREEZE_SCORE_TOP、RESTRICT_NICK） 需要权限：`punish`。 */
+    create(payload, options) {
+        return this.http.request('POST', `/punishments`, { ...options, body: payload });
     }
-    getPlayerLogs(query, options) {
-        return this.get("/audit/player", query, options);
+    /** 创建玩家近期回放监管案件 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 查询玩家近期关卡记录，最多将 5 个回放创建为 Overwatch 监管案件。 需要权限：`punish`。 */
+    createPlayerOverwatchCases(payload, options) {
+        return this.http.request('POST', `/punishments/overwatch/player`, { ...options, body: payload });
     }
-    getPunishmentLogs(query, options) {
-        return this.get("/audit/punishment", query, options);
+    /** 分页查询处罚列表 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 按统一分页参数 current/pageSize 查询处罚操作记录，可按玩家 ECID 和处罚类型筛选。 需要权限：`punish`。 */
+    list(query, options) {
+        return this.http.request('GET', `/punishments`, { ...options, query });
     }
-    getPermissionLogs(query, options) {
-        return this.get("/audit/permission", query, options);
+    /** 创建或更新 Overwatch 监督案件 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 按回放记录 ID 创建或更新 Overwatch 监督案件，可写入案件状态、处罚信息、难度和评审配置。 需要权限：`punish`。 */
+    overwatch(payload, options) {
+        return this.http.request('POST', `/punishments/overwatch`, { ...options, body: payload });
     }
-    getAdminLogs(query, options) {
-        return this.get("/audit/admin", query, options);
+    /** 解除处罚 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 解除指定玩家的指定类型处罚，处罚类型由路径参数 type 指定。 需要权限：`punish`。 */
+    remove(ecid, type, query, options) {
+        return this.http.request('DELETE', `/punishments/${encodeURIComponent(String(ecid))}/${encodeURIComponent(String(type))}`, { ...options, query });
     }
-    getConfigLogs(query, options) {
-        return this.get("/audit/config", query, options);
+    /** 设置跑酷天堂惩罚 🔐 **权限要求**: `punish` — 封禁、踢出等惩罚功能
+       *
+       * 将指定玩家在跑酷地图的关卡区间统一设置为指定使用时间。 需要权限：`punish`。 */
+    setParkourPunishment(payload, options) {
+        return this.http.request('POST', `/punishments/parkour`, { ...options, body: payload });
     }
 }
-exports.AuditApi = AuditApi;
-class SpamDetectorApi extends BaseApi {
-    getStatus(query, options) {
-        return this.get("/monitor/spam-detector/status", query, options);
+exports.PunishApi = PunishApi;
+class ServersApi extends BaseApi {
+    /** 查询 MainStack 事件日志 🔐 **权限要求**: `servers` — 查询和管理服务器运行状态
+       *
+       * 从 SLS 查询指定服务器地址和端口上报的 MainStack 性能事件，返回堆栈、TPS、Tick 使用率和查询处理统计数据。 需要权限：`servers`。 */
+    getMainstackEvent(query, options) {
+        return this.http.request('GET', `/servers/mainstack-event`, { ...options, query });
     }
-    control(payload, options) {
-        return this.post("/monitor/spam-detector/control", payload, options);
+    /** 查询服务器统计数据 🔐 **权限要求**: `servers` — 查询和管理服务器运行状态
+       *
+       * 查询服务器 TPS 分布、玩家数分布、Stage 允许状态分布以及物理机聚合数据；动态分组均以数组返回。 需要权限：`servers`。 */
+    getStatistics(options) {
+        return this.http.request('GET', `/servers/statistics`, { ...options });
     }
-    getStats(query, options) {
-        return this.get("/monitor/spam-detector/stats", query, options);
+    /** 查询服务器运行列表 🔐 **权限要求**: `servers` — 查询和管理服务器运行状态
+       *
+       * 查询当前所有游戏服务器实例，支持按 TPS 或玩家数范围过滤，并可按 TPS、玩家数或 allowAddStage 排序；响应 data.servers 包含服务器地址、负载和加房状态。 需要权限：`servers`。 */
+    list(query, options) {
+        return this.http.request('GET', `/servers`, { ...options, query });
     }
 }
-exports.SpamDetectorApi = SpamDetectorApi;
-class MonitorApi extends BaseApi {
+exports.ServersApi = ServersApi;
+class StageApi extends BaseApi {
     constructor(http) {
         super(http);
-        this.spamDetector = new SpamDetectorApi(http);
+        this.logs = new StageLogApi(http);
+    }
+    /** 创建自定义房间 🔐 **权限要求**: `stage` — 房间管理权限
+       *
+       * 创建新的自定义游戏房间，支持指定游戏、匹配类型、地图、房间名、房主和玩家数量配置。 需要权限：`stage`。 */
+    create(payload, options) {
+        return this.http.request('POST', `/stages`, { ...options, body: payload });
+    }
+    /** 查询房间数据库 ID 🔐 **权限要求**: `stage` — 房间管理权限
+       *
+       * 根据查询参数 runtimeId 查询对应的房间数据库记录 ID。 需要权限：`stage`。 */
+    getDbId(query, options) {
+        return this.http.request('GET', `/stage-database-ids`, { ...options, query });
+    }
+    /** 查询房间运行状态 🔐 **权限要求**: `stage` — 房间管理权限
+       *
+       * 查询实时房间实例，可按游戏、状态、运行时 ID 或请求 ID 筛选；runtimeId/requestId 支持用分号传入多个值。 需要权限：`stage`。 */
+    getInfo(query, options) {
+        return this.http.request('GET', `/stages`, { ...options, query });
+    }
+    /** 获取房间类型设置 🔐 **权限要求**: `stage` — 房间管理权限
+       *
+       * 查询全部可创建房间类型的配置，包括平台、最大人数、开局人数、快速开局人数和房间数量上限。 需要权限：`stage`。 */
+    getTypes(options) {
+        return this.http.request('GET', `/stages/types`, { ...options });
     }
 }
-exports.MonitorApi = MonitorApi;
-class PullConfigApi extends BaseApi {
-    /** Pull current config snapshot. */
-    pull(query, options) {
-        return this.get("/pull-config", query, options);
+exports.StageApi = StageApi;
+class StageLogApi extends BaseApi {
+    /** 导出房间日志计分 CSV 🔐 **权限要求**: `stage` — 房间管理权限
+       *
+       * 通过房间日志 ID 导出该房间的最终计分 CSV 文件；该接口跳过统一响应包裹并直接返回文件流。 需要权限：`stage`。 */
+    exportCsv(id, options) {
+        return this.http.request('GET', `/stage-logs/${encodeURIComponent(String(id))}/score.csv`, { ...options, responseType: 'arrayBuffer' });
+    }
+    /** 分页查询房间日志 🔐 **权限要求**: `stage` — 房间管理权限
+       *
+       * 按统一分页参数 current/pageSize 查询历史房间日志，可通过 game 筛选指定游戏。 需要权限：`stage`。 */
+    list(query, options) {
+        return this.http.request('GET', `/stage-logs`, { ...options, query });
+    }
+    /** 获取单个房间日志 🔐 **权限要求**: `stage` — 房间管理权限
+       *
+       * 通过房间日志 ID 查询单个历史房间的基础信息和最终计分详情，计分字段按统一 camelCase 响应。 需要权限：`stage`。 */
+    query(id, options) {
+        return this.http.request('GET', `/stage-logs/${encodeURIComponent(String(id))}`, { ...options });
     }
 }
-exports.PullConfigApi = PullConfigApi;
+exports.StageLogApi = StageLogApi;
 class SystemApi extends BaseApi {
-    /** Get API root text payload. */
-    getRoot(query, options) {
-        return this.get("/", query, { ...options, responseType: "text" });
+    /** 获取服务健康状态 返回当前应用进程的基础健康状态和服务器时间戳，用于负载均衡或人工确认服务是否可响应。 需要权限：`PUBLIC`。 */
+    getHealth(options) {
+        return this.http.request('GET', `/health`, { ...options });
+    }
+    /** 获取服务存活状态 检查服务是否存活（用于 K8s liveness probe） 需要权限：`PUBLIC`。 */
+    getLiveness(options) {
+        return this.http.request('GET', `/health/live`, { ...options });
     }
-    /** Health check endpoint. */
-    getHealth(query, options) {
-        return this.get("/health", query, options);
+    /** 获取服务就绪状态 检查服务是否就绪（用于 K8s readiness probe） 需要权限：`PUBLIC`。 */
+    getReadiness(options) {
+        return this.http.request('GET', `/health/ready`, { ...options });
+    }
+    /** 获取服务基础资料 返回 EaseCation Console API 的基础服务名称，用于确认当前访问的是 v3 控制台后端服务。 需要权限：`PUBLIC`。 */
+    getRoot(options) {
+        return this.http.request('GET', `/`, { ...options });
     }
 }
 exports.SystemApi = SystemApi;
+class UserApi extends BaseApi {
+    /** 获取玩家账号详情 🔐 **权限要求**: `auth_admin` — 管理员权限
+       *
+       * 根据路径 id（业务含义为玩家 ECID）查询玩家账号资料，返回账号资产、VIP、邮箱、最近登录 IP 和设备数据。 需要权限：`auth_admin`。 */
+    getById(id, options) {
+        return this.http.request('GET', `/users/${encodeURIComponent(String(id))}`, { ...options });
+    }
+    /** 获取当前用户资料 🔒 **权限要求**: `AUTHENTICATED` — 需要登录
+       *
+       * 根据 Authorization 头中已通过全局鉴权的 Token 返回当前后台用户身份，响应字段统一为 userId、username 和 accesses。 需要权限：`AUTHENTICATED`。 */
+    getMe(options) {
+        return this.http.request('GET', `/users/me`, { ...options });
+    }
+    /** 分页查询用户 🔐 **权限要求**: `auth_admin` — 管理员权限
+       *
+       * 按统一分页参数 current/pageSize 查询后台注册用户列表，返回 userId、username 和 accesses 权限数组。 需要权限：`auth_admin`。 */
+    listAll(query, options) {
+        return this.http.request('GET', `/users`, { ...options, query });
+    }
+    /** 更新用户访问权限 🔐 **权限要求**: `auth_admin` — 管理员权限
+       *
+       * 更新指定后台用户的访问权限；如果用户不存在且请求体提供 password，则自动注册后写入 accesses 权限数组。 需要权限：`auth_admin`。 */
+    updatePermissions(username, payload, options) {
+        return this.http.request('PUT', `/users/${encodeURIComponent(String(username))}/accesses`, { ...options, body: payload });
+    }
+}
+exports.UserApi = UserApi;