From 837f0268d5580dcccff080cc803573af13bc575b Mon Sep 17 00:00:00 2001
From: alger <algerkc@qq.com>
Date: Sun, 5 Jul 2026 14:00:07 +0800
Subject: [PATCH] =?UTF-8?q?fix(player):=20=E5=90=88=E5=B9=B6=E5=A4=96?=
 =?UTF-8?q?=E9=83=A8=E8=B4=A1=E7=8C=AE=E5=90=8E=E7=9A=84=E9=9B=86=E6=88=90?=
 =?UTF-8?q?=E4=BF=AE=E5=A4=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- PlayBar 下载按钮补 isElectron 守卫，Web 端不再显示无效按钮（#708 评审意见）
- preloadNextSongs 恢复 800ms 短去抖，避免快速切歌时音源请求风暴（#712 评审意见）
- 清理合并后未使用的导入
---
 src/renderer/components/player/PlayBar.vue |  2 +-
 src/renderer/hooks/usePlayerHooks.ts       |  3 +--
 src/renderer/store/modules/playlist.ts     | 12 +++++++++++-
 3 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/src/renderer/components/player/PlayBar.vue b/src/renderer/components/player/PlayBar.vue
index 632d1ee..c74794a 100644
--- a/src/renderer/components/player/PlayBar.vue
+++ b/src/renderer/components/player/PlayBar.vue
@@ -151,7 +151,7 @@
         </template>
         {{ t('player.playBar.reparse') }}
       </n-tooltip>
-      <n-tooltip v-if="playMusic?.id" trigger="hover" :z-index="9999999">
+      <n-tooltip v-if="playMusic?.id && isElectron" trigger="hover" :z-index="9999999">
         <template #trigger>
           <i
             class="iconfont ri-download-line"
diff --git a/src/renderer/hooks/usePlayerHooks.ts b/src/renderer/hooks/usePlayerHooks.ts
index e385453..2073427 100644
--- a/src/renderer/hooks/usePlayerHooks.ts
+++ b/src/renderer/hooks/usePlayerHooks.ts
@@ -6,8 +6,7 @@ import { getMusicLrc, getMusicUrl, getParsingMusicUrl } from '@/api/music';
 import { playbackRequestManager } from '@/services/playbackRequestManager';
 import { SongSourceConfigManager } from '@/services/SongSourceConfigManager';
 import type { ILyric, ILyricText, IWordData, SongResult } from '@/types/music';
-import { getImgUrl, isElectron } from '@/utils';
-import { getImageLinearBackground } from '@/utils/linearColor';
+import { isElectron } from '@/utils';
 import { parseLyrics as parseYrcLyrics } from '@/utils/yrcParser';
 
 const { message } = createDiscreteApi(['message']);
diff --git a/src/renderer/store/modules/playlist.ts b/src/renderer/store/modules/playlist.ts
index db59fc9..d66e3c3 100644
--- a/src/renderer/store/modules/playlist.ts
+++ b/src/renderer/store/modules/playlist.ts
@@ -107,9 +107,19 @@ export const usePlaylistStore = defineStore(
     };
 
     /**
-     * 智能预加载下一首歌曲（立即执行，不等待）
+     * 智能预加载下一首歌曲
+     * 短去抖：快速连续切歌时只保留最后一次，避免对音源 API 的请求风暴
      */
+    let preloadDebounceTimer: ReturnType<typeof setTimeout> | null = null;
     const preloadNextSongs = (currentIndex: number) => {
+      if (preloadDebounceTimer) clearTimeout(preloadDebounceTimer);
+      preloadDebounceTimer = setTimeout(() => {
+        preloadDebounceTimer = null;
+        doPreloadNextSongs(currentIndex);
+      }, 800);
+    };
+
+    const doPreloadNextSongs = (currentIndex: number) => {
       if (playList.value.length <= 1) return;
 
       let nextIndex: number;