@sansenjian/qq-music-api 2.2.9 → 2.3.1

package/public/playground-utils.js

@@ -0,0 +1,150 @@
+export const defaultBaseUrl = 'http://localhost:3200';
+
+const HTTP_PROTOCOLS = new Set(['http:', 'https:']);
+
+const getLocationOrigin = () => {
+  const location = globalThis.location;
+
+  if (location && HTTP_PROTOCOLS.has(location.protocol)) {
+    return location.origin;
+  }
+
+  return defaultBaseUrl;
+};
+
+export const getInitialBaseUrl = () => {
+  const location = globalThis.location;
+
+  if (location && HTTP_PROTOCOLS.has(location.protocol)) {
+    return location.origin;
+  }
+
+  return defaultBaseUrl;
+};
+
+export const normalizeBaseUrl = value => {
+  const trimmed = String(value || '').trim();
+
+  if (!trimmed) {
+    return defaultBaseUrl;
+  }
+
+  try {
+    const candidate = /^https?:\/\//i.test(trimmed)
+      ? trimmed
+      : `http://${trimmed.replace(/^\/+/, '')}`;
+    const parsed = new URL(candidate, getLocationOrigin());
+
+    if (!HTTP_PROTOCOLS.has(parsed.protocol)) {
+      return defaultBaseUrl;
+    }
+
+    return parsed.origin.replace(/\/+$/, '');
+  } catch {
+    return defaultBaseUrl;
+  }
+};
+
+export const normalizePath = value => {
+  const trimmed = String(value || '').trim();
+
+  if (!trimmed) {
+    return '/';
+  }
+
+  if (/^https?:\/\//i.test(trimmed)) {
+    try {
+      const url = new URL(trimmed);
+      return `${url.pathname}${url.search}${url.hash}` || '/';
+    } catch {
+      return '/';
+    }
+  }
+
+  return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+};
+
+export const normalizeQuery = value => String(value || '').trim().replace(/^\?/, '');
+
+export const buildRequestUrl = ({ baseUrl, path = '/', query = '' }) => {
+  const normalizedBase = normalizeBaseUrl(baseUrl);
+  const normalizedPath = normalizePath(path);
+  const normalizedQuery = normalizeQuery(query);
+
+  if (!normalizedQuery) {
+    return `${normalizedBase}${normalizedPath}`;
+  }
+
+  const separator = normalizedPath.includes('?') ? '&' : '?';
+  return `${normalizedBase}${normalizedPath}${separator}${normalizedQuery}`;
+};
+
+export const buildFetchOptions = ({ method = 'GET', cookie = '', body = '', signal } = {}) => {
+  const normalizedMethod = String(method || 'GET').toUpperCase();
+  const headers = {};
+  const trimmedCookie = String(cookie || '').trim();
+  const options = {
+    method: normalizedMethod,
+    headers
+  };
+
+  if (signal) {
+    options.signal = signal;
+  }
+
+  if (trimmedCookie) {
+    headers['X-Custom-Cookie'] = trimmedCookie;
+  }
+
+  if (normalizedMethod !== 'GET' && String(body || '').trim()) {
+    headers['Content-Type'] = 'application/json';
+    options.body = body;
+  }
+
+  return options;
+};
+
+export const formatResponseText = (text, fallbackText = '') => {
+  if (!text) {
+    return fallbackText;
+  }
+
+  try {
+    return JSON.stringify(JSON.parse(text), null, 2);
+  } catch {
+    return text || fallbackText;
+  }
+};
+
+export const formatBytes = bytes => {
+  if (!bytes) {
+    return '0 B';
+  }
+
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  }
+
+  return `${(bytes / 1024).toFixed(1)} KB`;
+};
+
+export const isAbortError = error => error instanceof DOMException && error.name === 'AbortError';
+
+export const getErrorMessage = error => error instanceof Error ? error.message : String(error);
+
+export const fetchPlaygroundRequest = async ({ url, options }) => {
+  const startedAt = performance.now();
+  const response = await fetch(url, options);
+  const rawText = await response.text();
+  const elapsedMs = Math.round(performance.now() - startedAt);
+  const statusText = `${response.status} ${response.statusText || 'OK'}`;
+
+  return {
+    elapsedMs,
+    formattedText: formatResponseText(rawText, statusText),
+    ok: response.ok,
+    rawText,
+    sizeBytes: new Blob([rawText]).size,
+    statusText
+  };
+};

package/dist/jest.config.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const config = {
-    preset: 'ts-jest',
-    testEnvironment: 'node',
-    testMatch: ['**/tests/**/*.test.ts'],
-    collectCoverageFrom: [
-        'module/**/*.ts',
-        'routers/**/*.ts',
-        'util/**/*.ts',
-        'middlewares/**/*.ts',
-        '!**/node_modules/**',
-        '!**/tests/**',
-        '!**/dist/**',
-        '!**/*.d.ts',
-        '!**/types/**/*.ts'
-    ],
-    coverageDirectory: 'coverage',
-    coverageReporters: ['text', 'lcov', 'html', 'json-summary', 'json'],
-    coveragePathIgnorePatterns: [
-        '/node_modules/',
-        '/tests/',
-        '/dist/',
-        '\\.d\\.ts$',
-        '/types/'
-    ],
-    coverageThreshold: {
-        global: {
-            branches: 35,
-            functions: 40,
-            lines: 50,
-            statements: 50
-        }
-    },
-    setupFilesAfterEnv: ['<rootDir>/tests/setup/jest.setup.ts'],
-    modulePathIgnorePatterns: ['<rootDir>/dist/'],
-    testTimeout: 10000,
-    verbose: true,
-    collectCoverage: true, // 默认开启覆盖率
-    coverageProvider: 'v8', // 使用 v8 引擎，更准确
-    moduleNameMapper: {
-        '^@module/(.*)$': '<rootDir>/module/$1',
-        '^@routers/(.*)$': '<rootDir>/routers/$1',
-        '^@util/(.*)$': '<rootDir>/util/$1'
-    },
-    transform: {
-        '^.+[.]ts$': ['ts-jest', {
-                tsconfig: 'tsconfig.test.json'
-            }]
-    }
-};
-exports.default = config;

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

@@ -1,139 +0,0 @@
-"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/types/api.js

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSuccessResponse = createSuccessResponse;
-exports.createErrorResponse = createErrorResponse;
-exports.handleApi = handleApi;
-/**
- * 成功响应创建器
- */
-function createSuccessResponse(data, status = 200) {
-    return {
-        status,
-        body: {
-            response: data,
-        },
-    };
-}
-/**
- * 错误响应创建器
- */
-function createErrorResponse(error, status = 500) {
-    return {
-        status,
-        body: {
-            error,
-        },
-    };
-}
-/**
- * API Promise 处理器 - 自动处理成功和错误情况
- */
-async function handleApi(promise, options) {
-    try {
-        const result = await promise;
-        const responseData = options?.transformData
-            ? options.transformData(result.data || result)
-            : result.data || result;
-        return {
-            status: options?.customStatus || 200,
-            body: {
-                response: responseData,
-            },
-        };
-    }
-    catch (error) {
-        if (options?.logError !== false) {
-            console.log('API error:', error);
-        }
-        return {
-            status: options?.customStatus || 500,
-            body: {
-                error,
-            },
-        };
-    }
-}

package/docs-dist/assets/CHANGELOG-ARCHITECTURE.md.r40JGJZK.lean.js

@@ -1 +0,0 @@
-import{_ as i,o as a,c as n,ag as h}from"./chunks/framework.aJbMEiY9.js";const y=JSON.parse('{"title":"代码架构优化说明","description":"","frontmatter":{},"headers":[],"relativePath":"CHANGELOG-ARCHITECTURE.md","filePath":"CHANGELOG-ARCHITECTURE.md","lastUpdated":1773499772000}'),l={name:"CHANGELOG-ARCHITECTURE.md"};function k(t,s,p,e,r,d){return a(),n("div",null,[...s[0]||(s[0]=[h("",38)])])}const o=i(l,[["render",k]]);export{y as __pageData,o as default};

package/docs-dist/assets/COOKIE_CONFIG_GUIDE.md.BVXl7WHu.js

@@ -1,13 +0,0 @@
-import{_ as s,o as a,c as e,ag as l}from"./chunks/framework.aJbMEiY9.js";const c=JSON.parse('{"title":"Cookie 配置指南","description":"","frontmatter":{},"headers":[],"relativePath":"COOKIE_CONFIG_GUIDE.md","filePath":"COOKIE_CONFIG_GUIDE.md","lastUpdated":1773499772000}'),t={name:"COOKIE_CONFIG_GUIDE.md"};function o(n,i,h,r,p,k){return a(),e("div",null,[...i[0]||(i[0]=[l(`<h1 id="cookie-配置指南" tabindex="-1">Cookie 配置指南 <a class="header-anchor" href="#cookie-配置指南" aria-label="Permalink to &quot;Cookie 配置指南&quot;">​</a></h1><h2 id="为什么需要配置-cookie" tabindex="-1">为什么需要配置 Cookie？ <a class="header-anchor" href="#为什么需要配置-cookie" aria-label="Permalink to &quot;为什么需要配置 Cookie？&quot;">​</a></h2><p>QQ 音乐的许多接口（如获取用户信息、用户歌单、播放历史等）需要用户登录状态才能访问。Cookie 包含了你的登录凭证，配置后 API 才能代表你请求这些数据。</p><h2 id="配置步骤" tabindex="-1">配置步骤 <a class="header-anchor" href="#配置步骤" aria-label="Permalink to &quot;配置步骤&quot;">​</a></h2><h3 id="_1-登录-qq-音乐" tabindex="-1">1. 登录 QQ 音乐 <a class="header-anchor" href="#_1-登录-qq-音乐" aria-label="Permalink to &quot;1. 登录 QQ 音乐&quot;">​</a></h3><p>访问 <a href="https://y.qq.com" target="_blank" rel="noreferrer">https://y.qq.com</a> 并登录你的 QQ 账号。</p><h3 id="_2-获取-cookie" tabindex="-1">2. 获取 Cookie <a class="header-anchor" href="#_2-获取-cookie" aria-label="Permalink to &quot;2. 获取 Cookie&quot;">​</a></h3><h4 id="chrome-edge-浏览器" tabindex="-1">Chrome/Edge 浏览器： <a class="header-anchor" href="#chrome-edge-浏览器" aria-label="Permalink to &quot;Chrome/Edge 浏览器：&quot;">​</a></h4><ol><li>按 <code>F12</code> 打开开发者工具</li><li>点击 <strong>Network（网络）</strong> 标签</li><li>刷新页面（<code>F5</code> 或 <code>Ctrl+R</code>）</li><li>在左侧请求列表中选择第一个请求（通常是 <code>y.qq.com</code>）</li><li>在右侧找到 <strong>Request Headers（请求标头）</strong></li><li>滚动找到 <strong>Cookie</strong> 字段</li><li>复制整个 Cookie 值（从 <code>uin=</code> 开始到最后一个字段）</li></ol><h4 id="firefox-浏览器" tabindex="-1">Firefox 浏览器： <a class="header-anchor" href="#firefox-浏览器" aria-label="Permalink to &quot;Firefox 浏览器：&quot;">​</a></h4><ol><li>按 <code>F12</code> 打开开发者工具</li><li>点击 <strong>Network（网络）</strong> 标签</li><li>刷新页面</li><li>选择第一个请求</li><li>在 <strong>Request Headers</strong> 中找到 <strong>Cookie</strong></li><li>复制整个值</li></ol><h3 id="_3-获取你的-qq-号" tabindex="-1">3. 获取你的 QQ 号 <a class="header-anchor" href="#_3-获取你的-qq-号" aria-label="Permalink to &quot;3. 获取你的 QQ 号&quot;">​</a></h3><p>有几种方法可以获取：</p><p><strong>方法 1</strong>: 从 Cookie 中提取</p><ul><li>Cookie 中的 <code>uin=</code> 后面的数字就是你的 QQ 号（去掉开头的 0）</li><li>例如：<code>uin=o0123456789</code> → QQ 号是 <code>123456789</code></li></ul><p><strong>方法 2</strong>: 从个人主页 URL 获取</p><ul><li>点击头像进入个人主页</li><li>URL 格式：<code>https://y.qq.com/portal/profile.html?uin=123456789</code></li><li><code>uin=</code> 后面的数字就是</li></ul><p><strong>方法 3</strong>: 在控制台查看</p><ul><li>按 <code>F12</code> 打开开发者工具</li><li>进入 <strong>Console（控制台）</strong> 标签</li><li>输入 <code>window.user</code> 并回车</li><li>查看返回的对象中的 <code>uin</code> 字段</li></ul><h3 id="_4-编辑配置文件" tabindex="-1">4. 编辑配置文件 <a class="header-anchor" href="#_4-编辑配置文件" aria-label="Permalink to &quot;4. 编辑配置文件&quot;">​</a></h3><p>打开项目中的 <code>config/user-info.json</code> 文件，填入你的信息：</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">{</span></span>
-<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">loginUin</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">123456789</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
-<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">cookie</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">uin=o0123456789; qqmusic_key=abcdef123456; qqmusic_uin=123456789; ...</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
-<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">uin</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">123456789</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span>
-<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">}</span></span></code></pre></div><p><strong>字段说明</strong>：</p><ul><li><code>loginUin</code>: 你的 QQ 号</li><li><code>cookie</code>: 完整的 Cookie 字符串（从浏览器复制的）</li><li><code>uin</code>: 你的 QQ 号（可以和 loginUin 相同）</li></ul><h3 id="_5-重启服务" tabindex="-1">5. 重启服务 <a class="header-anchor" href="#_5-重启服务" aria-label="Permalink to &quot;5. 重启服务&quot;">​</a></h3><p>配置完成后，需要重启 Node.js 服务使配置生效：</p><ol><li>停止当前运行的服务（<code>Ctrl+C</code>）</li><li>重新启动：<code>npm run dev</code></li></ol><h2 id="验证配置" tabindex="-1">验证配置 <a class="header-anchor" href="#验证配置" aria-label="Permalink to &quot;验证配置&quot;">​</a></h2><p>配置完成后，可以通过以下方式验证：</p><h3 id="方法-1-访问首页" tabindex="-1">方法 1: 访问首页 <a class="header-anchor" href="#方法-1-访问首页" aria-label="Permalink to &quot;方法 1: 访问首页&quot;">​</a></h3><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span>http://localhost:3200</span></span></code></pre></div><p>如果配置成功，页面应该正常显示，不会提示 Cookie 未配置。</p><h3 id="方法-2-测试用户接口" tabindex="-1">方法 2: 测试用户接口 <a class="header-anchor" href="#方法-2-测试用户接口" aria-label="Permalink to &quot;方法 2: 测试用户接口&quot;">​</a></h3><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span>http://localhost:3200/user/getCookie</span></span></code></pre></div><p>如果配置成功，会返回你配置的 Cookie 信息。</p><h3 id="方法-3-测试用户歌单" tabindex="-1">方法 3: 测试用户歌单 <a class="header-anchor" href="#方法-3-测试用户歌单" aria-label="Permalink to &quot;方法 3: 测试用户歌单&quot;">​</a></h3><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span>http://localhost:3200/user/getUserPlaylists?uin=你的 QQ 号</span></span></code></pre></div><p>如果配置成功，会返回你的歌单列表。</p><h2 id="常见问题" tabindex="-1">常见问题 <a class="header-anchor" href="#常见问题" aria-label="Permalink to &quot;常见问题&quot;">​</a></h2><h3 id="q-cookie-有效期多久" tabindex="-1">Q: Cookie 有效期多久？ <a class="header-anchor" href="#q-cookie-有效期多久" aria-label="Permalink to &quot;Q: Cookie 有效期多久？&quot;">​</a></h3><p><strong>A</strong>: Cookie 通常有较长的有效期（几天到几周不等），但如果发现接口返回 404 或权限错误，可能是 Cookie 过期了，需要重新获取。</p><h3 id="q-配置后还是返回-404" tabindex="-1">Q: 配置后还是返回 404？ <a class="header-anchor" href="#q-配置后还是返回-404" aria-label="Permalink to &quot;Q: 配置后还是返回 404？&quot;">​</a></h3><p><strong>A</strong>: 可能的原因：</p><ol><li>Cookie 已过期，需要重新获取</li><li>Cookie 格式不正确，确保完整复制</li><li>QQ 音乐 API 接口已更新</li><li>服务未重启，配置未生效</li></ol><h3 id="q-安全吗-会泄露我的账号吗" tabindex="-1">Q: 安全吗？会泄露我的账号吗？ <a class="header-anchor" href="#q-安全吗-会泄露我的账号吗" aria-label="Permalink to &quot;Q: 安全吗？会泄露我的账号吗？&quot;">​</a></h3><p><strong>A</strong>:</p><ul><li>Cookie 只存储在本地 <code>config/user-info.json</code> 文件中</li><li>这个文件已经在 <code>.gitignore</code> 中，不会被提交到 Git</li><li>不要将 <code>config/user-info.json</code> 分享给他人</li><li>如果担心，可以定期更换 Cookie</li></ul><h3 id="q-可以配置多个账号吗" tabindex="-1">Q: 可以配置多个账号吗？ <a class="header-anchor" href="#q-可以配置多个账号吗" aria-label="Permalink to &quot;Q: 可以配置多个账号吗？&quot;">​</a></h3><p><strong>A</strong>: 当前版本只支持单个账号配置。如需切换账号，修改 <code>config/user-info.json</code> 中的值并重启服务即可。</p><h2 id="示例配置" tabindex="-1">示例配置 <a class="header-anchor" href="#示例配置" aria-label="Permalink to &quot;示例配置&quot;">​</a></h2><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">{</span></span>
-<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">loginUin</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">123456789</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
-<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">cookie</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">uin=o0123456789; qqmusic_key=xxxxxxxxxx; qqmusic_uin=123456789; qqmusic_fromstatus=1; _qpsvr_localtk=xxxxxx</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
-<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">uin</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">123456789</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span>
-<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">}</span></span></code></pre></div><h2 id="注意事项" tabindex="-1">注意事项 <a class="header-anchor" href="#注意事项" aria-label="Permalink to &quot;注意事项&quot;">​</a></h2><ol><li><strong>不要提交到 Git</strong>: <code>config/user-info.json</code> 已添加到 <code>.gitignore</code>，请勿手动移除</li><li><strong>定期更新</strong>: 如果发现接口异常，尝试更新 Cookie</li><li><strong>备份</strong>: 建议备份你的 Cookie，方便下次使用</li><li><strong>隐私</strong>: 不要公开分享你的 Cookie</li></ol><h2 id="快速测试" tabindex="-1">快速测试 <a class="header-anchor" href="#快速测试" aria-label="Permalink to &quot;快速测试&quot;">​</a></h2><p>配置完成后，运行以下命令测试：</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#A0ADA0;--shiki-dark:#758575DD;"># 测试 Cookie 是否配置成功</span></span>
-<span class="line"><span style="--shiki-light:#59873A;--shiki-dark:#80A665;">curl</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">http://localhost:3200/user/getCookie</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span>
-<span class="line"></span>
-<span class="line"><span style="--shiki-light:#A0ADA0;--shiki-dark:#758575DD;"># 测试获取用户歌单</span></span>
-<span class="line"><span style="--shiki-light:#59873A;--shiki-dark:#80A665;">curl</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">http://localhost:3200/user/getUserPlaylists?uin=你的 QQ 号</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span></code></pre></div><p>如果返回 JSON 数据而不是错误信息，说明配置成功！</p>`,57)])])}const g=s(t,[["render",o]]);export{c as __pageData,g as default};

package/docs-dist/assets/COOKIE_CONFIG_GUIDE.md.BVXl7WHu.lean.js

@@ -1 +0,0 @@
-import{_ as s,o as a,c as e,ag as l}from"./chunks/framework.aJbMEiY9.js";const c=JSON.parse('{"title":"Cookie 配置指南","description":"","frontmatter":{},"headers":[],"relativePath":"COOKIE_CONFIG_GUIDE.md","filePath":"COOKIE_CONFIG_GUIDE.md","lastUpdated":1773499772000}'),t={name:"COOKIE_CONFIG_GUIDE.md"};function o(n,i,h,r,p,k){return a(),e("div",null,[...i[0]||(i[0]=[l("",57)])])}const g=s(t,[["render",o]]);export{c as __pageData,g as default};

package/docs-dist/assets/FALLBACK_MODE_GUIDE.md.BBdcIdh_.lean.js

@@ -1 +0,0 @@
-import{_ as i,o as a,c as n,ag as e}from"./chunks/framework.aJbMEiY9.js";const c=JSON.parse('{"title":"降级服务使用指南","description":"","frontmatter":{},"headers":[],"relativePath":"FALLBACK_MODE_GUIDE.md","filePath":"FALLBACK_MODE_GUIDE.md","lastUpdated":1773499772000}'),l={name:"FALLBACK_MODE_GUIDE.md"};function t(h,s,p,k,o,r){return a(),n("div",null,[...s[0]||(s[0]=[e("",62)])])}const g=i(l,[["render",t]]);export{c as __pageData,g as default};