🔧 refactor: 优化缓存服务

Author: imsyy

components.d.ts

@@ -82,7 +82,6 @@ declare module 'vue' {
     NGi: typeof import('naive-ui')['NGi']
     NGlobalStyle: typeof import('naive-ui')['NGlobalStyle']
     NGrid: typeof import('naive-ui')['NGrid']
-    NGridItem: typeof import('naive-ui')['NGridItem']
     NH1: typeof import('naive-ui')['NH1']
     NH2: typeof import('naive-ui')['NH2']
     NH3: typeof import('naive-ui')['NH3']
@@ -125,7 +124,6 @@ declare module 'vue' {
     NTag: typeof import('naive-ui')['NTag']
     NText: typeof import('naive-ui')['NText']
     NThing: typeof import('naive-ui')['NThing']
-    NUpload: typeof import('naive-ui')['NUpload']
     NVirtualList: typeof import('naive-ui')['NVirtualList']
     OtherSetting: typeof import('./src/components/Setting/OtherSetting.vue')['default']
     PersonalFM: typeof import('./src/components/Player/PersonalFM.vue')['default']
@@ -159,7 +157,6 @@ declare module 'vue' {
     SongUnlockManager: typeof import('./src/components/Modal/Setting/SongUnlockManager.vue')['default']
     SvgIcon: typeof import('./src/components/Global/SvgIcon.vue')['default']
     TextContainer: typeof import('./src/components/Global/TextContainer.vue')['default']
-    ThemeConfig: typeof import('./src/components/Modal/Setting/ThemeConfig.vue')['default']
     ThirdSetting: typeof import('./src/components/Setting/ThirdSetting.vue')['default']
     UpdateApp: typeof import('./src/components/Modal/UpdateApp.vue')['default']
     UpdatePlaylist: typeof import('./src/components/Modal/UpdatePlaylist.vue')['default']

electron/main/services/CacheService.ts

@@ -130,7 +130,21 @@ export class CacheService {
 
       for (const type of Object.keys(this.CACHE_SUB_DIR) as CacheResourceType[]) {
         const dir = join(basePath, this.CACHE_SUB_DIR[type]);
-        if (!existsSync(dir)) await mkdir(dir, { recursive: true });
+        if (!existsSync(dir)) {
+          await mkdir(dir, { recursive: true });
+        } else {
+          // 清理可能残留的临时文件 (.tmp)
+          try {
+            const files = await readdir(dir);
+            for (const file of files) {
+              if (file.endsWith(".tmp")) {
+                await rm(join(dir, file), { force: true });
+              }
+            }
+          } catch (e) {
+            cacheLog.warn(`⚠️ 无法清理目录中的临时文件: ${dir}`, e);
+          }
+        }
         // 计算初始大小
         this.sizes[type] = await this.calculateDirSize(dir);
       }

electron/main/services/LocalMusicService.ts

@@ -1,3 +1,4 @@
+import { nativeImage } from "electron";
 import { join, basename } from "path";
 import { readFile, mkdir } from "fs/promises";
 import { CacheService } from "./CacheService";
@@ -7,7 +8,6 @@ import { useStore } from "../store";
 import { type IAudioMetadata, parseFile } from "music-metadata";
 import FastGlob, { type Entry } from "fast-glob";
 import pLimit from "p-limit";
-import sharp from "sharp";
 
 /** 当前本地音乐库 DB 版本，用于控制缓存结构升级 */
 const CURRENT_DB_VERSION = 2;
@@ -138,18 +138,34 @@ export class LocalMusicService {
     const { coverDir } = this.paths;
     const picture = metadata.common.picture?.[0];
     if (!picture) return undefined;
-    const fileName = `${fileId}.webp`;
+
+    // 使用 jpg 格式，兼容性更好且无需外部依赖
+    const fileName = `${fileId}.jpg`;
     const savePath = join(coverDir, fileName);
+
     // 已存在
     if (existsSync(savePath)) return fileName;
-    // 压缩封面处理
-    const cacheService = CacheService.getInstance();
-    const buffer = await sharp(picture.data)
-      .resize(256, 256, { fit: "cover", position: "centre" })
-      .webp({ quality: 80 })
-      .toBuffer();
-    await cacheService.put("local-data", `covers/${fileName}`, buffer);
-    return fileName;
+
+    try {
+      const img = nativeImage.createFromBuffer(Buffer.from(picture.data));
+      if (img.isEmpty()) return undefined;
+
+      // 调整大小并压缩
+      const buffer = img
+        .resize({
+          width: 256,
+          height: 256,
+          quality: "better",
+        })
+        .toJPEG(80);
+
+      const cacheService = CacheService.getInstance();
+      await cacheService.put("local-data", `covers/${fileName}`, buffer);
+      return fileName;
+    } catch (e) {
+      console.error("Failed to extract cover using nativeImage:", e);
+      return undefined;
+    }
   }
 
   /**

electron/main/services/MusicCacheService.ts

@@ -1,5 +1,5 @@
 import { existsSync, createWriteStream } from "fs";
-import { unlink } from "fs/promises";
+import { unlink, rename } from "fs/promises";
 import { pipeline } from "stream/promises";
 import { CacheService } from "./CacheService";
 import { useStore } from "../store";
@@ -52,9 +52,11 @@ export class MusicCacheService {
     // 模糊查找 (API请求失败时，只要有缓存就用)
     try {
       const items = await this.cacheService.list("music");
-      // 查找以 id_ 开头的文件
+      // 查找以 id_ 开头且以 .sc 结尾的文件（排除 .tmp 文件）
       const prefix = `${id}_`;
-      const match = items.find((item) => item.key.startsWith(prefix));
+      const match = items.find(
+        (item) => item.key.startsWith(prefix) && item.key.endsWith(".sc"),
+      );
       if (match) {
         return this.cacheService.getFilePath("music", match.key);
       }
@@ -91,25 +93,29 @@ export class MusicCacheService {
 
     const key = this.getCacheKey(id, quality);
     const filePath = this.cacheService.getFilePath("music", key);
+    const tempPath = `${filePath}.tmp`;
 
     // 确保目录存在
     await this.cacheService.init();
 
     // 下载并写入
     try {
       const downloadStream = got.stream(url);
-      const fileStream = createWriteStream(filePath);
+      const fileStream = createWriteStream(tempPath);
 
       await pipeline(downloadStream, fileStream);
 
+      // 下载成功后，将临时文件重命名为正式缓存文件
+      await rename(tempPath, filePath);
+
       // 更新 CacheService 的大小记录
       await this.cacheService.notifyFileChange("music", key);
 
       return filePath;
     } catch (error) {
-      // 下载失败，清理残余
-      if (existsSync(filePath)) {
-        await unlink(filePath);
+      // 下载失败，清理残余的临时文件
+      if (existsSync(tempPath)) {
+        await unlink(tempPath).catch(() => {});
       }
       cacheLog.error("Music download failed:", error);
       throw error;

package.json

@@ -75,7 +75,6 @@
     "pinia": "^3.0.4",
     "pinia-plugin-persistedstate": "^4.7.1",
     "plyr": "^3.8.3",
-    "sharp": "^0.34.5",
     "sortablejs": "^1.15.6",
     "vue-virtual-scroller": "2.0.0-beta.8"
   },
@@ -134,7 +133,6 @@
       "electron",
       "electron-winstaller",
       "esbuild",
-      "sharp",
       "vue-demi"
     ]
   }