@sansenjian/qq-music-api 2.2.1 → 2.2.7

package/dist/module/apis/singers/getSingerStarNum.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = __importDefault(require("../../../util/request"));
+const apiResponse_1 = require("../../../util/apiResponse");
+exports.default = async ({ method = 'get', params = {}, option = {} }) => {
+    const data = Object.assign(params, {
+        format: 'json',
+        outCharset: 'utf-8',
+        utf8: 1,
+        rnd: Date.now()
+    });
+    const options = Object.assign(option, {
+        params: data
+    });
+    return (0, apiResponse_1.handleApi)((0, request_1.default)({
+        url: '/rsc/fcgi-bin/fcg_order_singer_getnum.fcg',
+        method: method,
+        options
+    }));
+};

package/dist/module/apis/songLists/songListCategories.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const apiResponse_1 = require("../../../util/apiResponse");
+const y_common_1 = __importDefault(require("../y_common"));
+exports.default = async ({ method = 'get', params = {}, option = {} }) => {
+    const data = {
+        ...params,
+        format: 'json',
+        outCharset: 'utf-8'
+    };
+    const options = {
+        ...option,
+        params: data
+    };
+    return (0, apiResponse_1.handleApi)((0, y_common_1.default)({
+        url: '/splcloud/fcgi-bin/fcg_get_diss_tag_conf.fcg',
+        method: method,
+        options
+    }));
+};

package/dist/module/apis/songLists/songListDetail.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const apiResponse_1 = require("../../../util/apiResponse");
+const y_common_1 = __importDefault(require("../y_common"));
+exports.default = async ({ method = 'get', params = {}, option = {} }) => {
+    const data = {
+        ...params,
+        format: 'json',
+        outCharset: 'utf-8',
+        type: 1,
+        json: 1,
+        utf8: 1,
+        onlysong: 0,
+        new_format: 1
+    };
+    const options = {
+        ...option,
+        params: data
+    };
+    return (0, apiResponse_1.handleApi)((0, y_common_1.default)({
+        url: '/qzone/fcg-bin/fcg_ucc_getcdinfo_byids_cp.fcg',
+        method: method,
+        options
+    }));
+};

package/dist/module/apis/songLists/songLists.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const apiResponse_1 = require("../../../util/apiResponse");
+const y_common_1 = __importDefault(require("../y_common"));
+exports.default = async ({ method = 'get', params = {}, option = {} }) => {
+    const data = {
+        ...params,
+        format: 'json',
+        outCharset: 'utf-8',
+        picmid: 1
+    };
+    const options = {
+        ...option,
+        params: data
+    };
+    return (0, apiResponse_1.handleApi)((0, y_common_1.default)({
+        url: '/splcloud/fcgi-bin/fcg_get_diss_by_tag.fcg',
+        method: method,
+        options
+    }), {
+        transformData: (response) => {
+            if (typeof response === 'string') {
+                const reg = /^\w+\(([^()]+)\)$/;
+                const matches = response.match(reg);
+                if (matches) {
+                    return JSON.parse(matches[1]);
+                }
+            }
+            return response;
+        }
+    });
+};

package/dist/module/apis/u_common.js

@@ -0,0 +1,56 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = __importDefault(require("../../util/request"));
+const config = __importStar(require("../config"));
+exports.default = ({ options = {}, method = 'get' }) => {
+    const opts = { ...options };
+    // Merge commonParams into params for query string
+    opts.params = { ...config.commonParams, ...(opts.params || {}) };
+    opts.headers = {
+        referer: 'https://y.qq.com/portal/player.html',
+        host: 'u.y.qq.com',
+        'content-type': 'application/x-www-form-urlencoded',
+        ...(opts.headers || {})
+    };
+    if (process.env.DEBUG === 'true') {
+        const logOpts = { ...opts, headers: { ...opts.headers, cookie: '[REDACTED]' } };
+        console.log('https://u.y.qq.com/cgi-bin/musicu.fcg', { opts: logOpts });
+    }
+    return (0, request_1.default)('https://u.y.qq.com/cgi-bin/musicu.fcg', method, opts, 'u');
+};

package/dist/module/apis/user/checkQQLoginQr.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const apiResponse_1 = require("../../../util/apiResponse");
+const loginUtils_1 = require("../../../util/loginUtils");
+const REQUEST_TIMEOUT_MS = 10000;
+const DEBUG_ENABLED = process.env.DEBUG === 'true';
+const debugLog = (message, payload) => {
+    if (DEBUG_ENABLED) {
+        console.log(`[checkQQLoginQr] ${message}`, payload ?? '');
+    }
+};
+const parseSetCookie = (setCookieHeader) => {
+    if (!setCookieHeader)
+        return [];
+    const cookies = [];
+    const parts = setCookieHeader.split(/,(?=\s*[a-zA-Z_]+=)/);
+    for (const part of parts) {
+        const cookiePair = part.split(';')[0].trim();
+        if (cookiePair && cookiePair.includes('=') && cookiePair.split('=')[1]) {
+            cookies.push(cookiePair);
+        }
+    }
+    return cookies;
+};
+const fetchWithTimeout = async (input, init = {}, timeout = REQUEST_TIMEOUT_MS) => {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+        return await fetch(input, {
+            ...init,
+            signal: controller.signal
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+};
+const buildLoginSession = (cookie) => {
+    const cookieList = cookie
+        .split(';')
+        .map(item => item.trim())
+        .filter(Boolean);
+    const cookieObject = {};
+    cookieList.forEach(item => {
+        const [key, value = ''] = item.split('=');
+        if (key && value) {
+            cookieObject[key] = value;
+        }
+    });
+    const loginUin = cookieObject.uin || '';
+    return {
+        loginUin,
+        uin: loginUin,
+        cookie,
+        cookieList,
+        cookieObject
+    };
+};
+const checkQQLoginQr = async ({ method = 'get', params = {}, option = {} }) => {
+    const { ptqrtoken, qrsig } = params;
+    if (!ptqrtoken || !qrsig) {
+        return (0, apiResponse_1.errorResponse)('参数错误', 400);
+    }
+    try {
+        const url = `https://ssl.ptlogin2.qq.com/ptqrlogin?u1=https%3A%2F%2Fgraph.qq.com%2Foauth2.0%2Flogin_jump&ptqrtoken=${ptqrtoken}&ptredirect=0&h=1&t=1&g=1&from_ui=1&ptlang=2052&action=0-0-1711022193435&js_ver=23111510&js_type=1&login_sig=du-YS1h8*0GqVqcrru0pXkpwVg2DYw-DtbFulJ62IgPf6vfiJe*4ONVrYc5hMUNE&pt_uistyle=40&aid=716027609&daid=383&pt_3rd_aid=100497308&&o1vId=3674fc47871e9c407d8838690b355408&pt_js_version=v1.48.1`;
+        const response = await fetchWithTimeout(url, { headers: { Cookie: `qrsig=${qrsig}` } });
+        const data = (await response.text()) || '';
+        const cookieMap = new Map();
+        const setCookie = (setCookieHeader) => {
+            const cookies = parseSetCookie(setCookieHeader);
+            for (const cookie of cookies) {
+                const [name] = cookie.split('=');
+                cookieMap.set(name, cookie);
+            }
+        };
+        setCookie(response.headers.get('Set-Cookie'));
+        const refresh = data.includes('已失效');
+        if (!data.includes('登录成功')) {
+            return (0, apiResponse_1.customResponse)({
+                isOk: false,
+                refresh,
+                message: (refresh && '二维码已失效') || '未扫描二维码'
+            }, 200);
+        }
+        const allCookie = () => Array.from(cookieMap.values());
+        const urlMatch = data.match(/(?:'((?:https?|ftp):\/\/[^\s/$.?#].[^\s]*)')/g);
+        if (!urlMatch || !urlMatch[0]) {
+            return (0, apiResponse_1.errorResponse)('Failed to extract checkSigUrl from response', 502);
+        }
+        const checkSigUrl = urlMatch[0].replace(/'/g, '');
+        const checkSigRes = await fetchWithTimeout(checkSigUrl, {
+            redirect: 'manual',
+            headers: { Cookie: allCookie().join('; ') }
+        });
+        const checkSigCookie = checkSigRes.headers.get('Set-Cookie');
+        const pSkeyMatch = checkSigCookie?.match(/p_skey=([^;]+)/);
+        if (!pSkeyMatch || !pSkeyMatch[1]) {
+            return (0, apiResponse_1.errorResponse)('Failed to extract p_skey from response', 502);
+        }
+        const p_skey = pSkeyMatch[1];
+        const gtk = (0, loginUtils_1.getGtk)(p_skey);
+        setCookie(checkSigCookie);
+        const authorizeUrl = 'https://graph.qq.com/oauth2.0/authorize';
+        const getAuthorizeData = (g_tk) => {
+            const data = new FormData();
+            data.append('response_type', 'code');
+            data.append('client_id', '100497308');
+            data.append('redirect_uri', 'https://y.qq.com/portal/wx_redirect.html?login_type=1&surl=https://y.qq.com/');
+            data.append('scope', 'get_user_info,get_app_friends');
+            data.append('state', 'state');
+            data.append('switch', '');
+            data.append('from_ptlogin', '1');
+            data.append('src', '1');
+            data.append('update_auth', '1');
+            data.append('openapi', '1010_1030');
+            data.append('g_tk', g_tk.toString());
+            data.append('auth_time', new Date().toString());
+            data.append('ui', (0, loginUtils_1.getGuid)());
+            return data;
+        };
+        const authorizeRes = await fetchWithTimeout(authorizeUrl, {
+            redirect: 'manual',
+            method: 'POST',
+            body: getAuthorizeData(gtk),
+            headers: {
+                Cookie: allCookie().join('; ')
+            }
+        });
+        setCookie(authorizeRes.headers.get('Set-Cookie'));
+        const location = authorizeRes.headers.get('Location');
+        const contentType = authorizeRes.headers.get('Content-Type');
+        debugLog('authorize response meta', {
+            status: authorizeRes.status,
+            redirected: authorizeRes.redirected,
+            hasLocation: Boolean(location),
+            contentType
+        });
+        if (authorizeRes.status < 300 || authorizeRes.status >= 400 || !location) {
+            return (0, apiResponse_1.errorResponse)('授权响应异常，未返回跳转地址', 502);
+        }
+        const codeMatch = location.match(/[?&]code=([^&]+)/);
+        if (!codeMatch || !codeMatch[1]) {
+            debugLog('authorize location parse failed', { location });
+            return (0, apiResponse_1.errorResponse)('授权响应中未找到 code 参数', 502);
+        }
+        const code = codeMatch[1];
+        const getFcgReqData = (g_tk, code) => {
+            const data = {
+                comm: {
+                    g_tk,
+                    platform: 'yqq',
+                    ct: 24,
+                    cv: 0
+                },
+                req: {
+                    module: 'QQConnectLogin.LoginServer',
+                    method: 'QQLogin',
+                    param: {
+                        code
+                    }
+                }
+            };
+            return JSON.stringify(data);
+        };
+        const loginUrl = 'https://u.y.qq.com/cgi-bin/musicu.fcg';
+        const loginRes = await fetchWithTimeout(loginUrl, {
+            method: 'POST',
+            body: getFcgReqData(gtk, code),
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                Cookie: allCookie().join('; ')
+            }
+        });
+        setCookie(loginRes.headers.get('Set-Cookie'));
+        const sessionCookie = allCookie().join('; ');
+        return (0, apiResponse_1.customResponse)({
+            isOk: true,
+            message: '登录成功',
+            session: buildLoginSession(sessionCookie)
+        }, 200);
+    }
+    catch (error) {
+        if (error.name === 'AbortError') {
+            return (0, apiResponse_1.errorResponse)('登录检查超时', 504);
+        }
+        return (0, apiResponse_1.errorResponse)('登录检查失败', 502);
+    }
+};
+exports.default = checkQQLoginQr;

package/dist/module/apis/user/getQQLoginQr.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const apiResponse_1 = require("../../../util/apiResponse");
+const loginUtils_1 = require("../../../util/loginUtils");
+const getQQLoginQr = async ({ method = 'get', params = {}, option = {} }) => {
+    try {
+        const url = 'https://ssl.ptlogin2.qq.com/ptqrshow?appid=716027609&e=2&l=M&s=3&d=72&v=4&t=0.9698127522807933&daid=383&pt_3rd_aid=100497308&u1=https%3A%2F%2Fgraph.qq.com%2Foauth2.0%2Flogin_jump';
+        const response = await fetch(url);
+        const data = await response.arrayBuffer();
+        const img = 'data:image/png;base64,' + (data && Buffer.from(data).toString('base64'));
+        const cookieHeader = response.headers.get('Set-Cookie');
+        const match = cookieHeader?.match(/qrsig=([^;]+)/);
+        if (!match) {
+            return (0, apiResponse_1.errorResponse)('Failed to get qrsig from response', 502);
+        }
+        const qrsig = match[1];
+        return (0, apiResponse_1.customResponse)({ img, ptqrtoken: (0, loginUtils_1.hash33)(qrsig), qrsig }, 200);
+    }
+    catch (error) {
+        return (0, apiResponse_1.errorResponse)('Failed to fetch QQ login QR', 502);
+    }
+};
+exports.default = getQQLoginQr;

package/dist/module/apis/user/getUserAvatar.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserAvatar = void 0;
+// 获取 QQ 用户头像
+const getUserAvatar = async (params) => {
+    const { k, uin, size = 140 } = params;
+    // 如果提供了 k 参数，使用 k 参数获取头像
+    if (k) {
+        const url = `https://thirdqq.qlogo.cn/g?b=sdk&k=${k}&s=${size}`;
+        return {
+            avatarUrl: url,
+            message: '头像 URL 获取成功'
+        };
+    }
+    // 如果提供了 uin，尝试从 uin 获取头像
+    if (uin) {
+        const url = `https://q.qlogo.cn/headimg_dl?dst_uin=${uin}&spec=${size}`;
+        return {
+            avatarUrl: url,
+            message: '头像 URL 获取成功'
+        };
+    }
+    throw new Error('缺少 k 或 uin 参数');
+};
+exports.getUserAvatar = getUserAvatar;

package/dist/module/apis/user/getUserLikedSongs.js

@@ -0,0 +1,129 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserLikedSongs = void 0;
+const request_1 = __importDefault(require("../../../util/request"));
+const apiResponse_1 = require("../../../util/apiResponse");
+const DEBUG_ENABLED = process.env.DEBUG === 'true';
+const debugLog = (message, payload) => {
+    if (DEBUG_ENABLED) {
+        console.log(`[getUserLikedSongs] ${message}`, payload ?? '');
+    }
+};
+// 获取用户喜欢的歌曲列表
+// 注意：此接口需要有效的 QQ 音乐 Cookie 才能正常工作
+const getUserLikedSongs = async (params) => {
+    const { uin, offset = 0, limit = 30 } = params;
+    const page = Math.floor(offset / limit) + 1;
+    // 使用 c6.y.qq.com/rsc/fcgi-bin/fcg_get_profile_homepage.fcg 接口
+    // 通过 mymusic 字段获取用户喜欢的歌曲信息
+    const url = 'https://c6.y.qq.com/rsc/fcgi-bin/fcg_get_profile_homepage.fcg';
+    try {
+        debugLog('request meta', {
+            url,
+            uin,
+            offset,
+            limit,
+            page,
+            hasGlobalCookie: Boolean(global.userInfo?.cookie),
+            cookieLength: global.userInfo?.cookie?.length || 0
+        });
+        const response = await (0, request_1.default)({
+            url,
+            method: 'GET',
+            isUUrl: 'u',
+            options: {
+                params: {
+                    _: Date.now(),
+                    cv: 4747474,
+                    ct: 24,
+                    format: 'json',
+                    inCharset: 'utf-8',
+                    outCharset: 'utf-8',
+                    notice: 0,
+                    platform: 'yqq.json',
+                    needNewCode: 0,
+                    uin: Number.parseInt(uin, 10),
+                    g_tk_new_20200303: 0,
+                    g_tk: 0,
+                    cid: 205360838,
+                    userid: Number.parseInt(uin, 10),
+                    reqfrom: 1,
+                    reqtype: 0,
+                    hostUin: 0,
+                    loginUin: Number.parseInt(uin, 10)
+                },
+                headers: {
+                    Referer: `https://y.qq.com/portal/profile.html?uin=${uin}`,
+                    Cookie: global.userInfo?.cookie || ''
+                }
+            }
+        });
+        const payload = response.data;
+        debugLog('upstream payload summary', {
+            topLevelKeys: payload && typeof payload === 'object' ? Object.keys(payload) : null,
+            code: payload?.code,
+            hasData: Boolean(payload?.data),
+            dataKeys: payload?.data && typeof payload.data === 'object' ? Object.keys(payload.data) : []
+        });
+        if (!payload || typeof payload !== 'object') {
+            debugLog('invalid payload received', payload);
+            return (0, apiResponse_1.errorResponse)('用户喜欢的歌曲响应格式无效', 502);
+        }
+        if (typeof payload.code === 'number' && payload.code !== 0) {
+            debugLog('upstream business error payload', payload);
+            return (0, apiResponse_1.errorResponse)(payload.msg || payload.message || '获取用户喜欢的歌曲失败', 502);
+        }
+        // 从 mymusic 字段中提取喜欢的歌曲信息
+        // mymusic 数组中的第一个元素通常包含"我喜欢"歌单的信息
+        const mymusic = payload?.data?.mymusic;
+        let likedSongsInfo = null;
+        if (Array.isArray(mymusic)) {
+            // 查找"我喜欢"歌单（通常 title 包含"喜欢"或 type 为 1）
+            likedSongsInfo = mymusic.find((item) => {
+                return item?.title && (item.title.includes('喜欢') || item.type === 1);
+            });
+        }
+        debugLog('liked songs info', likedSongsInfo);
+        if (!likedSongsInfo) {
+            debugLog('no liked songs info found in mymusic');
+            return (0, apiResponse_1.customResponse)({
+                response: {
+                    code: 0,
+                    data: {
+                        songs: [],
+                        total: 0,
+                        hasMore: false
+                    }
+                }
+            }, 200);
+        }
+        // 返回喜欢的歌曲信息（包含歌单 ID 和统计信息）
+        // 注意：完整的歌曲列表需要通过 musics.fcg 接口获取（需要二进制加密）
+        // 这里先返回歌单基本信息
+        return (0, apiResponse_1.customResponse)({
+            response: {
+                code: 0,
+                data: {
+                    songs: [likedSongsInfo],
+                    total: likedSongsInfo.num0 || 0,
+                    hasMore: false,
+                    info: {
+                        title: likedSongsInfo.title,
+                        songCount: likedSongsInfo.num0,
+                        albumCount: likedSongsInfo.num1,
+                        playlistCount: likedSongsInfo.num2,
+                        id: likedSongsInfo.id
+                    }
+                }
+            }
+        }, 200);
+    }
+    catch (error) {
+        console.error('获取用户喜欢的歌曲失败:', error);
+        return (0, apiResponse_1.errorResponse)(error.message || '获取用户喜欢的歌曲失败', 502);
+    }
+};
+exports.getUserLikedSongs = getUserLikedSongs;

package/dist/module/apis/user/getUserPlaylists.js

@@ -0,0 +1,138 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserPlaylists = void 0;
+const request_1 = __importDefault(require("../../../util/request"));
+const apiResponse_1 = require("../../../util/apiResponse");
+const DEBUG_ENABLED = process.env.DEBUG === 'true';
+const debugLog = (message, payload) => {
+    if (DEBUG_ENABLED) {
+        console.log(`[getUserPlaylists] ${message}`, payload ?? '');
+    }
+};
+const getNamedCandidateEntries = (payload) => [
+    ['data.mydiss.list', payload?.data?.mydiss?.list],
+    ['data.mymusic', payload?.data?.mymusic],
+    ['data.createdDissList', payload?.data?.createdDissList],
+    ['data.createdList', payload?.data?.createdList],
+    ['data.creator', payload?.data?.creator],
+    ['data.creator.playlist', payload?.data?.creator?.playlist],
+    ['data.creator.playlists', payload?.data?.creator?.playlists],
+    ['data.playlist', payload?.data?.playlist],
+    ['data.playlists', payload?.data?.playlists],
+    ['mydiss.list', payload?.mydiss?.list],
+    ['mymusic', payload?.mymusic],
+    ['createdDissList', payload?.createdDissList],
+    ['createdList', payload?.createdList],
+    ['creator', payload?.creator],
+    ['creator.playlist', payload?.creator?.playlist],
+    ['creator.playlists', payload?.creator?.playlists],
+    ['playlist', payload?.playlist],
+    ['playlists', payload?.playlists]
+];
+const extractPlaylists = (payload) => {
+    debugLog('payload top-level keys', Object.keys(payload || {}));
+    debugLog('payload.data keys', payload?.data && typeof payload.data === 'object' ? Object.keys(payload.data) : []);
+    const matchedEntry = getNamedCandidateEntries(payload).find(([, candidate]) => Array.isArray(candidate));
+    if (matchedEntry) {
+        const [candidatePath, playlists] = matchedEntry;
+        debugLog('matched playlist candidate', {
+            candidatePath,
+            length: playlists.length
+        });
+        return playlists;
+    }
+    debugLog('playlist candidates summary', getNamedCandidateEntries(payload).map(([candidatePath, candidate]) => ({
+        candidatePath,
+        type: Array.isArray(candidate) ? 'array' : typeof candidate,
+        keys: candidate && typeof candidate === 'object' && !Array.isArray(candidate) ? Object.keys(candidate) : undefined
+    })));
+    throw new Error('用户歌单响应中未找到歌单列表字段');
+};
+const getErrorMessage = (payload) => {
+    const candidates = [payload.message, payload.msg, payload.errmsg, payload.error];
+    const matched = candidates.find(candidate => typeof candidate === 'string' && candidate.trim() !== '');
+    return matched || '获取用户歌单失败';
+};
+// 获取用户创建的歌单
+// 注意：此接口需要有效的 QQ 音乐 Cookie 才能正常工作
+const getUserPlaylists = async (params) => {
+    const { uin, offset = 0, limit = 30 } = params;
+    // 使用 c6.y.qq.com/rsc/fcgi-bin/fcg_get_profile_homepage.fcg 接口
+    // 这是通过 Chrome DevTools 抓包发现的实际使用的接口
+    const url = 'https://c6.y.qq.com/rsc/fcgi-bin/fcg_get_profile_homepage.fcg';
+    const pageOffset = offset % limit;
+    try {
+        debugLog('request meta', {
+            url,
+            uin,
+            offset,
+            limit,
+            pageOffset,
+            hasGlobalCookie: Boolean(global.userInfo?.cookie),
+            cookieLength: global.userInfo?.cookie?.length || 0
+        });
+        const response = await (0, request_1.default)({
+            url,
+            method: 'GET',
+            isUUrl: 'u',
+            options: {
+                params: {
+                    _: Date.now(),
+                    cv: 4747474,
+                    ct: 24,
+                    format: 'json',
+                    inCharset: 'utf-8',
+                    outCharset: 'utf-8',
+                    notice: 0,
+                    platform: 'yqq.json',
+                    needNewCode: 0,
+                    uin: Number.parseInt(uin, 10),
+                    g_tk_new_20200303: 0,
+                    g_tk: 0,
+                    cid: 205360838,
+                    userid: Number.parseInt(uin, 10),
+                    reqfrom: 1,
+                    reqtype: 0,
+                    hostUin: 0,
+                    loginUin: Number.parseInt(uin, 10)
+                },
+                headers: {
+                    Referer: `https://y.qq.com/portal/profile.html?uin=${uin}`,
+                    Cookie: global.userInfo?.cookie || ''
+                }
+            }
+        });
+        const payload = response.data;
+        debugLog('upstream payload summary', {
+            topLevelKeys: payload && typeof payload === 'object' ? Object.keys(payload) : null,
+            code: payload?.code,
+            hasData: Boolean(payload?.data),
+            dataKeys: payload?.data && typeof payload.data === 'object' ? Object.keys(payload.data) : []
+        });
+        if (!payload || typeof payload !== 'object') {
+            debugLog('invalid payload received', payload);
+            return (0, apiResponse_1.errorResponse)('用户歌单响应格式无效', 502);
+        }
+        if (typeof payload.code === 'number' && payload.code !== 0) {
+            debugLog('upstream business error payload', payload);
+            return (0, apiResponse_1.errorResponse)(getErrorMessage(payload), 502);
+        }
+        const upstreamPlaylists = extractPlaylists(payload);
+        const playlists = pageOffset > 0 ? upstreamPlaylists.slice(pageOffset, pageOffset + limit) : upstreamPlaylists;
+        debugLog('final response contract', {
+            wrapper: 'customResponse',
+            expectedBodyShape: { response: { code: 0, data: { playlists: '...' } } },
+            upstreamLength: upstreamPlaylists.length,
+            normalizedLength: playlists.length
+        });
+        return (0, apiResponse_1.customResponse)({ response: { code: 0, data: { playlists } } }, 200);
+    }
+    catch (error) {
+        console.error('获取用户歌单失败:', error);
+        return (0, apiResponse_1.errorResponse)(error.message || '获取用户歌单失败', 502);
+    }
+};
+exports.getUserPlaylists = getUserPlaylists;