✨ feat: 下一首歌曲封面预载 & 可单独关闭歌曲缓存

Author: imsyy

electron/main/services/CacheService.ts

@@ -207,6 +207,9 @@ export class CacheService {
     const { target } = this.resolveSafePath(type, key);
     const buffer = this.toBuffer(data);
 
+    // 检查并清理超限缓存
+    await this.checkAndCleanCache();
+
     // 检查旧文件大小
     let oldSize = 0;
     try {
@@ -243,6 +246,51 @@ export class CacheService {
     this.sizes[type] = this.sizes[type] - oldSize + dataToWrite.length;
   }
 
+  /**
+   * 检查并清理超限缓存
+   * 优先清理 music 类型的缓存
+   */
+  public async checkAndCleanCache(): Promise<void> {
+    const store = useStore();
+    const limitSizeGB = store.get("cacheLimit") ?? 10;
+
+    // 如果设置为 0，则不限制
+    if (limitSizeGB <= 0) return;
+
+    const limitSizeBytes = limitSizeGB * 1024 * 1024 * 1024;
+    const currentSize = await this.getSize();
+
+    if (currentSize <= limitSizeBytes) return;
+
+    // 需要腾出的空间（至少 100MB）
+    const targetFreeSize = currentSize - limitSizeBytes + 100 * 1024 * 1024;
+    let freedSize = 0;
+
+    // 清理顺序：优先清理 music，然后是其他类型
+    const cleanOrder: CacheResourceType[] = ["music", "lyrics", "list-data", "local-data"];
+
+    for (const cacheType of cleanOrder) {
+      if (freedSize >= targetFreeSize) break;
+
+      const items = await this.list(cacheType);
+      // 按 atime 升序排序 (最久未访问的在前)
+      items.sort((a, b) => a.atime - b.atime);
+
+      for (const item of items) {
+        if (freedSize >= targetFreeSize) break;
+        try {
+          await this.remove(cacheType, item.key);
+          freedSize += item.size;
+          cacheLog.info(`Cleaned cache: ${cacheType}/${item.key}, size: ${item.size}`);
+        } catch (e) {
+          cacheLog.warn(`Failed to remove cache file: ${item.key}`, e);
+        }
+      }
+    }
+
+    cacheLog.info(`Cache cleanup completed. Freed: ${freedSize} bytes`);
+  }
+
   /**
    * 读取缓存
    */

electron/main/services/MusicCacheService.ts

@@ -2,7 +2,6 @@ import { existsSync, createWriteStream } from "fs";
 import { unlink, rename, stat } from "fs/promises";
 import { pipeline } from "stream/promises";
 import { CacheService } from "./CacheService";
-import { useStore } from "../store";
 import { cacheLog } from "../logger";
 import got from "got";
 
@@ -54,9 +53,7 @@ export class MusicCacheService {
       const items = await this.cacheService.list("music");
       // 查找以 id_ 开头且以 .sc 结尾的文件（排除 .tmp 文件）
       const prefix = `${id}_`;
-      const match = items.find(
-        (item) => item.key.startsWith(prefix) && item.key.endsWith(".sc"),
-      );
+      const match = items.find((item) => item.key.startsWith(prefix) && item.key.endsWith(".sc"));
       if (match) {
         return this.cacheService.getFilePath("music", match.key);
       }
@@ -74,30 +71,16 @@ export class MusicCacheService {
    * @returns 缓存后的本地文件路径
    */
   public async cacheMusic(id: number | string, url: string, quality: string): Promise<string> {
-    const store = useStore();
-    const limitSizeGB = store.get("cacheLimit") ?? 10;
-    const limitSizeBytes = limitSizeGB * 1024 * 1024 * 1024;
-
-    // 如果设置为 0，则不限制
-    if (limitSizeGB > 0) {
-      const currentSize = await this.cacheService.getSize();
-
-      if (currentSize > limitSizeBytes) {
-        // 腾出至少 100MB 空间
-        await this.cacheService.cleanOldCache(
-          "music",
-          currentSize - limitSizeBytes + 100 * 1024 * 1024,
-        );
-      }
-    }
-
     const key = this.getCacheKey(id, quality);
     const filePath = this.cacheService.getFilePath("music", key);
     const tempPath = `${filePath}.tmp`;
 
     // 确保目录存在
     await this.cacheService.init();
 
+    // 检查并清理超限缓存
+    await this.cacheService.checkAndCleanCache();
+
     // 下载并写入
     try {
       const downloadStream = got.stream(url);

src/components/Setting/LocalSetting.vue

@@ -108,6 +108,13 @@
         <n-switch class="set" v-model:value="settingStore.cacheEnabled" :round="false" />
       </n-card>
       <n-collapse-transition :show="settingStore.cacheEnabled">
+        <n-card class="set-item">
+          <div class="label">
+            <n-text class="name">缓存歌曲</n-text>
+            <n-text class="tip" :depth="3">是否缓存歌曲音频，关闭后可节省缓存空间</n-text>
+          </div>
+          <n-switch class="set" v-model:value="settingStore.songCacheEnabled" :round="false" />
+        </n-card>
         <n-card class="set-item">
           <div class="label">
             <n-text class="name">缓存大小上限</n-text>

src/components/Setting/PlaySetting.vue

@@ -333,7 +333,7 @@
 
 <script setup lang="ts">
 import type { SelectOption } from "naive-ui";
-import { useSettingStore, useStatusStore } from "@/stores";
+import { useSettingStore } from "@/stores";
 import { isLogin } from "@/utils/auth";
 import { renderOption } from "@/utils/helper";
 import { isElectron } from "@/utils/env";
@@ -342,7 +342,6 @@ import { usePlayerController } from "@/core/player/PlayerController";
 import { openSongUnlockManager } from "@/utils/modal";
 
 const player = usePlayerController();
-const statusStore = useStatusStore();
 const settingStore = useSettingStore();
 // 输出设备数据
 const outputDevices = ref<SelectOption[]>([]);

src/core/player/SongManager.ts

@@ -36,14 +36,47 @@ class SongManager {
   /** 预载下一首歌曲播放信息 */
   private nextPrefetch: AudioSource | undefined;
 
+  /**
+   * 预加载封面图片
+   * @param song 歌曲信息
+   */
+  private prefetchCover(song: SongType): void {
+    if (!song || song.path) return; // 本地歌曲跳过
+
+    const coverUrls: string[] = [];
+
+    // 收集需要预加载的封面 URL
+    if (song.coverSize) {
+      // 优先预加载大尺寸封面
+      if (song.coverSize.xl) coverUrls.push(song.coverSize.xl);
+      if (song.coverSize.l) coverUrls.push(song.coverSize.l);
+    }
+    if (song.cover && !coverUrls.includes(song.cover)) {
+      coverUrls.push(song.cover);
+    }
+    // 预加载图片
+    coverUrls.forEach((url) => {
+      if (!url || !url.startsWith("http")) return;
+      const img = new Image();
+      // 清理
+      const cleanup = () => {
+        img.onload = null;
+        img.onerror = null;
+      };
+      img.onload = cleanup;
+      img.onerror = cleanup;
+      img.src = url;
+    });
+  }
+
   /**
    * 检查本地缓存
    * @param id 歌曲id
    * @param quality 音质
    */
   private checkLocalCache = async (id: number, quality?: QualityType): Promise<string | null> => {
     const settingStore = useSettingStore();
-    if (isElectron && settingStore.cacheEnabled) {
+    if (isElectron && settingStore.cacheEnabled && settingStore.songCacheEnabled) {
       try {
         const cachePath = await window.electron.ipcRenderer.invoke(
           "music-cache-check",
@@ -69,7 +102,7 @@ class SongManager {
    */
   private triggerCacheDownload = (id: number, url: string, quality?: QualityType | string) => {
     const settingStore = useSettingStore();
-    if (isElectron && settingStore.cacheEnabled && url) {
+    if (isElectron && settingStore.cacheEnabled && settingStore.songCacheEnabled && url) {
       window.electron.ipcRenderer.invoke("music-cache-download", id, url, quality || "standard");
     }
   };
@@ -189,6 +222,9 @@ class SongManager {
       const nextSong = playList[nextIndex];
       if (!nextSong) return;
 
+      // 预加载封面图片
+      this.prefetchCover(nextSong);
+
       // 本地歌曲跳过
       if (nextSong.path) return;
 

src/stores/setting.ts

@@ -75,6 +75,8 @@ export interface SettingState {
   downloadPath: string;
   /** 是否启用缓存 */
   cacheEnabled: boolean;
+  /** 是否缓存歌曲（音频文件） */
+  songCacheEnabled: boolean;
   /** 音乐命名格式 */
   fileNameFormat: "title" | "artist-title" | "title-artist";
   /** 文件智能分类 */
@@ -140,7 +142,7 @@ export interface SettingState {
   /** 背景动画流动速度 */
   playerBackgroundFlowSpeed: number;
   /** 背景动画是否在歌曲暂停时暂停 */
-  playerBackgroundPause: boolean
+  playerBackgroundPause: boolean;
   /** 播放器元素自动隐藏 */
   autoHidePlayerMeta: boolean;
   /** 记忆最后进度 */
@@ -388,6 +390,7 @@ export const useSettingStore = defineStore("setting", {
     showLocalCover: true,
     downloadPath: "",
     cacheEnabled: true,
+    songCacheEnabled: true,
     fileNameFormat: "title-artist",
     folderStrategy: "none",
     downloadMeta: true,