@cx00123/lunetale-game-sdk 0.2.0 → 0.3.0

package/README.md

@@ -43,7 +43,7 @@ try {
 
 ```html
 <script type="module">
-  import { createGameClient } from 'https://cdn.jsdelivr.net/npm/@cx00123/lunetale-game-sdk@0.2.0/src/index.js'
+  import { createGameClient } from 'https://cdn.jsdelivr.net/npm/@cx00123/lunetale-game-sdk@0.3.0/src/index.js'
   const game = createGameClient()
   const vip = await game.getVIP()
   document.querySelector('#vip').textContent = vip.isVip ? '会员' : '普通用户'
@@ -80,6 +80,20 @@ if (character) {
 - 角色游戏存档按账号/身份/角色/游戏/存档代际独立保存，兼容程序更新继续使用同一存档；不自动导入旧版账号级存档，不向网页暴露这些隔离键。
 - `chat()` 仍为通用模型调用：由游戏提供 messages，不读写角色长期记忆。选择角色不会偷偷改变 `chat()` 的语义。
 
+### 获取当前玩家资料（0.3.0+）
+
+```js
+const player = await game.getPlayerProfile()
+// 当前 App 登录账号的展示资料，不是角色或聊天身份。
+document.querySelector('#player-name').textContent = player.nickname
+if (player.avatarUrl) document.querySelector('#player-avatar').src = player.avatarUrl
+console.log(player.bio)
+```
+
+返回 `{nickname, avatarUrl, bio}`，均为字符串，未设置时为空。昵称来自账号展示名，不会用邮箱兜底。每次调用读取后端最新资料，无 AI 计费；普通游戏也可使用，无需选角色。仍须从 App 或可信登录入口获得有效游戏凭证，不支持匿名读取或传 userId 查询别人。SDK 仅返回三个展示字段，不包含内部账号 ID、UUID、邮箱、手机号、密码、登录 token、聊天身份或记忆。
+
+需要同时部署新版后端和新版 Android / iOS App，旧 App 的原生桥不支持 `player` action；SDK 不会绕过旧端白名单，也不把 App JWT 交给网页。玩家资料属于个人信息，游戏应仅用于必要的界面展示，勿写入第三方分析日志。
+
 ## 2. 平台管理员准备
 
 1. 发布支持本 SDK 的后端并完成游戏定向迁移（先核对目标库和备份；角色/剧本模块须已部署）；安装新版 Android / iOS App。
@@ -135,6 +149,7 @@ CDN 的 HTML、图片等静态文件仍可公开访问；这些凭证保护的
 | --- | --- |
 | `createGameClient(options?)` | 创建一个顶层页面客户端；调用时同步取走并清除 fragment 授权码 |
 | `ready()` | 完成授权；其它方法也会按需自动授权 |
+| `getPlayerProfile()` | `{nickname,avatarUrl,bio}`，当前账号展示资料，非所选角色 |
 | `getVIP()` | `{isVip,tier,expiresAt,balance,aiEnabled,cost,vipOnly}` |
 | `isVIP()` | `boolean`；有效 VIP、SVIP 都是 true，查询失败会抛异常，不伪装为 false |
 | `chat({requestId?,messages})` | 通用 AI，`{requestId,content,charged,balance}`；不写角色记忆 |
@@ -193,6 +208,7 @@ CDN 的 HTML、图片等静态文件仍可公开访问；这些凭证保护的
 | POST | `/lunetale/game/runtime/exchange` | `Origin` + 一次性 code | `{code}` → `{accessToken,expiresAt,gameId}` |
 | GET | `/lunetale/game/runtime/vip` | `Origin` + `Authorization: Bearer <游戏凭证>` | VIPStatus，可选 credential |
 | POST | `/lunetale/game/runtime/chat` | 同上 | `{requestId,messages}` → ChatResult，可选 credential |
+| GET | `/lunetale/game/runtime/player` | 同上 | `{player:{nickname,avatarUrl,bio}}`，可选 credential；无参数 |
 | GET | `/lunetale/game/runtime/character` | 同上 | `{character: SelectedCharacter|null}`，可选 credential |
 | POST | `/lunetale/game/runtime/character-chat` | 同上 | `{requestId,message,scene?}` → CharacterChatResult，可选 credential |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cx00123/lunetale-game-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Lunetale HTML game selected-character, memory chat, AI and VIP SDK for Android/iOS and authorized web games",
   "type": "module",
   "main": "./src/index.js",

package/src/index.d.ts

@@ -34,6 +34,13 @@ export interface ChatResult {
   /** Balance at the original successful transaction; replay does not refresh it. */
   balance: number
 }
+/** Current account display profile, not the selected role or chat identity. */
+export interface PlayerProfile {
+  nickname: string
+  /** Empty string when no avatar is configured. */
+  avatarUrl: string
+  bio: string
+}
 export interface SelectedCharacter {
   id: number
   name: string
@@ -68,6 +75,8 @@ export class GameSDKError extends Error {
 export interface GameClient {
   ready(): Promise<void>
   getVIP(): Promise<VIPStatus>
+  /** Fetches current profile; no account IDs, login details or credentials. */
+  getPlayerProfile(): Promise<PlayerProfile>
   /** Both active VIP and SVIP count as true. */
   isVIP(): Promise<boolean>
   chat(input: ChatInput): Promise<ChatResult>

package/src/index.js

@@ -117,12 +117,12 @@ export function createGameClient(options = {}) {
       const timer = setTimeout(() => controller.abort(), timeout)
       try {
         const response = await fetch(`${base.href.replace(/\/$/, '')}/lunetale/game/runtime/${action}`, {
-          method: ['vip', 'character'].includes(action) ? 'GET' : 'POST',
+          method: ['vip', 'character', 'player'].includes(action) ? 'GET' : 'POST',
           headers: {
             'Content-Type': 'application/json',
             ...(token ? { Authorization: `Bearer ${token}` } : {}),
           },
-          body: ['vip', 'character'].includes(action) ? undefined : JSON.stringify(payload),
+          body: ['vip', 'character', 'player'].includes(action) ? undefined : JSON.stringify(payload),
           signal: controller.signal,
           credentials: 'omit',
           cache: 'no-store',
@@ -199,6 +199,15 @@ export function createGameClient(options = {}) {
     },
     getVIP() { return request('vip') },
     async isVIP() { return (await request('vip')).isVip === true },
+    async getPlayerProfile() {
+      const { player } = await request('player')
+      if (!player || typeof player !== 'object' || Array.isArray(player) ||
+          ['nickname', 'avatarUrl', 'bio'].some(key => typeof player[key] !== 'string')) {
+        throw new GameSDKError('PROTOCOL', '玩家资料响应格式错误')
+      }
+      // Explicit whitelist: future server fields must not leak account data.
+      return { nickname: player.nickname, avatarUrl: player.avatarUrl, bio: player.bio }
+    },
     async getSelectedCharacter() {
       const result = await request('character')
       if (!Object.hasOwn(result, 'character') || (result.character !== null &&