@sansenjian/qq-music-api 2.2.7 → 2.2.10

package/dist/routers/context/getSongInfo.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const module_1 = require("../../module");
-const controller = async (ctx, next) => {
+const util_1 = require("../util");
+const apiResponse_1 = require("../../util/apiResponse");
+const getSongInfoController = (0, util_1.withErrorHandler)(async (ctx) => {
     const song_mid = ctx.query.songmid;
     const song_id = ctx.query.songid || '';
-    const params = Object.assign({
+    const params = {
         format: 'json',
         inCharset: 'utf8',
         outCharset: 'utf-8',
@@ -26,22 +28,13 @@ const controller = async (ctx, next) => {
                 module: 'music.pf_song_detail_svr'
             }
         }
-    });
+    };
     const props = {
         method: 'get',
         params,
         option: {}
     };
-    await (0, module_1.UCommon)(props)
-        .then(res => {
-        const response = res.data;
-        ctx.status = 200;
-        ctx.body = {
-            response
-        };
-    })
-        .catch(error => {
-        console.log('error', error);
-    });
-};
-exports.default = controller;
+    const response = await (0, module_1.UCommon)(props);
+    (0, util_1.setApiResponse)(ctx, (0, apiResponse_1.customResponse)({ response: response.data }, 200));
+});
+exports.default = getSongInfoController;

package/dist/routers/context/getSongListCategories.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const module_1 = require("../../module");
+const util_1 = require("../util");
 /**
  * @description: 歌单
  * 1 歌单类型
@@ -9,15 +10,13 @@ const module_1 = require("../../module");
  * 4 歌单详情
  *
  */
-exports.default = async (ctx, next) => {
+const getSongListCategoriesController = (0, util_1.withErrorHandler)(async (ctx) => {
     const props = {
         method: 'get',
         params: {},
         option: {}
     };
-    const { status, body } = await (0, module_1.songListCategories)(props);
-    Object.assign(ctx, {
-        status,
-        body
-    });
-};
+    const result = await (0, module_1.songListCategories)(props);
+    (0, util_1.setApiResponse)(ctx, result);
+});
+exports.default = getSongListCategoriesController;

package/dist/routers/context/getSongListDetail.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const module_1 = require("../../module");
-const controller = async (ctx, next) => {
+const util_1 = require("../util");
+const getSongListDetailController = (0, util_1.withErrorHandler)(async (ctx) => {
     const { disstid } = ctx.query;
     const props = {
         method: 'get',
@@ -10,10 +11,7 @@ const controller = async (ctx, next) => {
         },
         option: {}
     };
-    const { status, body } = await (0, module_1.songListDetail)(props);
-    Object.assign(ctx, {
-        status,
-        body
-    });
-};
-exports.default = controller;
+    const result = await (0, module_1.songListDetail)(props);
+    (0, util_1.setApiResponse)(ctx, result);
+});
+exports.default = getSongListDetailController;

package/dist/routers/context/getUserAvatar.js

@@ -1,48 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const module_1 = require("../../module");
+const util_1 = require("../util");
+const apiResponse_1 = require("../../util/apiResponse");
 // 获取 QQ 用户头像
-exports.default = async (ctx, next) => {
+const getUserAvatarController = (0, util_1.withErrorHandler)(async (ctx) => {
     const rawK = Array.isArray(ctx.query.k) ? ctx.query.k[0] : ctx.query.k;
     const rawUin = Array.isArray(ctx.query.uin) ? ctx.query.uin[0] : ctx.query.uin;
     const rawSize = Array.isArray(ctx.query.size) ? ctx.query.size[0] : ctx.query.size;
     const parsedSize = rawSize ? Number(rawSize) : 140;
     if (!rawK && !rawUin) {
-        ctx.status = 400;
-        ctx.body = {
-            error: '缺少 k 或 uin 参数'
-        };
+        (0, util_1.setApiResponse)(ctx, (0, apiResponse_1.errorResponse)('缺少 k 或 uin 参数', 400));
         return;
     }
     if (!Number.isFinite(parsedSize) || parsedSize <= 0) {
-        ctx.status = 400;
-        ctx.body = {
-            error: 'size 参数无效'
-        };
+        (0, util_1.setApiResponse)(ctx, (0, apiResponse_1.errorResponse)('size 参数无效', 400));
         return;
     }
-    try {
-        const result = await (0, module_1.getUserAvatar)({
-            k: rawK,
-            uin: rawUin,
-            size: parsedSize
-        });
-        ctx.status = 200;
-        ctx.body = {
-            response: {
-                code: 0,
-                data: {
-                    avatarUrl: result.avatarUrl,
-                    message: '获取头像成功'
-                }
+    const result = await (0, module_1.getUserAvatar)({
+        k: rawK,
+        uin: rawUin,
+        size: parsedSize
+    });
+    (0, util_1.setApiResponse)(ctx, (0, apiResponse_1.customResponse)({
+        response: {
+            code: 0,
+            data: {
+                avatarUrl: result.avatarUrl,
+                message: '获取头像成功'
             }
-        };
-    }
-    catch (error) {
-        ctx.status = 502;
-        ctx.body = {
-            error: error.message
-        };
-    }
-    await next();
-};
+        }
+    }, 200));
+});
+exports.default = getUserAvatarController;

package/dist/routers/context/getUserPlaylists.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const module_1 = require("../../module");
-// 获取用户创建的歌单
+const cookieResolver_1 = require("../../util/cookieResolver");
 exports.default = async (ctx, next) => {
     const { uin, offset = 0, limit = 30 } = ctx.query;
     if (!uin) {
@@ -11,10 +11,13 @@ exports.default = async (ctx, next) => {
         };
         return;
     }
+    const normalizedUin = Array.isArray(uin) ? uin[0] : uin;
+    const { cookie } = (0, cookieResolver_1.resolveRequestCookie)(ctx);
     const { status, body } = await (0, module_1.getUserPlaylists)({
-        uin: uin,
+        uin: String(normalizedUin),
         offset: Number(offset),
-        limit: Number(limit)
+        limit: Number(limit),
+        cookie
     });
     Object.assign(ctx, {
         status,

package/dist/routers/context/index.js

@@ -1,107 +1,98 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-const req = (id) => {
-    const mod = require(id);
-    return mod && mod.default ? mod.default : mod;
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-const getDownloadQQMusic = req('./getDownloadQQMusic');
-const getHotKey = req('./getHotkey');
-const getSearchByKey = req('./getSearchByKey');
-const getSmartbox = req('./getSmartbox');
-const getSongListCategories = req('./getSongListCategories');
-const getSongLists = req('./getSongLists');
-const batchGetSongLists = req('./batchGetSongLists');
-const getSongInfo = req('./getSongInfo');
-const batchGetSongInfo = req('./batchGetSongInfo');
-const getSongListDetail = req('./getSongListDetail');
-const getNewDisks = req('./getNewDisks');
-const getMvByTag = req('./getMvByTag');
-const getMv = req('./getMv');
-const getSingerList = req('./getSingerList');
-const getSimilarSinger = req('./getSimilarSinger');
-const getSingerAlbum = req('./getSingerAlbum');
-const getSingerHotsong = req('./getSingerHotsong');
-const getSingerMv = req('./getSingerMv');
-const getSingerDesc = req('./getSingerDesc');
-const getSingerStarNum = req('./getSingerStarNum');
-const getRadioLists = req('./getRadioLists');
-const getDigitalAlbumLists = req('./getDigitalAlbumLists');
-const getLyric = req('./getLyric');
-const getMusicPlay = req('./getMusicPlay');
-const getAlbumInfo = req('./getAlbumInfo');
-const getComments = req('./getComments');
-const getRecommend = req('./getRecommend');
-const getMvPlay = req('./getMvPlay');
-const getTopLists = req('./getTopLists');
-const getRanks = req('./getRanks');
-const getTicketInfo = req('./getTicketInfo');
-const getImageUrl = req('./getImageUrl');
-const getQQLoginQr = req('./getQQLoginQr');
-const checkQQLoginQr = req('./checkQQLoginQr');
-const { get: getCookie, set: setCookie } = req('./cookies');
-const getUserPlaylists = req('./getUserPlaylists');
-const getUserAvatar = req('./getUserAvatar');
-const getUserLikedSongs = req('./getUserLikedSongs');
-const dailyRecommendController = req('./getDailyRecommend');
-const personalRecommendController = req('./getPersonalRecommend');
-const extendController = req('./getPlaylistTags');
-const getDailyRecommend = dailyRecommendController.getDailyRecommend;
-const getPrivateFM = dailyRecommendController.getPrivateFM;
-const getNewSongs = dailyRecommendController.getNewSongs;
-const getPersonalRecommend = personalRecommendController.getPersonalRecommend;
-const getSimilarSongs = personalRecommendController.getSimilarSongs;
-const getPlaylistTags = extendController.getPlaylistTags;
-const getPlaylistsByTag = extendController.getPlaylistsByTag;
-const getHotComments = extendController.getHotComments;
-const getSingerListByArea = extendController.getSingerListByArea;
+Object.defineProperty(exports, "__esModule", { value: true });
+// Import refactored controllers
+const getDownloadQQMusic_1 = __importDefault(require("./getDownloadQQMusic"));
+const getHotkey_1 = __importDefault(require("./getHotkey"));
+const getSearchByKey_1 = __importDefault(require("./getSearchByKey"));
+const getSmartbox_1 = __importDefault(require("./getSmartbox"));
+const getSongListCategories_1 = __importDefault(require("./getSongListCategories"));
+const getSongLists_1 = __importDefault(require("./getSongLists"));
+const batchGetSongLists_1 = __importDefault(require("./batchGetSongLists"));
+const getSongInfo_1 = __importDefault(require("./getSongInfo"));
+const batchGetSongInfo_1 = __importDefault(require("./batchGetSongInfo"));
+const getSongListDetail_1 = __importDefault(require("./getSongListDetail"));
+const getNewDisks_1 = __importDefault(require("./getNewDisks"));
+const getMvByTag_1 = __importDefault(require("./getMvByTag"));
+const getMv_1 = __importDefault(require("./getMv"));
+const getSingerList_1 = __importDefault(require("./getSingerList"));
+const getSimilarSinger_1 = __importDefault(require("./getSimilarSinger"));
+const getSingerAlbum_1 = __importDefault(require("./getSingerAlbum"));
+const getSingerHotsong_1 = __importDefault(require("./getSingerHotsong"));
+const getSingerMv_1 = __importDefault(require("./getSingerMv"));
+const getSingerDesc_1 = __importDefault(require("./getSingerDesc"));
+const getSingerStarNum_1 = __importDefault(require("./getSingerStarNum"));
+const getRadioLists_1 = __importDefault(require("./getRadioLists"));
+const getDigitalAlbumLists_1 = __importDefault(require("./getDigitalAlbumLists"));
+const getLyric_1 = __importDefault(require("./getLyric"));
+const getMusicPlay_1 = __importDefault(require("./getMusicPlay"));
+const getAlbumInfo_1 = __importDefault(require("./getAlbumInfo"));
+const getComments_1 = __importDefault(require("./getComments"));
+const getRecommend_1 = __importDefault(require("./getRecommend"));
+const getMvPlay_1 = __importDefault(require("./getMvPlay"));
+const getTopLists_1 = __importDefault(require("./getTopLists"));
+const getRanks_1 = __importDefault(require("./getRanks"));
+const getTicketInfo_1 = __importDefault(require("./getTicketInfo"));
+const getImageUrl_1 = __importDefault(require("./getImageUrl"));
+const getQQLoginQr_1 = __importDefault(require("./getQQLoginQr"));
+const checkQQLoginQr_1 = __importDefault(require("./checkQQLoginQr"));
+const cookies_1 = __importDefault(require("./cookies"));
+const getUserPlaylists_1 = __importDefault(require("./getUserPlaylists"));
+const getUserAvatar_1 = __importDefault(require("./getUserAvatar"));
+const getUserLikedSongs_1 = __importDefault(require("./getUserLikedSongs"));
+const getDailyRecommend_1 = require("./getDailyRecommend");
+const getPersonalRecommend_1 = require("./getPersonalRecommend");
+const getPlaylistTags_1 = require("./getPlaylistTags");
+// Export all controllers with consistent naming
 exports.default = {
-    getCookie,
-    setCookie,
-    getDownloadQQMusic,
-    getHotKey,
-    getSearchByKey,
-    getSmartbox,
-    getSongListCategories,
-    getSongLists,
-    batchGetSongLists,
-    getSongInfo,
-    batchGetSongInfo,
-    getSongListDetail,
-    getNewDisks,
-    getMvByTag,
-    getMv,
-    getSingerList,
-    getSimilarSinger,
-    getSingerAlbum,
-    getSingerHotsong,
-    getSingerMv,
-    getSingerDesc,
-    getSingerStarNum,
-    getRadioLists,
-    getDigitalAlbumLists,
-    getLyric,
-    getMusicPlay,
-    getAlbumInfo,
-    getComments,
-    getRecommend,
-    getMvPlay,
-    getTopLists,
-    getRanks,
-    getTicketInfo,
-    getImageUrl,
-    getQQLoginQr,
-    checkQQLoginQr,
-    getUserPlaylists,
-    getUserAvatar,
-    getUserLikedSongs,
-    getDailyRecommend,
-    getPrivateFM,
-    getNewSongs,
-    getPersonalRecommend,
-    getSimilarSongs,
-    getPlaylistTags,
-    getPlaylistsByTag,
-    getHotComments,
-    getSingerListByArea
+    getCookie: cookies_1.default.get,
+    setCookie: cookies_1.default.set,
+    getDownloadQQMusic: getDownloadQQMusic_1.default,
+    getHotKey: getHotkey_1.default,
+    getSearchByKey: getSearchByKey_1.default,
+    getSmartbox: getSmartbox_1.default,
+    getSongListCategories: getSongListCategories_1.default,
+    getSongLists: getSongLists_1.default,
+    batchGetSongLists: batchGetSongLists_1.default,
+    getSongInfo: getSongInfo_1.default,
+    batchGetSongInfo: batchGetSongInfo_1.default,
+    getSongListDetail: getSongListDetail_1.default,
+    getNewDisks: getNewDisks_1.default,
+    getMvByTag: getMvByTag_1.default,
+    getMv: getMv_1.default,
+    getSingerList: getSingerList_1.default,
+    getSimilarSinger: getSimilarSinger_1.default,
+    getSingerAlbum: getSingerAlbum_1.default,
+    getSingerHotsong: getSingerHotsong_1.default,
+    getSingerMv: getSingerMv_1.default,
+    getSingerDesc: getSingerDesc_1.default,
+    getSingerStarNum: getSingerStarNum_1.default,
+    getRadioLists: getRadioLists_1.default,
+    getDigitalAlbumLists: getDigitalAlbumLists_1.default,
+    getLyric: getLyric_1.default,
+    getMusicPlay: getMusicPlay_1.default,
+    getAlbumInfo: getAlbumInfo_1.default,
+    getComments: getComments_1.default,
+    getRecommend: getRecommend_1.default,
+    getMvPlay: getMvPlay_1.default,
+    getTopLists: getTopLists_1.default,
+    getRanks: getRanks_1.default,
+    getTicketInfo: getTicketInfo_1.default,
+    getImageUrl: getImageUrl_1.default,
+    getQQLoginQr: getQQLoginQr_1.default,
+    checkQQLoginQr: checkQQLoginQr_1.default,
+    getUserPlaylists: getUserPlaylists_1.default,
+    getUserAvatar: getUserAvatar_1.default,
+    getUserLikedSongs: getUserLikedSongs_1.default,
+    getDailyRecommend: getDailyRecommend_1.getDailyRecommendController,
+    getPrivateFM: getDailyRecommend_1.getPrivateFMController,
+    getNewSongs: getDailyRecommend_1.getNewSongsController,
+    getPersonalRecommend: getPersonalRecommend_1.getPersonalRecommendController,
+    getSimilarSongs: getPersonalRecommend_1.getSimilarSongsController,
+    getPlaylistTags: getPlaylistTags_1.getPlaylistTagsController,
+    getPlaylistsByTag: getPlaylistTags_1.getPlaylistsByTagController,
+    getHotComments: getPlaylistTags_1.getHotCommentsController,
+    getSingerListByArea: getPlaylistTags_1.getSingerListByAreaController
 };

package/dist/routers/util.js

@@ -5,6 +5,8 @@ exports.createPostController = createPostController;
 exports.validateRequired = validateRequired;
 exports.handleControllerResponse = handleControllerResponse;
 exports.createCustomController = createCustomController;
+exports.setApiResponse = setApiResponse;
+exports.withErrorHandler = withErrorHandler;
 const INTERNAL_ERROR_MESSAGE = '服务器内部错误';
 const normalizeErrorMessage = (error) => {
     if (error instanceof Error && error.message) {
@@ -186,3 +188,32 @@ function createCustomController(handler, apiFunction) {
         }
     };
 }
+/**
+ * 统一处理 API 响应并设置到 Koa 上下文
+ * @param ctx - Koa 上下文
+ * @param apiResponse - API 响应对象
+ */
+function setApiResponse(ctx, apiResponse) {
+    ctx.status = apiResponse.status || 500;
+    ctx.body = apiResponse.body;
+}
+/**
+ * 包装异步控制器，自动处理错误
+ * @param handler - 控制器处理函数
+ * @returns 包装后的控制器
+ */
+function withErrorHandler(handler) {
+    return async (ctx, next) => {
+        try {
+            await handler(ctx);
+            await next();
+        }
+        catch (error) {
+            console.error('Controller error:', error);
+            ctx.status = 502;
+            ctx.body = {
+                error: error.message || '服务器内部错误',
+            };
+        }
+    };
+}

package/dist/scripts/run-tests-with-flags.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * 运行测试并生成带 flags 的覆盖率报告
+ *
+ * 用法:
+ * - 运行所有测试：npm run test:flags
+ * - 只运行单元测试：npm run test:flags:unit
+ *
+ * 注意：此脚本通过 tsx 运行，不使用 ts-node
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ROOT_DIR = path.resolve(__dirname, '..');
+const COVERAGE_DIR = path.join(ROOT_DIR, 'coverage');
+// 确保覆盖率目录存在
+if (!fs.existsSync(COVERAGE_DIR)) {
+    fs.mkdirSync(COVERAGE_DIR, { recursive: true });
+}
+/**
+ * 运行命令
+ * 注意：command 参数必须是硬编码的命令字符串，不能包含用户输入
+ * @param command - 要执行的命令（必须是硬编码字符串）
+ * @param env - 环境变量
+ */
+function runCommand(command, env = {}) {
+    try {
+        // 使用 execSync 执行命令，命令必须是固定的字符串
+        // 安全说明：此函数只能用于执行硬编码的命令，不接受外部输入
+        // 所有调用此函数的地方都必须使用字符串字面量
+        (0, child_process_1.execSync)(command, {
+            stdio: 'inherit',
+            env: { ...process.env, ...env },
+            cwd: ROOT_DIR
+        });
+    }
+    catch (error) {
+        console.error(`命令执行失败：${command}`);
+        throw error;
+    }
+}
+/**
+ * 运行 Jest 测试（安全版本）
+ * 使用参数化方式执行 Jest，避免命令注入风险
+ * @param args - Jest 命令行参数数组
+ * @param env - 环境变量
+ */
+function runJest(args, env = {}) {
+    const command = `npx jest ${args.join(' ')}`;
+    return runCommand(command, env);
+}
+function runUnitTests() {
+    console.log('\n🧪 运行单元测试...\n');
+    // 运行单元测试 - 使用参数化方式
+    runJest(['--coverage', '--testPathPattern=tests/unit'], {
+        JEST_JUNIT_OUTPUT_NAME: 'unit-test-results.xml',
+        COVERAGE_FILE: 'coverage/unit-coverage.json'
+    });
+    // 移动覆盖率文件
+    const coverageFile = path.join(COVERAGE_DIR, 'coverage-final.json');
+    if (fs.existsSync(coverageFile)) {
+        const unitCoverageFile = path.join(COVERAGE_DIR, 'unit-coverage-final.json');
+        fs.copyFileSync(coverageFile, unitCoverageFile);
+        console.log(`✅ 单元测试覆盖率已保存到：${unitCoverageFile}`);
+    }
+}
+function runAllTests() {
+    console.log('\n🧪 运行所有测试...\n');
+    // 运行所有测试 - 使用参数化方式
+    runJest(['--coverage'], {
+        JEST_JUNIT_OUTPUT_NAME: 'test-results.xml',
+        COVERAGE_FILE: 'coverage/all-coverage.json'
+    });
+    // 移动覆盖率文件
+    const coverageFile = path.join(COVERAGE_DIR, 'coverage-final.json');
+    if (fs.existsSync(coverageFile)) {
+        const allCoverageFile = path.join(COVERAGE_DIR, 'all-coverage-final.json');
+        fs.copyFileSync(coverageFile, allCoverageFile);
+        console.log(`✅ 所有测试覆盖率已保存到：${allCoverageFile}`);
+    }
+}
+function main() {
+    const args = process.argv.slice(2);
+    const testType = args[0] || 'all';
+    console.log('🚀 开始运行测试...\n');
+    try {
+        if (testType === 'unit') {
+            runUnitTests();
+        }
+        else if (testType === 'all') {
+            runAllTests();
+        }
+        else {
+            console.error(`❌ 未知的测试类型：${testType}`);
+            console.error('可用选项：unit, all');
+            process.exit(1);
+        }
+        console.log('\n✅ 测试完成！\n');
+    }
+    catch (error) {
+        console.error('\n❌ 测试失败！\n');
+        process.exit(1);
+    }
+}
+main();

package/dist/util/cookie.js

@@ -1,19 +1,27 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+const service_config_1 = __importDefault(require("../config/service-config"));
+const cookieResolver_1 = require("./cookieResolver");
 const SAFE_COOKIE_NAMES = new Set(['qqmusic_key', 'qqmusic_uin']);
 const cookieMiddleware = () => async (ctx, next) => {
-    if (global.userInfo?.cookie) {
-        // Extend Request interface if needed, or just cast
-        ctx.request.cookie = global.userInfo.cookie;
+    const { cookie } = (0, cookieResolver_1.resolveRequestCookie)(ctx, {
+        fallbackMode: service_config_1.default.fallbackMode,
+        useGlobalCookie: service_config_1.default.useGlobalCookie,
+        cookieParamName: service_config_1.default.cookieParamName
+    });
+    if (cookie) {
+        (0, cookieResolver_1.setRequestCookieContext)(ctx, cookie);
     }
-    if (Array.isArray(global.userInfo?.cookieList)) {
-        global.userInfo.cookieList.forEach((cookie) => {
-            const [key, ...valueParts] = cookie.split('=');
+    if (service_config_1.default.useGlobalCookie && Array.isArray(global.userInfo?.cookieList)) {
+        global.userInfo.cookieList.forEach((cookieItem) => {
+            const [key, ...valueParts] = cookieItem.split('=');
             const normalizedKey = key?.trim();
             const value = valueParts.join('=').trim();
             if (normalizedKey && value && SAFE_COOKIE_NAMES.has(normalizedKey)) {
                 ctx.cookies.set(normalizedKey, value, {
-                    // 仅同步前端业务必需且可公开的 Cookie，避免敏感登录态透传
                     overwrite: true,
                     httpOnly: false,
                     sameSite: 'lax'