@heybox/hb-sdk 0.6.9 → 0.7.0-alpha.2

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.6.9+skill.771fa5cbe7a8",
+  "skillVersion": "0.7.0-alpha.2+skill.c5541658a22b",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.6.9",
-    "compatibility": "0.6.9"
+    "version": "0.7.0-alpha.2",
+    "compatibility": "0.7.0-alpha.2"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-771fa5cbe7a87fafd95ba7a830adfdbd5e7598235f95ce806238d92d882af3e4"
+  "integrity": "sha256-c5541658a22b5ef1a47a24dcdd617e59ef2a118858bedf547ac2833637f865b8"
 }

package/types/index.d.ts

@@ -1,12 +1,12 @@
 export { HbMiniProgramSDKError, HbMiniProgramNetworkError } from './core/errors';
 export { ready, on, off, auth, user, share, viewport, storage, network, ui, device, navigation, cloud } from './core/singleton';
-export type { MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap, } from './protocol/types';
-export type { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
+export type { MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap } from './protocol/types';
+export type { LoginOptions, LoginPayload, LoginResult, LoginScope, MiniProgramAuthModule } from './modules/auth';
 export type { DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, LeaderboardEntry, LeaderboardOrder, MiniProgramCloudLeaderboardModule, MiniProgramCloudModule, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, } from './modules/cloud';
-export type { BasePlatformAccountInfo, CurrentUserAvatarConfig, CurrentUserAvatarDecoration, CurrentUserBbsInfo, CurrentUserDetail, CurrentUserLevelInfo, CurrentUserMedal, CurrentUserProfile, EpicPlatformAccountInfo, GetCurrentUserDetailPayload, GetCurrentUserDetailResult, GetCurrentUserProfilePayload, GetCurrentUserProfileResult, GetPlatformAccountInfoPayload, GetPlatformAccountInfoResult, GetPlatformAccountOverviewPayload, GetPlatformAccountOverviewResult, GetSteamGameListOptions, GetSteamGameListPayload, GetSteamGameListResult, GetUserInfoPayload, GetUserInfoResult, MiniProgramUserInfo, MiniProgramUserInfoResult, MiniProgramUserModule, MobilePlatformAccountInfo, PcHardwareAccountInfo, PlatformAccountInfoMap, PlatformAccountOverview, PlatformAccountResult, PlatformAccountType, PlatformStatItem, PsnPlatformAccountInfo, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SteamPlatformAccountInfo, SwitchPlatformAccountInfo, UserScopedResult, XboxPlatformAccountInfo, } from './modules/user';
+export type { AuthorizedUserInfo, GetLocalIdentityPayload, GetLocalIdentityResult, GetUserInfoPayload, GetUserInfoResult, RevokeAuthorizationPayload, RevokeAuthorizationResult, GetSteamGameListOptions, GetSteamGameListPayload, GetSteamGameListResult, MiniProgramUserInfoResult, MiniProgramUserModule, UserInfoAuthorization, UserInfoAuthorizationStatus, SteamGameListData, SteamGameListItem, SteamGamePrice, SteamGameListSort, } from './modules/user';
 export type { MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareModule, MiniProgramSharePostOptions, MiniProgramShowShareMenuOptions, ScreenshotPayload, ScreenshotResult, ShowShareMenuPayload, ShowShareMenuResult, } from './modules/share';
 export type { GetWindowInfoPayload, GetWindowInfoResult, MiniProgramNavigationBarForegroundStyle, MiniProgramSafeArea, MiniProgramSetNavigationBarStyleOptions, MiniProgramViewportModule, MiniProgramWindowInfoResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, } from './modules/viewport';
-export type { GetStoragePayload, GetStorageResult, MiniProgramStorageModule, SetStoragePayload, } from './modules/storage';
+export type { GetStoragePayload, GetStorageResult, MiniProgramStorageModule, SetStoragePayload } from './modules/storage';
 export type { MiniProgramNetworkHeaders, MiniProgramNetworkModule, MiniProgramNetworkParams, MiniProgramNetworkRequestConfig, MiniProgramNetworkRequestMethod, MiniProgramNetworkResponse, MiniProgramNetworkValidateStatus, NetworkRequestPayload, NetworkResponsePayload, } from './modules/network';
 export type { HideLoadingPayload, HideLoadingResult, MiniProgramToastStatus, MiniProgramUiModule, ShowLoadingPayload, ShowLoadingResult, ShowToastPayload, ShowToastResult, } from './modules/ui';
 export type { MiniProgramDeviceModule, MiniProgramVibrateIntensity, SetClipboardPayload, SetClipboardResult, VibratePayload, VibrateResult, } from './modules/device';

package/types/miniapp-publish/index.d.ts

@@ -8,6 +8,7 @@ export declare const DEVELOPER_ENTITY_SWITCH_API_PATH = "/mall/developer/entity/
 export declare const LIST_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/list";
 export declare const CREATE_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/create";
 export declare const DETAIL_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/detail";
+export declare const CREATE_USER_MINIPROGRAM_LOCAL_DEV_LAUNCH_TOKEN_API_PATH = "/mall/developer/user_miniprogram/local_dev_launch_token";
 export declare const USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = "/mall/developer/user_miniprogram/preview_allowlist";
 export declare const UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH = "/mall/developer/user_miniprogram/preview_allowlist/update";
 export declare const CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH = "/mall/developer/user_miniprogram/leaderboard/create";

package/types/modules/auth/index.d.ts

@@ -1,35 +1,23 @@
 import type { MiniProgramRequester } from '../../core/client';
-import type { MiniProgramUserInfoResult } from '../user';
 export { AUTH_LOGIN_METHOD } from '../../protocol/capabilities';
-/** `auth.login` 不需要入参。 */
-export type LoginPayload = void;
-/** `auth.login` 返回登录流程结束后的最新用户登录态与公开基础资料。 */
-export type LoginResult = MiniProgramUserInfoResult;
+export type LoginScope = 'identity' | 'profile';
+export interface LoginOptions {
+    scopes?: LoginScope[];
+}
+export type LoginPayload = LoginOptions | undefined;
+/** 小程序服务端用于换取当前用户身份的短期授权码。 */
+export interface LoginResult {
+    code: string;
+    expiresIn: number;
+    scopes: LoginScope[];
+}
 export type { MiniProgramAuthMethod } from '../../protocol/capabilities';
 /** 外部小程序可调用的授权模块。 */
 export interface MiniProgramAuthModule {
-    /**
-     * 唤起登录授权，并返回登录后的最新用户信息。
-     *
-     * 该能力不会向小程序暴露 token、cookie 或任何登录凭据。
-     */
-    login(): Promise<LoginResult>;
+    /** 获取短期授权码；不会向小程序暴露 token、cookie 或黑盒用户资料。 */
+    login(options?: LoginOptions): Promise<LoginResult>;
 }
-/**
- * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
- *
- * @param requester 底层 bridge 请求能力。
- * @returns 登录流程完成后的最新用户登录态与公开资料。
- * @throws {HbMiniProgramSDKError} 当 bridge、父容器或宿主运行时调用失败时抛出。
- *
- * @remarks
- * 该能力不会向小程序暴露 token、cookie 或其他登录凭据。
- */
-export declare function login(requester: MiniProgramRequester): Promise<LoginResult>;
-/**
- * 创建授权模块。
- *
- * @param requester 底层 bridge 请求能力。
- * @returns 面向业务层的授权模块对象。
- */
+/** 获取短期授权码。 */
+export declare function login(requester: MiniProgramRequester, options?: LoginOptions): Promise<LoginResult>;
+/** 创建授权模块。 */
 export declare function createAuthModule(requester: MiniProgramRequester): MiniProgramAuthModule;

package/types/modules/cloud/index.d.ts

@@ -8,8 +8,8 @@ export interface LeaderboardEntry {
     rank: number;
     /** 是否进入展示范围并位于当前用户排名计算上限内。 */
     ranked: boolean;
-    /** 当前记录所属用户 ID，由平台注入，前端不能传入。 */
-    userId: string;
+    /** 当前小程序内稳定的用户标识，由平台注入，前端不能传入。 */
+    appUserId: string;
     /** 分数，排行榜唯一排序字段。 */
     score: number;
     /** 展示附加信息，不参与排序和查询。 */

package/types/modules/network/index.d.ts

@@ -22,8 +22,7 @@ export type MiniProgramNetworkValidateStatus = (status: number) => boolean;
  * 对外开放的网络请求配置。
  *
  * @remarks
- * 该配置面向业务层，保持 axios-like 的窄接口，不暴露 `sendRequestV2`
- * 等宿主协议的原始字段。
+ * 该配置面向业务层，保持 axios-like 的窄接口，不暴露宿主协议的原始字段。
  */
 export interface MiniProgramNetworkRequestConfig {
     /** 请求地址。 */

package/types/modules/user/get-info.d.ts

@@ -12,12 +12,12 @@ export type GetUserInfoResult = MiniProgramUserInfoResult;
 /**
  * 获取当前访问小程序用户的公开基础资料。
  *
- * @param requester 底层 bridge 请求能力。
  * @returns 当前用户的登录态与公开基础资料。
  *
- * 该能力只返回 `heybox_id`、`nickname`、`avatar` 三个公开字段。
- * 未登录时不会触发登录流程，直接返回 `{ isLogin: false, userInfo: null }`。
+ * 该能力仅在身份授权后返回按小程序隔离的 `app_user_id`，仅在 profile
+ * 授权后返回昵称与头像。未登录时返回
+ * `{ isHeyboxAppLoggedIn: false, authorization: null, userInfo: null }`。
  *
- * @throws {HbMiniProgramSDKError} 当 bridge、父容器或宿主运行时调用失败时抛出。
+ * @throws {HbMiniProgramSDKError} 当 SDK 调用失败时抛出。
  */
 export declare function getInfo(requester: MiniProgramRequester): Promise<GetUserInfoResult>;

package/types/modules/user/get-local-identity.d.ts

@@ -0,0 +1,9 @@
+import type { MiniProgramRequester } from '../../core/client';
+export { USER_GET_LOCAL_IDENTITY_METHOD } from '../../protocol/capabilities';
+/** `user.getLocalIdentity` 不需要入参。 */
+export type GetLocalIdentityPayload = void;
+/** 当前用户在本小程序内稳定且隔离的身份。 */
+export interface GetLocalIdentityResult {
+    appUserId: string;
+}
+export declare function getLocalIdentity(requester: MiniProgramRequester): Promise<GetLocalIdentityResult>;

package/types/modules/user/index.d.ts

@@ -1,51 +1,23 @@
 import type { MiniProgramRequester } from '../../core/client';
 import { USER_GET_INFO_METHOD, type GetUserInfoResult } from './get-info';
-import { USER_GET_CURRENT_USER_DETAIL_METHOD, type GetCurrentUserDetailResult } from './get-current-user-detail';
-import { USER_GET_CURRENT_USER_PROFILE_METHOD, type GetCurrentUserProfileResult } from './get-current-user-profile';
-import { USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, type GetPlatformAccountInfoResult } from './get-platform-account-info';
-import { USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD, type GetPlatformAccountOverviewResult } from './get-platform-account-overview';
-import { USER_GET_STEAM_GAME_LIST_METHOD, type GetSteamGameListOptions, type GetSteamGameListResult } from './get-steam-game-list';
-import type { PlatformAccountType } from './types';
+import { USER_GET_LOCAL_IDENTITY_METHOD, type GetLocalIdentityResult } from './get-local-identity';
+import { USER_REVOKE_AUTHORIZATION_METHOD, type RevokeAuthorizationResult } from './revoke-authorization';
+import { USER_GET_STEAM_GAME_LIST_METHOD, type GetSteamGameListOptions, type GetSteamGameListResult } from './steam-game-list';
 export * from './get-info';
-export * from './get-current-user-detail';
-export * from './get-current-user-profile';
-export * from './get-platform-account-info';
-export * from './get-platform-account-overview';
-export * from './get-steam-game-list';
+export * from './get-local-identity';
+export * from './revoke-authorization';
+export * from './steam-game-list';
 export * from './types';
-export type { MiniProgramUserMethod } from '../../protocol/capabilities';
 /** 外部小程序可调用的用户模块。 */
 export interface MiniProgramUserModule {
-    /**
-     * 获取当前用户登录态与公开基础资料。
-     */
+    /** 获取当前黑盒 APP 登录态、授权状态和已获准披露的资料。 */
     getInfo(): Promise<GetUserInfoResult>;
-    /**
-     * 获取当前用户展示详情。
-     */
-    getCurrentUserDetail(): Promise<GetCurrentUserDetailResult>;
-    /**
-     * 获取当前用户敏感资料详情。
-     */
-    getCurrentUserProfile(): Promise<GetCurrentUserProfileResult>;
-    /**
-     * 获取当前用户平台账号绑定/隐藏状态概览。
-     */
-    getPlatformAccountOverview(): Promise<GetPlatformAccountOverviewResult>;
-    /**
-     * 获取当前用户指定平台账号详情。
-     */
-    getPlatformAccountInfo<T extends PlatformAccountType>(platform: T): Promise<GetPlatformAccountInfoResult<T>>;
-    /**
-     * 获取当前用户 Steam 游戏库。
-     */
+    /** 获取当前用户在本小程序内稳定且隔离的身份。 */
+    getLocalIdentity(): Promise<GetLocalIdentityResult>;
+    /** 撤销当前用户授予本小程序的授权；必须由可信用户操作触发。 */
+    revokeAuthorization(): Promise<RevokeAuthorizationResult>;
+    /** 获取当前用户的 Steam 游戏库。 */
     getSteamGameList(options?: GetSteamGameListOptions): Promise<GetSteamGameListResult>;
 }
-/**
- * 创建用户模块。
- *
- * @param requester 底层 bridge 请求能力。
- * @returns 面向业务层的用户模块对象。
- */
 export declare function createUserModule(requester: MiniProgramRequester): MiniProgramUserModule;
-export { USER_GET_INFO_METHOD, USER_GET_CURRENT_USER_DETAIL_METHOD, USER_GET_CURRENT_USER_PROFILE_METHOD, USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD, USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, };
+export { USER_GET_INFO_METHOD, USER_GET_LOCAL_IDENTITY_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_REVOKE_AUTHORIZATION_METHOD, };

package/types/modules/user/revoke-authorization.d.ts

@@ -0,0 +1,7 @@
+import type { MiniProgramRequester } from '../../core/client';
+export { USER_REVOKE_AUTHORIZATION_METHOD } from '../../protocol/capabilities';
+/** `user.revokeAuthorization` 不接收入参。 */
+export type RevokeAuthorizationPayload = void;
+/** 撤销成功后不返回用户身份或资料。 */
+export type RevokeAuthorizationResult = void;
+export declare function revokeAuthorization(requester: MiniProgramRequester): Promise<RevokeAuthorizationResult>;

package/types/modules/user/steam-game-list.d.ts

@@ -0,0 +1,72 @@
+import type { MiniProgramRequester } from '../../core/client';
+/** Steam 游戏库排序方式。 */
+export type SteamGameListSort = 'weeks' | 'all' | 'achieved';
+/** Steam 游戏库查询与分页参数。 */
+export interface GetSteamGameListOptions {
+    /** 指定当前用户绑定的 Steam ID；不传时使用默认主账号。 */
+    steamId?: string;
+    /** 分页数量，默认 20，最大 100。 */
+    limit?: number;
+    /** 分页偏移量，默认 0。 */
+    offset?: number;
+    /** 排序方式，默认 `weeks`。 */
+    sort?: SteamGameListSort;
+    /** 搜索关键词。 */
+    q?: string;
+    /** 是否包含当前用户隐藏的游戏，默认 `false`。 */
+    includeHidden?: boolean;
+}
+/** `user.getSteamGameList` 请求参数。 */
+export type GetSteamGameListPayload = GetSteamGameListOptions | undefined;
+/** Steam 游戏库条目。 */
+export interface SteamGamePrice {
+    current?: string;
+    initial?: string;
+    discount?: number;
+    lowestPrice?: number;
+    deadlineDate?: string;
+    deadlineTimestamp?: number;
+}
+/** Steam 游戏库条目。 */
+export interface SteamGameListItem {
+    appid: number;
+    steamAppid: number;
+    name: string;
+    image?: string;
+    icon?: string;
+    playtimeForever?: number;
+    playtime2Weeks?: number;
+    tags?: string[];
+    price?: SteamGamePrice;
+}
+/** Steam 游戏库分页数据。 */
+export interface SteamGameListData {
+    gameList: SteamGameListItem[];
+    total?: number;
+    hasMore: boolean;
+    nextOffset: number;
+    isMe?: boolean;
+}
+/** `user.getSteamGameList` 返回当前用户的 Steam 绑定状态和游戏库。 */
+export type GetSteamGameListResult = {
+    isLogin: false;
+    isBound: false;
+    data: null;
+} | {
+    isLogin: true;
+    isBound: false;
+    data: null;
+} | {
+    isLogin: true;
+    isBound: true;
+    data: SteamGameListData;
+};
+/**
+ * 获取当前用户 Steam 游戏库。
+ *
+ * @param requester 底层 bridge 请求能力。
+ * @param options 查询与分页参数。
+ * @returns 当前用户 Steam 游戏库；未登录或未绑定 Steam 时返回状态对象。
+ */
+export declare function getSteamGameList(requester: MiniProgramRequester, options?: GetSteamGameListOptions): Promise<GetSteamGameListResult>;
+export { USER_GET_STEAM_GAME_LIST_METHOD } from '../../protocol/capabilities';

package/types/modules/user/types.d.ts

@@ -1,312 +1,47 @@
+/** 用户资料授权状态。 */
+export type UserInfoAuthorizationStatus = 'not_required' | 'not_requested' | 'granted' | 'denied';
+/** 当前小程序对用户身份与公开资料的授权状态。 */
+export interface UserInfoAuthorization {
+    identity: UserInfoAuthorizationStatus;
+    profile: UserInfoAuthorizationStatus;
+}
 /**
- * 小程序用户公开基础资料。
+ * 已获准向当前小程序披露的用户资料。
  *
- * 这里只包含允许暴露给外部小程序的公开字段，不包含 token、手机号、
- * cookie 或任何可用于直接调用主站私有接口的凭据。
+ * @remarks
+ * 只有 `identity` 已授权时，`user.getInfo()` 才会返回该对象。撤销 `identity`
+ * 后 `userInfo` 变为 `null`，调用方应停止使用并清理本地缓存的旧身份。
  */
-export interface MiniProgramUserInfo {
-    /** 黑盒用户 ID。 */
-    heybox_id: string;
-    /** 用户昵称。 */
-    nickname: string;
-    /** 用户头像 URL。 */
-    avatar: string;
+export interface AuthorizedUserInfo {
+    /**
+     * 当前黑盒用户在当前小程序内稳定且不可逆的关联标识。
+     *
+     * @remarks
+     * 同一用户在不同小程序中的值不同。它不是黑盒用户 ID、登录凭据或主站私有接口凭据，
+     * 只应作为当前小程序自己的业务关联键使用。示例：
+     * `au_1_x7K9mQ2pL4vN8cR3tY6wB1zD5fH`。调用方必须把完整值视为不透明字符串，
+     * 不应解析格式或依赖固定长度。
+     */
+    app_user_id: string;
+    /** 仅在 `profile` 授权后返回昵称与头像。 */
+    profile: {
+        nickname: string;
+        avatar: string;
+    } | null;
 }
 /**
- * 用户能力统一返回结构。
+ * 当前黑盒 APP 登录态、授权状态和已获准披露的用户资料。
  *
  * @remarks
- * 未登录时 `isLogin` 为 `false`，且 `userInfo` 固定为 `null`。
- * 已登录时 `isLogin` 为 `true`，`userInfo` 为公开基础资料。
+ * 未登录时 `isHeyboxAppLoggedIn` 为 `false`，授权状态和用户资料均为 `null`。
+ * 已登录但 identity 未授权时，`userInfo` 仍为 `null`。
  */
-export interface MiniProgramUserInfoResult {
-    /** 当前访问小程序的用户是否已登录黑盒账号。 */
-    isLogin: boolean;
-    /** 当前用户公开基础资料；未登录时为 `null`。 */
-    userInfo: MiniProgramUserInfo | null;
-}
-/** 当前用户作用域的登录态包装。 */
-export type UserScopedResult<T> = {
-    /** 当前访问小程序的用户已登录黑盒账号。 */
-    isLogin: true;
-    /** 当前用户作用域数据。 */
-    data: T;
+export type MiniProgramUserInfoResult = {
+    isHeyboxAppLoggedIn: false;
+    authorization: null;
+    userInfo: null;
 } | {
-    /** 当前访问小程序的用户未登录黑盒账号。 */
-    isLogin: false;
-    /** 未登录时固定为 `null`。 */
-    data: null;
+    isHeyboxAppLoggedIn: true;
+    authorization: UserInfoAuthorization;
+    userInfo: AuthorizedUserInfo | null;
 };
-/** 当前用户等级展示信息。 */
-export interface CurrentUserLevelInfo {
-    level?: string;
-    level_name?: string;
-    exp?: string;
-    next_exp?: string;
-    icon?: string;
-}
-/** 当前用户徽章展示信息。 */
-export interface CurrentUserMedal {
-    id?: string;
-    name?: string;
-    desc?: string;
-    icon?: string;
-    image?: string;
-    is_wearing?: boolean;
-}
-/** 当前用户头像装扮信息。 */
-export interface CurrentUserAvatarDecoration {
-    id?: string;
-    name?: string;
-    image?: string;
-    frame_url?: string;
-    is_using?: boolean;
-}
-/** 当前用户头像配置。 */
-export interface CurrentUserAvatarConfig {
-    avatar?: string;
-    frame_url?: string;
-    pendant_url?: string;
-}
-/** 当前用户社区资料摘要。 */
-export interface CurrentUserBbsInfo {
-    uid?: string;
-    nickname?: string;
-    avatar?: string;
-    level?: string;
-}
-/** 当前用户公开/展示详情。 */
-export interface CurrentUserDetail {
-    heybox_id: string;
-    nickname: string;
-    avatar: string;
-    sex?: string;
-    signature?: string;
-    ip_location?: string;
-    friends_count?: string;
-    level_info?: CurrentUserLevelInfo;
-    medals?: CurrentUserMedal[];
-    avatar_decoration?: CurrentUserAvatarDecoration;
-    avatar_config?: CurrentUserAvatarConfig;
-    bbs_info?: CurrentUserBbsInfo;
-}
-/** 当前用户敏感资料/编辑详情。 */
-export interface CurrentUserProfile {
-    heybox_id: string;
-    nickname?: string;
-    avatar?: string;
-    gender?: string;
-    birthday?: string;
-    email?: string;
-    education?: string;
-    career?: string;
-    signature?: string;
-}
-/** 第一版支持的平台账号类型。 */
-export type PlatformAccountType = 'steam' | 'epic' | 'xbox' | 'psn' | 'switch' | 'pc_hardware' | 'mobile';
-/** 平台账号轻量展示统计项。 */
-export interface PlatformStatItem {
-    key?: string;
-    name?: string;
-    desc?: string;
-    value?: string;
-    num?: string;
-    icon?: string;
-    img?: string;
-    color?: string;
-}
-/** 平台账号通用基础资料。 */
-export interface BasePlatformAccountInfo {
-    nickname?: string;
-    avatar?: string;
-    background_url?: string;
-    stats?: PlatformStatItem[];
-}
-/** Steam 平台账号详情。 */
-export interface SteamPlatformAccountInfo extends BasePlatformAccountInfo {
-    steamid: string;
-    short_id?: string;
-    level?: string;
-    city?: string;
-    province?: string;
-    country?: string;
-    country_code?: string;
-    country_flag?: string;
-    avatar_frame?: string;
-    head_image?: string;
-    head_video?: string;
-    update_time?: string;
-    account_year?: string;
-    individuality_signature?: string;
-    level_icon?: string;
-    total_badge_count?: string;
-    total_dlcs_count?: string;
-    total_game_count?: string;
-    total_game_price?: string;
-    total_player_time?: string;
-    friend_code?: string;
-    friend_code_show?: boolean;
-    inventory_open?: boolean;
-    personal_information_open?: boolean;
-    has_history?: boolean;
-}
-/** Steam 游戏库排序方式。 */
-export type SteamGameListSort = 'weeks' | 'all' | 'achieved';
-/** Steam 游戏库请求参数。 */
-export interface GetSteamGameListOptions {
-    /** 指定当前用户绑定的 Steam ID；不传时由宿主使用默认主账号。 */
-    steamId?: string;
-    /** 分页数量，默认 20，最大 100。 */
-    limit?: number;
-    /** 分页偏移量，默认 0。 */
-    offset?: number;
-    /** 排序方式，默认 `weeks`。 */
-    sort?: SteamGameListSort;
-    /** 搜索关键词。 */
-    q?: string;
-    /** 是否包含当前用户隐藏的游戏，默认 `false`。 */
-    includeHidden?: boolean;
-}
-/** `user.getSteamGameList` 请求参数。 */
-export type GetSteamGameListPayload = GetSteamGameListOptions | undefined;
-/** Steam 游戏价格信息。 */
-export interface SteamGamePrice {
-    current?: string;
-    initial?: string;
-    discount?: number;
-    lowestPrice?: number;
-    deadlineDate?: string;
-    deadlineTimestamp?: number;
-}
-/** 当前用户 Steam 游戏库条目。 */
-export interface SteamGameListItem {
-    appid: number;
-    steamAppid: number;
-    name: string;
-    image?: string;
-    icon?: string;
-    background?: string;
-    verticalImage?: string;
-    playtimeForever?: number;
-    playtime2Weeks?: number;
-    playtimePercent?: number;
-    achievedCount?: number;
-    achievementCount?: number;
-    isCleared?: boolean;
-    score?: string;
-    isFree?: boolean;
-    notOwned?: boolean;
-    hidden?: boolean;
-    onlinePlayer?: string;
-    tags?: string[];
-    genres?: string[];
-    price?: SteamGamePrice;
-}
-/** 当前用户 Steam 游戏库分页数据。 */
-export interface SteamGameListData {
-    gameList: SteamGameListItem[];
-    total?: number;
-    hasMore: boolean;
-    nextOffset: number;
-    isMe?: boolean;
-}
-/** `user.getSteamGameList` 返回当前用户 Steam 游戏库。 */
-export type GetSteamGameListResult = {
-    isLogin: false;
-    isBound: false;
-    data: null;
-} | {
-    isLogin: true;
-    isBound: false;
-    data: null;
-} | {
-    isLogin: true;
-    isBound: true;
-    data: SteamGameListData;
-};
-/** Epic 平台账号详情。 */
-export interface EpicPlatformAccountInfo extends BasePlatformAccountInfo {
-    xuid?: string;
-    head_color?: string;
-    desc?: string;
-}
-/** Xbox 平台账号详情。 */
-export interface XboxPlatformAccountInfo extends BasePlatformAccountInfo {
-    xuid?: string;
-    desc?: string;
-}
-/** PSN 平台账号详情。 */
-export interface PsnPlatformAccountInfo extends BasePlatformAccountInfo {
-    name?: string;
-    level?: string;
-    description?: string;
-    is_open?: boolean;
-}
-/** Switch 平台账号详情。 */
-export interface SwitchPlatformAccountInfo extends BasePlatformAccountInfo {
-    heybox_id?: string;
-    friend_code?: string;
-    friends_total?: string;
-    games_total?: string;
-    server_name?: string;
-    type?: string;
-    desc?: string;
-}
-/** PC 硬件账号详情。 */
-export interface PcHardwareAccountInfo {
-    cpu?: string;
-    gpu?: string;
-    board?: string;
-    perf_level?: string;
-}
-/** 移动设备平台账号详情。 */
-export interface MobilePlatformAccountInfo {
-    current_device?: {
-        id?: string;
-        name?: string;
-        desc?: string;
-        model?: string;
-        img_url?: string;
-        update_time?: string;
-        stats?: PlatformStatItem[];
-    };
-}
-/** 平台类型到平台账号详情的映射。 */
-export interface PlatformAccountInfoMap {
-    steam: SteamPlatformAccountInfo;
-    epic: EpicPlatformAccountInfo;
-    xbox: XboxPlatformAccountInfo;
-    psn: PsnPlatformAccountInfo;
-    switch: SwitchPlatformAccountInfo;
-    pc_hardware: PcHardwareAccountInfo;
-    mobile: MobilePlatformAccountInfo;
-}
-/** 单个平台账号详情返回结构。 */
-export type PlatformAccountResult<T extends PlatformAccountType> = {
-    isLogin: true;
-    platform: T;
-    is_bound: true;
-    is_hidden: boolean;
-    account_info: PlatformAccountInfoMap[T];
-} | {
-    isLogin: true;
-    platform: T;
-    is_bound: false;
-    is_hidden: boolean;
-    account_info: null;
-} | {
-    isLogin: false;
-    platform: T;
-    is_bound: false;
-    is_hidden: false;
-    account_info: null;
-};
-/** 平台账号绑定/隐藏状态概览。 */
-export interface PlatformAccountOverview {
-    platforms: Array<{
-        platform: PlatformAccountType;
-        is_bound: boolean;
-        is_hidden: boolean;
-    }>;
-    display_order: PlatformAccountType[];
-}