add: 向浏览器和操作系统报告音频元数据

- Replace all console.log/error/warn statements with appropriate debug instances
- Add debug utils with modular debug instances for different components
- Use debugUI for UI components (pages and components)
- Use debugStore for store files
- Use debugUtils for utility functions
- Use debugPlayroom for Playroom specific debugging
- Use debugLyrics for lyrics-related debugging
- Use debugVisualizer for audio visualization debugging
- Use debugResource for resource checking debugging
- Maintain original message content with Chinese descriptions
- Preserve Tab indentation throughout all files

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

.env.example

@@ -0,0 +1,14 @@
+# Debug Configuration
+# Set DEBUG environment variable to control debug output
+# Examples:
+#   DEBUG=msr:*           # Enable all MSR debug output
+#   DEBUG=msr:player      # Enable only player debug
+#   DEBUG=msr:store,msr:api  # Enable store and API debug
+#   DEBUG=*               # Enable all debug output (including libraries)
+#   DEBUG=                # Disable all debug output
+
+# Development (default: enable all msr:* debug)
+VITE_DEBUG=msr:*
+
+# Production (default: disabled)
+# VITE_DEBUG=

package-lock.json

@@ -21,9 +21,11 @@
 			"devDependencies": {
 				"@biomejs/biome": "1.9.4",
 				"@types/chrome": "^0.0.323",
+				"@types/debug": "^4.1.12",
 				"@types/node": "^22.15.21",
 				"@types/webextension-polyfill": "^0.12.3",
 				"@vitejs/plugin-vue": "^5.2.1",
+				"debug": "^4.4.1",
 				"typescript": "~5.6.2",
 				"vite": "^6.0.1",
 				"vue-tsc": "^2.1.10"
@@ -1245,6 +1247,16 @@
 				"@types/har-format": "*"
 			}
 		},
+		"node_modules/@types/debug": {
+			"version": "4.1.12",
+			"resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.12.tgz",
+			"integrity": "sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"@types/ms": "*"
+			}
+		},
 		"node_modules/@types/estree": {
 			"version": "1.0.7",
 			"resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.7.tgz",
@@ -1275,6 +1287,13 @@
 			"dev": true,
 			"license": "MIT"
 		},
+		"node_modules/@types/ms": {
+			"version": "2.1.0",
+			"resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz",
+			"integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==",
+			"dev": true,
+			"license": "MIT"
+		},
 		"node_modules/@types/node": {
 			"version": "22.15.21",
 			"resolved": "https://registry.npmjs.org/@types/node/-/node-22.15.21.tgz",
@@ -1613,6 +1632,24 @@
 			"dev": true,
 			"license": "MIT"
 		},
+		"node_modules/debug": {
+			"version": "4.4.1",
+			"resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz",
+			"integrity": "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"ms": "^2.1.3"
+			},
+			"engines": {
+				"node": ">=6.0"
+			},
+			"peerDependenciesMeta": {
+				"supports-color": {
+					"optional": true
+				}
+			}
+		},
 		"node_modules/delayed-stream": {
 			"version": "1.0.0",
 			"resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
@@ -2295,6 +2332,13 @@
 				"url": "https://github.com/sponsors/isaacs"
 			}
 		},
+		"node_modules/ms": {
+			"version": "2.1.3",
+			"resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+			"integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+			"dev": true,
+			"license": "MIT"
+		},
 		"node_modules/muggle-string": {
 			"version": "0.4.1",
 			"resolved": "https://registry.npmjs.org/muggle-string/-/muggle-string-0.4.1.tgz",

package.json

@@ -33,9 +33,11 @@
 	"devDependencies": {
 		"@biomejs/biome": "1.9.4",
 		"@types/chrome": "^0.0.323",
+		"@types/debug": "^4.1.12",
 		"@types/node": "^22.15.21",
 		"@types/webextension-polyfill": "^0.12.3",
 		"@vitejs/plugin-vue": "^5.2.1",
+		"debug": "^4.4.1",
 		"typescript": "~5.6.2",
 		"vite": "^6.0.1",
 		"vue-tsc": "^2.1.10"

public/background.js

@@ -1,7 +1,7 @@
-console.log("aaaa")
+console.log('aaaa')
 
 // 兼容 Chrome 和 Firefox
-const browserAPI = typeof browser !== 'undefined' ? browser : chrome;
+const browserAPI = typeof browser !== 'undefined' ? browser : chrome
 
 browserAPI.webRequest.onBeforeRequest.addListener(
 	async (details) => {
@@ -16,12 +16,18 @@ browserAPI.webRequest.onBeforeRequest.addListener(
 		console.log('recived request for fontset api, redirecting to index.html')
 		const pref = await browserAPI.storage.sync.get('preferences')
 
-		if (pref === undefined || pref.preferences === undefined || pref.preferences.autoRedirect === undefined || pref.preferences.autoRedirect === true) {
+		if (
-			const isChrome = typeof browserAPI.runtime.getBrowserInfo === 'undefined';
+			pref === undefined ||
+			pref.preferences === undefined ||
+			pref.preferences.autoRedirect === undefined ||
+			pref.preferences.autoRedirect === true
+		) {
+			const isChrome = typeof browserAPI.runtime.getBrowserInfo === 'undefined'
 
 			if (isChrome) {
 				if (
-					details.url === 'https://monster-siren.hypergryph.com/manifest.json' &&
+					details.url ===
+						'https://monster-siren.hypergryph.com/manifest.json' &&
 					details.type === 'other' &&
 					details.frameId === 0
 				) {
@@ -32,15 +38,22 @@ browserAPI.webRequest.onBeforeRequest.addListener(
 				}
 			} else {
 				// Firefox: 直接在当前标签页导航
-				browserAPI.tabs.update(details.tabId, { url: browserAPI.runtime.getURL('index.html') })
+				browserAPI.tabs.update(details.tabId, {
+					url: browserAPI.runtime.getURL('index.html'),
+				})
 			}
 		}
 	},
-	{ urls: ['https://monster-siren.hypergryph.com/api/fontset', 'https://monster-siren.hypergryph.com/manifest.json'] },
+	{
+		urls: [
+			'https://monster-siren.hypergryph.com/api/fontset',
+			'https://monster-siren.hypergryph.com/manifest.json',
+		],
+	},
 )
 
 // 兼容新旧版本的 API
-const actionAPI = browserAPI.action || browserAPI.browserAction;
+const actionAPI = browserAPI.action || browserAPI.browserAction
 if (actionAPI) {
 	actionAPI.onClicked.addListener(() => {
 		browserAPI.tabs.create({ url: browserAPI.runtime.getURL('index.html') })

public/manifest.json

@@ -5,12 +5,8 @@
 	"description": "塞壬唱片（Monster Siren Records）官网的替代前端。",
 	"content_scripts": [
 		{
-			"matches": [
+			"matches": ["https://monster-siren.hypergryph.com/"],
-				"https://monster-siren.hypergryph.com/"
+			"js": ["content.js"],
-			],
-			"js": [
-				"content.js"
-			],
 			"run_at": "document_end"
 		}
 	],
@@ -36,11 +32,7 @@
 	"background": {
 		"service_worker": "background.js"
 	},
-	"permissions": [
+	"permissions": ["tabs", "webRequest", "storage"],
-		"tabs",
-		"webRequest",
-		"storage"
-	],
 	"content_security_policy": {
 		"extension_pages": "default-src 'self'; script-src 'self' http://localhost:5173; style-src 'self' 'unsafe-inline'; connect-src 'self' ws://localhost:5173 https://monster-siren.hypergryph.com https://web.hycdn.cn https://res01.hycdn.cn; img-src 'self' https://web.hycdn.cn; media-src 'self' https://res01.hycdn.cn;",
 		"sandbox": "sandbox"

scripts/prebuild-chrome.js

@@ -1,61 +1,65 @@
-import fs from 'fs';
+import fs from 'fs'
-import path from 'path';
+import path from 'path'
-import { fileURLToPath } from 'url';
+import { fileURLToPath } from 'url'
 
-const __filename = fileURLToPath(import.meta.url);
+const __filename = fileURLToPath(import.meta.url)
-const __dirname = path.dirname(__filename);
+const __dirname = path.dirname(__filename)
 
 // 处理 manifest.json
 function processManifest() {
-  const manifestPath = path.join(__dirname, '../public/manifest.json');
+	const manifestPath = path.join(__dirname, '../public/manifest.json')
-  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+	const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'))
 
 	// 移除本地调试相关的配置
 	if (manifest.host_permissions) {
 		manifest.host_permissions = manifest.host_permissions.filter(
-      permission => !permission.includes('localhost')
+			(permission) => !permission.includes('localhost'),
-    );
+		)
 	}
 
-  if (manifest.content_security_policy && manifest.content_security_policy.extension_pages) {
+	if (
+		manifest.content_security_policy &&
+		manifest.content_security_policy.extension_pages
+	) {
 		// 移除 CSP 中的本地开发相关配置
-    manifest.content_security_policy.extension_pages = manifest.content_security_policy.extension_pages
+		manifest.content_security_policy.extension_pages =
+			manifest.content_security_policy.extension_pages
 				.replace(/script-src 'self' http:\/\/localhost:5173;\s*/g, '')
 				.replace(/\s*http:\/\/localhost:5173\s*/g, ' ')
 				.replace(/\s*ws:\/\/localhost:5173\s*/g, ' ')
 				.replace(/;\s+/g, '; ') // 标准化分号后的空格
 				.replace(/\s+/g, ' ') // 合并多个空格为一个
-      .trim();
+				.trim()
 	}
 
-  fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+	fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2))
-  console.log('✅ Manifest.json processed');
+	console.log('✅ Manifest.json processed')
 }
 
 // 处理 index.html
 function processIndexHtml() {
-  const indexPath = path.join(__dirname, '../index.html');
+	const indexPath = path.join(__dirname, '../index.html')
-  let content = fs.readFileSync(indexPath, 'utf8');
+	let content = fs.readFileSync(indexPath, 'utf8')
 
 	// 替换脚本地址
 	content = content.replace(
 		/src="[^"]*\/src\/main\.ts"/g,
-    'src="./src/main.ts"'
+		'src="./src/main.ts"',
-  );
+	)
 
 	// 移除 crossorigin 属性
-  content = content.replace(/\s+crossorigin/g, '');
+	content = content.replace(/\s+crossorigin/g, '')
 
-  fs.writeFileSync(indexPath, content);
+	fs.writeFileSync(indexPath, content)
-  console.log('✅ Index.html processed');
+	console.log('✅ Index.html processed')
 }
 
 // 执行处理
 try {
-  processManifest();
+	processManifest()
-  processIndexHtml();
+	processIndexHtml()
-  console.log('🎉 Build preparation completed!');
+	console.log('🎉 Build preparation completed!')
 } catch (error) {
-  console.error('❌ Error during build preparation:', error);
+	console.error('❌ Error during build preparation:', error)
-  process.exit(1);
+	process.exit(1)
 }

scripts/prebuild-firefox.js

@@ -1,42 +1,49 @@
-import fs from 'fs';
+import fs from 'fs'
-import path from 'path';
+import path from 'path'
-import { fileURLToPath } from 'url';
+import { fileURLToPath } from 'url'
 
-const __filename = fileURLToPath(import.meta.url);
+const __filename = fileURLToPath(import.meta.url)
-const __dirname = path.dirname(__filename);
+const __dirname = path.dirname(__filename)
 
 // 处理 manifest.json
 function processManifest() {
-  const manifestPath = path.join(__dirname, '../public/manifest.json');
+	const manifestPath = path.join(__dirname, '../public/manifest.json')
-  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+	const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'))
 
 	// 移除本地调试相关的配置
 	if (manifest.host_permissions) {
 		manifest.host_permissions = manifest.host_permissions.filter(
-      permission => !permission.includes('localhost')
+			(permission) => !permission.includes('localhost'),
-    );
+		)
 	}
 
-  if (manifest.content_security_policy && manifest.content_security_policy.extension_pages) {
+	if (
+		manifest.content_security_policy &&
+		manifest.content_security_policy.extension_pages
+	) {
 		// 移除 CSP 中的本地开发相关配置
-    manifest.content_security_policy.extension_pages = manifest.content_security_policy.extension_pages
+		manifest.content_security_policy.extension_pages =
+			manifest.content_security_policy.extension_pages
 				.replace(/script-src 'self' http:\/\/localhost:5173;\s*/g, '')
 				.replace(/\s*http:\/\/localhost:5173\s*/g, ' ')
 				.replace(/\s*ws:\/\/localhost:5173\s*/g, ' ')
 				.replace(/;\s+/g, '; ') // 标准化分号后的空格
 				.replace(/\s+/g, ' ') // 合并多个空格为一个
-      .trim();
+				.trim()
 	}
 
 	// 移除 CSP 中的 sandbox 配置（Firefox 不支持）
-  if (manifest.content_security_policy && manifest.content_security_policy.sandbox) {
+	if (
-    delete manifest.content_security_policy.sandbox;
+		manifest.content_security_policy &&
+		manifest.content_security_policy.sandbox
+	) {
+		delete manifest.content_security_policy.sandbox
 	}
 
 	// 移除 background.service_worker，替换为 background.scripts
 	if (manifest.background && manifest.background.service_worker) {
-    manifest.background.scripts = [manifest.background.service_worker];
+		manifest.background.scripts = [manifest.background.service_worker]
-    delete manifest.background.service_worker;
+		delete manifest.background.service_worker
 	}
 
 	// 添加 firefox 特有配置
@@ -44,37 +51,37 @@ function processManifest() {
 		gecko: {
 			id: 'msr-mod@firefox-addon.astrian.moe',
 			strict_min_version: '115.0',
+		},
 	}
-  };
 
-  fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+	fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2))
-  console.log('✅ Manifest.json processed');
+	console.log('✅ Manifest.json processed')
 }
 
 // 处理 index.html
 function processIndexHtml() {
-  const indexPath = path.join(__dirname, '../index.html');
+	const indexPath = path.join(__dirname, '../index.html')
-  let content = fs.readFileSync(indexPath, 'utf8');
+	let content = fs.readFileSync(indexPath, 'utf8')
 
 	// 替换脚本地址
 	content = content.replace(
 		/src="[^"]*\/src\/main\.ts"/g,
-    'src="./src/main.ts"'
+		'src="./src/main.ts"',
-  );
+	)
 
 	// 移除 crossorigin 属性
-  content = content.replace(/\s+crossorigin/g, '');
+	content = content.replace(/\s+crossorigin/g, '')
 
-  fs.writeFileSync(indexPath, content);
+	fs.writeFileSync(indexPath, content)
-  console.log('✅ Index.html processed');
+	console.log('✅ Index.html processed')
 }
 
 // 执行处理
 try {
-  processManifest();
+	processManifest()
-  processIndexHtml();
+	processIndexHtml()
-  console.log('🎉 Build preparation completed!');
+	console.log('🎉 Build preparation completed!')
 } catch (error) {
-  console.error('❌ Error during build preparation:', error);
+	console.error('❌ Error during build preparation:', error)
-  process.exit(1);
+	process.exit(1)
 }

scripts/prebuild-safari.js

@@ -1,39 +1,43 @@
-import fs from 'fs';
+import fs from 'fs'
-import path from 'path';
+import path from 'path'
-import { fileURLToPath } from 'url';
+import { fileURLToPath } from 'url'
 
-const __filename = fileURLToPath(import.meta.url);
+const __filename = fileURLToPath(import.meta.url)
-const __dirname = path.dirname(__filename);
+const __dirname = path.dirname(__filename)
 
 // 处理 manifest.json for Safari
 function processManifest() {
-  const manifestPath = path.join(__dirname, '../public/manifest.json');
+	const manifestPath = path.join(__dirname, '../public/manifest.json')
-  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+	const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'))
 
 	// 移除本地调试相关的配置
 	if (manifest.host_permissions) {
 		manifest.host_permissions = manifest.host_permissions.filter(
-      permission => !permission.includes('localhost')
+			(permission) => !permission.includes('localhost'),
-    );
+		)
 	}
 
-  if (manifest.content_security_policy && manifest.content_security_policy.extension_pages) {
+	if (
+		manifest.content_security_policy &&
+		manifest.content_security_policy.extension_pages
+	) {
 		// 移除 CSP 中的本地开发相关配置
-    manifest.content_security_policy.extension_pages = manifest.content_security_policy.extension_pages
+		manifest.content_security_policy.extension_pages =
+			manifest.content_security_policy.extension_pages
 				.replace(/script-src 'self' http:\/\/localhost:5173;\s*/g, '')
 				.replace(/\s*http:\/\/localhost:5173\s*/g, ' ')
 				.replace(/\s*ws:\/\/localhost:5173\s*/g, ' ')
 				.replace(/;\s+/g, '; ') // 标准化分号后的空格
 				.replace(/\s+/g, ' ') // 合并多个空格为一个
-      .trim();
+				.trim()
 	}
 
 	// Safari 特殊处理：添加 appShell.html 到 content scripts 匹配
 	if (manifest.content_scripts && manifest.content_scripts[0]) {
 		// 添加 appShell.html 的匹配规则
-    const existingMatches = manifest.content_scripts[0].matches;
+		const existingMatches = manifest.content_scripts[0].matches
-    if (!existingMatches.includes("https://monster-siren.hypergryph.com/")) {
+		if (!existingMatches.includes('https://monster-siren.hypergryph.com/')) {
-      existingMatches.push("https://monster-siren.hypergryph.com/");
+			existingMatches.push('https://monster-siren.hypergryph.com/')
 		}
 	}
 
@@ -42,13 +46,13 @@ function processManifest() {
 		// Safari 扩展在 Manifest V3 中必须使用 persistent: false
 		// 但为了调试，我们暂时设为 true 来确保页面加载
 		manifest.background = {
-      page: "background.html",
+			page: 'background.html',
-      persistent: true
+			persistent: true,
-    };
+		}
 	}
 
 	// 创建 background.html 文件用于 Safari
-  const backgroundHtmlPath = path.join(__dirname, '../public/background.html');
+	const backgroundHtmlPath = path.join(__dirname, '../public/background.html')
 	const backgroundHtmlContent = `<!DOCTYPE html>
 <html>
 <head>
@@ -102,16 +106,16 @@ function processManifest() {
     log('=== After background.js script tag ===');
   </script>
 </body>
-</html>`;
+</html>`
-  fs.writeFileSync(backgroundHtmlPath, backgroundHtmlContent);
+	fs.writeFileSync(backgroundHtmlPath, backgroundHtmlContent)
 
 	// 创建 Safari 兼容的 background.js
-  const backgroundJsPath = path.join(__dirname, '../public/background.js');
+	const backgroundJsPath = path.join(__dirname, '../public/background.js')
-  let backgroundJsContent = fs.readFileSync(backgroundJsPath, 'utf8');
+	let backgroundJsContent = fs.readFileSync(backgroundJsPath, 'utf8')
 
 	// 检查是否已经添加过 Safari 代码，避免重复
 	if (backgroundJsContent.includes('=== Safari background.js starting ===')) {
-    console.log('Safari background.js already processed, skipping...');
+		console.log('Safari background.js already processed, skipping...')
 	} else {
 		// 在开头添加 Safari 调试信息（只添加一次）
 		const safariDebugCode = `
@@ -168,38 +172,40 @@ if (typeof chrome !== 'undefined' && chrome.runtime && chrome.runtime.onMessage)
   });
 }
 
-`;
+`
 
 		// 替换 Safari 的重定向 URL 监听
 		backgroundJsContent = backgroundJsContent.replace(
 			/{ urls: \['https:\/\/monster-siren\.hypergryph\.com\/api\/fontset', 'https:\/\/monster-siren\.hypergryph\.com\/manifest\.json'\] }/g,
-      "{ urls: ['https://monster-siren.hypergryph.com/api/fontset', 'https://monster-siren.hypergryph.com/manifest.json', 'https://monster-siren.hypergryph.com/'] }"
+			"{ urls: ['https://monster-siren.hypergryph.com/api/fontset', 'https://monster-siren.hypergryph.com/manifest.json', 'https://monster-siren.hypergryph.com/'] }",
-    );
+		)
 
 		// 替换 Safari 的重定向判断逻辑
 		backgroundJsContent = backgroundJsContent.replace(
 			/details\.url === 'https:\/\/monster-siren\.hypergryph\.com\/manifest\.json'/g,
-      "(details.url === 'https://monster-siren.hypergryph.com/manifest.json' || details.url === 'https://monster-siren.hypergryph.com/')"
+			"(details.url === 'https://monster-siren.hypergryph.com/manifest.json' || details.url === 'https://monster-siren.hypergryph.com/')",
-    );
+		)
 
 		// 清理可能的重复条件
 		backgroundJsContent = backgroundJsContent.replace(
 			/\(\(details\.url === 'https:\/\/monster-siren\.hypergryph\.com\/manifest\.json' \|\| details\.url === 'https:\/\/monster-siren\.hypergryph\.com\/'\) \|\| details\.url === 'https:\/\/monster-siren\.hypergryph\.com\/'\)/g,
-      "(details.url === 'https://monster-siren.hypergryph.com/manifest.json' || details.url === 'https://monster-siren.hypergryph.com/')"
+			"(details.url === 'https://monster-siren.hypergryph.com/manifest.json' || details.url === 'https://monster-siren.hypergryph.com/')",
-    );
+		)
 
-    backgroundJsContent = safariDebugCode + backgroundJsContent;
+		backgroundJsContent = safariDebugCode + backgroundJsContent
 	}
-  fs.writeFileSync(backgroundJsPath, backgroundJsContent);
+	fs.writeFileSync(backgroundJsPath, backgroundJsContent)
-  console.log('✅ Safari-compatible background.js created');
+	console.log('✅ Safari-compatible background.js created')
 
 	// 创建 Safari 专用的 content.js
-  const contentJsPath = path.join(__dirname, '../public/content.js');
+	const contentJsPath = path.join(__dirname, '../public/content.js')
 
 	// 检查是否已经处理过 content.js
-  const existingContentJs = fs.existsSync(contentJsPath) ? fs.readFileSync(contentJsPath, 'utf8') : '';
+	const existingContentJs = fs.existsSync(contentJsPath)
+		? fs.readFileSync(contentJsPath, 'utf8')
+		: ''
 	if (existingContentJs.includes('checkRedirectPreference')) {
-    console.log('Safari content.js already processed, skipping...');
+		console.log('Safari content.js already processed, skipping...')
 	} else {
 		const contentJsContent = `
 // Safari 扩展 content script for redirect
@@ -307,53 +313,53 @@ async function main() {
 main().catch(error => {
   console.error('Error in main function:', error);
 });
-`;
+`
 
-    fs.writeFileSync(contentJsPath, contentJsContent);
+		fs.writeFileSync(contentJsPath, contentJsContent)
 	}
-  console.log('✅ Safari-compatible content.js created');
+	console.log('✅ Safari-compatible content.js created')
 
 	// Safari 可能需要额外的权限
 	if (!manifest.permissions.includes('activeTab')) {
-    manifest.permissions.push('activeTab');
+		manifest.permissions.push('activeTab')
 	}
 
 	// 添加 Safari 特有配置
 	manifest.browser_specific_settings = {
 		safari: {
-      minimum_version: "14.0"
+			minimum_version: '14.0',
+		},
 	}
-  };
 
-  fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+	fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2))
-  console.log('✅ Safari Manifest.json processed');
+	console.log('✅ Safari Manifest.json processed')
-  console.log('✅ Background.html created for Safari');
+	console.log('✅ Background.html created for Safari')
 }
 
 // 处理 index.html
 function processIndexHtml() {
-  const indexPath = path.join(__dirname, '../index.html');
+	const indexPath = path.join(__dirname, '../index.html')
-  let content = fs.readFileSync(indexPath, 'utf8');
+	let content = fs.readFileSync(indexPath, 'utf8')
 
 	// 替换脚本地址
 	content = content.replace(
 		/src="[^"]*\/src\/main\.ts"/g,
-    'src="./src/main.ts"'
+		'src="./src/main.ts"',
-  );
+	)
 
 	// 移除 crossorigin 属性
-  content = content.replace(/\s+crossorigin/g, '');
+	content = content.replace(/\s+crossorigin/g, '')
 
-  fs.writeFileSync(indexPath, content);
+	fs.writeFileSync(indexPath, content)
-  console.log('✅ Index.html processed for Safari');
+	console.log('✅ Index.html processed for Safari')
 }
 
 // 执行处理
 try {
-  processManifest();
+	processManifest()
-  processIndexHtml();
+	processIndexHtml()
-  console.log('🎉 Safari build preparation completed!');
+	console.log('🎉 Safari build preparation completed!')
 } catch (error) {
-  console.error('❌ Error during Safari build preparation:', error);
+	console.error('❌ Error during Safari build preparation:', error)
-  process.exit(1);
+	process.exit(1)
 }

src/App.vue

@@ -1,13 +1,15 @@
 <script setup lang="ts">
 import { useRoute, useRouter } from 'vue-router'
-import Player from './components/Player.vue'
+import MiniPlayer from './components/MiniPlayer.vue'
 import PreferencePanel from './components/PreferencePanel.vue'
+import Player from './components/Player.vue'
 import { ref } from 'vue'
 
 import LeftArrowIcon from './assets/icons/leftarrow.vue'
 // import SearchIcon from './assets/icons/search.vue'
 import CorgIcon from './assets/icons/corg.vue'
 import { watch } from 'vue'
+import { debug } from './utils/debug'
 
 import UpdatePopup from './components/UpdatePopup.vue'
 
@@ -16,10 +18,12 @@ const presentPreferencePanel = ref(false)
 const route = useRoute()
 const router = useRouter()
 
-watch(() => presentPreferencePanel, (value) => {
+watch(
-	console.log(value)
+	() => presentPreferencePanel,
-})
+	(value) => {
-
+		debug('偏好设置面板显示状态', value)
+	},
+)
 </script>
 
 <template>
@@ -73,6 +77,7 @@ watch(() => presentPreferencePanel, (value) => {
 							<CorgIcon :size="4" />
 						</button>
 
+						<MiniPlayer />
 						<Player />
 					</div>
 				</div>

src/apis/index.ts

@@ -9,33 +9,41 @@ export default {
 		const songs: {
 			data: ApiResponse
 		} = await msrInstance.get('songs')
-		if (songs.data.code !== 0) { throw new Error(`Cannot get songs: ${songs.data.msg}`) }
+		if (songs.data.code !== 0) {
+			throw new Error(`Cannot get songs: ${songs.data.msg}`)
+		}
 		return { songs: songs.data.data as { list: SongList } }
 	},
 	async getSong(cid: string) {
 		const song: {
 			data: ApiResponse
 		} = await msrInstance.get(`song/${cid}`)
-		if (song.data.code!== 0) { throw new Error(`Cannot get song: ${song.data.msg}`) }
+		if (song.data.code !== 0) {
+			throw new Error(`Cannot get song: ${song.data.msg}`)
+		}
 		return song.data.data as Song
 	},
 	async getAlbums() {
 		const albums: {
 			data: ApiResponse
 		} = await msrInstance.get('albums')
-		if (albums.data.code!== 0) { throw new Error(`Cannot get albums: ${albums.data.msg}`) }
+		if (albums.data.code !== 0) {
+			throw new Error(`Cannot get albums: ${albums.data.msg}`)
+		}
 		return albums.data.data as AlbumList
 	},
 	async getAlbum(cid: string) {
 		const album: {
 			data: ApiResponse
 		} = await msrInstance.get(`album/${cid}/detail`)
-		if (album.data.code!== 0) { throw new Error(`Cannot get album: ${album.data.msg}`) }
+		if (album.data.code !== 0) {
+			throw new Error(`Cannot get album: ${album.data.msg}`)
+		}
 		const albumMeta: {
 			data: ApiResponse
 		} = await msrInstance.get(`album/${cid}/data`)
 		let data = album.data.data as Album
 		data.artistes = (albumMeta.data.data as Album).artistes
 		return data
-	}
+	},
 }

src/components/AlbumDetailDialog.vue

@@ -11,6 +11,7 @@ import { artistsOrganize } from '../utils'
 import { usePlayQueueStore } from '../stores/usePlayQueueStore'
 import TrackItem from './TrackItem.vue'
 import LoadingIndicator from '../assets/icons/loadingindicator.vue'
+import { debugUI } from '../utils/debug'
 
 const props = defineProps<{
 	albumCid: string
@@ -28,7 +29,8 @@ const closeButton = ref<HTMLElement>()
 
 // Animation functions
 const animateIn = async () => {
-	if (!dialogBackdrop.value || !dialogContent.value || !closeButton.value) return
+	if (!dialogBackdrop.value || !dialogContent.value || !closeButton.value)
+		return
 
 	// Set initial states
 	gsap.set(dialogBackdrop.value, { opacity: 0 })
@@ -41,108 +43,124 @@ const animateIn = async () => {
 	tl.to(dialogBackdrop.value, {
 		opacity: 1,
 		duration: 0.3,
-		ease: "power2.out"
+		ease: 'power2.out',
 	})
-		.to(dialogContent.value, {
+		.to(
+			dialogContent.value,
+			{
 				y: 0,
 				opacity: 1,
 				scale: 1,
 				duration: 0.4,
-			ease: "power3.out"
+				ease: 'power3.out',
-		}, "-=0.1")
+			},
-		.to(closeButton.value, {
+			'-=0.1',
+		)
+		.to(
+			closeButton.value,
+			{
 				scale: 1,
 				rotation: 0,
 				duration: 0.3,
-			ease: "back.out(1.7)"
+				ease: 'back.out(1.7)',
-		}, "-=0.2")
+			},
+			'-=0.2',
+		)
 }
 
 const animateOut = () => {
-	if (!dialogBackdrop.value || !dialogContent.value || !closeButton.value) return
+	if (!dialogBackdrop.value || !dialogContent.value || !closeButton.value)
+		return
 
 	const tl = gsap.timeline({
-		onComplete: () => emit('dismiss')
+		onComplete: () => emit('dismiss'),
 	})
 
 	tl.to(closeButton.value, {
 		scale: 0,
 		rotation: 180,
 		duration: 0.2,
-		ease: "power2.in"
+		ease: 'power2.in',
 	})
-		.to(dialogContent.value, {
+		.to(
+			dialogContent.value,
+			{
 				y: 30,
 				opacity: 0,
 				scale: 0.95,
 				duration: 0.3,
-			ease: "power2.in"
+				ease: 'power2.in',
-		}, "-=0.1")
+			},
-		.to(dialogBackdrop.value, {
+			'-=0.1',
+		)
+		.to(
+			dialogBackdrop.value,
+			{
 				opacity: 0,
 				duration: 0.2,
-			ease: "power2.in"
+				ease: 'power2.in',
-		}, "-=0.1")
+			},
+			'-=0.1',
+		)
 }
 
 const handleClose = () => {
 	animateOut()
 }
 
-watch(() => props.present, async (newVal) => {
+watch(
+	() => props.present,
+	async (newVal) => {
 		if (newVal) {
 			await nextTick()
 			animateIn()
 		}
-})
+	},
+)
 
-watch(() => props.albumCid, async () => {
+watch(
-	console.log("AlbumDetailDialog mounted with albumCid:", props.albumCid)
+	() => props.albumCid,
+	async () => {
+		debugUI('专辑详情对话框加载', props.albumCid)
 		album.value = undefined // Reset album when cid changes
 		try {
 			let res = await apis.getAlbum(props.albumCid)
 			for (const track in res.songs) {
-			res.songs[parseInt(track)] = await apis.getSong(res.songs[parseInt(track)].cid)
+				res.songs[parseInt(track)] = await apis.getSong(
+					res.songs[parseInt(track)].cid,
+				)
 			}
 			album.value = res
 		} catch (error) {
-		console.error(error)
+			debugUI('专辑详情加载失败', error)
 		}
-})
+	},
+)
 
 const playQueue = usePlayQueueStore()
 
-function playTheAlbum(from: number = 0) {
+async function playTheAlbum(from: number = 0) {
-	if (playQueue.queueReplaceLock) {
+	let newQueue = []
-		if (!confirm("当前操作会将你的播放队列清空、放入这张专辑所有曲目，并从头播放。继续吗？")) { return }
-		playQueue.queueReplaceLock = false
-	}
-
-	let newPlayQueue = []
 	for (const track of album.value?.songs ?? []) {
-		console.log(track)
+		newQueue.push({
-		newPlayQueue.push({
 			song: track,
 			album: album.value
 		})
 	}
-	playQueue.list = newPlayQueue
+	await playQueue.replaceQueue(newQueue)
-	playQueue.currentIndex = from
+	await playQueue.togglePlay(true)
-	playQueue.isPlaying = true
-	playQueue.isBuffering = true
 }
 
 function shuffle() {
-	playTheAlbum()
+	//  playTheAlbum()
-	playQueue.shuffleCurrent = true
+	// 	playQueue.shuffleCurrent = true
-	playQueue.playMode.shuffle = false
+	// 	playQueue.playMode.shuffle = false
-	setTimeout(() => {
+	// 	setTimeout(() => {
-		playQueue.playMode.shuffle = true
+	// 		playQueue.playMode.shuffle = true
-		playQueue.isPlaying = true
+	// 		playQueue.isPlaying = true
-		playQueue.isBuffering = true
+	// 		playQueue.isBuffering = true
-	}, 100)
+	// 	}, 100)
 }
-
 </script>
 
 <template>

src/components/MiniPlayer.vue

@@ -0,0 +1,17 @@
+<script setup lang="ts">
+import { useRoute } from 'vue-router'
+
+const route = useRoute()
+</script>
+
+<template>
+	<RouterLink to="/playroom">
+		<div
+			class="h-9 w-52 bg-neutral-800/80 border border-[#ffffff39] rounded-full backdrop-blur-3xl flex items-center justify-between select-none">
+			<div class="flex items-center gap-2">
+				<div class="rounded-full w-9 h-9 bg-gray-600" />
+				<div class="text-white">Song title</div>
+			</div>
+		</div>
+	</RouterLink>
+</template>

src/components/PlayQueueItem.vue

@@ -59,7 +59,9 @@ function moveUp() {
 }
 
 function moveDown() {
-	const listLength = playQueueStore.playMode.shuffle ? playQueueStore.shuffleList.length : playQueueStore.list.length
+	const listLength = playQueueStore.playMode.shuffle
+		? playQueueStore.shuffleList.length
+		: playQueueStore.list.length
 	if (props.index === listLength - 1) return
 
 	playQueueStore.queueReplaceLock = true
@@ -109,7 +111,10 @@ function removeItem() {
 			playQueueStore.currentIndex--
 		} else if (props.index === playQueueStore.currentIndex) {
 			if (queue.length > 0) {
-				playQueueStore.currentIndex = Math.min(playQueueStore.currentIndex, queue.length - 1)
+				playQueueStore.currentIndex = Math.min(
+					playQueueStore.currentIndex,
+					queue.length - 1,
+				)
 			} else {
 				playQueueStore.currentIndex = 0
 			}
@@ -140,7 +145,10 @@ function removeItem() {
 			playQueueStore.currentIndex--
 		} else if (props.index === playQueueStore.currentIndex) {
 			if (queue.length > 0) {
-				playQueueStore.currentIndex = Math.min(playQueueStore.currentIndex, queue.length - 1)
+				playQueueStore.currentIndex = Math.min(
+					playQueueStore.currentIndex,
+					queue.length - 1,
+				)
 			} else {
 				playQueueStore.currentIndex = 0
 			}

src/components/Player.vue

@@ -1,163 +1,46 @@
-<!-- Player.vue - 添加预加载功能 -->
 <script setup lang="ts">
-import { computed, nextTick, ref, useTemplateRef, watch } from 'vue'
-import { useRoute } from 'vue-router'
-import { useFavourites } from '../stores/useFavourites'
 import { usePlayQueueStore } from '../stores/usePlayQueueStore'
+import { debugPlayer } from '../utils/debug'
+import { watch, ref } from 'vue'
+import apis from '../apis'
 
-import LoadingIndicator from '../assets/icons/loadingindicator.vue'
+const playQueue = usePlayQueueStore()
-import PlayIcon from '../assets/icons/play.vue'
-import PauseIcon from '../assets/icons/pause.vue'
-import { audioVisualizer, checkAndRefreshSongResource, supportsWebAudioVisualization } from '../utils'
 
-const playQueueStore = usePlayQueueStore()
+const resourcesUrl = ref<{ [key: string]: string }>({})
-const favourites = useFavourites()
-const route = useRoute()
-const player = useTemplateRef('playerRef')
 
-// [调试] 检查 store 方法类型
+// 监听播放列表变化
-console.log('[Player] 检查 store 方法:', {
+watch(() => playQueue.queue, async () => {
-	preloadNext: typeof playQueueStore.preloadNext,
+	debugPlayer(playQueue.queue)
-	getPreloadedAudio: typeof playQueueStore.getPreloadedAudio,
+	let newResourcesUrl: { [key: string]: string } = {}
-	clearPreloadedAudio: typeof playQueueStore.clearPreloadedAudio,
+	for (const track of playQueue.queue) {
-})
+		const res = await apis.getSong(track.song.cid)
-
+		newResourcesUrl[track.song.cid] = track.song.sourceUrl
-// 获取当前歌曲的计算属性
-const currentTrack = computed(() => {
-	if (
-		playQueueStore.playMode.shuffle &&
-		playQueueStore.shuffleList.length > 0
-	) {
-		return playQueueStore.list[
-			playQueueStore.shuffleList[playQueueStore.currentIndex]
-		]
 	}
-
+	debugPlayer(newResourcesUrl)
-	return playQueueStore.list[playQueueStore.currentIndex]
+	resourcesUrl.value = newResourcesUrl
 })
 
-// 获取当前歌曲的音频源
+// 在播放曲目变动时，将元数据更新到浏览器和操作系统中
-const currentAudioSrc = computed(() => {
+watch(() => playQueue.currentTrack, async () => {
-	const track = currentTrack.value
+	if (!playQueue.currentTrack) return
-	return track ? track.song.sourceUrl : ''
+	navigator.mediaSession.metadata = new MediaMetadata({
-})
+		title: playQueue.currentTrack.song.name,
-
+		artist: artistsOrganize(playQueue.currentTrack.song.artists ?? []),
-watch(
+		album: playQueue.currentTrack.album?.name,
-	() => playQueueStore.isPlaying,
+		artwork: [
-	(newValue) => {
+			{
-		if (newValue) {
+				src: playQueue.currentTrack.album?.coverUrl ?? '',
-			player.value?.play()
+				sizes: '500x500',
-			setMetadata()
+				type: 'image/png',
-		} else {
-			player.value?.pause()
-		}
 			},
-)
+		],
-
+	})
-// 监听当前索引变化，处理预加载逻辑
-watch(
-	() => playQueueStore.currentIndex,
-	async () => {
-		console.log('[Player] 当前索引变化:', playQueueStore.currentIndex)
-
-		// 检查是否可以使用预加载的音频
-		const track = currentTrack.value
-		if (track) {
-			const songId = track.song.cid
-
-			try {
-				// 首先检查和刷新当前歌曲的资源
-				console.log('[Player] 检查当前歌曲资源:', track.song.name)
-				const updatedSong = await checkAndRefreshSongResource(
-					track.song,
-					(updated) => {
-						// 更新播放队列中的歌曲信息
-						// 在随机播放模式下，currentIndex 是 shuffleList 的索引
-						// 需要通过 shuffleList[currentIndex] 获取实际的 list 索引
-						const actualIndex =
-							playQueueStore.playMode.shuffle &&
-							playQueueStore.shuffleList.length > 0
-								? playQueueStore.shuffleList[playQueueStore.currentIndex]
-								: playQueueStore.currentIndex
-						if (playQueueStore.list[actualIndex]) {
-							playQueueStore.list[actualIndex].song = updated
-						}
-						// 如果歌曲在收藏夹中，也更新收藏夹
-						favourites.updateSongInFavourites(songId, updated)
-					},
-				)
-
-				// 使用更新后的歌曲信息
-				const preloadedAudio = playQueueStore.getPreloadedAudio(songId)
-
-				if (preloadedAudio && updatedSong.sourceUrl === track.song.sourceUrl) {
-					console.log(`[Player] 使用预加载的音频: ${track.song.name}`)
-
-					// 直接使用预加载的音频数据
-					if (player.value) {
-						// 复制预加载音频的状态到主播放器
-						player.value.src = preloadedAudio.src
-						player.value.currentTime = 0
-
-						// 清理使用过的预加载音频
-						playQueueStore.clearPreloadedAudio(songId)
-
-						// 如果正在播放状态，立即播放
-						if (playQueueStore.isPlaying) {
-							await nextTick()
-							player.value.play().catch(console.error)
-						}
-
-						playQueueStore.isBuffering = false
-					}
-				} else {
-					console.log(`[Player] 正常加载音频: ${track.song.name}`)
-					playQueueStore.isBuffering = true
-
-					// 如果资源地址已更新，清除旧的预加载音频
-					if (updatedSong.sourceUrl !== track.song.sourceUrl) {
-						playQueueStore.clearPreloadedAudio(songId)
-					}
-				}
-			} catch (error) {
-				console.error('[Player] 处理预加载音频时出错:', error)
-				playQueueStore.isBuffering = true
-			}
-		}
-
-		setMetadata()
-
-		// 延迟预加载下一首歌，避免影响当前歌曲加载
-		setTimeout(async () => {
-			try {
-				console.log('[Player] 尝试预加载下一首歌')
-
-				// 检查函数是否存在
-				if (typeof playQueueStore.preloadNext === 'function') {
-					await playQueueStore.preloadNext()
-
-					// 预加载完成后，检查播放队列是否有更新，同步到收藏夹
-					playQueueStore.list.forEach((item) => {
-						if (favourites.isFavourite(item.song.cid)) {
-							favourites.updateSongInFavourites(item.song.cid, item.song)
-						}
 })
 
-					playQueueStore.limitPreloadCache()
+// 优化音乐人字符串显示
-				} else {
-					console.error('[Player] preloadNext 不是一个函数')
-				}
-			} catch (error) {
-				console.error('[Player] 预加载失败:', error)
-			}
-		}, 1000)
-	},
-)
-
 function artistsOrganize(list: string[]) {
-	if (list.length === 0) {
+	if (list.length === 0) return '未知音乐人'
-		return '未知音乐人'
+
-	}
 	return list
 		.map((artist) => {
 			return artist
@@ -165,371 +48,35 @@ function artistsOrganize(list: string[]) {
 		.join(' / ')
 }
 
-function setMetadata() {
+// 自动播放属性判断
-	if ('mediaSession' in navigator) {
+function isAutoPlay(cid: string) {
-		const current = currentTrack.value
+	// 为了提前缓存播放队列中的歌曲，同时消除两首歌切换时的间隙，因此改用了新的方式来在网页上挂载音频
-		if (!current) return
+	// 现在会将队列中每一首歌曲都挂载一个单独的 <audio> 并添加 preload="auto" 属性
+	// 这样就可以利用浏览器的内置行为来提前缓存队列中的所有歌曲了
+	// 不过，这样就会导致判断到底哪一首歌需要播放就成了难题
+	// 因此就有了这个函数，用于判断哪一个 <audio> 元素需要进行播放
+	// 此函数主要用于 <audio> 元素的 autoplay 属性，以便在专辑或歌单页面点击播放按钮时直接开始播放音乐
 
-		navigator.mediaSession.metadata = new MediaMetadata({
+	// 先判断是否正在播放
-			title: current.song.name,
+	if (!playQueue.isPlaying) return false
-			artist: artistsOrganize(current.song.artists ?? []),
-			album: current.album?.name,
-			artwork: [
-				{
-					src: current.album?.coverUrl ?? '',
-					sizes: '500x500',
-					type: 'image/png',
-				},
-			],
-		})
 
-		navigator.mediaSession.setActionHandler('previoustrack', playPrevious)
+	// 再判断是否是目前曲目
-		navigator.mediaSession.setActionHandler('nexttrack', playNext)
+	if (playQueue.currentTrack.song.cid !== cid) return false
 
-		playQueueStore.duration = player.value?.duration ?? 0
+	return true	
-		playQueueStore.currentTime = player.value?.currentTime ?? 0
 }
-
-	watch(
-		() => playQueueStore.updatedCurrentTime,
-		(newValue) => {
-			if (newValue === null) {
-				return
-			}
-			if (player.value) player.value.currentTime = newValue
-			playQueueStore.updatedCurrentTime = null
-		},
-	)
-}
-
-function playNext() {
-	if (playQueueStore.currentIndex === playQueueStore.list.length - 1) {
-		console.log('at the bottom, pause')
-		playQueueStore.currentIndex = 0
-		if (playQueueStore.playMode.repeat === 'all') {
-			playQueueStore.currentIndex = 0
-			playQueueStore.isPlaying = true
-		} else {
-			player.value?.pause()
-			playQueueStore.isPlaying = false
-		}
-	} else {
-		playQueueStore.currentIndex++
-		playQueueStore.isPlaying = true
-	}
-}
-
-function playPrevious() {
-	if (
-		player.value &&
-		(player.value.currentTime ?? 0) < 5 &&
-		playQueueStore.currentIndex > 0
-	) {
-		playQueueStore.currentIndex--
-		playQueueStore.isPlaying = true
-	} else {
-		if (player.value) {
-			player.value.currentTime = 0
-		}
-	}
-}
-
-function updateCurrentTime() {
-	playQueueStore.currentTime = player.value?.currentTime ?? 0
-
-	// 智能预加载策略：支持动态配置
-	if (playQueueStore.duration > 0) {
-		const progress = playQueueStore.currentTime / playQueueStore.duration
-		const remainingTime = playQueueStore.duration - playQueueStore.currentTime
-
-		// 从 localStorage 获取配置，如果没有则使用默认值
-		const config = JSON.parse(localStorage.getItem('preloadConfig') || '{}')
-		const preloadTrigger = (config.preloadTrigger || 50) / 100 // 转换为小数
-		const remainingTimeThreshold = config.remainingTimeThreshold || 30
-
-		if (
-			(progress > preloadTrigger || remainingTime < remainingTimeThreshold) &&
-			!playQueueStore.isPreloading
-		) {
-			try {
-				if (typeof playQueueStore.preloadNext === 'function') {
-					playQueueStore.preloadNext()
-				} else {
-					console.error('[Player] preloadNext 不是一个函数')
-				}
-			} catch (error) {
-				console.error('[Player] 智能预加载失败:', error)
-			}
-		}
-	}
-}
-
-// 检查浏览器是否支持音频可视化
-const isAudioVisualizationSupported = supportsWebAudioVisualization()
-console.log('[Player] 音频可视化支持状态:', isAudioVisualizationSupported)
-
-// 只在支持的浏览器上初始化音频可视化
-let barHeights = ref<number[]>([0, 0, 0, 0, 0, 0])
-let connectAudio = (_audio: HTMLAudioElement) => {}
-let isAnalyzing = ref(false)
-let error = ref<string | null>(null)
-
-if (isAudioVisualizationSupported) {
-	console.log('[Player] 初始化 audioVisualizer')
-	const visualizer = audioVisualizer({
-		sensitivity: 1.5,
-		barCount: 6,
-		maxDecibels: -10,
-		bassBoost: 0.8,
-		midBoost: 1.2,
-		trebleBoost: 1.4,
-		threshold: 0,
-	})
-	
-	barHeights = visualizer.barHeights
-	connectAudio = visualizer.connectAudio
-	isAnalyzing = visualizer.isAnalyzing
-	error = visualizer.error
-	
-	console.log('[Player] audioVisualizer 返回值:', {
-		barHeights: barHeights.value,
-		isAnalyzing: isAnalyzing.value,
-	})
-} else {
-	console.log('[Player] 音频可视化被禁用（Safari 或不支持的浏览器）')
-}
-
-// 监听播放列表变化
-watch(
-	() => playQueueStore.list.length,
-	async (newLength) => {
-		console.log('[Player] 播放列表长度变化:', newLength)
-		if (newLength === 0) {
-			console.log('[Player] 播放列表为空，跳过连接')
-			return
-		}
-
-		// 等待下一帧，确保 audio 元素已经渲染
-		await nextTick()
-
-		if (player.value) {
-			if (isAudioVisualizationSupported) {
-				console.log('[Player] 连接音频元素到可视化器')
-				console.log('[Player] 音频元素状态:', {
-					src: player.value.src?.substring(0, 50) + '...',
-					readyState: player.value.readyState,
-					paused: player.value.paused,
-				})
-				connectAudio(player.value)
-			} else {
-				console.log('[Player] 跳过音频可视化连接（不支持的浏览器）')
-			}
-		} else {
-			console.log('[Player] ❌ 音频元素不存在')
-		}
-
-		playQueueStore.visualizer = barHeights.value
-
-		// 开始预加载第一首歌的下一首
-		setTimeout(() => {
-			playQueueStore.preloadNext()
-		}, 2000)
-
-		// 初始化音量
-		if (player.value) {
-			initializeVolume()
-		}
-	},
-)
-
-// 监听音频元素变化
-watch(
-	() => player.value,
-	(audioElement) => {
-		if (audioElement && playQueueStore.list.length > 0 && isAudioVisualizationSupported) {
-			connectAudio(audioElement)
-		}
-	},
-)
-
-// 监听可视化器数据变化
-watch(
-	() => barHeights.value,
-	(newHeights) => {
-		playQueueStore.visualizer = newHeights
-	},
-	{ deep: true },
-)
-
-// 监听错误
-watch(
-	() => error.value,
-	(newError) => {
-		if (newError) {
-			console.error('[Player] 可视化器错误:', newError)
-		}
-	},
-)
-
-// 切换播放模式
-watch(
-	() => playQueueStore.playMode.shuffle,
-	(isShuffle) => {
-		if (isShuffle) {
-			const currentIndex = playQueueStore.currentIndex
-			const trackCount = playQueueStore.list.length
-
-			// 1. 已播放部分：不变
-			let shuffledList = [...Array(currentIndex).keys()]
-
-			// 2. 构建待打乱的列表
-			const shuffleSpace = [...Array(trackCount).keys()].filter((index) =>
-				playQueueStore.shuffleCurrent
-					? index >= currentIndex
-					: index > currentIndex,
-			)
-
-			// 3. 随机打乱
-			shuffleSpace.sort(() => Math.random() - 0.5)
-
-			// 4. 如果当前曲目不参与打乱，插入回当前位置（即 currentIndex 处）
-			if (!playQueueStore.shuffleCurrent) {
-				shuffledList.push(currentIndex)
-			}
-
-			// 5. 拼接：已播放部分 + 当前（可选）+ 打乱后的剩余部分
-			shuffledList = shuffledList.concat(shuffleSpace)
-
-			// 6. 应用 shuffleList
-			playQueueStore.shuffleList = shuffledList
-
-			// 清除 shuffleCurrent 状态
-			playQueueStore.shuffleCurrent = undefined
-		} else {
-			// 退出随机播放：恢复当前播放曲目的原索引
-			playQueueStore.currentIndex =
-				playQueueStore.shuffleList[playQueueStore.currentIndex]
-		}
-
-		// 切换播放模式后重新预加载
-		setTimeout(() => {
-			playQueueStore.clearAllPreloadedAudio()
-			playQueueStore.preloadNext()
-		}, 500)
-	},
-)
-
-function getCurrentTrack() {
-	return currentTrack.value
-}
-
-// 初始化音量
-function initializeVolume() {
-	if (player.value) {
-		const savedVolume = localStorage.getItem('audioVolume')
-		if (savedVolume) {
-			const volumeValue = Number.parseFloat(savedVolume)
-			player.value.volume = volumeValue
-			console.log('[Player] 初始化音量:', volumeValue)
-		} else {
-			// 设置默认音量
-			player.value.volume = 1
-			localStorage.setItem('audioVolume', '1')
-		}
-	}
-}
-
-// 监听音量变化事件
-function handleVolumeChange(event: Event) {
-	const target = event.target as HTMLAudioElement
-	if (target) {
-		// 保存音量变化到localStorage
-		localStorage.setItem('audioVolume', target.volume.toString())
-		console.log('[Player] 音量变化:', target.volume)
-	}
-}
-
-// 监听localStorage中音量的变化，同步到音频元素
-function syncVolumeFromStorage() {
-	if (player.value) {
-		const savedVolume = localStorage.getItem('audioVolume')
-		if (savedVolume) {
-			const volumeValue = Number.parseFloat(savedVolume)
-			if (player.value.volume !== volumeValue) {
-				player.value.volume = volumeValue
-			}
-		}
-	}
-}
-
-// 定期检查音量同步（可选，或者使用storage事件）
-setInterval(syncVolumeFromStorage, 100)
-
-// 组件卸载时清理预加载
-// onUnmounted(() => {
-//   playQueueStore.clearAllPreloadedAudio()
-// })
 </script>
 
 <template>
 	<div>
-		<audio :src="currentAudioSrc" ref="playerRef" :autoplay="playQueueStore.isPlaying"
+		<div class="text-white"  v-for="track in playQueue.queue" :key="track.song.cid">
-			v-if="playQueueStore.list.length !== 0" @volumechange="handleVolumeChange" @ended="() => {
+			<audio 
-				if (playQueueStore.playMode.repeat === 'single') { playQueueStore.isPlaying = true }
+				v-if="resourcesUrl[track.song.cid]" 
-				else { playNext() }
+				:src="resourcesUrl[track.song.cid]" 
-			}" @pause="playQueueStore.isPlaying = false" @play="playQueueStore.isPlaying = true" @playing="() => {
+				preload="auto" 
-				console.log('[Player] 音频开始播放事件')
+				:ref="`audio-${track.song.cid}`"
-				playQueueStore.isBuffering = false
+				:autoplay="isAutoPlay(track.song.cid)"
-				setMetadata()
+			/>
-				initializeVolume()
-			}" @waiting="playQueueStore.isBuffering = true" @loadeddata="() => {
-				console.log('[Player] 音频数据加载完成')
-				playQueueStore.isBuffering = false
-				initializeVolume()
-			}" @canplay="() => {
-				console.log('[Player] 音频可以播放')
-				playQueueStore.isBuffering = false
-			}" @error="(e) => {
-				console.error('[Player] 音频错误:', e)
-				playQueueStore.isBuffering = false
-			}" crossorigin="anonymous" @timeupdate="updateCurrentTime">
-		</audio>
-
-		<!-- 预加载进度指示器（可选显示） -->
-		<!-- <div v-if="playQueueStore.isPreloading"
-			class="fixed top-4 right-4 bg-black/80 text-white px-3 py-1 rounded text-xs z-50">
-			预加载中... {{ Math.round(playQueueStore.preloadProgress) }}%
-		</div> -->
-
-		<div
-			class="text-white h-9 bg-neutral-800/80 border border-[#ffffff39] rounded-full text-center backdrop-blur-3xl flex gap-2 overflow-hidden select-none"
-			v-if="playQueueStore.list.length !== 0 && route.path !== '/playroom'">
-			<RouterLink to="/playroom">
-				<img :src="getCurrentTrack()?.album?.coverUrl ?? ''" class="rounded-full h-8 w-8 mt-[.0625rem]" />
-			</RouterLink>
-
-			<RouterLink to="/playroom">
-				<div class="flex items-center w-32 h-9">
-					<span class="truncate text-xs">{{ getCurrentTrack()?.song.name }}</span>
-				</div>
-			</RouterLink>
-
-			<button class="h-9 w-12 flex justify-center items-center" @click.stop="() => {
-				playQueueStore.isPlaying = !playQueueStore.isPlaying
-			}">
-				<div v-if="playQueueStore.isPlaying">
-					<LoadingIndicator v-if="playQueueStore.isBuffering === true" :size="4" />
-					<!-- 在支持的浏览器上显示可视化，否则显示暂停图标 -->
-					<div v-else-if="isAudioVisualizationSupported" class="h-4 flex justify-center items-center gap-[.125rem]">
-						<div class="bg-white/75 w-[.125rem] rounded-full" v-for="(bar, index) in playQueueStore.visualizer"
-							:key="index" :style="{
-								height: `${Math.max(10, bar)}%`
-							}" />
-					</div>
-					<PauseIcon v-else :size="4" />
-				</div>
-				<PlayIcon v-else :size="4" />
-			</button>
 		</div>
 	</div>
 </template>

src/components/PreferencePanel.vue

@@ -1,5 +1,4 @@
 <script lang="ts" setup>
-
 import XIcon from '../assets/icons/x.vue'
 import { usePreferences } from '../stores/usePreferences'
 import { computed } from 'vue'

src/components/ScrollingLyrics.vue

@@ -90,6 +90,7 @@ import { onMounted, ref, watch, nextTick, computed, onUnmounted } from 'vue'
 import axios from 'axios'
 import gsap from 'gsap'
 import { usePlayQueueStore } from '../stores/usePlayQueueStore'
+import { debugLyrics } from '../utils/debug'
 
 // 类型定义
 interface LyricsLine {
@@ -136,7 +137,7 @@ const props = defineProps<{
 // 滚动指示器相关计算
 const scrollIndicatorHeight = computed(() => {
 	if (parsedLyrics.value.length === 0) return 0
-	return Math.max(10, 100 / parsedLyrics.value.length * 5) // 显示大约5行的比例
+	return Math.max(10, (100 / parsedLyrics.value.length) * 5) // 显示大约5行的比例
 })
 
 const scrollIndicatorPosition = computed(() => {
@@ -144,7 +145,11 @@ const scrollIndicatorPosition = computed(() => {
 	const progress = currentLineIndex.value / (parsedLyrics.value.length - 1)
 	const containerHeight = lyricsContainer.value?.clientHeight || 400
 	const indicatorTrackHeight = containerHeight / 2 // 指示器轨道高度
-	return progress * (indicatorTrackHeight - (scrollIndicatorHeight.value / 100 * indicatorTrackHeight))
+	return (
+		progress *
+		(indicatorTrackHeight -
+			(scrollIndicatorHeight.value / 100) * indicatorTrackHeight)
+	)
 })
 
 // 设置行引用
@@ -155,14 +160,18 @@ function setLineRef(el: HTMLElement | null, index: number) {
 }
 
 // 歌词解析函数
-function parseLyrics(lrcText: string, minGapDuration: number = 5): (LyricsLine | GapLine)[] {
+function parseLyrics(
-	if (!lrcText) return [
+	lrcText: string,
+	minGapDuration: number = 5,
+): (LyricsLine | GapLine)[] {
+	if (!lrcText)
+		return [
 			{
 				type: 'lyric',
 				time: 0,
 				text: '',
-			originalTime: '[00:00]'
+				originalTime: '[00:00]',
-		}
+			},
 		]
 
 	const lines = lrcText.split('\n')
@@ -188,13 +197,13 @@ function parseLyrics(lrcText: string, minGapDuration: number = 5): (LyricsLine |
 					type: 'lyric',
 					time: totalSeconds,
 					text: text,
-					originalTime: match[0]
+					originalTime: match[0],
 				})
 			} else {
 				tempParsedLines.push({
 					type: 'gap',
 					time: totalSeconds,
-					originalTime: match[0]
+					originalTime: match[0],
 				})
 			}
 		}
@@ -203,14 +212,18 @@ function parseLyrics(lrcText: string, minGapDuration: number = 5): (LyricsLine |
 	tempParsedLines.sort((a, b) => a.time - b.time)
 
 	const finalLines: (LyricsLine | GapLine)[] = []
-	const lyricLines = tempParsedLines.filter(line => line.type === 'lyric') as LyricsLine[]
+	const lyricLines = tempParsedLines.filter(
-	const gapLines = tempParsedLines.filter(line => line.type === 'gap') as GapLine[]
+		(line) => line.type === 'lyric',
+	) as LyricsLine[]
+	const gapLines = tempParsedLines.filter(
+		(line) => line.type === 'gap',
+	) as GapLine[]
 
 	if (lyricLines.length === 0) return tempParsedLines
 
 	for (let i = 0; i < gapLines.length; i++) {
 		const gapLine = gapLines[i]
-		const nextLyricLine = lyricLines.find(lyric => lyric.time > gapLine.time)
+		const nextLyricLine = lyricLines.find((lyric) => lyric.time > gapLine.time)
 
 		if (nextLyricLine) {
 			const duration = nextLyricLine.time - gapLine.time
@@ -229,7 +242,7 @@ function parseLyrics(lrcText: string, minGapDuration: number = 5): (LyricsLine |
 		type: 'lyric',
 		time: 0,
 		text: '',
-		originalTime: '[00:00]'
+		originalTime: '[00:00]',
 	})
 	return sortedLines
 }
@@ -252,7 +265,12 @@ function findCurrentLineIndex(time: number): number {
 
 // 使用 GSAP 滚动到指定行
 function scrollToLine(lineIndex: number, smooth = true) {
-	if (!lyricsContainer.value || !lyricsWrapper.value || !lineRefs.value[lineIndex]) return
+	if (
+		!lyricsContainer.value ||
+		!lyricsWrapper.value ||
+		!lineRefs.value[lineIndex]
+	)
+		return
 
 	const container = lyricsContainer.value
 	const wrapper = lyricsWrapper.value
@@ -276,10 +294,10 @@ function scrollToLine(lineIndex: number, smooth = true) {
 		scrollTween = gsap.to(wrapper, {
 			y: targetY,
 			duration: 0.8,
-			ease: "power2.out",
+			ease: 'power2.out',
 			onComplete: () => {
 				scrollTween = null
-			}
+			},
 		})
 	} else {
 		gsap.set(wrapper, { y: targetY })
@@ -304,7 +322,7 @@ function highlightCurrentLine(lineIndex: number) {
 				scale: 1,
 				opacity: index < lineIndex ? 0.6 : 0.4,
 				duration: 0.3,
-				ease: "power2.out"
+				ease: 'power2.out',
 			})
 		}
 	})
@@ -314,10 +332,10 @@ function highlightCurrentLine(lineIndex: number) {
 		scale: 1.05,
 		opacity: 1,
 		duration: 0.2,
-		ease: "back.out(1.7)",
+		ease: 'back.out(1.7)',
 		onComplete: () => {
 			highlightTween = null
-		}
+		},
 	})
 }
 
@@ -334,7 +352,7 @@ function handleWheel(event: WheelEvent) {
 		scrollTween.kill()
 	}
 
-	const currentY = gsap.getProperty(lyricsWrapper.value, "y") as number
+	const currentY = gsap.getProperty(lyricsWrapper.value, 'y') as number
 	const newY = currentY - event.deltaY * 0.5
 
 	// 修正滚动范围计算
@@ -347,7 +365,7 @@ function handleWheel(event: WheelEvent) {
 	gsap.to(lyricsWrapper.value, {
 		y: limitedY,
 		duration: 0.1,
-		ease: "power2.out"
+		ease: 'power2.out',
 	})
 
 	if (userScrollTimeout) {
@@ -367,7 +385,7 @@ function handleWheel(event: WheelEvent) {
 // 处理歌词行点击
 function handleLineClick(line: LyricsLine | GapLine, index: number) {
 	if (line.type === 'lyric') {
-		console.log('Jump to time:', line.time)
+		debugLyrics('跳转到时间点', line.time)
 		// 这里可以发出事件让父组件处理音频跳转
 		// emit('seek', line.time)
 	}
@@ -377,15 +395,16 @@ function handleLineClick(line: LyricsLine | GapLine, index: number) {
 
 	// 添加点击反馈动画
 	if (lineRefs.value[index]) {
-		gsap.fromTo(lineRefs.value[index],
+		gsap.fromTo(
+			lineRefs.value[index],
 			{ scale: 1 },
 			{
 				scale: 1.1,
 				duration: 0.1,
 				yoyo: true,
 				repeat: 1,
-				ease: "power2.inOut"
+				ease: 'power2.inOut',
-			}
+			},
 		)
 	}
 }
@@ -397,15 +416,16 @@ function toggleAutoScroll() {
 
 	// 按钮点击动画
 	if (controlPanel.value) {
-		gsap.fromTo(controlPanel.value.children[0],
+		gsap.fromTo(
+			controlPanel.value.children[0],
 			{ scale: 1 },
 			{
 				scale: 0.95,
 				duration: 0.1,
 				yoyo: true,
 				repeat: 1,
-				ease: "power2.inOut"
+				ease: 'power2.inOut',
-			}
+			},
 		)
 	}
 
@@ -428,7 +448,7 @@ function resetScroll() {
 	gsap.to(lyricsWrapper.value, {
 		y: 0,
 		duration: 0.3,
-		ease: "power2.out"
+		ease: 'power2.out',
 	})
 
 	autoScroll.value = true
@@ -436,15 +456,16 @@ function resetScroll() {
 
 	// 按钮点击动画
 	if (controlPanel.value) {
-		gsap.fromTo(controlPanel.value.children[1],
+		gsap.fromTo(
+			controlPanel.value.children[1],
 			{ scale: 1 },
 			{
 				scale: 0.95,
 				duration: 0.1,
 				yoyo: true,
 				repeat: 1,
-				ease: "power2.inOut"
+				ease: 'power2.inOut',
-			}
+			},
 		)
 	}
 
@@ -470,11 +491,15 @@ function getGapDotOpacities(line: GapLine) {
 	// 每个圆点的阈值
 	const thresholds = [1 / 4, 2 / 4, 3 / 4]
 	// 透明度从 0.3 到 1
-	return thresholds.map(t => progress >= t ? 1 : progress >= t - 1 / 3 ? 0.6 : 0.3)
+	return thresholds.map((t) =>
+		progress >= t ? 1 : progress >= t - 1 / 3 ? 0.6 : 0.3,
+	)
 }
 
 // 监听播放时间变化
-watch(() => playQueueStore.currentTime, (time) => {
+watch(
+	() => playQueueStore.currentTime,
+	(time) => {
 		const newIndex = findCurrentLineIndex(time)
 
 		if (newIndex !== currentLineIndex.value && newIndex >= 0) {
@@ -490,11 +515,14 @@ watch(() => playQueueStore.currentTime, (time) => {
 				})
 			}
 		}
-})
+	},
+)
 
 // 监听歌词源变化
-watch(() => props.lrcSrc, async (newSrc) => {
+watch(
-	console.log('Loading new lyrics from:', newSrc)
+	() => props.lrcSrc,
+	async (newSrc) => {
+		debugLyrics('加载新歌词', newSrc)
 		// 重置状态
 		currentLineIndex.value = -1
 		lineRefs.value = []
@@ -508,16 +536,17 @@ watch(() => props.lrcSrc, async (newSrc) => {
 
 			// 加载动画
 			if (loadingIndicator.value) {
-			gsap.fromTo(loadingIndicator.value,
+				gsap.fromTo(
+					loadingIndicator.value,
 					{ opacity: 0, scale: 0.8 },
-				{ opacity: 1, scale: 1, duration: 0.3, ease: "back.out(1.7)" }
+					{ opacity: 1, scale: 1, duration: 0.3, ease: 'back.out(1.7)' },
 				)
 			}
 
 			try {
 				const response = await axios.get(newSrc)
 				parsedLyrics.value = parseLyrics(response.data)
-			console.log('Parsed lyrics:', parsedLyrics.value)
+				debugLyrics('歌词解析完成', parsedLyrics.value)
 
 				autoScroll.value = true
 				userScrolling.value = false
@@ -526,9 +555,8 @@ watch(() => props.lrcSrc, async (newSrc) => {
 				if (lyricsWrapper.value) {
 					gsap.set(lyricsWrapper.value, { y: 0 })
 				}
-
 			} catch (error) {
-			console.error('Failed to load lyrics:', error)
+				debugLyrics('歌词加载失败', error)
 				parsedLyrics.value = []
 			} finally {
 				loading.value = false
@@ -541,8 +569,9 @@ watch(() => props.lrcSrc, async (newSrc) => {
 				gsap.set(lyricsWrapper.value, { y: 0 })
 			}
 		}
-}, { immediate: true })
+	},
-
+	{ immediate: true },
+)
 
 // 页面焦点处理函数变量声明
 let handleVisibilityChange: (() => void) | null = null
@@ -561,7 +590,11 @@ function setupPageFocusHandlers() {
 
 			// 重新同步歌词位置
 			nextTick(() => {
-				if (currentLineIndex.value >= 0 && autoScroll.value && !userScrolling.value) {
+				if (
+					currentLineIndex.value >= 0 &&
+					autoScroll.value &&
+					!userScrolling.value
+				) {
 					scrollToLine(currentLineIndex.value, false) // 不使用动画，直接定位
 				}
 			})
@@ -578,9 +611,10 @@ onMounted(() => {
 
 	// 控制面板入场动画
 	if (controlPanel.value) {
-		gsap.fromTo(controlPanel.value,
+		gsap.fromTo(
+			controlPanel.value,
 			{ opacity: 0, x: 20 },
-			{ opacity: 0, x: 0, duration: 0.2, ease: "power2.out", delay: 0.2 }
+			{ opacity: 0, x: 0, duration: 0.2, ease: 'power2.out', delay: 0.2 },
 		)
 	}
 
@@ -588,15 +622,16 @@ onMounted(() => {
 	nextTick(() => {
 		lineRefs.value.forEach((el, index) => {
 			if (el) {
-				gsap.fromTo(el,
+				gsap.fromTo(
+					el,
 					{ opacity: 0, y: 30 },
 					{
 						opacity: 1,
 						y: 0,
 						duration: 0.2,
-						ease: "power2.out",
+						ease: 'power2.out',
-						delay: index * 0.1
+						delay: index * 0.1,
-					}
+					},
 				)
 			}
 		})
@@ -620,7 +655,10 @@ defineExpose({
 	scrollToLine,
 	toggleAutoScroll,
 	resetScroll,
-	getCurrentLine: () => currentLineIndex.value >= 0 ? parsedLyrics.value[currentLineIndex.value] : null
+	getCurrentLine: () =>
+		currentLineIndex.value >= 0
+			? parsedLyrics.value[currentLineIndex.value]
+			: null,
 })
 </script>
 

src/components/TrackItem.vue

@@ -4,16 +4,17 @@ import { ref } from 'vue'
 import { usePlayQueueStore } from '../stores/usePlayQueueStore'
 import { useToast } from 'vue-toast-notification'
 import { useFavourites } from '../stores/useFavourites'
+import { debugUI } from '../utils/debug'
 
 import QueueAddIcon from '../assets/icons/queueadd.vue'
 import StarEmptyIcon from '../assets/icons/starempty.vue'
 import StarFilledIcon from '../assets/icons/starfilled.vue'
 
 const props = defineProps<{
-	album?: Album,
+	album?: Album
-	track: Song,
+	track: Song
-	index: number,
+	index: number
-	playfrom: (index: number) => void,
+	playfrom: (index: number) => void
 }>()
 
 const hover = ref(false)
@@ -23,8 +24,8 @@ const toast = useToast()
 const favourites = useFavourites()
 
 function appendToQueue() {
-	console.log('aaa')
+	debugUI('添加歌曲到队列')
-	let queue = playQueueStore.list
+	const queue = playQueueStore.list
 	queue.push({
 		song: props.track,
 		album: props.album,
@@ -41,7 +42,7 @@ function appendToQueue() {
 <template>
 	<button
 		class="flex justify-between align-center gap-4 text-left px-2 h-[2.75rem] hover:bg-neutral-600/40 odd:bg-netural-600/20 relative overflow-hidden bg-neutral-800/20 odd:bg-neutral-800/40 transition-all"
-		@click="playfrom(index)" @mouseenter="() => { hover = true; console.log('aaa') }" @mouseleave="hover = false">
+		@click="playfrom(index)" @mouseenter="() => { hover = true; debugUI('鼠标悬停在歌曲项') }" @mouseleave="hover = false">
 
 		<span class="text-[3.7rem] text-white/10 absolute left-0 top-[-1.4rem] track_num">{{ index + 1 }}</span>
 

src/main.ts

@@ -15,15 +15,14 @@ const routes = [
 	{ path: '/', component: HomePage },
 	{ path: '/albums/:albumId', component: AlbumDetailView },
 	{ path: '/playroom', component: Playroom },
-  { path: '/library', component: Library }
+	{ path: '/library', component: Library },
 ]
 
 const router = createRouter({
 	history: createWebHashHistory(),
-  routes
+	routes,
 })
 
 const pinia = createPinia()
 
 createApp(App).use(router).use(pinia).use(ToastPlugin).mount('#app')
-

src/pages/AlbumDetail.vue

@@ -5,6 +5,7 @@ import { useRoute } from 'vue-router'
 import { usePlayQueueStore } from '../stores/usePlayQueueStore'
 import { artistsOrganize } from '../utils'
 import TrackItem from '../components/TrackItem.vue'
+import { debugUI } from '../utils/debug'
 
 import PlayIcon from '../assets/icons/play.vue'
 import StarEmptyIcon from '../assets/icons/starempty.vue'
@@ -21,27 +22,35 @@ onMounted(async () => {
 	try {
 		let res = await apis.getAlbum(albumId as string)
 		for (const track in res.songs) {
-			res.songs[parseInt(track)] = await apis.getSong(res.songs[parseInt(track)].cid)
+			res.songs[parseInt(track)] = await apis.getSong(
+				res.songs[parseInt(track)].cid,
+			)
 		}
 		album.value = res
-		console.log(res)
+		debugUI('专辑详情加载完成', res)
 	} catch (error) {
-		console.log(error)
+		debugUI('专辑详情加载失败', error)
 	}
 })
 
 function playTheAlbum(from: number = 0) {
 	if (playQueue.queueReplaceLock) {
-		if (!confirm("当前操作会将你的播放队列清空、放入这张专辑所有曲目，并从头播放。继续吗？")) { return }
+		if (
+			!confirm(
+				'当前操作会将你的播放队列清空、放入这张专辑所有曲目，并从头播放。继续吗？',
+			)
+		) {
+			return
+		}
 		playQueue.queueReplaceLock = false
 	}
 
 	let newPlayQueue = []
 	for (const track of album.value?.songs ?? []) {
-		console.log(track)
+		debugUI('添加歌曲到播放队列', track)
 		newPlayQueue.push({
 			song: track,
-			album: album.value
+			album: album.value,
 		})
 	}
 	playQueue.playMode.shuffle = false

src/pages/Home.vue

@@ -6,7 +6,7 @@ import AlbumDetailDialog from '../components/AlbumDetailDialog.vue'
 const albums = ref([] as AlbumList)
 
 const presentAlbumDetailDialog = ref(false)
-const presentedAlbum = ref("")
+const presentedAlbum = ref('')
 
 onMounted(async () => {
 	const res = await apis.getAlbums()

src/pages/Library.vue

@@ -2,6 +2,7 @@
 import StarFilledIcon from '../assets/icons/starfilled.vue'
 import PlayIcon from '../assets/icons/play.vue'
 import ShuffleIcon from '../assets/icons/shuffle.vue'
+import { debugUI } from '../utils/debug'
 
 import { useFavourites } from '../stores/useFavourites'
 import { ref } from 'vue'
@@ -14,10 +15,18 @@ const playQueueStore = usePlayQueueStore()
 const currentList = ref<'favourites' | number>('favourites')
 
 function playTheList(list: 'favourites' | number, playFrom: number = 0) {
-	if (playFrom < 0 || playFrom >= favourites.favouritesCount) { playFrom = 0 }
+	if (playFrom < 0 || playFrom >= favourites.favouritesCount) {
+		playFrom = 0
+	}
 
 	if (usePlayQueueStore().queueReplaceLock) {
-		if (!confirm("当前操作会将你的播放队列清空、放入这张歌单所有曲目，并从头播放。继续吗？")) { return }
+		if (
+			!confirm(
+				'当前操作会将你的播放队列清空、放入这张歌单所有曲目，并从头播放。继续吗？',
+			)
+		) {
+			return
+		}
 		usePlayQueueStore().queueReplaceLock = false
 	}
 	playQueueStore.list = []
@@ -25,9 +34,9 @@ function playTheList(list: 'favourites' | number, playFrom: number = 0) {
 	if (list === 'favourites') {
 		if (favourites.favouritesCount === 0) return
 
-		let newPlayQueue = favourites.favourites.map(item => ({
+		let newPlayQueue = favourites.favourites.map((item) => ({
 			song: item.song,
-			album: item.album
+			album: item.album,
 		}))
 		playQueueStore.list = newPlayQueue.slice().reverse()
 		playQueueStore.currentIndex = playFrom
@@ -49,7 +58,6 @@ function shuffle(list: 'favourites' | number) {
 		playQueueStore.isBuffering = true
 	}, 100)
 }
-
 </script>
 
 <template>
@@ -124,7 +132,7 @@ function shuffle(list: 'favourites' | number) {
 			<div class="flex flex-col gap-2 mt-4 mr-8 pb-8">
 				<PlayListItem v-for="(item, index) in favourites.favourites.slice().reverse()" :key="item.song.cid" :item="item"
 					:index="index" @play="(playFrom) => {
-						console.log('play from', playFrom)
+						debugUI('从收藏库播放', playFrom)
 						playTheList('favourites', playFrom)
 					}" />
 			</div>

src/pages/Playroom.vue

@@ -2,12 +2,13 @@
 import { usePlayQueueStore } from '../stores/usePlayQueueStore'
 import { artistsOrganize } from '../utils'
 import gsap from 'gsap'
-import { Draggable } from "gsap/Draggable"
+import { Draggable } from 'gsap/Draggable'
 import { onMounted, onUnmounted, nextTick } from 'vue'
 import { useTemplateRef } from 'vue'
 import { ref, watch } from 'vue'
 import { usePreferences } from '../stores/usePreferences'
 import { useFavourites } from '../stores/useFavourites'
+import { debugPlayroom } from '../utils/debug'
 
 import ScrollingLyrics from '../components/ScrollingLyrics.vue'
 
@@ -68,7 +69,7 @@ onMounted(async () => {
 			const containerWidth = progressBarContainer.value?.clientWidth || 0
 			const newTime = (thumbPosition / containerWidth) * playQueueStore.duration
 			playQueueStore.updatedCurrentTime = newTime
-		}
+		},
 	})
 
 	// 等待DOM完全渲染后再初始化拖拽
@@ -90,17 +91,24 @@ onMounted(async () => {
 
 function timeFormatter(time: number) {
 	const timeInSeconds = Math.floor(time)
-	if (timeInSeconds < 0) { return '-:--' }
+	if (timeInSeconds < 0) {
+		return '-:--'
+	}
 	const minutes = Math.floor(timeInSeconds / 60)
 	const seconds = Math.floor(timeInSeconds % 60)
-	if (Number.isNaN(minutes) || Number.isNaN(seconds)) { return '-:--' }
+	if (Number.isNaN(minutes) || Number.isNaN(seconds)) {
+		return '-:--'
+	}
 	return `${minutes}:${seconds < 10 ? '0' : ''}${seconds}`
 }
 
 // 监听播放进度，更新进度条
-watch(() => playQueueStore.currentTime, () => {
+watch(
+	() => playQueueStore.currentTime,
+	() => {
 		thumbUpdate()
-})
+	},
+)
 
 function thumbUpdate() {
 	const progress = playQueueStore.currentTime / playQueueStore.duration
@@ -132,14 +140,14 @@ function toggleVolumeControl() {
 
 function createVolumeDraggable() {
 	if (!volumeSliderThumb.value || !volumeSliderContainer.value) {
-		console.warn('Volume slider elements not found')
+		debugPlayroom('音量滑块元素未找到')
 		return
 	}
 
 	// 确保容器有宽度
 	const containerWidth = volumeSliderContainer.value.clientWidth
 	if (containerWidth === 0) {
-		console.warn('Volume slider container has no width')
+		debugPlayroom('音量滑块容器宽度为0')
 		return
 	}
 
@@ -152,7 +160,10 @@ function createVolumeDraggable() {
 			const containerWidth = volumeSliderContainer.value?.clientWidth || 0
 			const thumbWidth = volumeSliderThumb.value?.clientWidth || 0
 			// 确保音量值在0-1之间
-			const newVolume = Math.max(0, Math.min(1, thumbPosition / (containerWidth - thumbWidth)))
+			const newVolume = Math.max(
+				0,
+				Math.min(1, thumbPosition / (containerWidth - thumbWidth)),
+			)
 			volume.value = newVolume
 			updateAudioVolume()
 			// 保存音量到localStorage
@@ -161,10 +172,10 @@ function createVolumeDraggable() {
 		onDragEnd: () => {
 			// 拖拽结束时也保存一次
 			localStorage.setItem('audioVolume', volume.value.toString())
-		}
+		},
 	})
 
-	console.log('Volume draggable created successfully')
+	debugPlayroom('音量滑块拖拽创建成功')
 }
 
 function updateAudioVolume() {
@@ -176,18 +187,18 @@ function updateAudioVolume() {
 }
 
 function formatDetector() {
-	const format = playQueueStore.list[playQueueStore.currentIndex].song.sourceUrl?.split('.').pop()
+	/* const format = playQueueStore.list[playQueueStore.currentIndex].sourceUrl?.split('.').pop()
 	if (format === 'mp3') { return 'MP3' }
 	if (format === 'flac') { return 'FLAC' }
 	if (format === 'm4a') { return 'M4A' }
 	if (format === 'ape') { return 'APE' }
-	if (format === 'wav') { return 'WAV' }
+	if (format === 'wav') { return 'WAV' } */
 	return '未知格式'
 }
 
 function playNext() {
 	if (playQueueStore.currentIndex === playQueueStore.list.length - 1) {
-		console.log("at the bottom, pause")
+		debugPlayroom('到达播放队列末尾，暂停')
 		playQueueStore.currentIndex = 0
 		playQueueStore.isPlaying = false
 	} else {
@@ -207,19 +218,25 @@ function playPrevious() {
 
 function setupEntranceAnimations() {
 	if (controllerRef.value) {
-		gsap.fromTo(controllerRef.value.children,
+		gsap.fromTo(
+			controllerRef.value.children,
 			{ opacity: 0, y: 30, scale: 0.95 },
 			{
-				opacity: 1, y: 0, scale: 1,
+				opacity: 1,
-				duration: 0.6, ease: "power2.out", stagger: 0.1
+				y: 0,
-			}
+				scale: 1,
+				duration: 0.6,
+				ease: 'power2.out',
+				stagger: 0.1,
+			},
 		)
 	}
 
 	if (lyricsSection.value) {
-		gsap.fromTo(lyricsSection.value,
+		gsap.fromTo(
+			lyricsSection.value,
 			{ opacity: 0, x: 50 },
-			{ opacity: 1, x: 0, duration: 0.8, ease: "power2.out", delay: 0.3 }
+			{ opacity: 1, x: 0, duration: 0.8, ease: 'power2.out', delay: 0.3 },
 		)
 	}
 }
@@ -227,11 +244,14 @@ function setupEntranceAnimations() {
 function handlePlayPause() {
 	if (playButton.value) {
 		gsap.to(playButton.value, {
-			scale: 0.9, duration: 0.1, yoyo: true, repeat: 1,
+			scale: 0.9,
-			ease: "power2.inOut",
+			duration: 0.1,
+			yoyo: true,
+			repeat: 1,
+			ease: 'power2.inOut',
 			onComplete: () => {
 				playQueueStore.isPlaying = !playQueueStore.isPlaying
-			}
+			},
 		})
 	} else {
 		playQueueStore.isPlaying = !playQueueStore.isPlaying
@@ -245,9 +265,15 @@ function toggleShuffle() {
 
 function toggleRepeat() {
 	switch (playQueueStore.playMode.repeat) {
-		case 'off': playQueueStore.playMode.repeat = 'all'; break
+		case 'off':
-		case 'all': playQueueStore.playMode.repeat = 'single'; break
+			playQueueStore.playMode.repeat = 'all'
-		case 'single': playQueueStore.playMode.repeat = 'off'; break
+			break
+		case 'all':
+			playQueueStore.playMode.repeat = 'single'
+			break
+		case 'single':
+			playQueueStore.playMode.repeat = 'off'
+			break
 	}
 }
 
@@ -259,15 +285,26 @@ function makePlayQueueListPresent() {
 
 		const tl = gsap.timeline()
 		tl.to(playQueueDialogContainer.value, {
-			backgroundColor: '#17171780', duration: 0.3, ease: 'power2.out'
+			backgroundColor: '#17171780',
-		}).to(playQueueDialog.value, {
+			duration: 0.3,
-			x: 0, duration: 0.4, ease: 'power3.out'
+			ease: 'power2.out',
-		}, '<0.1')
+		}).to(
+			playQueueDialog.value,
+			{
+				x: 0,
+				duration: 0.4,
+				ease: 'power3.out',
+			},
+			'<0.1',
+		)
 
 		if (playQueueDialog.value.children.length > 0) {
-			tl.fromTo(playQueueDialog.value.children,
+			tl.fromTo(
+				playQueueDialog.value.children,
 				{ opacity: 0, x: -20 },
-				{ opacity: 1, x: 0, duration: 0.3, ease: 'power2.out', stagger: 0.05 }, '<0.2')
+				{ opacity: 1, x: 0, duration: 0.3, ease: 'power2.out', stagger: 0.05 },
+				'<0.2',
+			)
 		}
 	})
 }
@@ -285,34 +322,48 @@ function makePlayQueueListDismiss() {
 				gsap.set(playQueueDialog.value, { x: -384 })
 			}
 			if (playQueueDialogContainer.value) {
-				gsap.set(playQueueDialogContainer.value, { backgroundColor: 'transparent' })
+				gsap.set(playQueueDialogContainer.value, {
-			}
+					backgroundColor: 'transparent',
+				})
 			}
+		},
 	})
 
 	if (playQueueDialog.value.children.length > 0) {
 		tl.to(playQueueDialog.value.children, {
-			opacity: 0, x: -20, duration: 0.2, ease: 'power2.in', stagger: 0.03
+			opacity: 0,
+			x: -20,
+			duration: 0.2,
+			ease: 'power2.in',
+			stagger: 0.03,
 		})
 	}
 
-	tl.to(playQueueDialog.value, {
+	tl.to(
-		x: -384, duration: 0.3, ease: 'power2.in'
+		playQueueDialog.value,
-	}, playQueueDialog.value.children.length > 0 ? '<0.1' : '0')
+		{
-		.to(playQueueDialogContainer.value, {
+			x: -384,
-			backgroundColor: 'transparent', duration: 0.2, ease: 'power2.in'
+			duration: 0.3,
-		}, '<')
+			ease: 'power2.in',
+		},
+		playQueueDialog.value.children.length > 0 ? '<0.1' : '0',
+	).to(
+		playQueueDialogContainer.value,
+		{
+			backgroundColor: 'transparent',
+			duration: 0.2,
+			ease: 'power2.in',
+		},
+		'<',
+	)
 }
 
 function getCurrentTrack() {
-	if (playQueueStore.list.length === 0) {
+	debugPlayroom('获取当前播放轨道', playQueueStore.queue)
+	if (playQueueStore.queue.length === 0) {
 		return null
 	}
-	if (playQueueStore.playMode.shuffle) {
+	return playQueueStore.currentTrack
-		return playQueueStore.list[playQueueStore.shuffleList[playQueueStore.currentIndex]]
-	} else {
-		return playQueueStore.list[playQueueStore.currentIndex]
-	}
 }
 
 function toggleMoreOptions() {
@@ -321,15 +372,23 @@ function toggleMoreOptions() {
 		nextTick(() => {
 			if (moreOptionsDialog.value) {
 				const tl = gsap.timeline()
-				tl.fromTo(moreOptionsDialog.value,
+				tl.fromTo(
+					moreOptionsDialog.value,
 					{ opacity: 0, scale: 0.9, y: 10 },
-					{ opacity: 1, scale: 1, y: 0, duration: 0.2, ease: "power2.out" }
+					{ opacity: 1, scale: 1, y: 0, duration: 0.2, ease: 'power2.out' },
 				)
 				if (moreOptionsDialog.value.children[0]?.children) {
-					tl.fromTo(moreOptionsDialog.value.children[0].children,
+					tl.fromTo(
+						moreOptionsDialog.value.children[0].children,
 						{ opacity: 0, x: -10 },
-						{ opacity: 1, x: 0, duration: 0.15, ease: "power2.out", stagger: 0.05 },
+						{
-						"<0.1"
+							opacity: 1,
+							x: 0,
+							duration: 0.15,
+							ease: 'power2.out',
+							stagger: 0.05,
+						},
+						'<0.1',
 					)
 				}
 			}
@@ -339,16 +398,21 @@ function toggleMoreOptions() {
 			const tl = gsap.timeline({
 				onComplete: () => {
 					showMoreOptions.value = false
-				}
+				},
 			})
 			if (moreOptionsDialog.value.children[0]?.children) {
-				tl.to(moreOptionsDialog.value.children[0].children,
+				tl.to(moreOptionsDialog.value.children[0].children, {
-					{ opacity: 0, x: -10, duration: 0.1, ease: "power2.in", stagger: 0.02 }
+					opacity: 0,
-				)
+					x: -10,
+					duration: 0.1,
+					ease: 'power2.in',
+					stagger: 0.02,
+				})
 			}
-			tl.to(moreOptionsDialog.value,
+			tl.to(
-				{ opacity: 0, scale: 0.9, y: 10, duration: 0.15, ease: "power2.in" },
+				moreOptionsDialog.value,
-				moreOptionsDialog.value.children[0]?.children ? "<0.05" : "0"
+				{ opacity: 0, scale: 0.9, y: 10, duration: 0.15, ease: 'power2.in' },
+				moreOptionsDialog.value.children[0]?.children ? '<0.05' : '0',
 			)
 		} else {
 			showMoreOptions.value = false
@@ -356,8 +420,12 @@ function toggleMoreOptions() {
 	}
 }
 
-watch(() => [preferences.presentLyrics, getCurrentTrack()?.song.lyricUrl], (newValue, oldValue) => {
+watch(
-	if (!getCurrentTrack()) { return }
+	() => [preferences.presentLyrics, getCurrentTrack()?.song.lyricUrl],
+	(newValue, oldValue) => {
+		if (!getCurrentTrack()) {
+			return
+		}
 
 		const [showLyrics, hasLyricUrl] = newValue
 		const [prevShowLyrics, _prevHasLyricUrl] = oldValue || [false, null]
@@ -369,10 +437,11 @@ watch(() => [preferences.presentLyrics, getCurrentTrack()?.song.lyricUrl], (newV
 				const tl = gsap.timeline()
 				tl.from(controllerRef.value, {
 					marginRight: '-40rem',
-			}).fromTo(lyricsSection.value,
+				}).fromTo(
+					lyricsSection.value,
 					{ opacity: 0, x: 50, scale: 0.95 },
-				{ opacity: 1, x: 0, scale: 1, duration: 0.5, ease: "power2.out" },
+					{ opacity: 1, x: 0, scale: 1, duration: 0.5, ease: 'power2.out' },
-				"-=0.3"
+					'-=0.3',
 				)
 			})
 		}
@@ -383,44 +452,58 @@ watch(() => [preferences.presentLyrics, getCurrentTrack()?.song.lyricUrl], (newV
 			// If lyrics were toggled off
 			if (prevShowLyrics && !showLyrics) {
 				animationConfig = {
-				opacity: 0, x: -50, scale: 0.95,
+					opacity: 0,
-				duration: 0.3, ease: "power2.in"
+					x: -50,
+					scale: 0.95,
+					duration: 0.3,
+					ease: 'power2.in',
 				}
 			}
 			// If no lyrics available (song changed)
 			else if (!hasLyricUrl) {
 				animationConfig = {
-				opacity: 0, y: -20, scale: 0.98,
+					opacity: 0,
-				duration: 0.3, ease: "power1.in"
+					y: -20,
+					scale: 0.98,
+					duration: 0.3,
+					ease: 'power1.in',
 				}
 			}
 			// Default animation
 			else {
 				animationConfig = {
-				opacity: 0, x: -50,
+					opacity: 0,
-				duration: 0.3, ease: "power2.in"
+					x: -50,
+					duration: 0.3,
+					ease: 'power2.in',
 				}
 			}
 
 			const tl = gsap.timeline({
 				onComplete: () => {
 					presentLyrics.value = false
-			}
+				},
 			})
 
 			tl.to(controllerRef.value, {
 				marginLeft: '44rem',
-			duration: 0.3, ease: "power2.out"
+				duration: 0.3,
+				ease: 'power2.out',
 			})
 				.to(lyricsSection.value, animationConfig, '<')
 				.set(lyricsSection.value, {
-				opacity: 1, x: 0, y: 0, scale: 1 // Reset for next time
+					opacity: 1,
+					x: 0,
+					y: 0,
+					scale: 1, // Reset for next time
 				})
 				.set(controllerRef.value, {
-				marginLeft: '0rem' // Reset for next time
+					marginLeft: '0rem', // Reset for next time
 				})
 		}
-}, { immediate: true })
+	},
+	{ immediate: true },
+)
 
 // 页面焦点处理函数变量声明
 let handleVisibilityChange: (() => void) | null = null
@@ -441,10 +524,10 @@ function setupPageFocusHandlers() {
 	handleVisibilityChange = () => {
 		if (document.hidden) {
 			// 页面失去焦点时，暂停所有动画
-			console.log('[Playroom] 页面失去焦点，暂停动画')
+			debugPlayroom('页面失去焦点，暂停动画')
 		} else {
 			// 页面重新获得焦点时，重新同步状态
-			console.log('[Playroom] 页面重新获得焦点，同步状态')
+			debugPlayroom('页面重新获得焦点，同步状态')
 			nextTick(() => {
 				resyncLyricsState()
 			})
@@ -452,7 +535,7 @@ function setupPageFocusHandlers() {
 	}
 
 	handlePageFocus = () => {
-		console.log('[Playroom] 窗口获得焦点，同步状态')
+		debugPlayroom('窗口获得焦点，同步状态')
 		nextTick(() => {
 			resyncLyricsState()
 		})
@@ -466,15 +549,17 @@ function setupPageFocusHandlers() {
 // 重新同步歌词状态
 function resyncLyricsState() {
 	const currentTrack = getCurrentTrack()
-	if (!currentTrack) { return }
+	if (!currentTrack) {
+		return
+	}
 
-	console.log('[Playroom] 重新同步歌词状态')
+	debugPlayroom('重新同步歌词状态')
 
 	// 重置动画状态
 	if (controllerRef.value) {
 		gsap.set(controllerRef.value, {
 			marginLeft: '0rem',
-			marginRight: '0rem' 
+			marginRight: '0rem',
 		})
 	}
 
@@ -483,15 +568,18 @@ function resyncLyricsState() {
 			opacity: 1,
 			x: 0,
 			y: 0,
-			scale: 1 
+			scale: 1,
 		})
 	}
 
 	// 检查当前歌词显示状态应该是什么
-	const shouldShowLyrics = preferences.presentLyrics && currentTrack.song.lyricUrl ? true : false
+	const shouldShowLyrics =
+		preferences.presentLyrics && currentTrack.song.lyricUrl ? true : false
 
 	if (shouldShowLyrics !== presentLyrics.value) {
-		console.log(`[Playroom] 歌词状态不一致，重新设置: ${presentLyrics.value} -> ${shouldShowLyrics}`)
+		debugPlayroom(
+			`歌词状态不一致，重新设置: ${presentLyrics.value} -> ${shouldShowLyrics}`,
+		)
 
 		// 直接设置状态，不触发动画
 		presentLyrics.value = shouldShowLyrics
@@ -503,11 +591,12 @@ function resyncLyricsState() {
 				tl.from(controllerRef.value, {
 					marginRight: '-40rem',
 					duration: 0.4,
-					ease: "power2.out"
+					ease: 'power2.out',
-				}).fromTo(lyricsSection.value,
+				}).fromTo(
+					lyricsSection.value,
 					{ opacity: 0, x: 50, scale: 0.95 },
-					{ opacity: 1, x: 0, scale: 1, duration: 0.5, ease: "power2.out" },
+					{ opacity: 1, x: 0, scale: 1, duration: 0.5, ease: 'power2.out' },
-					"-=0.2"
+					'-=0.2',
 				)
 			})
 		}
@@ -515,21 +604,29 @@ function resyncLyricsState() {
 }
 
 // New: Watch for track changes and animate
-watch(() => playQueueStore.currentIndex, () => {
+watch(
+	() => playQueueStore.currentIndex,
+	() => {
 		if (albumCover.value) {
 			gsap.to(albumCover.value, {
-			scale: 0.95, opacity: 0.7, duration: 0.2,
+				scale: 0.95,
-			ease: "power2.inOut", yoyo: true, repeat: 1
+				opacity: 0.7,
+				duration: 0.2,
+				ease: 'power2.inOut',
+				yoyo: true,
+				repeat: 1,
 			})
 		}
 
 		if (songInfo.value) {
-		gsap.fromTo(songInfo.value,
+			gsap.fromTo(
+				songInfo.value,
 				{ opacity: 0, y: 10 },
-			{ opacity: 1, y: 0, duration: 0.4, ease: "power2.out", delay: 0.3 }
+				{ opacity: 1, y: 0, duration: 0.4, ease: 'power2.out', delay: 0.3 },
 			)
 		}
-})
+	},
+)
 </script>
 
 <template>
@@ -826,22 +923,22 @@ watch(() => playQueueStore.currentIndex, () => {
 				<div class="flex gap-2 mx-8 mb-4">
 					<button
 						class="flex-1 h-9 border border-[#ffffff39] rounded-full text-center backdrop-blur-3xl flex justify-center items-center transition-all duration-200 hover:scale-105"
-						:class="playQueueStore.playMode.shuffle ? 'bg-[#ffffffaa] text-neutral-700' : 'text-white bg-neutral-800/80'"
+						:class="playQueueStore.isShuffle ? 'bg-[#ffffffaa] text-neutral-700' : 'text-white bg-neutral-800/80'"
 						@click="toggleShuffle">
 						<ShuffleIcon :size="4" />
 					</button>
 					<button
 						class="flex-1 h-9 border border-[#ffffff39] rounded-full text-center backdrop-blur-3xl flex justify-center items-center transition-all duration-200 hover:scale-105"
-						:class="playQueueStore.playMode.repeat === 'off' ? 'text-white bg-neutral-800/80' : 'bg-[#ffffffaa] text-neutral-700'"
+						:class="playQueueStore.loopMode === 'off' ? 'text-white bg-neutral-800/80' : 'bg-[#ffffffaa] text-neutral-700'"
 						@click="toggleRepeat">
-						<CycleTwoArrowsIcon :size="4" v-if="playQueueStore.playMode.repeat !== 'single'" />
+						<CycleTwoArrowsIcon :size="4" v-if="playQueueStore.loopMode !== 'single'" />
 						<CycleTwoArrowsWithNumOneIcon :size="4" v-else />
 					</button>
 				</div>
 
 				<hr class="border-[#ffffff39]" />
 
-				<div class="flex-auto h-0 overflow-y-auto px-4 flex flex-col gap-2" v-if="playQueueStore.playMode.shuffle">
+				<div class="flex-auto h-0 overflow-y-auto px-4 flex flex-col gap-2" v-if="playQueueStore.isShuffle">
 					<PlayQueueItem v-for="(oriIndex, shuffledIndex) in playQueueStore.shuffleList"
 						:queueItem="playQueueStore.list[oriIndex]" :isCurrent="playQueueStore.currentIndex === shuffledIndex"
 						:key="playQueueStore.list[oriIndex].song.cid" :index="shuffledIndex" />

src/stores/useFavourites.ts

@@ -1,5 +1,6 @@
-import { defineStore } from "pinia"
+import { defineStore } from 'pinia'
-import { ref, watch, computed } from "vue"
+import { ref, watch, computed } from 'vue'
+import { debugStore } from '../utils/debug'
 
 // 声明全局类型
 declare global {
@@ -21,7 +22,11 @@ export const useFavourites = defineStore('favourites', () => {
 	const detectAvailableAPIs = () => {
 		// 检查原生 chrome API
 		try {
-			if (typeof chrome !== 'undefined' && chrome.storage && chrome.storage.local) {
+			if (
+				typeof chrome !== 'undefined' &&
+				chrome.storage &&
+				chrome.storage.local
+			) {
 				storageType.value = 'chrome'
 				return 'chrome'
 			}
@@ -31,7 +36,11 @@ export const useFavourites = defineStore('favourites', () => {
 
 		// 检查 window.chrome
 		try {
-			if (window.chrome && window.chrome.storage && window.chrome.storage.local) {
+			if (
+				window.chrome &&
+				window.chrome.storage &&
+				window.chrome.storage.local
+			) {
 				storageType.value = 'chrome'
 				return 'chrome'
 			}
@@ -131,7 +140,8 @@ export const useFavourites = defineStore('favourites', () => {
 	const normalizeFavourites = (data: any[]): QueueItem[] => {
 		if (!Array.isArray(data)) return []
 
-		return data.map(item => {
+		return data
+			.map((item) => {
 				if (!item || !item.song) return null
 
 				// 规范化 Song 对象
@@ -144,37 +154,48 @@ export const useFavourites = defineStore('favourites', () => {
 					mvUrl: item.song.mvUrl,
 					mvCoverUrl: item.song.mvCoverUrl,
 					// 确保 artistes 和 artists 是数组
-				artistes: Array.isArray(item.song.artistes) ? item.song.artistes :
+					artistes: Array.isArray(item.song.artistes)
-					typeof item.song.artistes === 'object' ? Object.values(item.song.artistes) :
+						? item.song.artistes
-						[],
+						: typeof item.song.artistes === 'object'
-				artists: Array.isArray(item.song.artists) ? item.song.artists :
+							? Object.values(item.song.artistes)
-					typeof item.song.artists === 'object' ? Object.values(item.song.artists) :
+							: [],
-						[]
+					artists: Array.isArray(item.song.artists)
+						? item.song.artists
+						: typeof item.song.artists === 'object'
+							? Object.values(item.song.artists)
+							: [],
 				}
 
 				// 规范化 Album 对象（如果存在）
-			const album = item.album ? {
+				const album = item.album
+					? {
 							cid: item.album.cid || '',
 							name: item.album.name || '',
 							intro: item.album.intro,
 							belong: item.album.belong,
 							coverUrl: item.album.coverUrl || '',
 							coverDeUrl: item.album.coverDeUrl,
-				artistes: Array.isArray(item.album.artistes) ? item.album.artistes :
+							artistes: Array.isArray(item.album.artistes)
-					typeof item.album.artistes === 'object' ? Object.values(item.album.artistes) :
+								? item.album.artistes
-						[],
+								: typeof item.album.artistes === 'object'
-				songs: item.album.songs
+									? Object.values(item.album.artistes)
-			} : undefined
+									: [],
+							songs: item.album.songs,
+						}
+					: undefined
 
 				return { song, album }
-		}).filter(Boolean) as QueueItem[]
+			})
+			.filter(Boolean) as QueueItem[]
 	}
 
 	// 获取收藏列表
 	const getFavourites = async () => {
 		const result = await getStoredValue('favourites', defaultFavourites)
 		// 确保返回的是数组并进行数据规范化
-		const normalizedResult = Array.isArray(result) ? normalizeFavourites(result) : defaultFavourites
+		const normalizedResult = Array.isArray(result)
+			? normalizeFavourites(result)
+			: defaultFavourites
 		return normalizedResult
 	}
 
@@ -187,7 +208,7 @@ export const useFavourites = defineStore('favourites', () => {
 
 	// 检查歌曲是否已收藏
 	const isFavourite = (songCid: string): boolean => {
-		return favourites.value.some(item => item.song.cid === songCid)
+		return favourites.value.some((item) => item.song.cid === songCid)
 	}
 
 	// 添加到收藏
@@ -208,7 +229,9 @@ export const useFavourites = defineStore('favourites', () => {
 
 	// 从收藏中移除
 	const removeFromFavourites = async (songCid: string) => {
-		const index = favourites.value.findIndex(item => item.song.cid === songCid)
+		const index = favourites.value.findIndex(
+			(item) => item.song.cid === songCid,
+		)
 		if (index !== -1) {
 			const removedItem = favourites.value.splice(index, 1)[0]
 			if (isLoaded.value) {
@@ -265,7 +288,9 @@ export const useFavourites = defineStore('favourites', () => {
 
 	// 监听变化并保存（防抖处理）
 	let saveTimeout: NodeJS.Timeout | null = null
-	watch(favourites, async () => {
+	watch(
+		favourites,
+		async () => {
 			if (isLoaded.value) {
 				// 清除之前的定时器
 				if (saveTimeout) {
@@ -280,20 +305,27 @@ export const useFavourites = defineStore('favourites', () => {
 					}
 				}, 300)
 			}
-	}, { deep: true })
+		},
+		{ deep: true },
+	)
 
 	// 更新收藏列表中的歌曲信息
 	const updateSongInFavourites = async (songCid: string, updatedSong: Song) => {
-		const index = favourites.value.findIndex(item => item.song.cid === songCid)
+		const index = favourites.value.findIndex(
+			(item) => item.song.cid === songCid,
+		)
 		if (index !== -1) {
 			// 更新歌曲信息，保持其他属性不变
-			favourites.value[index].song = { ...favourites.value[index].song, ...updatedSong }
+			favourites.value[index].song = {
+				...favourites.value[index].song,
+				...updatedSong,
+			}
 			if (isLoaded.value) {
 				try {
 					await saveFavourites()
 				} catch (error) {
 					// 保存失败时可以考虑回滚或错误处理
-					console.error('Failed to save updated song:', error)
+					debugStore('更新歌曲信息保存失败', error)
 				}
 			}
 		}
@@ -317,7 +349,6 @@ export const useFavourites = defineStore('favourites', () => {
 		clearFavourites,
 		getStoredValue,
 		setStoredValue,
-		updateSongInFavourites
+		updateSongInFavourites,
 	}
 })
-

src/stores/usePlayQueueStore.ts

@@ -1,217 +1,159 @@
 import { defineStore } from 'pinia'
-import { computed, ref } from 'vue'
+import { ref, computed } from 'vue'
-import { checkAndRefreshSongResource } from '../utils'
 
 export const usePlayQueueStore = defineStore('queue', () => {
-	const list = ref<QueueItem[]>([])
+	// 内部状态
-	const currentIndex = ref<number>(0)
+	const queue = ref<QueueItem[]>([])
-	const isPlaying = ref<boolean>(false)
+	const isShuffle = ref(false)
-	const queueReplaceLock = ref<boolean>(false)
+	const loopingMode = ref<'single' | 'all' | 'off'>('off')
-	const isBuffering = ref<boolean>(false)
+	const queueReplaceLock = ref(false)
-	const currentTime = ref<number>(0)
+	const currentPlaying = ref(0) // 当前播放指针，指针在 queueOrder 中寻址（无论是否开启了随机播放）
-	const duration = ref<number>(0)
+	const queueOrder = ref<number[]>([]) // 播放队列顺序
-	const updatedCurrentTime = ref<number | null>(null)
+	const isPlaying = ref(false)
-	const visualizer = ref<number[]>([0, 0, 0, 0, 0, 0])
-	const shuffleList = ref<number[]>([])
-	const playMode = ref<{
-		shuffle: boolean
-		repeat: 'off' | 'single' | 'all'
-	}>({
-		shuffle: false,
-		repeat: 'off',
-	})
-	const shuffleCurrent = ref<boolean | undefined>(undefined)
 
-	// 预加载相关状态
+	// 暴露给外部的响应式只读引用
-	const preloadedAudio = ref<Map<string, HTMLAudioElement>>(new Map())
+	const queueState = computed(() =>
-	const isPreloading = ref<boolean>(false)
+		// 按 queueOrder 的顺序排序输出队列
-	const preloadProgress = ref<number>(0)
+		queueOrder.value
-
+			.map((index) => queue.value[index])
-	// 获取下一首歌的索引
+			.filter(Boolean),
-	const getNextIndex = computed(() => {
-		if (list.value.length === 0) return -1
-
-		if (playMode.value.repeat === 'single') {
-			return currentIndex.value
-		}
-
-		if (playMode.value.shuffle && shuffleList.value.length > 0) {
-			// 当前在 shuffleList 中的位置
-			const currentShuffleIndex = currentIndex.value
-			if (currentShuffleIndex < shuffleList.value.length - 1) {
-				// 返回下一个位置对应的原始 list 索引
-				return shuffleList.value[currentShuffleIndex + 1]
-			} else if (playMode.value.repeat === 'all') {
-				// 返回第一个位置对应的原始 list 索引
-				return shuffleList.value[0]
-			}
-			return -1
-		}
-
-		if (currentIndex.value < list.value.length - 1) {
-			return currentIndex.value + 1
-		} else if (playMode.value.repeat === 'all') {
-			return 0
-		}
-
-		return -1
-	})
-
-	// 预加载下一首歌
-	const preloadNext = async () => {
-		const nextIndex = getNextIndex.value
-		if (nextIndex === -1) {
-			return
-		}
-
-		// 获取下一首歌曲对象
-		// nextIndex 已经是原始 list 中的索引
-		const nextSong = list.value[nextIndex]
-
-		if (!nextSong || !nextSong.song) {
-			return
-		}
-
-		const songId = nextSong.song.cid
-
-		// 如果已经预加载过，跳过
-		if (preloadedAudio.value.has(songId)) {
-			return
-		}
-
-		// 检查是否有有效的音频源
-		if (!nextSong.song.sourceUrl) {
-			return
-		}
-
-		try {
-			isPreloading.value = true
-			preloadProgress.value = 0
-
-			// 在预加载前检查和刷新资源
-			console.log('[Store] 预加载前检查资源:', nextSong.song.name)
-			const updatedSong = await checkAndRefreshSongResource(
-				nextSong.song,
-				(updated) => {
-					// 更新播放队列中的歌曲信息
-					// nextIndex 已经是原始 list 中的索引
-					if (list.value[nextIndex]) {
-						list.value[nextIndex].song = updated
-					}
-
-					// 如果歌曲在收藏夹中，也更新收藏夹
-					// 注意：这里不直接导入 favourites store 以避免循环依赖
-					// 改为触发一个事件或者在调用方处理
-					console.log('[Store] 预加载时需要更新收藏夹:', updated.name)
-				},
 	)
+	const shuffleState = computed(() => isShuffle.value)
+	const loopModeState = computed(() => loopingMode.value)
 
-			const audio = new Audio()
+	// 获取当前播放项
-			audio.preload = 'auto'
+	const currentTrack = computed(() => {
-			audio.crossOrigin = 'anonymous'
+		const actualIndex = queueOrder.value[currentPlaying.value]
-
+		return queue.value[actualIndex] || null
-			// 监听加载进度
-			audio.addEventListener('progress', () => {
-				if (audio.buffered.length > 0) {
-					const buffered = audio.buffered.end(0)
-					const total = audio.duration || 1
-					preloadProgress.value = (buffered / total) * 100
-				}
 	})
 	
-			// 监听加载完成
+	// 获取当前是否正在播放
-			audio.addEventListener('canplaythrough', () => {
+	const playingState = computed(() => isPlaying.value)
-				preloadedAudio.value.set(songId, audio)
+
-				isPreloading.value = false
+	/************
-				preloadProgress.value = 100
+	 *	播放队列相关
-				console.log('[Store] 预加载完成:', updatedSong.name)
+	 ***********/
+	// 使用新队列替换老队列
+	// 队列替换锁开启时启用确认，确认后重置该锁
+	async function replaceQueue(newQueue: QueueItem[]) {
+		if (queueReplaceLock.value) {
+			if (
+				!confirm(
+					'当前操作会将你的播放队列清空、放入这张专辑所有曲目，并从头播放。继续吗？',
+				)
+			) {
+				return
+			}
+			// 重置队列替换锁
+			queueReplaceLock.value = false
+		}
+
+		// 将新队列替换已有队列
+		queue.value = newQueue
+
+		// 初始化播放顺序
+		queueOrder.value = Array.from({ length: newQueue.length }, (_, i) => i)
+		currentPlaying.value = 0
+
+		// 关闭随机播放和循环（外部可在此方法执行完毕后再更新播放模式）
+		isShuffle.value = false
+		loopingMode.value = 'off'
+	}
+
+	/***********
+	 * 播放控制相关
+	 *
+	 **********/
+	// 控制播放
+	const togglePlay = (turnTo?: boolean) => {
+		const newPlayState = turnTo ?? !isPlaying.value
+		if (newPlayState === isPlaying.value) return
+		isPlaying.value = newPlayState
+	}
+
+	/************
+	 * 播放模式相关
+	 **********/
+	// 切换随机播放模式
+	const toggleShuffle = (turnTo?: boolean) => {
+		// 未指定随机状态时自动开关
+		const newShuffleState = turnTo ?? !isShuffle.value
+
+		if (newShuffleState === isShuffle.value) return // 状态未改变
+
+		// TODO: 进行洗牌
+		/* if (newShuffleState) {
+			// 开启随机播放：保存当前顺序并打乱
+			const originalOrder = [...queueOrder.value]
+			const shuffled = [...queueOrder.value]
+			
+			// Fisher-Yates 洗牌算法
+			for (let i = shuffled.length - 1; i > 0; i--) {
+				const j = Math.floor(Math.random() * (i + 1));
+				[shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]]
+			}
+			
+			// 确保当前播放的歌曲位置不变（可选）
+			const currentSongIndex = queueOrder.value[currentPlaying.value]
+			const newCurrentPos = shuffled.indexOf(currentSongIndex)
+			if (newCurrentPos !== -1 && newCurrentPos !== currentPlaying.value) {
+				[shuffled[currentPlaying.value], shuffled[newCurrentPos]] = 
+					[shuffled[newCurrentPos], shuffled[currentPlaying.value]]
+			}
+			
+			// 保存原始顺序以便恢复
+			queue.value.forEach((_, index) => {
+				queue.value[index]._originalOrderIndex = originalOrder.indexOf(index)
 			})
 			
-			// 监听加载错误
+			queueOrder.value = shuffled
-			audio.addEventListener('error', (e) => {
-				console.error(`[Store] 预加载音频失败: ${updatedSong.name}`, e)
-				isPreloading.value = false
-				preloadProgress.value = 0
-			})
-
-			// 使用更新后的音频源
-			audio.src = updatedSong.sourceUrl!
-		} catch (error) {
-			console.error('[Store] 预加载过程出错:', error)
-			isPreloading.value = false
-		}
-	}
-
-	// 获取预加载的音频对象
-	const getPreloadedAudio = (songId: string): HTMLAudioElement | null => {
-		const audio = preloadedAudio.value.get(songId) || null
-		return audio
-	}
-
-	// 清理预加载的音频
-	const clearPreloadedAudio = (songId: string) => {
-		const audio = preloadedAudio.value.get(songId)
-		if (audio) {
-			audio.pause()
-			audio.src = ''
-			preloadedAudio.value.delete(songId)
-		}
-	}
-
-	// 清理所有预加载的音频
-	const clearAllPreloadedAudio = () => {
-		preloadedAudio.value.forEach((_audio, songId) => {
-			clearPreloadedAudio(songId)
-		})
-		preloadedAudio.value.clear()
-	}
-
-	// 限制预加载缓存大小（最多保留3首歌）
-	const limitPreloadCache = () => {
-		while (preloadedAudio.value.size > 3) {
-			const oldestKey = preloadedAudio.value.keys().next().value
-			if (oldestKey) {
-				clearPreloadedAudio(oldestKey)
 		} else {
+			// 关闭随机播放：恢复原始顺序
+			const restoredOrder = Array.from({ length: queue.value.length }, (_, i) => i)
+			
+			// 找到当前播放歌曲在原始顺序中的位置
+			const currentSongIndex = queueOrder.value[currentPlaying.value]
+			const newCurrentPos = restoredOrder.indexOf(currentSongIndex)
+			
+			queueOrder.value = restoredOrder
+			currentPlaying.value = newCurrentPos !== -1 ? newCurrentPos : 0
+		} */
+
+		isShuffle.value = newShuffleState
+	}
+
+	// 切换循环播放模式
+	const toggleLoop = (mode?: 'single' | 'all' | 'off') => {
+		// 如果指定了循环模式
+		if (mode) return (loopingMode.value = mode)
+
+		// 如果没有指定，那么按照「无 -> 列表循环 -> 单曲循环」的顺序轮换
+		switch (loopingMode.value) {
+			case 'off':
+				loopingMode.value = 'all'
+				break
+			case 'all':
+				loopingMode.value = 'single'
+				break
+			case 'single':
+				loopingMode.value = 'off'
 				break
 		}
 	}
-	}
-
-	// 调试函数：打印当前状态
-	const debugPreloadState = () => {
-		console.log('[Store] 预加载状态:', {
-			isPreloading: isPreloading.value,
-			progress: preloadProgress.value,
-			cacheSize: preloadedAudio.value.size,
-			cachedSongs: Array.from(preloadedAudio.value.keys()),
-			nextIndex: getNextIndex.value,
-		})
-	}
 
 	return {
-		list,
+		// 响应式状态（只读）
-		currentIndex,
+		queue: queueState,
-		isPlaying,
+		isShuffle: shuffleState,
-		queueReplaceLock,
+		loopMode: loopModeState,
-		isBuffering,
+		currentTrack,
-		currentTime,
+		currentIndex: currentPlaying,
-		duration,
+		isPlaying: playingState,
-		updatedCurrentTime,
+
-		visualizer,
+		// 修改方法
-		shuffleList,
+		replaceQueue,
-		playMode,
+		toggleShuffle,
-		shuffleCurrent,
+		toggleLoop,
-		// 预加载相关 - 确保所有函数都在返回对象中
+		togglePlay
-		preloadedAudio,
-		isPreloading,
-		preloadProgress,
-		getNextIndex,
-		preloadNext,
-		getPreloadedAudio,
-		clearPreloadedAudio,
-		clearAllPreloadedAudio,
-		limitPreloadCache,
-		debugPreloadState,
 	}
 })

src/stores/usePreferences.ts

@@ -1,5 +1,5 @@
-import { defineStore } from "pinia"
+import { defineStore } from 'pinia'
-import { ref, watch } from "vue"
+import { ref, watch } from 'vue'
 
 // 声明全局类型
 declare global {
@@ -20,14 +20,18 @@ export const usePreferences = defineStore('preferences', () => {
 	const defaultPreferences = {
 		displayTimeLeft: false,
 		presentLyrics: false,
-		autoRedirect: true
+		autoRedirect: true,
 	}
 
 	// 检测可用的 API
 	const detectAvailableAPIs = () => {
 		// 检查原生 chrome API
 		try {
-			if (typeof chrome !== 'undefined' && chrome.storage && chrome.storage.sync) {
+			if (
+				typeof chrome !== 'undefined' &&
+				chrome.storage &&
+				chrome.storage.sync
+			) {
 				storageType.value = 'chrome'
 				return 'chrome'
 			}
@@ -37,7 +41,11 @@ export const usePreferences = defineStore('preferences', () => {
 
 		// 检查 window.chrome
 		try {
-			if (window.chrome && window.chrome.storage && window.chrome.storage.sync) {
+			if (
+				window.chrome &&
+				window.chrome.storage &&
+				window.chrome.storage.sync
+			) {
 				storageType.value = 'chrome'
 				return 'chrome'
 			}
@@ -143,7 +151,7 @@ export const usePreferences = defineStore('preferences', () => {
 		const preferences = {
 			displayTimeLeft: displayTimeLeft.value,
 			presentLyrics: presentLyrics.value,
-			autoRedirect: autoRedirect.value
+			autoRedirect: autoRedirect.value,
 		}
 		await setStoredValue('preferences', preferences)
 	}
@@ -188,6 +196,6 @@ export const usePreferences = defineStore('preferences', () => {
 		getStoredValue,
 		setStoredValue,
 		getPreferences,
-		savePreferences
+		savePreferences,
 	}
 })

src/stores/useUpdatePopup.ts

@@ -1,5 +1,6 @@
-import { defineStore } from "pinia"
+import { defineStore } from 'pinia'
-import { ref } from "vue"
+import { ref } from 'vue'
+import { debugStore } from '../utils/debug'
 
 // 声明全局类型
 declare global {
@@ -26,7 +27,11 @@ export const useUpdatePopup = defineStore('updatePopup', () => {
 	const detectAvailableAPIs = () => {
 		// 检查原生 chrome API
 		try {
-			if (typeof chrome !== 'undefined' && chrome.storage && chrome.storage.sync) {
+			if (
+				typeof chrome !== 'undefined' &&
+				chrome.storage &&
+				chrome.storage.sync
+			) {
 				storageType.value = 'chrome'
 				return 'chrome'
 			}
@@ -36,7 +41,11 @@ export const useUpdatePopup = defineStore('updatePopup', () => {
 
 		// 检查 window.chrome
 		try {
-			if (window.chrome && window.chrome.storage && window.chrome.storage.sync) {
+			if (
+				window.chrome &&
+				window.chrome.storage &&
+				window.chrome.storage.sync
+			) {
 				storageType.value = 'chrome'
 				return 'chrome'
 			}
@@ -143,7 +152,10 @@ export const useUpdatePopup = defineStore('updatePopup', () => {
 			}
 
 			// 获取上次显示弹窗的版本号
-			const lastShownVersion = await getStoredValue('lastUpdatePopupVersion', '')
+			const lastShownVersion = await getStoredValue(
+				'lastUpdatePopupVersion',
+				'',
+			)
 
 			// 如果版本号不同，需要显示弹窗并更新存储的版本号
 			if (lastShownVersion !== currentVersion) {
@@ -153,7 +165,7 @@ export const useUpdatePopup = defineStore('updatePopup', () => {
 
 			return false
 		} catch (error) {
-			console.error('检查更新弹窗状态失败:', error)
+			debugStore('检查更新弹窗状态失败', error)
 			return false
 		}
 	}
@@ -166,7 +178,7 @@ export const useUpdatePopup = defineStore('updatePopup', () => {
 				await setStoredValue('lastUpdatePopupVersion', currentVersion)
 			}
 		} catch (error) {
-			console.error('标记更新弹窗已显示失败:', error)
+			debugStore('标记更新弹窗已显示失败', error)
 		}
 	}
 
@@ -182,7 +194,7 @@ export const useUpdatePopup = defineStore('updatePopup', () => {
 			detectAvailableAPIs()
 			isLoaded.value = true
 		} catch (error) {
-			console.error('初始化更新弹窗 store 失败:', error)
+			debugStore('初始化更新弹窗 store 失败', error)
 			isLoaded.value = true
 		}
 	}
@@ -199,6 +211,6 @@ export const useUpdatePopup = defineStore('updatePopup', () => {
 		getLastShownVersion,
 		initializeUpdatePopup,
 		getStoredValue,
-		setStoredValue
+		setStoredValue,
 	}
 })

src/style.css

@@ -1,15 +1,15 @@
 @import "tailwindcss";
 /* 导入来自 /assets/MiSans_VF.ttf 的字体 */
 @font-face {
-	font-family: 'MiSans';
+	font-family: "MiSans";
-	src: url('/assets/MiSans_VF.ttf') format('truetype-variations');
+	src: url("/assets/MiSans_VF.ttf") format("truetype-variations");
 	font-weight: 1 999;
 	font-display: swap;
 }
 
 @font-face {
-	font-family: 'Alte DIN';
+	font-family: "Alte DIN";
-	src: url('/assets/din1451alt.ttf') format('truetype-variations');
+	src: url("/assets/din1451alt.ttf") format("truetype-variations");
 	font-weight: 1 999;
 	font-display: swap;
 }
@@ -27,5 +27,5 @@ input {
 }
 
 .track_num {
-	font-family: 'DIN Alternate', 'Alte DIN' !important;
+	font-family: "DIN Alternate", "Alte DIN" !important;
 }

src/utils/artistsOrganize.ts

@@ -1,6 +1,10 @@
 export default (list: string[]) => {
-	if (list.length === 0) { return '未知音乐人' }
+	if (list.length === 0) {
-	return list.map((artist) => {
+		return '未知音乐人'
-		return artist
+	}
-	}).join(' / ')
+	return list
+		.map((artist) => {
+			return artist
+		})
+		.join(' / ')
 }

src/utils/audioVisualizer.ts

@@ -1,5 +1,6 @@
 // utils/audioVisualizer.ts - 平衡频谱版本
 import { ref, onUnmounted, Ref } from 'vue'
+import { debugVisualizer } from './debug'
 
 interface AudioVisualizerOptions {
 	sensitivity?: number
@@ -24,10 +25,10 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 		midBoost = 1.2, // 提升中音
 		trebleBoost = 1.5, // 提升高音
 		threshold = 15, // 响度门槛，低于此值不产生波动
-    minHeight = 0         // 最小高度百分比
+		minHeight = 0, // 最小高度百分比
 	} = options
 
-  console.log('[AudioVisualizer] 初始化平衡频谱，选项:', options)
+	debugVisualizer('初始化平衡频谱', options)
 
 	// 导出的竖杠高度值数组 (0-100)
 	const barHeights: Ref<number[]> = ref(Array(barCount).fill(0))
@@ -46,7 +47,7 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 	// 调试日志
 	function log(...args: any[]) {
 		if (debug) {
-      console.log('[AudioVisualizer]', ...args)
+			debugVisualizer(...args)
 		}
 	}
 
@@ -65,8 +66,15 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 		try {
 			log('开始初始化音频上下文...')
 
-      audioContext = new (window.AudioContext || (window as any).webkitAudioContext)()
+			audioContext = new (
-      log('AudioContext 创建成功, 状态:', audioContext.state, '采样率:', audioContext.sampleRate)
+				window.AudioContext || (window as any).webkitAudioContext
+			)()
+			log(
+				'AudioContext 创建成功, 状态:',
+				audioContext.state,
+				'采样率:',
+				audioContext.sampleRate,
+			)
 
 			// 如果上下文被暂停，尝试恢复
 			if (audioContext.state === 'suspended') {
@@ -98,7 +106,7 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 				frequencyBinCount: analyser.frequencyBinCount,
 				sampleRate: audioContext.sampleRate,
 				frequencyResolution: audioContext.sampleRate / analyser.fftSize,
-        maxDecibels: analyser.maxDecibels
+				maxDecibels: analyser.maxDecibels,
 			})
 
 			// 连接音频节点
@@ -111,7 +119,6 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 			isInitialized.value = true
 			error.value = null
 			log('✅ 音频可视化器初始化成功')
-      
 		} catch (err) {
 			log('❌ 音频上下文初始化失败:', err)
 			error.value = `初始化失败: ${err instanceof Error ? err.message : String(err)}`
@@ -150,21 +157,29 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 		analyser.getByteFrequencyData(dataArray)
 
 		// 使用平衡的频段分割
-    const frequencyBands = divideFrequencyBandsBalanced(dataArray, barCount, audioContext.sampleRate)
+		const frequencyBands = divideFrequencyBandsBalanced(
+			dataArray,
+			barCount,
+			audioContext.sampleRate,
+		)
 
 		// 应用频段特定的增强
 		const enhancedBands = applyFrequencyEnhancement(frequencyBands)
 
 		// 更新竖杠高度 (0-100)
-    barHeights.value = enhancedBands.map(value => 
+		barHeights.value = enhancedBands.map((value) =>
-      Math.min(100, Math.max(0, (value / 255) * 100 * sensitivity))
+			Math.min(100, Math.max(0, (value / 255) * 100 * sensitivity)),
 		)
 
 		animationId = requestAnimationFrame(animate)
 	}
 
 	// 平衡的频段分割 - 使用对数分布和人耳感知特性
-  function divideFrequencyBandsBalanced(data: Uint8Array, bands: number, sampleRate: number): number[] {
+	function divideFrequencyBandsBalanced(
+		data: Uint8Array,
+		bands: number,
+		sampleRate: number,
+	): number[] {
 		const nyquist = sampleRate / 2
 		const result: number[] = []
 
@@ -175,11 +190,12 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 			{ min: 250, max: 800, name: '中低音' }, // 索引 2
 			{ min: 800, max: 2500, name: '中音' }, // 索引 3
 			{ min: 2500, max: 6000, name: '中高音' }, // 索引 4
-			{ min: 6000, max: 20000, name: '高音' }    // 索引 5
+			{ min: 6000, max: 20000, name: '高音' }, // 索引 5
 		]
 
 		for (let i = 0; i < bands; i++) {
-      const range = frequencyRanges[i] || frequencyRanges[frequencyRanges.length - 1]
+			const range =
+				frequencyRanges[i] || frequencyRanges[frequencyRanges.length - 1]
 
 			// 将频率转换为 bin 索引
 			const startBin = Math.floor((range.min / nyquist) * data.length)
@@ -190,7 +206,9 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 			const actualEnd = Math.min(data.length - 1, endBin)
 
 			if (debug && Math.random() < 0.01) {
-        log(`频段 ${i} (${range.name}): ${range.min}-${range.max}Hz, bins ${actualStart}-${actualEnd}`)
+				log(
+					`频段 ${i} (${range.name}): ${range.min}-${range.max}Hz, bins ${actualStart}-${actualEnd}`,
+				)
 			}
 
 			// 计算该频段的 RMS (均方根) 值，而不是简单平均
@@ -213,7 +231,14 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 	// 应用频段特定的增强和门槛
 	function applyFrequencyEnhancement(bands: number[]): number[] {
 		// 六个频段的增强倍数
-    const boosts = [bassBoost, bassBoost, midBoost, midBoost, trebleBoost, trebleBoost]
+		const boosts = [
+			bassBoost,
+			bassBoost,
+			midBoost,
+			midBoost,
+			trebleBoost,
+			trebleBoost,
+		]
 
 		return bands.map((value, index) => {
 			// 应用响度门槛
@@ -221,7 +246,7 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 				if (debug && Math.random() < 0.01) {
 					log(`频段 ${index} 低于门槛: ${Math.round(value)} < ${threshold}`)
 				}
-        return minHeight * 255 / 100  // 返回最小高度对应的值
+				return (minHeight * 255) / 100 // 返回最小高度对应的值
 			}
 
 			const boost = boosts[index] || 1
@@ -252,9 +277,13 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 		if (audioElement.readyState >= 2) {
 			initAudioContext(audioElement)
 		} else {
-      audioElement.addEventListener('loadeddata', () => {
+			audioElement.addEventListener(
+				'loadeddata',
+				() => {
 					initAudioContext(audioElement)
-      }, { once: true })
+				},
+				{ once: true },
+			)
 		}
 
 		// 监听播放状态
@@ -309,7 +338,7 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 				Math.random() * 70 + 15, // 中低音：15-85
 				Math.random() * 80 + 10, // 中音：10-90
 				Math.random() * 75 + 10, // 中高音：10-85
-        Math.random() * 65 + 15   // 高音：15-80
+				Math.random() * 65 + 15, // 高音：15-80
 			]
 			testCount++
 
@@ -323,7 +352,13 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 	}
 
 	// 动态调整增强参数和门槛
-  function updateEnhancement(bass: number, mid: number, treble: number, newThreshold?: number, newMaxDecibels?: number) {
+	function updateEnhancement(
+		bass: number,
+		mid: number,
+		treble: number,
+		newThreshold?: number,
+		newMaxDecibels?: number,
+	) {
 		options.bassBoost = bass
 		options.midBoost = mid
 		options.trebleBoost = treble
@@ -338,7 +373,13 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 				log('实时更新 maxDecibels:', newMaxDecibels)
 			}
 		}
-    log('更新频段增强:', { bass, mid, treble, threshold: options.threshold, maxDecibels: options.maxDecibels })
+		log('更新频段增强:', {
+			bass,
+			mid,
+			treble,
+			threshold: options.threshold,
+			maxDecibels: options.maxDecibels,
+		})
 	}
 
 	// 设置响度门槛
@@ -373,6 +414,6 @@ export function audioVisualizer(options: AudioVisualizerOptions = {}) {
 		testWithFakeData,
 		updateEnhancement,
 		setThreshold,
-    setMaxDecibels
+		setMaxDecibels,
 	}
 }

src/utils/browserDetection.ts

@@ -1,6 +1,7 @@
 /**
  * 浏览器检测工具
  */
+import { debugUtils } from './debug'
 
 /**
  * 检测是否为 Safari 浏览器
@@ -11,13 +12,15 @@ export function isSafari(): boolean {
 
 	// 检测 Safari 浏览器（包括 iOS 和 macOS）
 	// Safari 的 User Agent 包含 'safari' 但不包含 'chrome' 或 'chromium'
-	const isSafariBrowser = ua.includes('safari') && 
+	const isSafariBrowser =
+		ua.includes('safari') &&
 		!ua.includes('chrome') &&
 		!ua.includes('chromium') &&
 		!ua.includes('android')
 
 	// 额外检查：使用 Safari 特有的 API
-	const isSafariByFeature = 'safari' in window || 
+	const isSafariByFeature =
+		'safari' in window ||
 		/^((?!chrome|android).)*safari/i.test(navigator.userAgent)
 
 	return isSafariBrowser || isSafariByFeature
@@ -28,7 +31,9 @@ export function isSafari(): boolean {
  * @returns {boolean} 如果是移动版 Safari 返回 true，否则返回 false
  */
 export function isMobileSafari(): boolean {
-	return /iPad|iPhone|iPod/.test(navigator.userAgent) && !(window as any).MSStream
+	return (
+		/iPad|iPhone|iPod/.test(navigator.userAgent) && !(window as any).MSStream
+	)
 }
 
 /**
@@ -39,16 +44,18 @@ export function supportsWebAudioVisualization(): boolean {
 	// Safari 在某些情况下对 AudioContext 的支持有限制
 	// 特别是在处理跨域音频资源时
 	if (isSafari()) {
-		console.log('[BrowserDetection] Safari detected, audio visualization disabled')
+		debugUtils('Safari浏览器检测，音频可视化禁用')
 		return false
 	}
 
 	// 检查基本的 Web Audio API 支持
-	const hasAudioContext = 'AudioContext' in window || 'webkitAudioContext' in window
+	const hasAudioContext =
-	const hasAnalyserNode = hasAudioContext && (
+		'AudioContext' in window || 'webkitAudioContext' in window
-		'AnalyserNode' in window || 
+	const hasAnalyserNode =
-		((window as any).AudioContext && 'createAnalyser' in (window as any).AudioContext.prototype)
+		hasAudioContext &&
-	)
+		('AnalyserNode' in window ||
+			((window as any).AudioContext &&
+				'createAnalyser' in (window as any).AudioContext.prototype))
 
 	return hasAudioContext && hasAnalyserNode
 }
@@ -93,6 +100,6 @@ export function getBrowserInfo() {
 		version: browserVersion,
 		isSafari: isSafari(),
 		isMobileSafari: isMobileSafari(),
-		supportsAudioVisualization: supportsWebAudioVisualization()
+		supportsAudioVisualization: supportsWebAudioVisualization(),
 	}
 }

src/utils/debug.ts

@@ -0,0 +1,30 @@
+import createDebug from 'debug'
+
+// 创建不同模块的 debug 实例
+export const debugPlayer = createDebug('msr:player')
+export const debugStore = createDebug('msr:store')
+export const debugApi = createDebug('msr:api')
+export const debugUI = createDebug('msr:ui')
+export const debugUtils = createDebug('msr:utils')
+export const debugVisualizer = createDebug('msr:visualizer')
+export const debugResource = createDebug('msr:resource')
+export const debugLyrics = createDebug('msr:lyrics')
+export const debugPlayroom = createDebug('msr:playroom')
+
+// 通用 debug 实例
+export const debug = createDebug('msr:app')
+
+// 在开发环境下默认启用所有 debug
+if (import.meta.env.DEV) {
+	// 从环境变量或 localStorage 读取 DEBUG 设置
+	const debugEnv = import.meta.env.VITE_DEBUG || localStorage.getItem('DEBUG')
+	if (debugEnv) {
+		createDebug.enable(debugEnv)
+	} else {
+		// 开发环境默认启用所有 msr: 相关的调试
+		createDebug.enable('msr:*')
+	}
+}
+
+// 导出 createDebug 以便其他地方创建自定义实例
+export default createDebug

src/utils/index.ts

@@ -1,8 +1,16 @@
-import artistsOrganize from "./artistsOrganize"
+import artistsOrganize from './artistsOrganize'
-import { audioVisualizer } from "./audioVisualizer"
+import { audioVisualizer } from './audioVisualizer'
-import cicdInfo from "./cicdInfo"
+import cicdInfo from './cicdInfo'
-import { checkAndRefreshSongResource, checkAndRefreshMultipleSongs } from "./songResourceChecker"
+import {
-import { isSafari, isMobileSafari, supportsWebAudioVisualization, getBrowserInfo } from "./browserDetection"
+	checkAndRefreshSongResource,
+	checkAndRefreshMultipleSongs,
+} from './songResourceChecker'
+import {
+	isSafari,
+	isMobileSafari,
+	supportsWebAudioVisualization,
+	getBrowserInfo,
+} from './browserDetection'
 
 export {
 	artistsOrganize,
@@ -13,5 +21,5 @@ export {
 	isSafari,
 	isMobileSafari,
 	supportsWebAudioVisualization,
-	getBrowserInfo
+	getBrowserInfo,
 }

src/utils/songResourceChecker.ts

@@ -1,5 +1,6 @@
 import axios from 'axios'
 import apis from '../apis'
+import { debugResource } from './debug'
 
 /**
  * 检查歌曲资源 URL 是否可用，如果不可用则刷新
@@ -9,10 +10,10 @@ import apis from '../apis'
  */
 export const checkAndRefreshSongResource = async (
 	song: Song,
-  updateCallback?: (updatedSong: Song) => void
+	updateCallback?: (updatedSong: Song) => void,
 ): Promise<Song> => {
 	if (!song.sourceUrl) {
-    console.warn('[ResourceChecker] 歌曲没有 sourceUrl:', song.name)
+		debugResource('歌曲没有 sourceUrl', song.name)
 		return song
 	}
 
@@ -21,25 +22,25 @@ export const checkAndRefreshSongResource = async (
 		await axios.head(song.sourceUrl, {
 			headers: {
 				'Cache-Control': 'no-cache, no-store, must-revalidate',
-        'Pragma': 'no-cache',
+				Pragma: 'no-cache',
-        'Expires': '0'
+				Expires: '0',
 			},
 			params: {
-        _t: Date.now() // 添加时间戳参数避免缓存
+				_t: Date.now(), // 添加时间戳参数避免缓存
 			},
-      timeout: 5000 // 5秒超时
+			timeout: 5000, // 5秒超时
 		})
 
 		// 资源可用，返回原始歌曲
-    console.log('[ResourceChecker] 资源可用:', song.name)
+		debugResource('资源可用', song.name)
 		return song
 	} catch (error) {
 		// 资源不可用，刷新歌曲信息
-    console.log('[ResourceChecker] 资源不可用，正在刷新:', song.name, error)
+		debugResource('资源不可用，正在刷新', song.name, error)
 
 		try {
 			const updatedSong = await apis.getSong(song.cid)
-      console.log('[ResourceChecker] 歌曲信息已刷新:', updatedSong.name)
+			debugResource('歌曲信息已刷新', updatedSong.name)
 
 			// 调用更新回调（如果提供）
 			if (updateCallback) {
@@ -48,7 +49,7 @@ export const checkAndRefreshSongResource = async (
 
 			return updatedSong
 		} catch (refreshError) {
-      console.error('[ResourceChecker] 刷新歌曲信息失败:', refreshError)
+			debugResource('刷新歌曲信息失败', refreshError)
 			// 刷新失败，返回原始歌曲
 			return song
 		}
@@ -63,7 +64,7 @@ export const checkAndRefreshSongResource = async (
  */
 export const checkAndRefreshMultipleSongs = async (
 	songs: Song[],
-  updateCallback?: (updatedSong: Song, originalIndex: number) => void
+	updateCallback?: (updatedSong: Song, originalIndex: number) => void,
 ): Promise<Song[]> => {
 	const results: Song[] = []
 
@@ -71,7 +72,7 @@ export const checkAndRefreshMultipleSongs = async (
 		const originalSong = songs[i]
 		const updatedSong = await checkAndRefreshSongResource(
 			originalSong,
-      updateCallback ? (updated) => updateCallback(updated, i) : undefined
+			updateCallback ? (updated) => updateCallback(updated, i) : undefined,
 		)
 		results.push(updatedSong)
 	}

src/vite-env.d.ts

@@ -8,10 +8,10 @@ type Song = {
 	cid: string
 	name: string
 	albumCid?: string
-  sourceUrl?: string
-  lyricUrl?: string | null
 	mvUrl?: string | null
 	mvCoverUrl?: string | null
+	sourceUrl?: string | null
+	lyricUrl?: string | null
 	artistes?: string[]
 	artists?: string[]
 }
@@ -38,6 +38,8 @@ interface ApiResponse {
 interface QueueItem {
 	song: Song
 	album?: Album
+	sourceUrl?: string
+	lyricUrl?: string | null
 }
 
 interface LyricsLine {

vite.config.ts

@@ -1,7 +1,7 @@
+import path from 'node:path'
 import tailwindcss from '@tailwindcss/vite'
 import vue from '@vitejs/plugin-vue'
 import { defineConfig } from 'vite'
-import path from "node:path"
 
 // https://vite.dev/config/
 export default defineConfig({
@@ -28,7 +28,7 @@ export default defineConfig({
 	},
 	resolve: {
 		alias: {
-      "@": path.resolve(__dirname, "./src"),
+			'@': path.resolve(__dirname, './src'),
+		},
 	},
-  }
 })