qqmusic-api-enhanced 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,135 @@
-# Temporary Holding Version
+# qqmusic-api-enhanced
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+QQ 音乐增强版 Node.js / Bun API 客户端，基于 QQ 音乐逆向协议与签名机制实现。项目架构与设计风格严格对齐 `@neteasecloudmusicapienhanced/api`，旨在为音乐播放器、猜歌游戏（如 SonGuessr）、数据分析等应用提供开箱即用、零外部生产依赖的纯 TypeScript 解决方案。
+
+---
+
+## 特性亮点
+
+- **零外部生产依赖**：纯 TypeScript 编写，直接利用 Node.js / Bun 原生 `crypto`、`zlib`、`fetch`，无需安装 heavy C++ 插件或额外加密包。
+- **全平台扫码登录**：支持手机 QQ 快捷扫码、微信网页扫码、QQ 音乐移动端 App 扫码，玩家可自主完成身份凭据提取与长效刷新。
+- **VKey 播放直链提取**：基于 `UrlGetVkey` 逆向调度，支持 128kbps (mp3)、320kbps (高品质 mp3)、FLAC (无损)、M4A 以及试听片段直链解析。
+- **QRC 逐字歌词解密**：内置原生定制版 Triple-DES（支持 QQ 音乐特定 PC-2 偏移置换）及 zlib 解压算法，自动将加密 QRC 转换为带时间戳的明文逐字歌词。
+- **完整类型支持**：提供详尽的 `interface.d.ts` 类型定义，全面涵盖入参参数、返回格式与枚举项。
+
+---
+
+## 安装
+
+```bash
+# npm
+npm install qqmusic-api-enhanced
+
+# pnpm
+pnpm add qqmusic-api-enhanced
+
+# bun
+bun add qqmusic-api-enhanced
+```
+
+---
+
+## 快速上手
+
+### 1. 基础调用与默认导出
+
+```typescript
+import qqmusic, { song_detail, song_url, lyric } from "qqmusic-api-enhanced";
+
+// 获取歌曲详情 (支持数字 ID 或字符串 MID)
+const detail = await song_detail({ id: "0039MnYb0qxYAc" });
+console.log(detail.body.data.track_info.name); // 晴天
+
+// 获取播放音频 CDN 直链 (支持 '128' | '320' | 'flac' | 'm4a' | 'try')
+const urlRes = await song_url({
+  id: "0039MnYb0qxYAc",
+  type: "320",
+  cookie: "uin=12345678; qm_keyst=YOUR_COOKIE_KEY", // VIP/付费歌曲需传入有效 Cookie
+});
+console.log(urlRes.body.data[0].url);
+
+// 获取歌词 (包含普通 LRC 与自动解密的逐字 QRC)
+const lyricRes = await lyric({ id: "0039MnYb0qxYAc", qrc: true });
+console.log(lyricRes.body.lyric);
+```
+
+### 2. 玩家自助扫码登录流程
+
+```typescript
+import { login_qr_create, login_qr_check, login_status } from "qqmusic-api-enhanced";
+
+// 第一步：生成二维码 (支持 'qq' | 'wx' | 'mobile')
+const qr = await login_qr_create({ type: "qq" });
+console.log("扫码链接:", qr.body.url);
+console.log("二维码 Base64 图片:", qr.body.qrimg);
+
+// 第二步：轮询扫码状态 (需传入 第一步返回的 qrsig 或 uuid)
+const timer = setInterval(async () => {
+  const check = await login_qr_check({
+    type: "qq",
+    qrsig: qr.body.qrsig,
+  });
+
+  if (check.body.code === 200) {
+    clearInterval(timer);
+    console.log("登录成功！用户 uin:", check.body.uin);
+    console.log("获取到的 Cookie 字符串:", check.body.cookieStr);
+
+    // 第三步：验证登录状态
+    const status = await login_status({ cookie: check.body.cookieStr });
+    console.log("用户信息:", status.body.userInfo);
+  } else if (check.body.code === 800) {
+    clearInterval(timer);
+    console.log("二维码已过期，请重新生成");
+  } else {
+    console.log("等待用户扫码/确认中:", check.body.message);
+  }
+}, 2000);
+```
+
+---
+
+## API 列表
+
+| 模块名称 | 功能说明 | 关键参数 | 备注 |
+|---|---|---|---|
+| `login_qr_create` | 创建登录二维码 | `type?: 'qq' \| 'wx' \| 'mobile'` | 返回二维码 Base64 图片与轮询凭据 |
+| `login_qr_check` | 轮询二维码扫码结果 | `type, qrsig?, uuid?` | 登录成功后直接返回完整 Cookie |
+| `login_status` | 校验当前登录态 | `cookie?: string` | 检查 Cookie 有效性与用户账号信息 |
+| `login_refresh` | 刷新登录凭证 | `cookie?: string` | 延长 musickey / qm_keyst 有效期 |
+| `song_detail` | 歌曲详情元数据 | `id: string \| number` | 支持纯数字 song_id 或字符串 mid |
+| `song_url` | 提取歌曲音频 CDN 直链 | `id, type?: '128'\|'320'\|'flac'\|'m4a'\|'try'` | 自动计算 VKey 与 CDN 地址拼接 |
+| `lyric` | 获取歌曲歌词 | `id, qrc?: boolean, trans?: boolean` | 自动执行定制 Triple-DES 解密 QRC |
+| `playlist_detail` | 获取歌单基本信息 | `id: string \| number` | 歌单 disstid |
+| `playlist_track_all` | 歌单全量曲目分页展开 | `id, limit?: number, offset?: number` | 最大支持每次抓取 1000 首歌曲 |
+| `artist_detail` | 歌手主页详情 | `id: string` (歌手 mid) | 歌手基本资料与统计信息 |
+| `artist_songs` | 歌手单曲列表分页 | `id, page?: number, limit?: number, order?: number` | 分页拉取歌手所有歌曲 |
+| `search` | 综合分类检索 | `keywords, type?: 0\|1\|2\|3\|7, page?, limit?` | 0-单曲, 1-歌手, 2-专辑, 3-歌单, 7-歌词 |
+| `user_detail` | 用户主页信息 | `id?: string \| number` (uin) | 查询指定或当前登录用户的公开资料 |
+| `user_playlist` | 用户创建与收藏歌单 | `id?: string \| number, limit?: number` | 获取用户歌单列表 |
+| `recommend_songs` | 热门与新歌推荐 | `type?: 1\|2\|3\|4` | 1-华语, 2-欧美, 3-韩国, 4-日本 |
+
+---
+
+## 底层工具集导出
+
+本包同时导出所有基础密码学与网络方法，便于深度定制：
+
+```typescript
+import {
+  zzcSign,     // 计算 QQ 音乐客户端请求的 zzc 签名
+  qrcDecrypt,  // 独立解密 QRC 逐字歌词 (Triple-DES 变体 + zlib)
+  hash33,      // 经典 hash33 哈希计算
+  getGtk,      // 从 skey 计算 g_tk
+  getGuid,     // 生成设备与会话 32 位 GUID
+  request,     // 统一网络调度器 (自动判断 cgi 或 raw http)
+  requestCgi,  // 请求 musicu.fcg / musics.fcg
+  requestRaw,  // 原始 fetch 包装
+} from "qqmusic-api-enhanced";
+```
+
+---
+
+## 协议与免责声明
+
+本项目仅供个人学习、技术研究与教育用途。所有接口数据与媒体资源版权归腾讯公司所有。请勿将本项目用于任何商业用途或违反相关法律法规的场景。

package/interface.d.ts

@@ -0,0 +1,329 @@
+export interface RequestBaseConfig {
+  cookie?: string | Record<string, string>;
+  proxy?: string;
+  realIP?: string;
+  guid?: string;
+  uin?: string | number;
+  musickey?: string;
+}
+
+export interface Response<Body = any> {
+  status: number;
+  body: Body;
+  cookie?: string[];
+}
+
+export interface ApiResponse<T = any> {
+  status: number;
+  body: T;
+  cookie?: string[];
+}
+
+// ==============================
+// 1. 登录与凭证模块 (Login & Auth)
+// ==============================
+
+export interface LoginQrCreateQuery extends RequestBaseConfig {
+  /** 登录方式: 'qq' (默认手机QQ扫码) | 'wx' (微信扫码) | 'mobile' (QQ音乐移动端App扫码) */
+  type?: "qq" | "wx" | "mobile";
+}
+
+export interface LoginQrCreateResult {
+  code: number;
+  type: "qq" | "wx" | "mobile";
+  qrsig?: string;
+  ptqrtoken?: string | number;
+  uuid?: string;
+  qrimg: string;
+  url: string;
+}
+
+export interface LoginQrCheckQuery extends RequestBaseConfig {
+  /** 登录方式: 'qq' | 'wx' | 'mobile' */
+  type?: "qq" | "wx" | "mobile";
+  /** 手机 QQ 轮询凭证，来源于 login_qr_create */
+  qrsig?: string;
+  /** 微信轮询凭证 uuid，来源于 login_qr_create */
+  uuid?: string;
+}
+
+export interface LoginQrCheckResult {
+  code: number;
+  message: string;
+  uin?: string;
+  musickey?: string;
+  cookie?: Record<string, string>;
+  cookieStr?: string;
+}
+
+export interface LoginStatusQuery extends RequestBaseConfig {}
+
+export interface LoginStatusResult {
+  code: number;
+  isLogin: boolean;
+  uin?: string;
+  userInfo?: Record<string, any>;
+}
+
+export interface LoginRefreshQuery extends RequestBaseConfig {}
+
+export interface LoginRefreshResult {
+  code: number;
+  musickey?: string;
+  raw?: Record<string, any>;
+}
+
+// ==============================
+// 2. 歌曲与播放 (Songs & Playback)
+// ==============================
+
+export interface SongDetailQuery extends RequestBaseConfig {
+  /** 歌曲数字 ID 或 字母数字混合 MID */
+  id?: string | number;
+  /** 兼容 ids 参数 */
+  ids?: string | number;
+}
+
+export interface SongDetailResult {
+  code: number;
+  data: Record<string, any>;
+}
+
+export interface SongUrlQuery extends RequestBaseConfig {
+  /** 歌曲 mid (单条或数组) */
+  id?: string | string[];
+  /** 兼容 ids 参数 */
+  ids?: string | string[];
+  /** 音质: '128' (默认) | '320' | 'flac' | 'm4a' | 'try' */
+  type?: "128" | "320" | "flac" | "m4a" | "try" | string;
+}
+
+export interface SongUrlResult {
+  code: number;
+  data: Array<{
+    id?: number;
+    mid: string;
+    url: string;
+    type: string;
+    sip: string[];
+    purl: string;
+    expiration?: number;
+  }>;
+}
+
+// ==============================
+// 3. 歌词与解密 (Lyrics & QRC)
+// ==============================
+
+export interface LyricQuery extends RequestBaseConfig {
+  /** 歌曲 ID 或 MID */
+  id?: string | number;
+  /** 是否拉取并解密逐字歌词 (默认 true) */
+  qrc?: boolean;
+  /** 是否拉取翻译歌词 (默认 true) */
+  trans?: boolean;
+  /** 是否拉取罗马音歌词 (默认 false) */
+  roma?: boolean;
+}
+
+export interface LyricResult {
+  code: number;
+  lyric: string;
+  trans: string;
+  roma: string;
+  raw: Record<string, any>;
+}
+
+// ==============================
+// 4. 歌单模块 (Playlists)
+// ==============================
+
+export interface PlaylistDetailQuery extends RequestBaseConfig {
+  /** 歌单 ID (disstid) */
+  id?: string | number;
+}
+
+export interface PlaylistDetailResult {
+  code: number;
+  data: Record<string, any>;
+}
+
+export interface PlaylistTrackAllQuery extends RequestBaseConfig {
+  /** 歌单 ID (disstid) */
+  id?: string | number;
+  /** 抓取数量 (默认 100, 上限 1000) */
+  limit?: number;
+  /** 分页偏移量 (默认 0) */
+  offset?: number;
+}
+
+export interface PlaylistTrackAllResult {
+  code: number;
+  songs: any[];
+  total: number;
+  raw: Record<string, any>;
+}
+
+// ==============================
+// 5. 歌手模块 (Artists)
+// ==============================
+
+export interface ArtistDetailQuery extends RequestBaseConfig {
+  /** 歌手 MID (如 0025NhlC2yWrP4) */
+  id?: string;
+}
+
+export interface ArtistDetailResult {
+  code: number;
+  data: Record<string, any>;
+}
+
+export interface ArtistSongsQuery extends RequestBaseConfig {
+  /** 歌手 MID */
+  id?: string;
+  /** 分页页码 (从 1 开始，默认 1) */
+  page?: number;
+  /** 每页数量 (默认 20, 上限 100) */
+  limit?: number;
+  /** 排序: 0-最新, 1-最热(默认) */
+  order?: number;
+}
+
+export interface ArtistSongsResult {
+  code: number;
+  songs: any[];
+  total: number;
+  raw: Record<string, any>;
+}
+
+// ==============================
+// 6. 搜索模块 (Search)
+// ==============================
+
+export interface SearchQuery extends RequestBaseConfig {
+  /** 搜索关键词 */
+  keywords?: string;
+  /** 兼容 keyword 参数 */
+  keyword?: string;
+  /** 搜索类型: 0-单曲(默认), 1-歌手, 2-专辑, 3-歌单, 7-歌词 */
+  type?: number | string;
+  /** 页码 (默认 1) */
+  page?: number;
+  /** 每页大小 (默认 20) */
+  limit?: number;
+  searchid?: string;
+}
+
+export interface SearchResult {
+  code: number;
+  data: Record<string, any>;
+}
+
+// ==============================
+// 7. 用户模块 (User)
+// ==============================
+
+export interface UserDetailQuery extends RequestBaseConfig {
+  /** 用户数字 QQ/uin 或加密 encrypt_uin (为空时默认当前登录账号) */
+  id?: string | number;
+}
+
+export interface UserDetailResult {
+  code: number;
+  data: Record<string, any>;
+}
+
+export interface UserPlaylistQuery extends RequestBaseConfig {
+  /** 用户数字 QQ/uin 或加密 encrypt_uin */
+  id?: string | number;
+  /** 歌单数量限制 (默认 100) */
+  limit?: number;
+}
+
+export interface UserPlaylistResult {
+  code: number;
+  playlists: any[];
+  total: number;
+  raw: Record<string, any>;
+}
+
+// ==============================
+// 8. 推荐模块 (Recommendations)
+// ==============================
+
+export interface RecommendSongsQuery extends RequestBaseConfig {
+  /** 地区分类: 1-华语, 2-欧美, 3-韩国, 4-日本 (默认 1) */
+  type?: number | string;
+}
+
+export interface RecommendSongsResult {
+  code: number;
+  songs: any[];
+  raw: Record<string, any>;
+}
+
+// ==============================
+// 函数签名声明
+// ==============================
+
+export function artist_detail(query?: ArtistDetailQuery): Promise<Response<ArtistDetailResult>>;
+export function artist_songs(query?: ArtistSongsQuery): Promise<Response<ArtistSongsResult>>;
+export function login_qr_check(query?: LoginQrCheckQuery): Promise<Response<LoginQrCheckResult>>;
+export function login_qr_create(query?: LoginQrCreateQuery): Promise<Response<LoginQrCreateResult>>;
+export function login_refresh(query?: LoginRefreshQuery): Promise<Response<LoginRefreshResult>>;
+export function login_status(query?: LoginStatusQuery): Promise<Response<LoginStatusResult>>;
+export function lyric(query?: LyricQuery): Promise<Response<LyricResult>>;
+export function playlist_detail(query?: PlaylistDetailQuery): Promise<Response<PlaylistDetailResult>>;
+export function playlist_track_all(query?: PlaylistTrackAllQuery): Promise<Response<PlaylistTrackAllResult>>;
+export function recommend_songs(query?: RecommendSongsQuery): Promise<Response<RecommendSongsResult>>;
+export function search(query?: SearchQuery): Promise<Response<SearchResult>>;
+export function song_detail(query?: SongDetailQuery): Promise<Response<SongDetailResult>>;
+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 request(arg1: string, arg2?: any, arg3?: any, arg4?: any): Promise<ApiResponse>;
+export function requestCgi<T = any>(module: string, method: string, param?: Record<string, any>, options?: any): Promise<ApiResponse<T>>;
+export function requestRaw(url: string, options?: any): Promise<{ status: number; data: any; headers: any; cookie: string[] }>;
+export function zzcSign(data: string): string;
+export function qrcDecrypt(hexData: string): string | null;
+export function hash33(str: string): number;
+export function getGtk(skey: string): number;
+export function getGuid(): string;
+export function getSearchId(): string;
+export function cookieToJson(cookie: string | Record<string, string> | undefined | null): Record<string, string>;
+export function cookieToString(cookieObj: Record<string, string> | undefined | null): string;
+export function parseSetCookie(setCookieHeaders?: string[]): Record<string, string>;
+
+declare const api: {
+  artist_detail: typeof artist_detail;
+  artist_songs: typeof artist_songs;
+  login_qr_check: typeof login_qr_check;
+  login_qr_create: typeof login_qr_create;
+  login_refresh: typeof login_refresh;
+  login_status: typeof login_status;
+  lyric: typeof lyric;
+  playlist_detail: typeof playlist_detail;
+  playlist_track_all: typeof playlist_track_all;
+  recommend_songs: typeof recommend_songs;
+  search: typeof search;
+  song_detail: typeof song_detail;
+  song_url: typeof song_url;
+  user_detail: typeof user_detail;
+  user_playlist: typeof user_playlist;
+  request: typeof request;
+  requestCgi: typeof requestCgi;
+  requestRaw: typeof requestRaw;
+  zzcSign: typeof zzcSign;
+  qrcDecrypt: typeof qrcDecrypt;
+  hash33: typeof hash33;
+  getGtk: typeof getGtk;
+  getGuid: typeof getGuid;
+  getSearchId: typeof getSearchId;
+  cookieToJson: typeof cookieToJson;
+  cookieToString: typeof cookieToString;
+  parseSetCookie: typeof parseSetCookie;
+};
+
+export default api;

package/main.js

@@ -0,0 +1,65 @@
+import artist_detail_fn from "./module/artist_detail.js";
+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 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";
+import recommend_songs_fn from "./module/recommend_songs.js";
+import search_fn from "./module/search.js";
+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 { 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";
+import { zzcSign } from "./util/sign.js";
+export const artist_detail = (query = {}) => artist_detail_fn(query, request);
+export const artist_songs = (query = {}) => artist_songs_fn(query, request);
+export const login_qr_check = (query = {}) => login_qr_check_fn(query, request);
+export const login_qr_create = (query = {}) => login_qr_create_fn(query, request);
+export const login_refresh = (query = {}) => login_refresh_fn(query, request);
+export const login_status = (query = {}) => login_status_fn(query, request);
+export const lyric = (query = {}) => lyric_fn(query, request);
+export const playlist_detail = (query = {}) => playlist_detail_fn(query, request);
+export const playlist_track_all = (query = {}) => playlist_track_all_fn(query, request);
+export const recommend_songs = (query = {}) => recommend_songs_fn(query, request);
+export const search = (query = {}) => search_fn(query, request);
+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, };
+const api = {
+    artist_detail,
+    artist_songs,
+    login_qr_check,
+    login_qr_create,
+    login_refresh,
+    login_status,
+    lyric,
+    playlist_detail,
+    playlist_track_all,
+    recommend_songs,
+    search,
+    song_detail,
+    song_url,
+    user_detail,
+    user_playlist,
+    request,
+    requestCgi,
+    requestRaw,
+    zzcSign,
+    qrcDecrypt,
+    hash33,
+    getGtk,
+    getGuid,
+    getSearchId,
+    cookieToJson,
+    cookieToString,
+    parseSetCookie,
+};
+export default api;

package/main.ts

@@ -0,0 +1,113 @@
+import artist_detail_fn from "./module/artist_detail.js";
+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 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";
+import recommend_songs_fn from "./module/recommend_songs.js";
+import search_fn from "./module/search.js";
+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 { cookieToJson, cookieToString, parseSetCookie } from "./util/cookie.js";
+import { getGtk, getGuid, getSearchId, hash33, qrcDecrypt } from "./util/crypto.js";
+import { request, requestCgi, requestRaw, type ApiResponse } from "./util/request.js";
+import { zzcSign } from "./util/sign.js";
+
+export const artist_detail = (query: Parameters<typeof artist_detail_fn>[0] = {}) =>
+  artist_detail_fn(query, request);
+
+export const artist_songs = (query: Parameters<typeof artist_songs_fn>[0] = {}) =>
+  artist_songs_fn(query, request);
+
+export const login_qr_check = (query: Parameters<typeof login_qr_check_fn>[0] = {}) =>
+  login_qr_check_fn(query, request);
+
+export const login_qr_create = (query: Parameters<typeof login_qr_create_fn>[0] = {}) =>
+  login_qr_create_fn(query, request);
+
+export const login_refresh = (query: Parameters<typeof login_refresh_fn>[0] = {}) =>
+  login_refresh_fn(query, request);
+
+export const login_status = (query: Parameters<typeof login_status_fn>[0] = {}) =>
+  login_status_fn(query, request);
+
+export const lyric = (query: Parameters<typeof lyric_fn>[0] = {}) =>
+  lyric_fn(query, request);
+
+export const playlist_detail = (query: Parameters<typeof playlist_detail_fn>[0] = {}) =>
+  playlist_detail_fn(query, request);
+
+export const playlist_track_all = (query: Parameters<typeof playlist_track_all_fn>[0] = {}) =>
+  playlist_track_all_fn(query, request);
+
+export const recommend_songs = (query: Parameters<typeof recommend_songs_fn>[0] = {}) =>
+  recommend_songs_fn(query, request);
+
+export const search = (query: Parameters<typeof search_fn>[0] = {}) =>
+  search_fn(query, request);
+
+export const song_detail = (query: Parameters<typeof song_detail_fn>[0] = {}) =>
+  song_detail_fn(query, request);
+
+export const song_url = (query: Parameters<typeof song_url_fn>[0] = {}) =>
+  song_url_fn(query, request);
+
+export const user_detail = (query: Parameters<typeof user_detail_fn>[0] = {}) =>
+  user_detail_fn(query, request);
+
+export const user_playlist = (query: Parameters<typeof user_playlist_fn>[0] = {}) =>
+  user_playlist_fn(query, request);
+
+export {
+  request,
+  requestCgi,
+  requestRaw,
+  zzcSign,
+  qrcDecrypt,
+  hash33,
+  getGtk,
+  getGuid,
+  getSearchId,
+  cookieToJson,
+  cookieToString,
+  parseSetCookie,
+  type ApiResponse,
+};
+
+const api = {
+  artist_detail,
+  artist_songs,
+  login_qr_check,
+  login_qr_create,
+  login_refresh,
+  login_status,
+  lyric,
+  playlist_detail,
+  playlist_track_all,
+  recommend_songs,
+  search,
+  song_detail,
+  song_url,
+  user_detail,
+  user_playlist,
+  request,
+  requestCgi,
+  requestRaw,
+  zzcSign,
+  qrcDecrypt,
+  hash33,
+  getGtk,
+  getGuid,
+  getSearchId,
+  cookieToJson,
+  cookieToString,
+  parseSetCookie,
+};
+
+export default api;

package/module/artist_detail.d.ts

@@ -0,0 +1,11 @@
+import { request, type ApiResponse } from "../util/request.js";
+/**
+ * 获取歌手详细资料与百科背景.
+ *
+ * @param query.id 歌手 MID (例如: 0025NhlC2yWrP4)
+ * @param query.cookie 登录 Cookie (可选)
+ */
+export default function artist_detail(query?: {
+    id?: string;
+    cookie?: any;
+}, req?: typeof request): Promise<ApiResponse>;

package/module/artist_detail.js

@@ -0,0 +1,35 @@
+import { request } from "../util/request.js";
+/**
+ * 获取歌手详细资料与百科背景.
+ *
+ * @param query.id 歌手 MID (例如: 0025NhlC2yWrP4)
+ * @param query.cookie 登录 Cookie (可选)
+ */
+export default async function artist_detail(query = {}, req = request) {
+    const mid = query.id?.trim();
+    if (!mid) {
+        return {
+            status: 400,
+            body: { code: 400, message: "缺少歌手 mid" },
+        };
+    }
+    const cgiRes = await req("music.musichallSinger.SingerInfoInter", "GetSingerDetail", {
+        singer_mids: [mid],
+        group_singer: 1,
+        wiki_singer: 1,
+        ex_singer: 1,
+        pic: 1,
+        photos: 1,
+    }, {
+        cookie: query.cookie,
+        platform: "web",
+    });
+    return {
+        status: cgiRes.status,
+        body: {
+            code: cgiRes.body?.code ?? 200,
+            data: cgiRes.body,
+        },
+        cookie: cgiRes.cookie,
+    };
+}