Merge pull request #765 from imsyy/dev-download

✨ feat: 支持下载时转换繁体中文

Author: imsyy

src/components/Setting/LocalSetting.vue

@@ -349,6 +349,22 @@
           class="set"
         />
       </n-card>
+      <n-card class="set-item">
+        <div class="label">
+          <n-text class="name">下载歌词转繁体</n-text>
+          <n-text class="tip" :depth="3">
+            下载的歌词文件将转换为繁体中文（包括 LRC、YRC、TTML）
+            <br />
+            使用歌词设置中的繁体变体：{{ traditionalVariantLabel }}
+          </n-text>
+        </div>
+        <n-switch
+          v-model:value="settingStore.downloadLyricToTraditional"
+          :disabled="!settingStore.downloadMeta || !settingStore.downloadLyric"
+          :round="false"
+          class="set"
+        />
+      </n-card>
       <n-card class="set-item">
         <div class="label">
           <n-text class="name">下载的歌词文件编码格式</n-text>
@@ -398,6 +414,19 @@ const cacheSizeDisplay = ref<string>("--");
 const cacheLimit = ref<number>(10); // 本地状态
 const cacheLimited = ref<number>(1); // 是否限制缓存 (1 为限制)
 
+// 繁体变体标签
+const variantMap: Record<string, string> = {
+  s2t: "繁体中文 (标准)",
+  s2tw: "台湾正体",
+  s2hk: "香港繁体",
+  s2twp: "台湾正体 (含词汇)",
+};
+
+// 繁体变体标签
+const traditionalVariantLabel = computed(() => {
+  return variantMap[settingStore.traditionalChineseVariant] || "繁体中文";
+});
+
 // 默认下载音质选项
 const downloadQualityOptions = computed(() => {
   const levels = pick(songLevelData, ["l", "m", "h", "sq", "hr", "je", "sk", "db", "jm"]);

src/core/resource/DownloadManager.ts

@@ -4,9 +4,11 @@ import { isElectron } from "@/utils/env";
 import { saveAs } from "file-saver";
 import { cloneDeep } from "lodash-es";
 import { songDownloadUrl, songLyric, songLyricTTML, songUrl, unlockSongUrl } from "@/api/song";
+import { qqMusicMatch } from "@/api/qqmusic";
 
 import { songLevelData } from "@/utils/meta";
 import { getPlayerInfoObj } from "@/utils/format";
+import { getConverter, type ConverterMode } from "@/utils/opencc";
 
 interface DownloadTask {
   song: SongType;
@@ -379,7 +381,7 @@ class DownloadManager {
 
         if (downloadLyric) {
           const lyricResult = (await songLyric(song.id)) as LyricResult;
-          lyric = this.processLyric(lyricResult);
+          lyric = await this.processLyric(lyricResult);
 
           // 获取逐字歌词内容用于另存
           if (downloadMakeYrc) {
@@ -397,6 +399,26 @@ class DownloadManager {
                 console.log(
                   `[Download] YRC fetched from lrcResult: ${!!yrcLyric}, len: ${yrcLyric?.length}`,
                 );
+
+                // Fallback: 如果官方没有 YRC，尝试从 QM 获取
+                if (!yrcLyric) {
+                  try {
+                    const artistsStr = Array.isArray(song.artists)
+                      ? song.artists.map((a) => a.name).join("/")
+                      : String(song.artists || "");
+                    const keyword = `${song.name}-${artistsStr}`;
+                    console.log(`[Download] Trying QM fallback with keyword: ${keyword}`);
+                    const qmResult = await qqMusicMatch(keyword);
+                    if (qmResult?.code === 200 && qmResult?.qrc) {
+                      yrcLyric = qmResult.qrc;
+                      console.log(
+                        `[Download] QM QRC fetched as fallback, len: ${yrcLyric?.length}`,
+                      );
+                    }
+                  } catch (e) {
+                    console.error("[Download] Error fetching QM lyrics as fallback:", e);
+                  }
+                }
               }
             } catch (e) {
               console.error("[Download] Error fetching verbatim lyrics:", e);
@@ -424,6 +446,9 @@ class DownloadManager {
           let content = ttmlLyric || yrcLyric;
           if (content) {
             try {
+              // 繁体转换
+              content = await this._convertToTraditionalIfNeeded(content);
+
               const ext = ttmlLyric ? "ttml" : "yrc";
               const fileName = `${safeFileName}.${ext}`;
               const encoding = settingStore.downloadLyricEncoding || "utf-8";
@@ -479,7 +504,7 @@ class DownloadManager {
    * @param lyricResult 歌词结果
    * @returns 处理后的歌词字符串
    */
-  private processLyric(lyricResult: LyricResult): string {
+  private async processLyric(lyricResult: LyricResult): Promise<string> {
     const settingStore = useSettingStore();
     try {
       const rawLyric = lyricResult?.lrc?.lyric || "";
@@ -595,7 +620,12 @@ class DownloadManager {
           }
         }
       }
-      return lines.join("\n");
+      const result = lines.join("\n");
+
+      // 繁体转换
+      return await this._convertToTraditionalIfNeeded(result);
+
+
     } catch (e) {
       console.error("Lyric processing failed", e);
       return "";
@@ -659,6 +689,20 @@ class DownloadManager {
       this.retryDownload(id);
     });
   }
+  /**
+   * 繁体转换辅助方法
+   * @param text 需要转换的文本
+   * @returns 转换后的文本
+   */
+  private async _convertToTraditionalIfNeeded(text: string): Promise<string> {
+    const settingStore = useSettingStore();
+    if (settingStore.downloadLyricToTraditional && text) {
+      const variant = (settingStore.traditionalChineseVariant || "s2t") as ConverterMode;
+      const converter = await getConverter(variant);
+      return converter(text);
+    }
+    return text;
+  }
 }
 
 let instance: DownloadManager | null = null;

src/stores/setting.ts

@@ -103,6 +103,8 @@ export interface SettingState {
   useUnlockForDownload: boolean;
   /** 内嵌暂逐字歌词 (beta) */
   downloadMakeYrc: boolean;
+  /** 下载歌词转繁体 */
+  downloadLyricToTraditional: boolean;
   /** 下载歌词文件编码 */
   downloadLyricEncoding: "utf-8" | "gbk" | "utf-16" | "iso-8859-1";
   /** 默认下载音质（弹窗默认选项） */
@@ -443,6 +445,7 @@ export const useSettingStore = defineStore("setting", {
     usePlaybackForDownload: false,
     useUnlockForDownload: false,
     downloadMakeYrc: false,
+    downloadLyricToTraditional: false,
     downloadLyricEncoding: "utf-8",
     saveMetaFile: false,
     downloadSongLevel: "h",