✨ feat: 增加下载重试按钮，解决卡0%问题

electron/main/ipc/ipc-file.ts

@@ -379,10 +379,10 @@ const initFileIpc = (): void => {
         songData?: any;
         skipIfExist?: boolean;
       } = {
-        fileName: "未知文件名",
-        fileType: "mp3",
-        path: app.getPath("downloads"),
-      },
+          fileName: "未知文件名",
+          fileType: "mp3",
+          path: app.getPath("downloads"),
+        },
     ): Promise<{ status: "success" | "skipped" | "error"; message?: string }> => {
       try {
         // 获取窗口

src/components/Menu/SongListMenu.vue

@@ -19,6 +19,7 @@
 import type { SongType } from "@/types/main";
 import { NAlert, type DropdownOption } from "naive-ui";
 import { useStatusStore, useLocalStore, useDataStore, useMusicStore } from "@/stores";
+import DownloadManager from "@/utils/downloadManager";
 import { renderIcon, copyData } from "@/utils/helper";
 import { deleteCloudSong, importCloudSong } from "@/api/cloud";
 import {
@@ -74,6 +75,8 @@ const openDropdown = (
     const isCurrent = statusStore.playIndex === index;
     // 是否为用户歌单
     const isUserPlaylist = !!playListId && userPlaylistsData.some((pl) => pl.id === playListId);
+    // 是否正在下载或下载失败
+    const isDownloading = dataStore.downloadingSongs.some((item) => item.song.id === song.id);
     // 生成菜单
     nextTick().then(() => {
       dropdownOptions.value = [
@@ -246,10 +249,17 @@ const openDropdown = (
         {
           key: "download",
           label: "下载歌曲",
-          show: !isLocal && type === "song",
+          show: !isLocal && type === "song" && !isDownloading,
           props: { onClick: () => openDownloadSong(song) },
           icon: renderIcon("Download"),
         },
+        {
+          key: "retry-download",
+          label: "重试下载",
+          show: isDownloading,
+          props: { onClick: () => DownloadManager.retryDownload(song.id) },
+          icon: renderIcon("Refresh"),
+        },
       ];
       // 显示菜单
       dropdownX.value = e.clientX;

src/components/Setting/LocalSetting.vue

@@ -213,7 +213,6 @@
 </template>
 
 <script setup lang="ts">
-import { computed } from "vue";
 import { useSettingStore } from "@/stores";
 import { changeLocalLyricPath, changeLocalMusicPath } from "@/utils/helper";
 import { songLevelData, getSongLevelsData } from "@/utils/meta";

src/stores/data.ts

@@ -40,8 +40,8 @@ interface ListState {
     song: SongType;
     /** 音质 */
     quality: SongLevelType;
-    /** 状态：下载中 / 失败 */
-    status: "downloading" | "failed";
+    /** 状态：下载中 / 等待中 / 失败 */
+    status: "downloading" | "waiting" | "failed";
     /** 下载进度 */
     progress: number;
     /** 已传输大小 */
@@ -350,14 +350,23 @@ export const useDataStore = defineStore("data", {
       this.downloadingSongs.push({
         song: cloneDeep(song),
         quality,
-        status: "downloading",
+        status: "waiting",
         progress: 0,
         transferred: "0MB",
         totalSize: "0MB",
       });
       // 保存到本地存储
       musicDB.setItem("downloadingSongs", cloneDeep(this.downloadingSongs));
     },
+    // 更新下载状态
+    updateDownloadStatus(songId: number, status: "downloading" | "waiting" | "failed") {
+      const index = this.downloadingSongs.findIndex((item) => item.song.id === songId);
+      if (index !== -1) {
+        this.downloadingSongs[index].status = status;
+        // 强制触发响应式更新 (Fix: 下一首歌曲状态更新UI不变化的问题)
+        this.downloadingSongs = [...this.downloadingSongs];
+      }
+    },
     // 更新下载进度
     updateDownloadProgress(
       songId: number,
@@ -370,7 +379,7 @@ export const useDataStore = defineStore("data", {
         item.progress = progress;
         item.transferred = transferred;
         item.totalSize = totalSize;
-        // 进度更新过于频繁，不再实时保存到本地存储，仅在添加/删除时保存
+        // 进度更新过于频繁，不需要强制更新整个数组，以免影响性能
       }
     },
     // 移除正在下载的歌曲（下载失败时）
@@ -383,23 +392,25 @@ export const useDataStore = defineStore("data", {
     },
     // 标记下载失败（保留在列表中）
     markDownloadFailed(songId: number) {
-      const item = this.downloadingSongs.find((item) => item.song.id === songId);
-      if (item) {
-        item.status = "failed";
-        item.progress = 0;
-        item.transferred = "0MB";
-        item.totalSize = "0MB";
+      const index = this.downloadingSongs.findIndex((item) => item.song.id === songId);
+      if (index !== -1) {
+        this.downloadingSongs[index].status = "failed";
+        this.downloadingSongs[index].progress = 0;
+        this.downloadingSongs[index].transferred = "0MB";
+        this.downloadingSongs[index].totalSize = "0MB";
+        this.downloadingSongs = [...this.downloadingSongs];
         musicDB.setItem("downloadingSongs", cloneDeep(this.downloadingSongs));
       }
     },
     // 重置下载任务状态（用于重试）
     resetDownloadingSong(songId: number) {
-      const item = this.downloadingSongs.find((item) => item.song.id === songId);
-      if (item) {
-        item.status = "downloading";
-        item.progress = 0;
-        item.transferred = "0MB";
-        item.totalSize = "0MB";
+      const index = this.downloadingSongs.findIndex((item) => item.song.id === songId);
+      if (index !== -1) {
+        this.downloadingSongs[index].status = "waiting";
+        this.downloadingSongs[index].progress = 0;
+        this.downloadingSongs[index].transferred = "0MB";
+        this.downloadingSongs[index].totalSize = "0MB";
+        this.downloadingSongs = [...this.downloadingSongs];
       }
     },
   },

src/utils/downloadManager.ts

@@ -118,14 +118,17 @@ class DownloadManager {
         const total = (totalBytes / 1024 / 1024).toFixed(2) + "MB";
         dataStore.updateDownloadProgress(
           song.id,
-          Number((percent * 100).toFixed(0)),
+          Number((percent * 100).toFixed(1)),
           transferred,
           total,
         );
       };
       removeListener = window.electron.ipcRenderer.on("download-progress", progressHandler);
     }
 
+    // 更新状态为下载中
+    dataStore.updateDownloadStatus(song.id, "downloading");
+
     // 开始下载
     try {
       const result = await this.processDownload({
@@ -319,14 +322,28 @@ class DownloadManager {
     if (!task) return;
 
     // 重置任务状态与进度
-    dataStore.resetDownloadingSong(songId);
+    dataStore.updateDownloadStatus(songId, "downloading");
+    // 重置进度信息
+    dataStore.updateDownloadProgress(songId, 0, "0MB", "0MB");
 
     // 重新加入队列
     this.queue.push({ song: task.song, quality: task.quality });
 
     // 继续处理队列
     this.processQueue();
   }
+
+  /**
+   * 重试所有下载任务
+   */
+  public retryAllDownloads() {
+    const dataStore = useDataStore();
+    const songsToRetry = dataStore.downloadingSongs.map((item) => item.song.id);
+
+    songsToRetry.forEach((id) => {
+      this.retryDownload(id);
+    });
+  }
 }
 
 export default DownloadManager.getInstance();