🎈 perf: 优化下载逻辑

Author: kazukokawagawa

src/components/Setting/LocalSetting.vue

@@ -144,13 +144,14 @@
       </n-card>
       <n-card class="set-item">
         <div class="label">
-          <n-text class="name">模拟播放下载</n-text>
+          <n-text class="name">模拟播放下载<n-tag type="warning" size="small" round>Beta</n-tag></n-text>
           <n-text class="tip" :depth="3">使用播放接口进行下载，可能解决部分下载失败问题</n-text>
         </div>
         <n-switch
-          v-model:value="settingStore.usePlaybackForDownload"
+          :value="settingStore.usePlaybackForDownload"
           :round="false"
           class="set"
+          @update:value="handlePlaybackDownloadChange"
         />
       </n-card>
       <n-card class="set-item">
@@ -180,6 +181,23 @@ const choosePath = async () => {
   const path = await window.electron.ipcRenderer.invoke("choose-path");
   if (path) settingStore.downloadPath = path;
 };
+
+// 模拟播放下载开关
+const handlePlaybackDownloadChange = (value: boolean) => {
+  if (value) {
+    window.$dialog.warning({
+      title: "开启提示",
+      content: "模拟播放下载可能导致部分音质歌词嵌入异常且未经完整测试可能有不稳定情况，确认要打开吗？",
+      positiveText: "确认打开",
+      negativeText: "取消",
+      onPositiveClick: () => {
+        settingStore.usePlaybackForDownload = true;
+      },
+    });
+  } else {
+    settingStore.usePlaybackForDownload = false;
+  }
+};
 </script>
 
 <style lang="scss" scoped>

src/utils/download.ts

@@ -12,30 +12,54 @@ interface DownloadOptions {
   quality: SongLevelType;
   downloadPath?: string;
   skipIfExist?: boolean;
+  mode?: "standard" | "playback";
 }
 
 export const downloadSong = async ({
   song,
   quality,
   downloadPath,
   skipIfExist,
+  mode,
 }: DownloadOptions): Promise<{ success: boolean; skipped?: boolean; message?: string }> => {
   try {
     const settingStore = useSettingStore();
     let url = "";
     let type = "mp3";
 
+    const usePlayback = mode ? mode === "playback" : settingStore.usePlaybackForDownload;
+
     // 获取下载链接
-    if (settingStore.usePlaybackForDownload) {
-      const levelName = songLevelData[quality].level;
-      // @ts-ignore
-      const result = await songUrl(song.id, levelName);
-      if (result.code !== 200 || !result?.data?.[0]?.url) {
-        return { success: false, message: result.message || "获取播放链接失败" };
+    const levelName = songLevelData[quality].level;
+    // songUrl 仅支持以下音质
+    const allowedLevels = [
+      "standard",
+      "higher",
+      "exhigh",
+      "lossless",
+      "hires",
+      "jyeffect",
+      "sky",
+      "jymaster",
+    ];
+
+    // 如果开启了“使用播放链接下载”且音质支持，则尝试获取播放链接
+    if (usePlayback && allowedLevels.includes(levelName)) {
+      try {
+        // @ts-ignore: levelName is checked against allowedLevels at runtime
+        const result = await songUrl(song.id, levelName);
+        if (result.code === 200 && result?.data?.[0]?.url) {
+          url = result.data[0].url;
+          type = (result.data[0].type || result.data[0].encodeType || "mp3").toLowerCase();
+        }
+      } catch (e) {
+        console.error("Error fetching playback url for download:", e);
       }
-      url = result.data[0].url;
-      type = (result.data[0].type || result.data[0].encodeType || "mp3").toLowerCase();
-    } else {
+    }
+
+    // 如果没有获取到 URL (可能是因为没开启设置，或者音质不支持，或者获取失败)，则使用标准下载接口
+    if (!url) {
+
       const result = await songDownloadUrl(song.id, quality);
       if (result.code !== 200 || !result?.data?.url) {
         return { success: false, message: result.message || "获取下载链接失败" };