🐞 fix: 完善自定义协议处理逻辑

Author: imsyy

electron/main/index.ts

@@ -81,7 +81,7 @@ class MainProcess {
     // 自定义协议
     app.on("open-url", (_, url) => {
       processLog.log("🔗 Received custom protocol URL:", url);
-      trySendCustomProtocol(url)
+      trySendCustomProtocol(url);
     });
 
     // 将要退出

electron/main/ipc/ipc-window.ts

@@ -2,10 +2,14 @@ import { app, ipcMain } from "electron";
 import { useStore } from "../store";
 import { isDev } from "../utils/config";
 import { initThumbar } from "../thumbar";
+import { processProtocolFromCommand } from "../utils/protocol";
 import mainWindow from "../windows/main-window";
 import loadWindow from "../windows/load-window";
 import loginWindow from "../windows/login-window";
 
+// 记录是否已处理启动协议
+let isProtocolProcessed = false;
+
 /**
  * 窗口 IPC 通信
  * @returns void
@@ -42,7 +46,14 @@ const initWindowsIpc = (): void => {
       }
     }, 100);
     // 初始化缩略图工具栏
-    if (mainWin) initThumbar(mainWin);
+    if (mainWin) {
+      initThumbar(mainWin);
+      // 检查是否有自定义协议启动（仅执行一次）
+      if (!isProtocolProcessed) {
+        processProtocolFromCommand(process.argv);
+        isProtocolProcessed = true;
+      }
+    }
   });
 
   // 最小化

electron/main/utils/protocol.ts

@@ -2,11 +2,20 @@ import { app } from "electron";
 import { processLog } from "../logger";
 import mainWindow from "../windows/main-window";
 
+/**
+ * 注册自定义协议
+ * 用于在外部打开应用时传递 URL 参数
+ */
 export const registerCustomProtocol = () => {
   app.setAsDefaultProtocolClient("orpheus");
   processLog.info("🔗 Registered custom protocol");
 };
 
+/**
+ * 尝试发送自定义协议 URL 到主窗口
+ * @param str 自定义协议字符串
+ * @returns 是否成功发送
+ */
 export const trySendCustomProtocol = (str: string): boolean => {
   try {
     if (str.startsWith("orpheus://")) {
@@ -18,13 +27,18 @@ export const trySendCustomProtocol = (str: string): boolean => {
     processLog.error("❌ Failed to send protocol url", e);
     return false;
   }
-}
+};
 
+/**
+ * 从命令行参数中处理自定义协议
+ * @param command 命令行参数数组
+ * @returns 是否成功处理协议
+ */
 export const processProtocolFromCommand = (command: string[]): boolean => {
   // 这里第一个参数是程序名称 忽略此 仅遍历参数
   for (let i = 1; i < command.length; i++) {
     const arg = command[i];
     if (trySendCustomProtocol(arg)) return true;
   }
   return false;
-}
+};

src/components/Layout/Menu.vue

@@ -132,6 +132,13 @@ const menuOptions = computed<MenuOption[] | MenuGroupOption[]>(() => {
           show: isLogin() === 1 && !settingStore.hideCloud,
           icon: renderIcon("Cloud"),
         },
+        // {
+        //   key: "download",
+        //   link: "download",
+        //   label: "下载管理",
+        //   show: isElectron,
+        //   icon: renderIcon("Download"),
+        // },
         {
           key: "local",
           link: "local",
@@ -283,8 +290,8 @@ const menuUpdate = (key: string, item: MenuOption) => {
 
 // 选中菜单项
 const checkMenuItem = () => {
-   // 当前路由名称
-   let routerName =
+  // 当前路由名称
+  let routerName =
     (router.currentRoute.value.matched?.[0]?.name as string) ||
     (router.currentRoute.value?.name as string);
   if (!routerName) return;
@@ -296,6 +303,10 @@ const checkMenuItem = () => {
   if (routerName.startsWith("like-") && routerName !== "like-songs") {
     routerName = "like";
   }
+  // 处理下载子路由
+  if (routerName.startsWith("download-")) {
+    routerName = "download";
+  }
   // 显示菜单
   menuRef.value?.showOption(routerName);
   // 高亮菜单

src/router/routes.ts

@@ -225,6 +225,26 @@ const appRoutes: Array<RouteRecordRaw> = [
       },
     ],
   },
+  // 下载管理
+  {
+    path: "/download",
+    name: "download",
+    meta: { needApp: true },
+    component: () => import("@/views/Download/layout.vue"),
+    redirect: "/download/downloaded",
+    children: [
+      {
+        path: "downloaded",
+        name: "download-downloaded",
+        component: () => import("@/views/Download/downloaded.vue"),
+      },
+      {
+        path: "downloading",
+        name: "download-downloading",
+        component: () => import("@/views/Download/downloading.vue"),
+      },
+    ],
+  },
   // 本地歌曲
   {
     path: "/local",

src/utils/protocal.ts

@@ -22,9 +22,7 @@ export const handleProtocolUrl = (url: string) => {
     default:
       break;
   }
-}
-
-
+};
 
 export const handleOpenOrpheus = async (url: string) => {
   const data = parseOrpheus(url);
@@ -48,8 +46,31 @@ const parseOrpheus = (url: string): OrpheusData | undefined => {
   // 形如 `{"type":"song","id":"1826361712","cmd":"play"}`
 
   if (!url.startsWith("orpheus://")) return;
-  const path = url.replace("orpheus://", "");
-  const jsonString = atob(path);
+  let path = url.replace("orpheus://", "");
+  // 移除末尾可能存在的斜杠
+  if (path.endsWith("/")) {
+    path = path.slice(0, -1);
+  }
+  // 尝试 URL 解码
+  try {
+    path = decodeURIComponent(path);
+  } catch (e) {
+    console.warn("URL Decode failed, using original path:", e);
+  }
+  // 处理 URL-safe Base64
+  path = path.replace(/-/g, "+").replace(/_/g, "/");
+  // 补全 Base64 填充
+  const padding = path.length % 4;
+  if (padding > 0) {
+    path += "=".repeat(4 - padding);
+  }
+  let jsonString: string;
+  try {
+    jsonString = atob(path);
+  } catch (e) {
+    console.error("❌ Failed to decode base64:", path, e);
+    return;
+  }
   let data: OrpheusData;
   try {
     const json = JSON.parse(jsonString);
@@ -59,4 +80,4 @@ const parseOrpheus = (url: string): OrpheusData | undefined => {
     return;
   }
   return data;
-}
+};

src/views/Download/downloaded.vue

@@ -0,0 +1,24 @@
+<template>
+  <div class="download-downloaded">
+    <SongList
+      :data="data"
+      :loading="loading"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+import type { SongType } from "@/types/main";
+import SongList from "@/components/List/SongList.vue";
+
+defineProps<{
+  data: SongType[];
+  loading: boolean;
+}>();
+</script>
+
+<style lang="scss" scoped>
+.download-downloaded {
+  height: 100%;
+}
+</style>

src/views/Download/downloading.vue

@@ -0,0 +1,14 @@
+<template>
+  <div class="download-downloading">
+    <n-empty description="暂无正在下载的任务" class="empty" />
+  </div>
+</template>
+
+<style lang="scss" scoped>
+.download-downloading {
+  height: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+</style>