fix(mpv): 修复MPV播放UNC路径歌曲失败

Author: 577fkj

electron/main/services/MpvService.ts

@@ -3,6 +3,7 @@ import { app } from "electron";
 import { connect } from "net";
 import { join } from "path";
 import { existsSync, unlinkSync } from "fs";
+import { fileURLToPath } from "url";
 import { processLog } from "../logger";
 import mainWindow from "../windows/main-window";
 
@@ -129,7 +130,7 @@ export class MpvService {
 
       // 连接成功后再加载文件，确保能收到 file-loaded/playback-restart
       if (url) {
-        this.sendCommand("loadfile", [url, "replace"]);
+        this.sendCommand("loadfile", [this.normalizeMpvLoadTarget(url), "replace"]);
       }
     } catch (error) {
       processLog.error("启动 MPV 失败:", error);
@@ -477,4 +478,39 @@ export class MpvService {
     this.mpvProcessNonce = null;
     this.pendingFileLoaded = null;
   }
+
+  private normalizeMpvLoadTarget(url?: string) {
+    if (!url) return "";
+    if (!url.startsWith("file://")) {
+      return this.normalizeLocalPath(url);
+    }
+
+    try {
+      const parsedUrl = new URL(url);
+      if (parsedUrl.host) {
+        const uncPath = `//${parsedUrl.host}${decodeURIComponent(parsedUrl.pathname)}`;
+        return this.normalizeLocalPath(uncPath);
+      }
+    } catch {
+      // 忽略 URL 解析失败，继续走兜底逻辑
+    }
+
+    try {
+      return this.normalizeLocalPath(fileURLToPath(url));
+    } catch {
+      const rawPath = decodeURIComponent(url.slice("file://".length));
+      return this.normalizeLocalPath(rawPath);
+    }
+  }
+
+  private normalizeLocalPath(filePath: string) {
+    if (process.platform !== "win32") return filePath;
+    if (filePath.startsWith("//")) {
+      return filePath.replace(/\//g, "\\");
+    }
+    if (/^[A-Za-z]:\//.test(filePath)) {
+      return filePath.replace(/\//g, "\\");
+    }
+    return filePath;
+  }
 }

src/core/automix/AutomixManager.ts

@@ -15,6 +15,7 @@ import { isAudioAnalysis, isTransitionProposal, isAdvancedTransition } from "@/u
 import type { SongType } from "@/types/main";
 import { isElectron } from "@/utils/env";
 import { msToTime } from "@/utils/time";
+import { toFileUrl } from "@/utils/fileUrl";
 
 /**
  * 自动混音（Automix）管理器
@@ -177,8 +178,7 @@ export class AutomixManager {
       const songManager = useSongManager();
       const cachedPath = await songManager.ensureMusicCachePath(songId, audioSourceUrl, quality);
       if (cachedPath) {
-        const encodedPath = cachedPath.replace(/#/g, "%23").replace(/\?/g, "%3F");
-        return `file://${encodedPath}`;
+        return toFileUrl(cachedPath);
       }
     }
     return audioSourceUrl;

src/core/player/SongManager.ts

@@ -12,6 +12,7 @@ import { QualityType, type SongType, type AudioSourceType } from "@/types/main";
 import { isLogin } from "@/utils/auth";
 import { isElectron } from "@/utils/env";
 import { formatSongsList } from "@/utils/format";
+import { toFileUrl } from "@/utils/fileUrl";
 import { AI_AUDIO_LEVELS } from "@/utils/meta";
 import { handleSongQuality } from "@/utils/helper";
 import { openUserLogin } from "@/utils/modal";
@@ -154,7 +155,7 @@ class SongManager {
         );
         if (cachePath) {
           console.log(`🚀 [${id}] 由本地音乐缓存提供`);
-          return `file://${cachePath}`;
+          return toFileUrl(cachePath);
         }
       } catch (e) {
         console.error(`❌ [${id}] 检查缓存失败:`, e);
@@ -492,8 +493,8 @@ class SongManager {
         console.error("❌ 本地文件不存在");
         return { id: song.id, url: undefined };
       }
-      const encodedPath = song.path.replace(/#/g, "%23").replace(/\?/g, "%3F");
-      return { id: song.id, url: `file://${encodedPath}`, source: "local" };
+      const fileUrl = toFileUrl(song.path);
+      return { id: song.id, url: fileUrl, source: "local" };
     }
 
     // Stream songs (Subsonic / Jellyfin)

src/utils/fileUrl.ts

@@ -0,0 +1,21 @@
+const encodeFilePath = (filePath: string) => {
+  return encodeURI(filePath.replace(/\\/g, "/")).replace(/#/g, "%23").replace(/\?/g, "%3F");
+};
+
+export const toFileUrl = (filePath: string): string => {
+  const normalizedPath = encodeFilePath(filePath);
+
+  if (normalizedPath.startsWith("//")) {
+    return `file:${normalizedPath}`;
+  }
+
+  if (/^[A-Za-z]:\//.test(normalizedPath)) {
+    return `file:///${normalizedPath}`;
+  }
+
+  if (normalizedPath.startsWith("/")) {
+    return `file://${normalizedPath}`;
+  }
+
+  return `file:///${normalizedPath}`;
+};