qqmusic-api-enhanced 1.0.0 → 1.0.1

package/interface.d.ts

@@ -34,8 +34,11 @@ export interface LoginQrCreateResult {
   qrsig?: string;
   ptqrtoken?: string | number;
   uuid?: string;
-  qrimg: string;
-  url: string;
+  qrcode?: string;
+  qrcodeID?: string;
+  qrurl?: string;
+  qrimg?: string;
+  url?: string;
 }
 
 export interface LoginQrCheckQuery extends RequestBaseConfig {
@@ -43,8 +46,14 @@ export interface LoginQrCheckQuery extends RequestBaseConfig {
   type?: "qq" | "wx" | "mobile";
   /** 手机 QQ 轮询凭证，来源于 login_qr_create */
   qrsig?: string;
+  /** 手机 QQ 轮询 token，来源于 login_qr_create */
+  ptqrtoken?: string | number;
   /** 微信轮询凭证 uuid，来源于 login_qr_create */
   uuid?: string;
+  /** QQ 音乐移动端 App 扫码 qrcodeID，来源于 login_qr_create */
+  qrcodeID?: string;
+  /** 兼容通用 key 参数 */
+  key?: string;
 }
 
 export interface LoginQrCheckResult {
@@ -54,6 +63,26 @@ export interface LoginQrCheckResult {
   musickey?: string;
   cookie?: Record<string, string>;
   cookieStr?: string;
+  data?: Record<string, any>;
+}
+
+export interface NormalizedVipInfo {
+  vipStatus: "vip" | "nonVip" | "unknown";
+  vipTier?: "svip" | "vip";
+  vipLevel?: number;
+  vipYear?: boolean;
+  vipExpireTime?: number;
+}
+
+export interface NormalizedLoginAccount {
+  userId: string;
+  nickname: string;
+  avatarUrl?: string;
+  vipStatus: "vip" | "nonVip" | "unknown";
+  vipTier?: "svip" | "vip";
+  vipLevel?: number;
+  vipYear?: boolean;
+  vipExpireTime?: number;
 }
 
 export interface LoginStatusQuery extends RequestBaseConfig {}
@@ -61,18 +90,37 @@ export interface LoginStatusQuery extends RequestBaseConfig {}
 export interface LoginStatusResult {
   code: number;
   isLogin: boolean;
-  uin?: string;
+  uin: string;
+  nickname: string;
+  avatarUrl?: string;
+  vip: NormalizedVipInfo;
+  account: NormalizedLoginAccount;
+  data?: Record<string, any>;
   userInfo?: Record<string, any>;
 }
 
-export interface LoginRefreshQuery extends RequestBaseConfig {}
+export interface LoginRefreshQuery extends RequestBaseConfig {
+  openid?: string;
+  refresh_token?: string;
+  refresh_key?: string;
+}
 
 export interface LoginRefreshResult {
   code: number;
   musickey?: string;
+  cookieStr?: string;
+  data?: Record<string, any>;
   raw?: Record<string, any>;
 }
 
+export interface UserVipInfoQuery extends RequestBaseConfig {}
+
+export interface UserVipInfoResult {
+  code: number;
+  data: Record<string, any>;
+  vip: NormalizedVipInfo;
+}
+
 // ==============================
 // 2. 歌曲与播放 (Songs & Playback)
 // ==============================
@@ -281,6 +329,8 @@ export function song_detail(query?: SongDetailQuery): Promise<Response<SongDetai
 export function song_url(query?: SongUrlQuery): Promise<Response<SongUrlResult>>;
 export function user_detail(query?: UserDetailQuery): Promise<Response<UserDetailResult>>;
 export function user_playlist(query?: UserPlaylistQuery): Promise<Response<UserPlaylistResult>>;
+export function user_vip_info(query?: UserVipInfoQuery): Promise<Response<UserVipInfoResult>>;
+export function deriveVipInfo(body: any): NormalizedVipInfo;
 
 // 基础网络调度器与工具函数
 export function request(arg1: string, arg2?: any, arg3?: any, arg4?: any): Promise<ApiResponse>;
@@ -312,6 +362,8 @@ declare const api: {
   song_url: typeof song_url;
   user_detail: typeof user_detail;
   user_playlist: typeof user_playlist;
+  user_vip_info: typeof user_vip_info;
+  deriveVipInfo: typeof deriveVipInfo;
   request: typeof request;
   requestCgi: typeof requestCgi;
   requestRaw: typeof requestRaw;
@@ -327,3 +379,4 @@ declare const api: {
 };
 
 export default api;
+

package/main.js

@@ -13,6 +13,7 @@ import song_detail_fn from "./module/song_detail.js";
 import song_url_fn from "./module/song_url.js";
 import user_detail_fn from "./module/user_detail.js";
 import user_playlist_fn from "./module/user_playlist.js";
+import user_vip_info_fn, { deriveVipInfo, } from "./module/user_vip_info.js";
 import { cookieToJson, cookieToString, parseSetCookie } from "./util/cookie.js";
 import { getGtk, getGuid, getSearchId, hash33, qrcDecrypt } from "./util/crypto.js";
 import { request, requestCgi, requestRaw } from "./util/request.js";
@@ -32,7 +33,8 @@ export const song_detail = (query = {}) => song_detail_fn(query, request);
 export const song_url = (query = {}) => song_url_fn(query, request);
 export const user_detail = (query = {}) => user_detail_fn(query, request);
 export const user_playlist = (query = {}) => user_playlist_fn(query, request);
-export { request, requestCgi, requestRaw, zzcSign, qrcDecrypt, hash33, getGtk, getGuid, getSearchId, cookieToJson, cookieToString, parseSetCookie, };
+export const user_vip_info = (query = {}) => user_vip_info_fn(query, request);
+export { request, requestCgi, requestRaw, zzcSign, qrcDecrypt, hash33, getGtk, getGuid, getSearchId, cookieToJson, cookieToString, parseSetCookie, deriveVipInfo, };
 const api = {
     artist_detail,
     artist_songs,
@@ -49,6 +51,8 @@ const api = {
     song_url,
     user_detail,
     user_playlist,
+    user_vip_info,
+    deriveVipInfo,
     request,
     requestCgi,
     requestRaw,

package/main.ts

@@ -3,7 +3,10 @@ import artist_songs_fn from "./module/artist_songs.js";
 import login_qr_check_fn from "./module/login_qr_check.js";
 import login_qr_create_fn from "./module/login_qr_create.js";
 import login_refresh_fn from "./module/login_refresh.js";
-import login_status_fn from "./module/login_status.js";
+import login_status_fn, {
+  type LoginStatusResult,
+  type NormalizedLoginAccount,
+} from "./module/login_status.js";
 import lyric_fn from "./module/lyric.js";
 import playlist_detail_fn from "./module/playlist_detail.js";
 import playlist_track_all_fn from "./module/playlist_track_all.js";
@@ -13,6 +16,10 @@ import song_detail_fn from "./module/song_detail.js";
 import song_url_fn from "./module/song_url.js";
 import user_detail_fn from "./module/user_detail.js";
 import user_playlist_fn from "./module/user_playlist.js";
+import user_vip_info_fn, {
+  deriveVipInfo,
+  type NormalizedVipInfo,
+} from "./module/user_vip_info.js";
 
 import { cookieToJson, cookieToString, parseSetCookie } from "./util/cookie.js";
 import { getGtk, getGuid, getSearchId, hash33, qrcDecrypt } from "./util/crypto.js";
@@ -64,6 +71,9 @@ export const user_detail = (query: Parameters<typeof user_detail_fn>[0] = {}) =>
 export const user_playlist = (query: Parameters<typeof user_playlist_fn>[0] = {}) =>
   user_playlist_fn(query, request);
 
+export const user_vip_info = (query: Parameters<typeof user_vip_info_fn>[0] = {}) =>
+  user_vip_info_fn(query, request);
+
 export {
   request,
   requestCgi,
@@ -77,7 +87,11 @@ export {
   cookieToJson,
   cookieToString,
   parseSetCookie,
+  deriveVipInfo,
   type ApiResponse,
+  type NormalizedVipInfo,
+  type NormalizedLoginAccount,
+  type LoginStatusResult,
 };
 
 const api = {
@@ -96,6 +110,8 @@ const api = {
   song_url,
   user_detail,
   user_playlist,
+  user_vip_info,
+  deriveVipInfo,
   request,
   requestCgi,
   requestRaw,

package/module/login_qr_check.d.ts

@@ -2,14 +2,17 @@ import { request, type ApiResponse } from "../util/request.js";
 /**
  * 轮询检查二维码登录状态.
  *
- * @param query.type 登录类型: 'qq' | 'wx'
+ * @param query.type 登录类型: 'qq' | 'wx' | 'mobile'
  * @param query.qrsig QQ 二维码凭证标识 (type=qq 时必填)
  * @param query.ptqrtoken QQ 二维码校验 token (type=qq 时必填)
  * @param query.uuid 微信登录会话 uuid (type=wx 时必填)
+ * @param query.qrcodeID QQ 音乐 App 扫码 qrcodeID (type=mobile 时必填)
  */
 export default function login_qr_check(query?: {
-    type?: "qq" | "wx";
+    type?: "qq" | "wx" | "mobile";
     qrsig?: string;
     ptqrtoken?: string | number;
     uuid?: string;
+    qrcodeID?: string;
+    key?: string;
 }, req?: typeof request): Promise<ApiResponse>;

package/module/login_qr_check.js

@@ -4,10 +4,11 @@ import { cookieToString, parseSetCookie } from "../util/cookie.js";
 /**
  * 轮询检查二维码登录状态.
  *
- * @param query.type 登录类型: 'qq' | 'wx'
+ * @param query.type 登录类型: 'qq' | 'wx' | 'mobile'
  * @param query.qrsig QQ 二维码凭证标识 (type=qq 时必填)
  * @param query.ptqrtoken QQ 二维码校验 token (type=qq 时必填)
  * @param query.uuid 微信登录会话 uuid (type=wx 时必填)
+ * @param query.qrcodeID QQ 音乐 App 扫码 qrcodeID (type=mobile 时必填)
  */
 export default async function login_qr_check(query = {}, req = request) {
     const type = query.type || "qq";
@@ -138,6 +139,76 @@ export default async function login_qr_check(query = {}, req = request) {
             cookie: resultCookie,
         };
     }
+    if (type === "mobile") {
+        const qrcodeID = query.qrcodeID || query.key;
+        if (!qrcodeID) {
+            return {
+                status: 400,
+                body: { code: 400, message: "缺少必要参数 qrcodeID" },
+            };
+        }
+        const cgiRes = await requestCgi("music.login.LoginServer", "CheckQRCode", {
+            qrcodeID,
+            tmeAppID: "qqmusic",
+        }, {
+            platform: "android",
+        });
+        const cgiBody = (cgiRes.body || {});
+        const code = cgiBody.code;
+        if (code === 40000) {
+            return {
+                status: 200,
+                body: { code: 801, message: "等待 QQ 音乐 App 扫码" },
+            };
+        }
+        if (code === 40001) {
+            return {
+                status: 200,
+                body: { code: 802, message: "已扫码，等待确认" },
+            };
+        }
+        if (code === 40002) {
+            return {
+                status: 200,
+                body: { code: 800, message: "二维码已过期，请刷新" },
+            };
+        }
+        if (code === 0) {
+            const cookies = cgiRes.cookie || [];
+            const cookieObj = parseSetCookie(cookies);
+            if (cgiBody.musicid && !cookieObj.uin)
+                cookieObj.uin = String(cgiBody.musicid);
+            if (cgiBody.musickey && !cookieObj.qm_keyst)
+                cookieObj.qm_keyst = String(cgiBody.musickey);
+            if (cgiBody.musickey && !cookieObj.qqmusic_key)
+                cookieObj.qqmusic_key = String(cgiBody.musickey);
+            if (cgiBody.openid && !cookieObj.openid)
+                cookieObj.openid = String(cgiBody.openid);
+            if (cgiBody.refresh_token && !cookieObj.refresh_token)
+                cookieObj.refresh_token = String(cgiBody.refresh_token);
+            const cookieStr = cookieToString(cookieObj);
+            return {
+                status: 200,
+                body: {
+                    code: 200,
+                    message: "登录成功",
+                    uin: cookieObj.uin || String(cgiBody.musicid || ""),
+                    musickey: cookieObj.qm_keyst || String(cgiBody.musickey || ""),
+                    cookieStr,
+                    data: cgiBody,
+                },
+                cookie: cookies,
+            };
+        }
+        return {
+            status: 200,
+            body: {
+                code: 801,
+                message: cgiBody.msg || "等待扫码",
+                data: cgiBody,
+            },
+        };
+    }
     // 微信扫码轮询
     const { uuid } = query;
     if (!uuid) {

package/module/login_qr_check.ts

@@ -5,17 +5,20 @@ import { cookieToString, parseSetCookie } from "../util/cookie.js";
 /**
  * 轮询检查二维码登录状态.
  *
- * @param query.type 登录类型: 'qq' | 'wx'
+ * @param query.type 登录类型: 'qq' | 'wx' | 'mobile'
  * @param query.qrsig QQ 二维码凭证标识 (type=qq 时必填)
  * @param query.ptqrtoken QQ 二维码校验 token (type=qq 时必填)
  * @param query.uuid 微信登录会话 uuid (type=wx 时必填)
+ * @param query.qrcodeID QQ 音乐 App 扫码 qrcodeID (type=mobile 时必填)
  */
 export default async function login_qr_check(
   query: {
-    type?: "qq" | "wx";
+    type?: "qq" | "wx" | "mobile";
     qrsig?: string;
     ptqrtoken?: string | number;
     uuid?: string;
+    qrcodeID?: string;
+    key?: string;
   } = {},
   req = request
 ): Promise<ApiResponse> {
@@ -179,6 +182,82 @@ export default async function login_qr_check(
     };
   }
 
+  if (type === "mobile") {
+    const qrcodeID = query.qrcodeID || query.key;
+    if (!qrcodeID) {
+      return {
+        status: 400,
+        body: { code: 400, message: "缺少必要参数 qrcodeID" },
+      };
+    }
+
+    const cgiRes = await requestCgi(
+      "music.login.LoginServer",
+      "CheckQRCode",
+      {
+        qrcodeID,
+        tmeAppID: "qqmusic",
+      },
+      {
+        platform: "android",
+      }
+    );
+
+    const cgiBody = (cgiRes.body || {}) as any;
+    const code = cgiBody.code;
+
+    if (code === 40000) {
+      return {
+        status: 200,
+        body: { code: 801, message: "等待 QQ 音乐 App 扫码" },
+      };
+    }
+    if (code === 40001) {
+      return {
+        status: 200,
+        body: { code: 802, message: "已扫码，等待确认" },
+      };
+    }
+    if (code === 40002) {
+      return {
+        status: 200,
+        body: { code: 800, message: "二维码已过期，请刷新" },
+      };
+    }
+    if (code === 0) {
+      const cookies = cgiRes.cookie || [];
+      const cookieObj = parseSetCookie(cookies);
+      if (cgiBody.musicid && !cookieObj.uin) cookieObj.uin = String(cgiBody.musicid);
+      if (cgiBody.musickey && !cookieObj.qm_keyst) cookieObj.qm_keyst = String(cgiBody.musickey);
+      if (cgiBody.musickey && !cookieObj.qqmusic_key) cookieObj.qqmusic_key = String(cgiBody.musickey);
+      if (cgiBody.openid && !cookieObj.openid) cookieObj.openid = String(cgiBody.openid);
+      if (cgiBody.refresh_token && !cookieObj.refresh_token) cookieObj.refresh_token = String(cgiBody.refresh_token);
+
+      const cookieStr = cookieToString(cookieObj);
+      return {
+        status: 200,
+        body: {
+          code: 200,
+          message: "登录成功",
+          uin: cookieObj.uin || String(cgiBody.musicid || ""),
+          musickey: cookieObj.qm_keyst || String(cgiBody.musickey || ""),
+          cookieStr,
+          data: cgiBody,
+        },
+        cookie: cookies,
+      };
+    }
+
+    return {
+      status: 200,
+      body: {
+        code: 801,
+        message: cgiBody.msg || "等待扫码",
+        data: cgiBody,
+      },
+    };
+  }
+
   // 微信扫码轮询
   const { uuid } = query;
   if (!uuid) {

package/module/login_qr_create.js

@@ -24,14 +24,17 @@ export default async function login_qr_create(query = {}, req = request) {
         const ptqrtoken = hash33(qrsig);
         // 二维码图片转 base64
         let qrimg = "";
-        if (typeof res.body === "string") {
+        if (Buffer.isBuffer(res.body)) {
+            qrimg = `data:image/png;base64,${res.body.toString("base64")}`;
+        }
+        else if (res.body instanceof Uint8Array) {
             qrimg = `data:image/png;base64,${Buffer.from(res.body).toString("base64")}`;
         }
-        else if (Buffer.isBuffer(res.body)) {
-            qrimg = `data:image/png;base64,${res.body.toString("base64")}`;
+        else if (typeof res.body === "string") {
+            qrimg = res.body.startsWith("data:") ? res.body : `data:image/png;base64,${Buffer.from(res.body).toString("base64")}`;
         }
         else {
-            qrimg = `data:image/png;base64,${Buffer.from(String(res.body)).toString("base64")}`;
+            qrimg = `data:image/png;base64,${Buffer.from(String(res.body || "")).toString("base64")}`;
         }
         return {
             status: 200,

package/module/login_qr_create.ts

@@ -34,12 +34,14 @@ export default async function login_qr_create(
 
     // 二维码图片转 base64
     let qrimg = "";
-    if (typeof res.body === "string") {
-      qrimg = `data:image/png;base64,${Buffer.from(res.body).toString("base64")}`;
-    } else if (Buffer.isBuffer(res.body)) {
+    if (Buffer.isBuffer(res.body)) {
       qrimg = `data:image/png;base64,${res.body.toString("base64")}`;
+    } else if (res.body instanceof Uint8Array) {
+      qrimg = `data:image/png;base64,${Buffer.from(res.body).toString("base64")}`;
+    } else if (typeof res.body === "string") {
+      qrimg = res.body.startsWith("data:") ? res.body : `data:image/png;base64,${Buffer.from(res.body).toString("base64")}`;
     } else {
-      qrimg = `data:image/png;base64,${Buffer.from(String(res.body)).toString("base64")}`;
+      qrimg = `data:image/png;base64,${Buffer.from(String(res.body || "")).toString("base64")}`;
     }
 
     return {

package/module/login_refresh.d.ts

@@ -11,4 +11,8 @@ export default function login_refresh(query?: {
     openid?: string;
     refresh_token?: string;
     refresh_key?: string;
-}, req?: typeof request): Promise<ApiResponse>;
+}, req?: typeof request): Promise<ApiResponse<{
+    code: number;
+    data: any;
+    cookieStr: string;
+}>>;

package/module/login_refresh.js

@@ -1,5 +1,5 @@
 import { request } from "../util/request.js";
-import { cookieToJson } from "../util/cookie.js";
+import { cookieToJson, cookieToString, parseSetCookie } from "../util/cookie.js";
 /**
  * 刷新登录凭证.
  *
@@ -24,11 +24,22 @@ export default async function login_refresh(query = {}, req = request) {
         cookie: query.cookie,
         platform: "web",
     });
+    const resBody = (cgiRes.body || {});
+    const newCookies = parseSetCookie(cgiRes.cookie || []);
+    const mergedCookies = { ...cookieObj, ...newCookies };
+    if (resBody.musickey && !mergedCookies.qm_keyst) {
+        mergedCookies.qm_keyst = resBody.musickey;
+    }
+    if (resBody.musickey && !mergedCookies.qqmusic_key) {
+        mergedCookies.qqmusic_key = resBody.musickey;
+    }
+    const cookieStr = cookieToString(mergedCookies);
     return {
         status: cgiRes.status,
         body: {
-            code: cgiRes.body?.code ?? 200,
-            data: cgiRes.body,
+            code: resBody.code ?? (cgiRes.status === 200 ? 200 : 500),
+            data: resBody,
+            cookieStr,
         },
         cookie: cgiRes.cookie,
     };

package/module/login_refresh.ts

@@ -1,5 +1,5 @@
 import { request, type ApiResponse } from "../util/request.js";
-import { cookieToJson } from "../util/cookie.js";
+import { cookieToJson, cookieToString, parseSetCookie } from "../util/cookie.js";
 
 /**
  * 刷新登录凭证.
@@ -16,7 +16,7 @@ export default async function login_refresh(
     refresh_key?: string;
   } = {},
   req = request
-): Promise<ApiResponse> {
+): Promise<ApiResponse<{ code: number; data: any; cookieStr: string }>> {
   const cookieObj = cookieToJson(query.cookie);
   const uin = cookieObj.uin || cookieObj.qqmusic_uin || cookieObj.wxuin || "0";
   const musickey = cookieObj.qm_keyst || cookieObj.qqmusic_key || "";
@@ -41,11 +41,23 @@ export default async function login_refresh(
     }
   );
 
+  const resBody = (cgiRes.body || {}) as any;
+  const newCookies = parseSetCookie(cgiRes.cookie || []);
+  const mergedCookies = { ...cookieObj, ...newCookies };
+  if (resBody.musickey && !mergedCookies.qm_keyst) {
+    mergedCookies.qm_keyst = resBody.musickey;
+  }
+  if (resBody.musickey && !mergedCookies.qqmusic_key) {
+    mergedCookies.qqmusic_key = resBody.musickey;
+  }
+  const cookieStr = cookieToString(mergedCookies);
+
   return {
     status: cgiRes.status,
     body: {
-      code: cgiRes.body?.code ?? 200,
-      data: cgiRes.body,
+      code: resBody.code ?? (cgiRes.status === 200 ? 200 : 500),
+      data: resBody,
+      cookieStr,
     },
     cookie: cgiRes.cookie,
   };

package/module/login_status.d.ts

@@ -1,9 +1,30 @@
 import { request, type ApiResponse } from "../util/request.js";
+import { type NormalizedVipInfo } from "./user_vip_info.js";
+export interface NormalizedLoginAccount {
+    userId: string;
+    nickname: string;
+    avatarUrl?: string;
+    vipStatus: "vip" | "nonVip" | "unknown";
+    vipTier?: "svip" | "vip";
+    vipLevel?: number;
+    vipYear?: boolean;
+    vipExpireTime?: number;
+}
+export interface LoginStatusResult {
+    code: number;
+    isLogin: boolean;
+    uin: string;
+    nickname: string;
+    avatarUrl?: string;
+    vip: NormalizedVipInfo;
+    account: NormalizedLoginAccount;
+    data: any;
+}
 /**
- * 校验当前 Cookie 登录状态及获取用户信息.
+ * 校验当前 Cookie 登录状态及获取用户信息与 VIP 等级.
  *
  * @param query.cookie 登录凭据 Cookie
  */
 export default function login_status(query?: {
     cookie?: any;
-}, req?: typeof request): Promise<ApiResponse>;
+}, req?: typeof request): Promise<ApiResponse<LoginStatusResult>>;

package/module/login_status.js

@@ -1,21 +1,76 @@
 import { request } from "../util/request.js";
+import { cookieToJson } from "../util/cookie.js";
+import user_detail_fn from "./user_detail.js";
+import user_vip_info_fn from "./user_vip_info.js";
 /**
- * 校验当前 Cookie 登录状态及获取用户信息.
+ * 校验当前 Cookie 登录状态及获取用户信息与 VIP 等级.
  *
  * @param query.cookie 登录凭据 Cookie
  */
 export default async function login_status(query = {}, req = request) {
+    const cookieObj = cookieToJson(query.cookie);
+    let uin = cookieObj.uin || cookieObj.qqmusic_uin || cookieObj.wxuin || "";
     const cgiRes = await req("music.UserInfo.userInfoServer", "GetLoginUserInfo", {}, {
         cookie: query.cookie,
         platform: "web",
     });
-    const data = cgiRes.body || {};
-    const isLogin = data.code === 0 && Boolean(data.user?.uin || data.uin || data.encryptUin);
+    const data = (cgiRes.body || {});
+    const userData = data.user || data.userInfo || data;
+    const isLogin = data.code === 0 && Boolean(userData.uin || userData.encryptUin || uin);
+    if (userData.uin) {
+        uin = String(userData.uin).trim();
+    }
+    else if (!uin && userData.encryptUin) {
+        uin = String(userData.encryptUin).trim();
+    }
+    let nickname = userData.nick || userData.nickname || "";
+    let avatarUrl = userData.headurl || userData.avatar;
+    // 若基本信息不全且处于已登录状态，尝试从 user_detail 补全昵称与头像
+    if (isLogin && (!nickname || !avatarUrl)) {
+        try {
+            const detailRes = await user_detail_fn({ uin, cookie: query.cookie }, req);
+            const header = detailRes.body?.data?.data || detailRes.body?.data || {};
+            if (header.nick && !nickname)
+                nickname = header.nick;
+            if (header.headurl && !avatarUrl)
+                avatarUrl = header.headurl;
+        }
+        catch { }
+    }
+    if (!nickname) {
+        nickname = uin ? `QQ用户_${uin.slice(-4)}` : "QQ音乐用户";
+    }
+    // 补全 VIP 会员信息
+    let vip = { vipStatus: "nonVip" };
+    if (isLogin) {
+        try {
+            const vipRes = await user_vip_info_fn({ cookie: query.cookie }, req);
+            vip = vipRes.body.vip;
+        }
+        catch {
+            vip = { vipStatus: "unknown" };
+        }
+    }
+    const account = {
+        userId: uin,
+        nickname,
+        avatarUrl,
+        vipStatus: vip.vipStatus,
+        vipTier: vip.vipTier,
+        vipLevel: vip.vipLevel,
+        vipYear: vip.vipYear,
+        vipExpireTime: vip.vipExpireTime,
+    };
     return {
         status: cgiRes.status,
         body: {
             code: isLogin ? 200 : 301,
             isLogin,
+            uin,
+            nickname,
+            avatarUrl,
+            vip,
+            account,
             data,
         },
         cookie: cgiRes.cookie,

package/module/login_status.ts

@@ -1,14 +1,42 @@
 import { request, type ApiResponse } from "../util/request.js";
+import { cookieToJson } from "../util/cookie.js";
+import user_detail_fn from "./user_detail.js";
+import user_vip_info_fn, { type NormalizedVipInfo } from "./user_vip_info.js";
+
+export interface NormalizedLoginAccount {
+  userId: string;
+  nickname: string;
+  avatarUrl?: string;
+  vipStatus: "vip" | "nonVip" | "unknown";
+  vipTier?: "svip" | "vip";
+  vipLevel?: number;
+  vipYear?: boolean;
+  vipExpireTime?: number;
+}
+
+export interface LoginStatusResult {
+  code: number;
+  isLogin: boolean;
+  uin: string;
+  nickname: string;
+  avatarUrl?: string;
+  vip: NormalizedVipInfo;
+  account: NormalizedLoginAccount;
+  data: any;
+}
 
 /**
- * 校验当前 Cookie 登录状态及获取用户信息.
+ * 校验当前 Cookie 登录状态及获取用户信息与 VIP 等级.
  *
  * @param query.cookie 登录凭据 Cookie
  */
 export default async function login_status(
   query: { cookie?: any } = {},
   req = request
-): Promise<ApiResponse> {
+): Promise<ApiResponse<LoginStatusResult>> {
+  const cookieObj = cookieToJson(query.cookie);
+  let uin = cookieObj.uin || cookieObj.qqmusic_uin || cookieObj.wxuin || "";
+
   const cgiRes = await req(
     "music.UserInfo.userInfoServer",
     "GetLoginUserInfo",
@@ -19,14 +47,65 @@ export default async function login_status(
     }
   );
 
-  const data = cgiRes.body || {};
-  const isLogin = data.code === 0 && Boolean(data.user?.uin || data.uin || data.encryptUin);
+  const data = (cgiRes.body || {}) as any;
+  const userData = data.user || data.userInfo || data;
+  const isLogin = data.code === 0 && Boolean(userData.uin || userData.encryptUin || uin);
+
+  if (userData.uin) {
+    uin = String(userData.uin).trim();
+  } else if (!uin && userData.encryptUin) {
+    uin = String(userData.encryptUin).trim();
+  }
+
+  let nickname = userData.nick || userData.nickname || "";
+  let avatarUrl: string | undefined = userData.headurl || userData.avatar;
+
+  // 若基本信息不全且处于已登录状态，尝试从 user_detail 补全昵称与头像
+  if (isLogin && (!nickname || !avatarUrl)) {
+    try {
+      const detailRes = await user_detail_fn({ uin, cookie: query.cookie }, req);
+      const header = detailRes.body?.data?.data || detailRes.body?.data || {};
+      if (header.nick && !nickname) nickname = header.nick;
+      if (header.headurl && !avatarUrl) avatarUrl = header.headurl;
+    } catch {}
+  }
+
+  if (!nickname) {
+    nickname = uin ? `QQ用户_${uin.slice(-4)}` : "QQ音乐用户";
+  }
+
+  // 补全 VIP 会员信息
+  let vip: NormalizedVipInfo = { vipStatus: "nonVip" };
+  if (isLogin) {
+    try {
+      const vipRes = await user_vip_info_fn({ cookie: query.cookie }, req);
+      vip = vipRes.body.vip;
+    } catch {
+      vip = { vipStatus: "unknown" };
+    }
+  }
+
+  const account: NormalizedLoginAccount = {
+    userId: uin,
+    nickname,
+    avatarUrl,
+    vipStatus: vip.vipStatus,
+    vipTier: vip.vipTier,
+    vipLevel: vip.vipLevel,
+    vipYear: vip.vipYear,
+    vipExpireTime: vip.vipExpireTime,
+  };
 
   return {
     status: cgiRes.status,
     body: {
       code: isLogin ? 200 : 301,
       isLogin,
+      uin,
+      nickname,
+      avatarUrl,
+      vip,
+      account,
       data,
     },
     cookie: cgiRes.cookie,

package/module/user_vip_info.d.ts

@@ -1,4 +1,12 @@
 import { request, type ApiResponse } from "../util/request.js";
+export interface NormalizedVipInfo {
+    vipStatus: "vip" | "nonVip" | "unknown";
+    vipTier?: "svip" | "vip";
+    vipLevel?: number;
+    vipYear?: boolean;
+    vipExpireTime?: number;
+}
+export declare function deriveVipInfo(body: any): NormalizedVipInfo;
 /**
  * 获取当前登录用户的 VIP 会员信息及身份明细.
  *
@@ -6,4 +14,8 @@ import { request, type ApiResponse } from "../util/request.js";
  */
 export default function user_vip_info(query?: {
     cookie?: any;
-}, req?: typeof request): Promise<ApiResponse>;
+}, req?: typeof request): Promise<ApiResponse<{
+    code: number;
+    data: any;
+    vip: NormalizedVipInfo;
+}>>;

package/module/user_vip_info.js

@@ -1,4 +1,54 @@
 import { request } from "../util/request.js";
+export function deriveVipInfo(body) {
+    if (!body) {
+        return { vipStatus: "unknown" };
+    }
+    const vipData = body.data || body;
+    const identity = vipData.identity || {};
+    const svip = Number(vipData.svip || 0);
+    const isVip = Number(identity.HugeVip || identity.vip || 0);
+    const level = Number(identity.level || 0);
+    const isYear = Boolean(Number(identity.is_year || identity.year_vip || identity.HugeVipYear || identity.year || 0) > 0 ||
+        Number(vipData.year || vipData.is_year || 0) > 0);
+    let vipStatus = "nonVip";
+    let vipTier = undefined;
+    let vipLevel = undefined;
+    let vipYear = undefined;
+    let vipExpireTime = undefined;
+    if (svip > 0) {
+        vipStatus = "vip";
+        vipTier = "svip";
+        vipLevel = level > 0 ? Math.min(Math.max(level, 1), 10) : 1;
+        vipYear = isYear;
+    }
+    else if (isVip > 0) {
+        vipStatus = "vip";
+        vipTier = "vip";
+        vipLevel = level > 0 ? Math.min(Math.max(level, 1), 10) : 1;
+        vipYear = isYear;
+    }
+    const expireTs = Number(vipData.userinfo?.expire || 0);
+    if (expireTs > 0) {
+        vipExpireTime = expireTs * 1000;
+    }
+    else if (identity.HugeVipEnd) {
+        const parsed = Date.parse(identity.HugeVipEnd);
+        if (!isNaN(parsed))
+            vipExpireTime = parsed;
+    }
+    else if (identity.twelveEnd) {
+        const parsed = Date.parse(identity.twelveEnd);
+        if (!isNaN(parsed))
+            vipExpireTime = parsed;
+    }
+    return {
+        vipStatus,
+        vipTier,
+        vipLevel,
+        vipYear,
+        vipExpireTime,
+    };
+}
 /**
  * 获取当前登录用户的 VIP 会员信息及身份明细.
  *
@@ -9,11 +59,13 @@ export default async function user_vip_info(query = {}, req = request) {
         cookie: query.cookie,
         platform: "web",
     });
+    const vip = deriveVipInfo(cgiRes.body);
     return {
         status: cgiRes.status,
         body: {
             code: cgiRes.body?.code ?? 200,
             data: cgiRes.body,
+            vip,
         },
         cookie: cgiRes.cookie,
     };

package/module/user_vip_info.ts

@@ -1,5 +1,65 @@
 import { request, type ApiResponse } from "../util/request.js";
 
+export interface NormalizedVipInfo {
+  vipStatus: "vip" | "nonVip" | "unknown";
+  vipTier?: "svip" | "vip";
+  vipLevel?: number;
+  vipYear?: boolean;
+  vipExpireTime?: number;
+}
+
+export function deriveVipInfo(body: any): NormalizedVipInfo {
+  if (!body) {
+    return { vipStatus: "unknown" };
+  }
+  const vipData = body.data || body;
+  const identity = vipData.identity || {};
+  const svip = Number(vipData.svip || 0);
+  const isVip = Number(identity.HugeVip || identity.vip || 0);
+  const level = Number(identity.level || 0);
+  const isYear = Boolean(
+    Number(identity.is_year || identity.year_vip || identity.HugeVipYear || identity.year || 0) > 0 ||
+    Number(vipData.year || vipData.is_year || 0) > 0
+  );
+
+  let vipStatus: "vip" | "nonVip" | "unknown" = "nonVip";
+  let vipTier: "svip" | "vip" | undefined = undefined;
+  let vipLevel: number | undefined = undefined;
+  let vipYear: boolean | undefined = undefined;
+  let vipExpireTime: number | undefined = undefined;
+
+  if (svip > 0) {
+    vipStatus = "vip";
+    vipTier = "svip";
+    vipLevel = level > 0 ? Math.min(Math.max(level, 1), 10) : 1;
+    vipYear = isYear;
+  } else if (isVip > 0) {
+    vipStatus = "vip";
+    vipTier = "vip";
+    vipLevel = level > 0 ? Math.min(Math.max(level, 1), 10) : 1;
+    vipYear = isYear;
+  }
+
+  const expireTs = Number(vipData.userinfo?.expire || 0);
+  if (expireTs > 0) {
+    vipExpireTime = expireTs * 1000;
+  } else if (identity.HugeVipEnd) {
+    const parsed = Date.parse(identity.HugeVipEnd);
+    if (!isNaN(parsed)) vipExpireTime = parsed;
+  } else if (identity.twelveEnd) {
+    const parsed = Date.parse(identity.twelveEnd);
+    if (!isNaN(parsed)) vipExpireTime = parsed;
+  }
+
+  return {
+    vipStatus,
+    vipTier,
+    vipLevel,
+    vipYear,
+    vipExpireTime,
+  };
+}
+
 /**
  * 获取当前登录用户的 VIP 会员信息及身份明细.
  *
@@ -8,7 +68,7 @@ import { request, type ApiResponse } from "../util/request.js";
 export default async function user_vip_info(
   query: { cookie?: any } = {},
   req = request
-): Promise<ApiResponse> {
+): Promise<ApiResponse<{ code: number; data: any; vip: NormalizedVipInfo }>> {
   const cgiRes = await req(
     "VipLogin.VipLoginInter",
     "vip_login_base",
@@ -19,11 +79,14 @@ export default async function user_vip_info(
     }
   );
 
+  const vip = deriveVipInfo(cgiRes.body);
+
   return {
     status: cgiRes.status,
     body: {
       code: cgiRes.body?.code ?? 200,
       data: cgiRes.body,
+      vip,
     },
     cookie: cgiRes.cookie,
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qqmusic-api-enhanced",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "QQ音乐增强版API，支持扫码登录/凭证刷新/直链提取/歌词解密/歌单歌手检索 || QQ Music Enhanced API for Node.js & Bun",
   "type": "module",
   "main": "main.js",

package/util/request.js

@@ -75,6 +75,28 @@ export async function requestCgi(module, method, param = {}, options = {}) {
         clearTimeout(timeoutTimer);
     }
 }
+function isBinaryBuffer(buf, contentType) {
+    if (contentType.includes("image/") ||
+        contentType.includes("application/octet-stream") ||
+        contentType.includes("audio/") ||
+        contentType.includes("video/")) {
+        return true;
+    }
+    if (buf.length >= 4) {
+        if (buf[0] === 0x89 && buf[1] === 0x50 && buf[2] === 0x4e && buf[3] === 0x47)
+            return true; // PNG
+        if (buf[0] === 0xff && buf[1] === 0xd8)
+            return true; // JPEG
+        if (buf[0] === 0x47 && buf[1] === 0x49 && buf[2] === 0x46)
+            return true; // GIF
+        if (buf.length >= 12 &&
+            buf.subarray(0, 4).toString("ascii") === "RIFF" &&
+            buf.subarray(8, 12).toString("ascii") === "WEBP") {
+            return true; // WEBP
+        }
+    }
+    return false;
+}
 /**
  * 执行原始 HTTP/HTTPS 请求 (用于扫码、验证码或第三方 OAuth 接口).
  *
@@ -90,7 +112,19 @@ export async function requestRaw(url, init = {}) {
             ...init,
             signal: controller.signal,
         });
-        const text = await res.text();
+        const cookie = res.headers.getSetCookie?.() || [];
+        const contentType = res.headers.get("content-type") || "";
+        const buffer = Buffer.from(await res.arrayBuffer());
+        if (isBinaryBuffer(buffer, contentType)) {
+            return {
+                status: res.status,
+                data: buffer,
+                text: "",
+                headers: res.headers,
+                cookie,
+            };
+        }
+        const text = buffer.toString("utf-8");
         let data = text;
         try {
             data = JSON.parse(text);
@@ -98,7 +132,6 @@ export async function requestRaw(url, init = {}) {
         catch {
             // 保持原始文本
         }
-        const cookie = res.headers.getSetCookie?.() || [];
         return {
             status: res.status,
             data,

package/util/request.ts

@@ -104,6 +104,30 @@ export async function requestCgi<T = any>(
   }
 }
 
+function isBinaryBuffer(buf: Buffer, contentType: string): boolean {
+  if (
+    contentType.includes("image/") ||
+    contentType.includes("application/octet-stream") ||
+    contentType.includes("audio/") ||
+    contentType.includes("video/")
+  ) {
+    return true;
+  }
+  if (buf.length >= 4) {
+    if (buf[0] === 0x89 && buf[1] === 0x50 && buf[2] === 0x4e && buf[3] === 0x47) return true; // PNG
+    if (buf[0] === 0xff && buf[1] === 0xd8) return true; // JPEG
+    if (buf[0] === 0x47 && buf[1] === 0x49 && buf[2] === 0x46) return true; // GIF
+    if (
+      buf.length >= 12 &&
+      buf.subarray(0, 4).toString("ascii") === "RIFF" &&
+      buf.subarray(8, 12).toString("ascii") === "WEBP"
+    ) {
+      return true; // WEBP
+    }
+  }
+  return false;
+}
+
 /**
  * 执行原始 HTTP/HTTPS 请求 (用于扫码、验证码或第三方 OAuth 接口).
  *
@@ -124,7 +148,21 @@ export async function requestRaw(
       signal: controller.signal,
     });
 
-    const text = await res.text();
+    const cookie = res.headers.getSetCookie?.() || [];
+    const contentType = res.headers.get("content-type") || "";
+    const buffer = Buffer.from(await res.arrayBuffer());
+
+    if (isBinaryBuffer(buffer, contentType)) {
+      return {
+        status: res.status,
+        data: buffer,
+        text: "",
+        headers: res.headers,
+        cookie,
+      };
+    }
+
+    const text = buffer.toString("utf-8");
     let data: any = text;
     try {
       data = JSON.parse(text);
@@ -132,7 +170,6 @@ export async function requestRaw(
       // 保持原始文本
     }
 
-    const cookie = res.headers.getSetCookie?.() || [];
     return {
       status: res.status,
       data,