@heybox/hb-sdk 0.4.7 → 0.5.0

package/dist/index.cjs.js

@@ -424,6 +424,16 @@ const AUTH_LOGIN_METHOD = 'auth.login';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const USER_GET_INFO_METHOD = 'user.getInfo';
+/** 当前用户展示详情能力方法名。 */
+const USER_GET_CURRENT_USER_DETAIL_METHOD = 'user.getCurrentUserDetail';
+/** 当前用户敏感资料详情能力方法名。 */
+const USER_GET_CURRENT_USER_PROFILE_METHOD = 'user.getCurrentUserProfile';
+/** 当前用户平台账号概览能力方法名。 */
+const USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD = 'user.getPlatformAccountOverview';
+/** 当前用户指定平台账号详情能力方法名。 */
+const USER_GET_PLATFORM_ACCOUNT_INFO_METHOD = 'user.getPlatformAccountInfo';
+/** 当前用户 Steam 游戏库能力方法名。 */
+const USER_GET_STEAM_GAME_LIST_METHOD = 'user.getSteamGameList';
 /**
  * 展示分享面板能力方法名。
  *
@@ -730,6 +740,37 @@ function getInfo(requester) {
     return requester.request(USER_GET_INFO_METHOD);
 }
 
+/** 获取当前访问小程序用户的展示详情。 */
+function getCurrentUserDetail(requester) {
+    return requester.request(USER_GET_CURRENT_USER_DETAIL_METHOD);
+}
+
+/** 获取当前访问小程序用户的敏感资料详情。 */
+function getCurrentUserProfile(requester) {
+    return requester.request(USER_GET_CURRENT_USER_PROFILE_METHOD);
+}
+
+/** 获取当前访问小程序用户的指定平台账号详情。 */
+function getPlatformAccountInfo(requester, platform) {
+    return requester.request(USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, { platform });
+}
+
+/** 获取当前访问小程序用户的平台账号绑定/隐藏状态概览。 */
+function getPlatformAccountOverview(requester) {
+    return requester.request(USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD);
+}
+
+/**
+ * 获取当前用户 Steam 游戏库。
+ *
+ * @param requester 底层 bridge 请求能力。
+ * @param options 查询与分页参数。
+ * @returns 当前用户 Steam 游戏库；未登录或未绑定 Steam 时返回状态对象。
+ */
+function getSteamGameList(requester, options) {
+    return requester.request(USER_GET_STEAM_GAME_LIST_METHOD, options);
+}
+
 /**
  * 创建用户模块。
  *
@@ -739,6 +780,11 @@ function getInfo(requester) {
 function createUserModule(requester) {
     return {
         getInfo: () => getInfo(requester),
+        getCurrentUserDetail: () => getCurrentUserDetail(requester),
+        getCurrentUserProfile: () => getCurrentUserProfile(requester),
+        getPlatformAccountOverview: () => getPlatformAccountOverview(requester),
+        getPlatformAccountInfo: platform => getPlatformAccountInfo(requester, platform),
+        getSteamGameList: options => getSteamGameList(requester, options),
     };
 }
 
@@ -952,6 +998,11 @@ const auth = {
 /** 默认 SDK 实例的用户资料模块。 */
 const user = {
     getInfo: () => getDefaultSDK().user.getInfo(),
+    getCurrentUserDetail: () => getDefaultSDK().user.getCurrentUserDetail(),
+    getCurrentUserProfile: () => getDefaultSDK().user.getCurrentUserProfile(),
+    getPlatformAccountOverview: () => getDefaultSDK().user.getPlatformAccountOverview(),
+    getPlatformAccountInfo: platform => getDefaultSDK().user.getPlatformAccountInfo(platform),
+    getSteamGameList: options => getDefaultSDK().user.getSteamGameList(options),
 };
 /** 默认 SDK 实例的分享模块。 */
 const share = {

package/dist/index.esm.js

@@ -420,6 +420,16 @@ const AUTH_LOGIN_METHOD = 'auth.login';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const USER_GET_INFO_METHOD = 'user.getInfo';
+/** 当前用户展示详情能力方法名。 */
+const USER_GET_CURRENT_USER_DETAIL_METHOD = 'user.getCurrentUserDetail';
+/** 当前用户敏感资料详情能力方法名。 */
+const USER_GET_CURRENT_USER_PROFILE_METHOD = 'user.getCurrentUserProfile';
+/** 当前用户平台账号概览能力方法名。 */
+const USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD = 'user.getPlatformAccountOverview';
+/** 当前用户指定平台账号详情能力方法名。 */
+const USER_GET_PLATFORM_ACCOUNT_INFO_METHOD = 'user.getPlatformAccountInfo';
+/** 当前用户 Steam 游戏库能力方法名。 */
+const USER_GET_STEAM_GAME_LIST_METHOD = 'user.getSteamGameList';
 /**
  * 展示分享面板能力方法名。
  *
@@ -726,6 +736,37 @@ function getInfo(requester) {
     return requester.request(USER_GET_INFO_METHOD);
 }
 
+/** 获取当前访问小程序用户的展示详情。 */
+function getCurrentUserDetail(requester) {
+    return requester.request(USER_GET_CURRENT_USER_DETAIL_METHOD);
+}
+
+/** 获取当前访问小程序用户的敏感资料详情。 */
+function getCurrentUserProfile(requester) {
+    return requester.request(USER_GET_CURRENT_USER_PROFILE_METHOD);
+}
+
+/** 获取当前访问小程序用户的指定平台账号详情。 */
+function getPlatformAccountInfo(requester, platform) {
+    return requester.request(USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, { platform });
+}
+
+/** 获取当前访问小程序用户的平台账号绑定/隐藏状态概览。 */
+function getPlatformAccountOverview(requester) {
+    return requester.request(USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD);
+}
+
+/**
+ * 获取当前用户 Steam 游戏库。
+ *
+ * @param requester 底层 bridge 请求能力。
+ * @param options 查询与分页参数。
+ * @returns 当前用户 Steam 游戏库；未登录或未绑定 Steam 时返回状态对象。
+ */
+function getSteamGameList(requester, options) {
+    return requester.request(USER_GET_STEAM_GAME_LIST_METHOD, options);
+}
+
 /**
  * 创建用户模块。
  *
@@ -735,6 +776,11 @@ function getInfo(requester) {
 function createUserModule(requester) {
     return {
         getInfo: () => getInfo(requester),
+        getCurrentUserDetail: () => getCurrentUserDetail(requester),
+        getCurrentUserProfile: () => getCurrentUserProfile(requester),
+        getPlatformAccountOverview: () => getPlatformAccountOverview(requester),
+        getPlatformAccountInfo: platform => getPlatformAccountInfo(requester, platform),
+        getSteamGameList: options => getSteamGameList(requester, options),
     };
 }
 
@@ -948,6 +994,11 @@ const auth = {
 /** 默认 SDK 实例的用户资料模块。 */
 const user = {
     getInfo: () => getDefaultSDK().user.getInfo(),
+    getCurrentUserDetail: () => getDefaultSDK().user.getCurrentUserDetail(),
+    getCurrentUserProfile: () => getDefaultSDK().user.getCurrentUserProfile(),
+    getPlatformAccountOverview: () => getDefaultSDK().user.getPlatformAccountOverview(),
+    getPlatformAccountInfo: platform => getDefaultSDK().user.getPlatformAccountInfo(platform),
+    getSteamGameList: options => getDefaultSDK().user.getSteamGameList(options),
 };
 /** 默认 SDK 实例的分享模块。 */
 const share = {

package/dist/protocol.cjs.js

@@ -40,6 +40,16 @@ const AUTH_LOGIN_METHOD = 'auth.login';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const USER_GET_INFO_METHOD = 'user.getInfo';
+/** 当前用户展示详情能力方法名。 */
+const USER_GET_CURRENT_USER_DETAIL_METHOD = 'user.getCurrentUserDetail';
+/** 当前用户敏感资料详情能力方法名。 */
+const USER_GET_CURRENT_USER_PROFILE_METHOD = 'user.getCurrentUserProfile';
+/** 当前用户平台账号概览能力方法名。 */
+const USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD = 'user.getPlatformAccountOverview';
+/** 当前用户指定平台账号详情能力方法名。 */
+const USER_GET_PLATFORM_ACCOUNT_INFO_METHOD = 'user.getPlatformAccountInfo';
+/** 当前用户 Steam 游戏库能力方法名。 */
+const USER_GET_STEAM_GAME_LIST_METHOD = 'user.getSteamGameList';
 /**
  * 展示分享面板能力方法名。
  *
@@ -124,6 +134,41 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'user.getInfo',
         risk: 'medium',
     },
+    {
+        method: USER_GET_CURRENT_USER_DETAIL_METHOD,
+        module: 'user',
+        capability: USER_GET_CURRENT_USER_DETAIL_METHOD,
+        permission: 'user.currentUserDetail',
+        risk: 'high',
+    },
+    {
+        method: USER_GET_CURRENT_USER_PROFILE_METHOD,
+        module: 'user',
+        capability: USER_GET_CURRENT_USER_PROFILE_METHOD,
+        permission: 'user.currentUserProfile',
+        risk: 'high',
+    },
+    {
+        method: USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD,
+        module: 'user',
+        capability: USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD,
+        permission: 'user.platformAccount.overview',
+        risk: 'medium',
+    },
+    {
+        method: USER_GET_PLATFORM_ACCOUNT_INFO_METHOD,
+        module: 'user',
+        capability: USER_GET_PLATFORM_ACCOUNT_INFO_METHOD,
+        permission: 'user.platformAccount.info',
+        risk: 'high',
+    },
+    {
+        method: USER_GET_STEAM_GAME_LIST_METHOD,
+        module: 'user',
+        capability: USER_GET_STEAM_GAME_LIST_METHOD,
+        permission: 'user.steamGameList',
+        risk: 'high',
+    },
     {
         method: SHARE_SHOW_SHARE_MENU_METHOD,
         module: 'share',
@@ -242,7 +287,12 @@ exports.STORAGE_SET_STORAGE_METHOD = STORAGE_SET_STORAGE_METHOD;
 exports.UI_HIDE_LOADING_METHOD = UI_HIDE_LOADING_METHOD;
 exports.UI_SHOW_LOADING_METHOD = UI_SHOW_LOADING_METHOD;
 exports.UI_SHOW_TOAST_METHOD = UI_SHOW_TOAST_METHOD;
+exports.USER_GET_CURRENT_USER_DETAIL_METHOD = USER_GET_CURRENT_USER_DETAIL_METHOD;
+exports.USER_GET_CURRENT_USER_PROFILE_METHOD = USER_GET_CURRENT_USER_PROFILE_METHOD;
 exports.USER_GET_INFO_METHOD = USER_GET_INFO_METHOD;
+exports.USER_GET_PLATFORM_ACCOUNT_INFO_METHOD = USER_GET_PLATFORM_ACCOUNT_INFO_METHOD;
+exports.USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD = USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD;
+exports.USER_GET_STEAM_GAME_LIST_METHOD = USER_GET_STEAM_GAME_LIST_METHOD;
 exports.VIEWPORT_GET_WINDOW_INFO_METHOD = VIEWPORT_GET_WINDOW_INFO_METHOD;
 exports.VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD = VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD;
 exports.isMiniProgramBridgeMessage = isMiniProgramBridgeMessage;

package/dist/protocol.esm.js

@@ -38,6 +38,16 @@ const AUTH_LOGIN_METHOD = 'auth.login';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const USER_GET_INFO_METHOD = 'user.getInfo';
+/** 当前用户展示详情能力方法名。 */
+const USER_GET_CURRENT_USER_DETAIL_METHOD = 'user.getCurrentUserDetail';
+/** 当前用户敏感资料详情能力方法名。 */
+const USER_GET_CURRENT_USER_PROFILE_METHOD = 'user.getCurrentUserProfile';
+/** 当前用户平台账号概览能力方法名。 */
+const USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD = 'user.getPlatformAccountOverview';
+/** 当前用户指定平台账号详情能力方法名。 */
+const USER_GET_PLATFORM_ACCOUNT_INFO_METHOD = 'user.getPlatformAccountInfo';
+/** 当前用户 Steam 游戏库能力方法名。 */
+const USER_GET_STEAM_GAME_LIST_METHOD = 'user.getSteamGameList';
 /**
  * 展示分享面板能力方法名。
  *
@@ -122,6 +132,41 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'user.getInfo',
         risk: 'medium',
     },
+    {
+        method: USER_GET_CURRENT_USER_DETAIL_METHOD,
+        module: 'user',
+        capability: USER_GET_CURRENT_USER_DETAIL_METHOD,
+        permission: 'user.currentUserDetail',
+        risk: 'high',
+    },
+    {
+        method: USER_GET_CURRENT_USER_PROFILE_METHOD,
+        module: 'user',
+        capability: USER_GET_CURRENT_USER_PROFILE_METHOD,
+        permission: 'user.currentUserProfile',
+        risk: 'high',
+    },
+    {
+        method: USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD,
+        module: 'user',
+        capability: USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD,
+        permission: 'user.platformAccount.overview',
+        risk: 'medium',
+    },
+    {
+        method: USER_GET_PLATFORM_ACCOUNT_INFO_METHOD,
+        module: 'user',
+        capability: USER_GET_PLATFORM_ACCOUNT_INFO_METHOD,
+        permission: 'user.platformAccount.info',
+        risk: 'high',
+    },
+    {
+        method: USER_GET_STEAM_GAME_LIST_METHOD,
+        module: 'user',
+        capability: USER_GET_STEAM_GAME_LIST_METHOD,
+        permission: 'user.steamGameList',
+        risk: 'high',
+    },
     {
         method: SHARE_SHOW_SHARE_MENU_METHOD,
         module: 'share',
@@ -222,4 +267,4 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
     },
 ];
 
-export { AUTH_LOGIN_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isMiniProgramBridgeMessage };
+export { AUTH_LOGIN_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_CURRENT_USER_DETAIL_METHOD, USER_GET_CURRENT_USER_PROFILE_METHOD, USER_GET_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isMiniProgramBridgeMessage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.4.7",
+  "version": "0.5.0",
   "description": "",
   "exports": {
     ".": {

package/skill/references/api-protocol.md

@@ -51,7 +51,12 @@ export {
   UI_HIDE_LOADING_METHOD,
   UI_SHOW_LOADING_METHOD,
   UI_SHOW_TOAST_METHOD,
+  USER_GET_CURRENT_USER_DETAIL_METHOD,
+  USER_GET_CURRENT_USER_PROFILE_METHOD,
   USER_GET_INFO_METHOD,
+  USER_GET_PLATFORM_ACCOUNT_INFO_METHOD,
+  USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD,
+  USER_GET_STEAM_GAME_LIST_METHOD,
   VIEWPORT_GET_WINDOW_INFO_METHOD,
   VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD,
 } from './protocol/capabilities';
@@ -76,10 +81,25 @@ export type {
 } from './protocol/capabilities';
 export type { LoginPayload, LoginResult } from './modules/auth';
 export type {
+  GetCurrentUserDetailPayload,
+  GetCurrentUserDetailResult,
+  GetCurrentUserProfilePayload,
+  GetCurrentUserProfileResult,
+  GetPlatformAccountInfoPayload,
+  GetPlatformAccountInfoResult,
+  GetPlatformAccountOverviewPayload,
+  GetPlatformAccountOverviewResult,
+  GetSteamGameListOptions,
+  GetSteamGameListPayload,
+  GetSteamGameListResult,
   GetUserInfoPayload,
   GetUserInfoResult,
   MiniProgramUserInfo,
   MiniProgramUserInfoResult,
+  SteamGameListData,
+  SteamGameListItem,
+  SteamGameListSort,
+  SteamGamePrice,
 } from './modules/user';
 export type { ScreenshotPayload, ScreenshotResult } from './modules/share/screenshot';
 export type { ShowShareMenuPayload, ShowShareMenuResult } from './modules/share/show-share-menu';
@@ -168,5 +188,5 @@ Reference 由 `packages/hb-sdk` 的公开导出与源码注释自动生成，不
 
 | 导出面 | Classes | Functions | Interfaces | Types | Constants |
 | --- | ---: | ---: | ---: | ---: | ---: |
-| Root API | 3 | 4 | 30 | 32 | 3 |
-| Protocol API | 0 | 1 | 25 | 47 | 21 |
+| Root API | 3 | 4 | 53 | 45 | 3 |
+| Protocol API | 0 | 1 | 30 | 57 | 26 |

package/skill/references/api-root.md

@@ -19,7 +19,7 @@
 ## Package metadata
 
 - Package: `@heybox/hb-sdk`
-- Version at generation time: `0.4.7`
+- Version at generation time: `0.5.0`
 - Public root export: `@heybox/hb-sdk`
 - Protocol export: `@heybox/hb-sdk/protocol`
 - Vite plugin export: `@heybox/hb-sdk/vite`
@@ -38,11 +38,47 @@ export type {
 } from './protocol/types';
 export type { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
 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 {
   MiniProgramScreenshotOptions,
@@ -333,6 +369,35 @@ if (!result.isLogin) {
 
 SDK 只返回允许暴露给外部小程序的公开资料，不会返回 token、cookie、手机号或其他私有凭据。
 
+需要当前用户更完整资料时，可以使用 current-user scoped API。这些 API 与 `user.getInfo()` 一样不会主动唤起登录；未登录时返回普通未登录结果，业务应只在用户操作后调用 `auth.login()`。
+
+```ts
+const detail = await user.getCurrentUserDetail();
+
+if (detail.isLogin) {
+  console.log(detail.data.nickname, detail.data.level_info);
+}
+
+const steam = await user.getPlatformAccountInfo('steam');
+
+if (steam.isLogin && steam.is_bound) {
+  console.log(steam.account_info.steamid);
+}
+
+const games = await user.getSteamGameList({
+  limit: 20,
+  sort: 'weeks',
+});
+
+if (games.isLogin && games.isBound) {
+  console.log(games.data.gameList);
+}
+```
+
+`user.getCurrentUserDetail()` 返回当前用户展示资料，`user.getCurrentUserProfile()` 返回更敏感的个人资料字段。`user.getPlatformAccountOverview()` 返回 `steam`、`epic`、`xbox`、`psn`、`switch`、`pc_hardware`、`mobile` 的绑定/隐藏状态；`user.getPlatformAccountInfo(platform)` 只支持这些平台字面量，未绑定平台返回 `account_info: null`，不会抛出未绑定错误。`user.getSteamGameList(options)` 返回当前用户 Steam 游戏库，未登录或未绑定 Steam 时返回状态对象；分页 `limit` 默认 20、最大 100，`sort` 支持 `weeks`、`all`、`achieved`。
+
+这些 API 仍然只面向当前登录用户，不支持传入 `userid` 查询其他人。平台账号详情和 Steam 游戏库会过滤好友列表、客户端路由协议和页面 UI 状态字段；敏感字段按独立 permission key 管理，后续可由宿主策略按能力或平台收紧。
+
 ### 分享
 
 ```ts

package/skill/references/safety-boundaries.md

@@ -11,7 +11,8 @@
 ## 能力边界
 
 - 调用模块能力前会自动等待 `ready()`，但业务仍建议在页面启动阶段显式 `await ready()`，便于集中处理握手失败。
-- `user.getInfo()` 不会触发登录；登录必须由业务在用户操作后调用 `auth.login()`。
+- `user.getInfo()`、`user.getCurrentUserDetail()`、`user.getCurrentUserProfile()`、`user.getPlatformAccountOverview()`、`user.getPlatformAccountInfo(platform)` 和 `user.getSteamGameList(options)` 不会触发登录；登录必须由业务在用户操作后调用 `auth.login()`。
+- 当前用户详情和平台账号 API 只允许读取当前登录用户，不支持传入 `userid` 查询其他人，也不透传 `/account/home_v2/` 原始响应。
 - 分享、截图、UI、设备、导航、storage 和网络请求只开放稳定窄接口，不透传黑盒客户端内部协议参数。
 - `network.request()` 的 `validateStatus` 只在 SDK 本地执行，不会被序列化给父容器。
 - `on()` 返回取消监听函数；组件卸载或页面销毁时应主动取消监听。

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.4.7+skill.c42e9bccd99b",
+  "skillVersion": "0.5.0+skill.a70b82c55c5b",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.4.7",
-    "compatibility": "0.4.7"
+    "version": "0.5.0",
+    "compatibility": "0.5.0"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-c42e9bccd99b7a9f6119a18ad0bd8bd9040176bdcc99134b0c6f29aa19e9aa59"
+  "integrity": "sha256-a70b82c55c5bab095c92d138f75cec352f9dce0d2cd1cd3fb897a196fa63f09d"
 }

package/types/index.d.ts

@@ -4,7 +4,7 @@ export type { MiniProgramSDKOptions } from './core/client';
 export { ready, on, off, auth, user, share, viewport, storage, network, ui, device, navigation } from './core/singleton';
 export type { MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap, } from './protocol/types';
 export type { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
-export type { GetUserInfoPayload, GetUserInfoResult, MiniProgramUserInfo, MiniProgramUserInfoResult, MiniProgramUserModule, } from './modules/user';
+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 { MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareModule, 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';

package/types/modules/user/get-current-user-detail.d.ts

@@ -0,0 +1,9 @@
+import type { MiniProgramRequester } from '../../core/client';
+import type { CurrentUserDetail, UserScopedResult } from './types';
+export { USER_GET_CURRENT_USER_DETAIL_METHOD } from '../../protocol/capabilities';
+/** `user.getCurrentUserDetail` 不需要入参。 */
+export type GetCurrentUserDetailPayload = void;
+/** `user.getCurrentUserDetail` 返回当前用户展示详情。 */
+export type GetCurrentUserDetailResult = UserScopedResult<CurrentUserDetail>;
+/** 获取当前访问小程序用户的展示详情。 */
+export declare function getCurrentUserDetail(requester: MiniProgramRequester): Promise<GetCurrentUserDetailResult>;

package/types/modules/user/get-current-user-profile.d.ts

@@ -0,0 +1,9 @@
+import type { MiniProgramRequester } from '../../core/client';
+import type { CurrentUserProfile, UserScopedResult } from './types';
+export { USER_GET_CURRENT_USER_PROFILE_METHOD } from '../../protocol/capabilities';
+/** `user.getCurrentUserProfile` 不需要入参。 */
+export type GetCurrentUserProfilePayload = void;
+/** `user.getCurrentUserProfile` 返回当前用户敏感资料详情。 */
+export type GetCurrentUserProfileResult = UserScopedResult<CurrentUserProfile>;
+/** 获取当前访问小程序用户的敏感资料详情。 */
+export declare function getCurrentUserProfile(requester: MiniProgramRequester): Promise<GetCurrentUserProfileResult>;

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

@@ -0,0 +1,12 @@
+import type { MiniProgramRequester } from '../../core/client';
+import type { PlatformAccountResult, PlatformAccountType } from './types';
+export { USER_GET_PLATFORM_ACCOUNT_INFO_METHOD } from '../../protocol/capabilities';
+/** `user.getPlatformAccountInfo` 请求参数。 */
+export interface GetPlatformAccountInfoPayload<T extends PlatformAccountType = PlatformAccountType> {
+    /** 要读取的平台账号类型。 */
+    platform: T;
+}
+/** `user.getPlatformAccountInfo` 返回指定平台的当前用户账号详情。 */
+export type GetPlatformAccountInfoResult<T extends PlatformAccountType = PlatformAccountType> = PlatformAccountResult<T>;
+/** 获取当前访问小程序用户的指定平台账号详情。 */
+export declare function getPlatformAccountInfo<T extends PlatformAccountType>(requester: MiniProgramRequester, platform: T): Promise<GetPlatformAccountInfoResult<T>>;

package/types/modules/user/get-platform-account-overview.d.ts

@@ -0,0 +1,9 @@
+import type { MiniProgramRequester } from '../../core/client';
+import type { PlatformAccountOverview, UserScopedResult } from './types';
+export { USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD } from '../../protocol/capabilities';
+/** `user.getPlatformAccountOverview` 不需要入参。 */
+export type GetPlatformAccountOverviewPayload = void;
+/** `user.getPlatformAccountOverview` 返回当前用户平台账号概览。 */
+export type GetPlatformAccountOverviewResult = UserScopedResult<PlatformAccountOverview>;
+/** 获取当前访问小程序用户的平台账号绑定/隐藏状态概览。 */
+export declare function getPlatformAccountOverview(requester: MiniProgramRequester): Promise<GetPlatformAccountOverviewResult>;

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

@@ -0,0 +1,12 @@
+import type { MiniProgramRequester } from '../../core/client';
+import type { GetSteamGameListOptions, GetSteamGameListResult } from './types';
+export { USER_GET_STEAM_GAME_LIST_METHOD } from '../../protocol/capabilities';
+export type { GetSteamGameListOptions, GetSteamGameListPayload, GetSteamGameListResult } from './types';
+/**
+ * 获取当前用户 Steam 游戏库。
+ *
+ * @param requester 底层 bridge 请求能力。
+ * @param options 查询与分页参数。
+ * @returns 当前用户 Steam 游戏库；未登录或未绑定 Steam 时返回状态对象。
+ */
+export declare function getSteamGameList(requester: MiniProgramRequester, options?: GetSteamGameListOptions): Promise<GetSteamGameListResult>;

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

@@ -1,6 +1,17 @@
 import type { MiniProgramRequester } from '../../core/client';
-import { type GetUserInfoResult } from './get-info';
+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';
 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 './types';
 export type { MiniProgramUserMethod } from '../../protocol/capabilities';
 /** 外部小程序可调用的用户模块。 */
@@ -9,6 +20,26 @@ export interface MiniProgramUserModule {
      * 获取当前用户登录态与公开基础资料。
      */
     getInfo(): Promise<GetUserInfoResult>;
+    /**
+     * 获取当前用户展示详情。
+     */
+    getCurrentUserDetail(): Promise<GetCurrentUserDetailResult>;
+    /**
+     * 获取当前用户敏感资料详情。
+     */
+    getCurrentUserProfile(): Promise<GetCurrentUserProfileResult>;
+    /**
+     * 获取当前用户平台账号绑定/隐藏状态概览。
+     */
+    getPlatformAccountOverview(): Promise<GetPlatformAccountOverviewResult>;
+    /**
+     * 获取当前用户指定平台账号详情。
+     */
+    getPlatformAccountInfo<T extends PlatformAccountType>(platform: T): Promise<GetPlatformAccountInfoResult<T>>;
+    /**
+     * 获取当前用户 Steam 游戏库。
+     */
+    getSteamGameList(options?: GetSteamGameListOptions): Promise<GetSteamGameListResult>;
 }
 /**
  * 创建用户模块。
@@ -17,3 +48,4 @@ export interface MiniProgramUserModule {
  * @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, };