🐞 fix: 神秘的小修复

Author: imsyy

CLAUDE.md

@@ -46,6 +46,7 @@ Set `SKIP_NATIVE_BUILD=true` to skip Rust native module compilation during dev.
 ### Native Modules (`native/`)
 
 Rust-based, built via `scripts/build-native.ts`:
+
 - `taskbar-lyric` — Windows taskbar lyrics display
 - `external-media-integration` — OS media integration
 - `smtc-for-splayer` — Windows System Media Transport Controls

README.md

@@ -1,7 +1,10 @@
 > [!CAUTION]
-> # 本项目停止维护
-> 后续版本请使用 [SPlayer-Next](https://github.com/SPlayer-Dev/SPlayer-Next) 
-
+>
+> # 本项目进入维护模式
+>
+> 项目已进入维护模式，后续仅进行必要的维护与重大问题修复，不再主动开发新功能
+>
+> 新功能及后续版本请移步 [SPlayer-Next](https://github.com/SPlayer-Dev/SPlayer-Next)
 
 <div align="center">
 <img alt="logo" height="100" width="100" src="public/icons/favicon.png" />

docs/api.md

@@ -296,29 +296,6 @@
 
 ---
 
-### 歌曲宝解锁
-
-**接口**: `GET /api/unblock/gequbao?keyword={keyword}`
-
-**描述**: 获取歌曲宝解锁后的播放链接
-
-**请求参数**:
-
-- `keyword` (必需): 搜索关键词（歌曲名-歌手名）
-- `songName` (可选): 歌曲名称，用于匹配校验
-- `artist` (可选): 歌手名称，用于匹配校验
-
-**响应示例**:
-
-```json
-{
-  "code": 200,
-  "url": "https://..."
-}
-```
-
----
-
 ## 全部 API 列表
 
 **接口**: `GET /api`

electron/main/services/MusicCacheService.ts

@@ -15,16 +15,16 @@ export class MusicCacheService {
   private downloadingTasks: Map<string, Promise<string>> = new Map();
   /** 音质优先级 */
   private readonly qualityPriority: Record<string, number> = {
-    "master": 100,
-    "dolby": 95,
-    "spatial": 90,
-    "surround": 85,
+    master: 100,
+    dolby: 95,
+    spatial: 90,
+    surround: 85,
     "hi-res": 80,
-    "sq": 70,
-    "hq": 60,
-    "mq": 50,
-    "lq": 40,
-    "standard": 40,
+    sq: 70,
+    hq: 60,
+    mq: 50,
+    lq: 40,
+    standard: 40,
   };
 
   private constructor() {

electron/main/store/index.ts

@@ -72,8 +72,6 @@ export interface StoreType {
       enabled: boolean;
     };
   };
-  /** 更新通道 */
-  updateChannel?: "stable" | "nightly";
 }
 
 /**
@@ -118,7 +116,6 @@ export const useStore = () => {
       },
       downloadThreadCount: 8,
       enableDownloadHttp2: true,
-      updateChannel: "stable",
     },
   });
 };

electron/main/update/index.ts

@@ -2,7 +2,6 @@ import { type BrowserWindow } from "electron";
 import { updateLog } from "../logger";
 import electronUpdater from "electron-updater";
 import { isDev } from "../utils/config";
-import { useStore } from "../store";
 
 // import
 const { autoUpdater } = electronUpdater;
@@ -70,15 +69,6 @@ export const checkUpdate = (win: BrowserWindow, showTip: boolean = false) => {
   // 更改提示
   isShowTip = showTip;
 
-  // 获取更新通道
-  const store = useStore();
-  const updateChannel = store.get("updateChannel") || "stable";
-  const allowPrerelease = updateChannel === "nightly";
-
-  // 设置更新通道
-  autoUpdater.channel = updateChannel === "nightly" ? "nightly" : "latest";
-  // 设置是否允许 Pre-release
-  autoUpdater.allowPrerelease = allowPrerelease;
   // 检查更新
   autoUpdater
     .checkForUpdates()

electron/main/windows/taskbar-lyric-window.ts

@@ -249,7 +249,10 @@ class TaskbarLyricWindow {
       const scaleFactor = primaryDisplay.scaleFactor;
       const store = useStore();
       const GAP = store.get("taskbar.margin", 10) * scaleFactor;
-      const positionSetting = store.get("taskbar.position", "automatic") as TaskbarConfig["position"];
+      const positionSetting = store.get(
+        "taskbar.position",
+        "automatic",
+      ) as TaskbarConfig["position"];
       // autoMaxWidth 开启时无上限（撑满可用空间），关闭时按设置的像素值（逻辑像素）限制
       const autoMaxWidth = store.get("taskbar.autoMaxWidth", true);
       const maxWidthLogical = store.get("taskbar.maxWidth", 400);

electron/server/netease/index.ts

@@ -3,10 +3,14 @@ import { pathCase } from "change-case";
 import { serverLog } from "../../main/logger";
 import { useStore } from "../../main/store";
 import { defaultAMLLDbServer } from "../../main/utils/config";
+import { ensureNcmConfig, NON_API_EXPORTS } from "./ncm-config";
 import NeteaseCloudMusicApi from "@neteasecloudmusicapienhanced/api";
 
 // 初始化 NcmAPI
 export const initNcmAPI = async (fastify: FastifyInstance) => {
+  // 预热配置
+  void ensureNcmConfig();
+
   // 主信息
   fastify.get("/netease", (_, reply) => {
     reply.send({
@@ -24,6 +28,8 @@ export const initNcmAPI = async (fastify: FastifyInstance) => {
 
     // 将 path-case 转回 camelCase 或直接匹配下划线路由
     const routerName = Object.keys(NeteaseCloudMusicApi).find((key) => {
+      // 排除包的服务层导出
+      if (NON_API_EXPORTS.has(key)) return false;
       // 跳过非函数属性
       if (typeof (NeteaseCloudMusicApi as Record<string, unknown>)[key] !== "function")
         return false;
@@ -40,6 +46,9 @@ export const initNcmAPI = async (fastify: FastifyInstance) => {
     )[routerName];
     serverLog.log("🌐 Request NcmAPI:", requestPath);
 
+    // 等待 xeapi 公钥等配置就绪
+    await ensureNcmConfig();
+
     try {
       const result = await neteaseApi({
         ...(req.query as Record<string, unknown>),

electron/server/netease/ncm-api.d.ts

@@ -0,0 +1,13 @@
+// @neteasecloudmusicapienhanced/api 部分内部模块未导出类型声明，此处补充
+
+// generateConfig：注册匿名 token 并获取 xeapi 公钥
+declare module "@neteasecloudmusicapienhanced/api/generateConfig.js" {
+  const generateConfig: () => Promise<void>;
+  export default generateConfig;
+}
+
+// server.js：服务层导出
+declare module "@neteasecloudmusicapienhanced/api/server.js" {
+  const serverModule: Record<string, unknown>;
+  export default serverModule;
+}

electron/server/netease/ncm-config.ts

@@ -0,0 +1,53 @@
+// 封装对 @neteasecloudmusicapienhanced/api 内部模块的依赖
+// 该包未对外导出 generateConfig / server 的稳定接口，此处集中处理「伸进内部文件」的耦合
+import { existsSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+import { serverLog } from "../../main/logger";
+import generateConfig from "@neteasecloudmusicapienhanced/api/generateConfig.js";
+import ncmServerExports from "@neteasecloudmusicapienhanced/api/server.js";
+
+// 包 server.js 的导出（serveNcmApi、getModulesDefinitions 等）会被合并到主入口对象上，
+// 它们不是网易云接口模块，必须从动态路由中排除，避免被当作 HTTP 接口调用（如 /netease/serve-ncm-api）。
+export const NON_API_EXPORTS = new Set<string>([
+  ...Object.keys(ncmServerExports ?? {}),
+  "server", // 主入口对象上的 server getter
+]);
+
+// xeapi 公钥缓存文件路径（由 generateConfig 写入系统临时目录）
+const xeapiPublicKeyPath = join(tmpdir(), "xeapi_public_key");
+
+let ncmConfigReady = false;
+let ncmConfigPromise: Promise<void> | null = null;
+
+/**
+ * 确保 NcmAPI 配置就绪
+ *
+ * 新版本 @neteasecloudmusicapienhanced/api 的 song/url/v1 等接口改用 xeapi 加密，
+ * 必须先调用 generateConfig 注册匿名 token 并获取 xeapi 公钥，
+ * 否则请求会抛出 "xeapi public key is missing"。
+ *
+ * 不阻塞服务启动；失败时不锁死状态，下次调用会自动重试。
+ */
+export const ensureNcmConfig = (): Promise<void> => {
+  if (ncmConfigReady) return Promise.resolve();
+  if (!ncmConfigPromise) {
+    ncmConfigPromise = generateConfig()
+      .then(() => {
+        if (existsSync(xeapiPublicKeyPath)) {
+          ncmConfigReady = true;
+          serverLog.info("🔑 NcmAPI xeapi 公钥初始化完成");
+        } else {
+          serverLog.error("❌ NcmAPI xeapi 公钥生成失败，下次请求将重试");
+        }
+      })
+      .catch((error: unknown) => {
+        serverLog.error("❌ NcmAPI 配置初始化失败:", error);
+      })
+      .finally(() => {
+        // 释放，未成功时允许后续请求重新尝试
+        ncmConfigPromise = null;
+      });
+  }
+  return ncmConfigPromise;
+};