mioku-plugin-music 2.2.0 → 2.4.0

package/config.md

@@ -1,6 +1,6 @@
 ---
 title: Music 插件配置
-description: 在这里调整 music 插件的配置项目
+description: 在这里调整 music 插件的配置项目。Token/Cookie、Storefront、语言、音质等请分别在 Apple Music / NetEase 的「服务配置」页面配置。
 fields:
   - key: base.searchLimit
     label: 默认搜索条数
@@ -11,39 +11,20 @@ fields:
   - key: base.defaultProvider
     label: 默认音乐源
     type: select
-    description: 需要安装对应的服务
+    description: 初次安装为「无」，需要选择对应的提供商并安装其服务后使用
     options:
+      - value: ""
+        label: 无（未选择）
       - value: applemusic
         label: Apple Music
-
-  - key: base.applemusic.storefront
-    label: Apple Music Storefront
-    type: text
-    description: 默认地区代码，例如 cn、us、jp。
-    placeholder: cn
-
-  - key: base.applemusic.language
-    label: Apple Music 语言
-    type: text
-    description: 默认语言代码，例如 zh-CN、en-US。
-    placeholder: zh-CN
-
-  - key: base.applemusic.defaultMediaUserToken
-    label: 默认 Media User Token
-    type: secret
-    description: Apple Music 下载高质量 AAC 必需 token，无token仅能下载30s音频
-    placeholder: eyJ...
+      - value: netease
+        label: NetEase Cloud Music
 ---
 
+> 默认音乐源初始为「无」。请先在上方选择提供商，**重启 Bot 后会自动下载对应服务**。
+
 ```mioku-fields
 keys:
   - base.searchLimit
   - base.defaultProvider
 ```
-
-```mioku-fields
-keys:
-  - base.applemusic.storefront
-  - base.applemusic.language
-  - base.applemusic.defaultMediaUserToken
-```

package/config.ts

@@ -2,10 +2,5 @@ import type { MusicBaseConfig } from "./types";
 
 export const MUSIC_DEFAULTS: MusicBaseConfig = {
   searchLimit: 15,
-  defaultProvider: "applemusic",
-  applemusic: {
-    storefront: "cn",
-    language: "zh-CN",
-    defaultMediaUserToken: "",
-  },
+  defaultProvider: "",
 };

package/index.ts

@@ -3,6 +3,7 @@ import type { AIService } from "mioku";
 import type { ScreenshotService } from "mioku";
 import type { ConfigService } from "mioku";
 import type { AppleMusicServiceApi } from "mioku-service-applemusic";
+import type { NeteaseServiceApi } from "mioku-service-netease";
 import { resetMusicRuntimeState, setMusicRuntimeState } from "./runtime";
 import { MusicPluginRuntime } from "./runtime-core/service";
 import { MUSIC_DEFAULTS } from "./config";
@@ -25,6 +26,9 @@ export default definePlugin({
     const applemusicService = ctx.services?.applemusic as
       | AppleMusicServiceApi
       | undefined;
+    const neteaseService = ctx.services?.netease as
+      | NeteaseServiceApi
+      | undefined;
     let baseConfig = cloneConfig(MUSIC_DEFAULTS);
 
     if (configService) {
@@ -42,6 +46,7 @@ export default definePlugin({
       aiService,
       screenshotService,
       applemusicService,
+      neteaseService,
     });
     runtime.updateConfig(baseConfig);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-music",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "音乐插件：点歌、搜索音乐、听歌语音发送",
   "main": "index.ts",
   "type": "module",
@@ -59,11 +59,13 @@
   "peerDependencies": {
     "mioku": "^0.8.0",
     "mioki": "^0.16.0",
-    "mioku-service-applemusic": "^2.0.0"
+    "mioku-service-applemusic": "^2.0.0",
+    "mioku-service-netease": "^1.0.0"
   },
   "devDependencies": {
     "mioku": "workspace:*",
     "mioki": "^0.16.0",
-    "mioku-service-applemusic": "workspace:*"
+    "mioku-service-applemusic": "workspace:*",
+    "mioku-service-netease": "workspace:*"
   }
 }

package/providers/factory.ts

@@ -1,5 +1,7 @@
 import type { AppleMusicServiceApi } from "mioku-service-applemusic";
+import type { NeteaseServiceApi } from "mioku-service-netease";
 import { AppleMusicProvider } from "./applemusic-provider";
+import { NeteaseProvider } from "./netease-provider";
 import {
   type MusicProvider,
   type MusicProviderClientOptions,
@@ -8,6 +10,7 @@ import {
 
 export interface MusicProviderFactoryOptions {
   applemusic?: AppleMusicServiceApi;
+  netease?: NeteaseServiceApi;
 }
 
 interface MusicProviderRegistryItem {
@@ -32,6 +35,20 @@ const MUSIC_PROVIDER_REGISTRY: MusicProviderRegistryItem[] = [
       return new AppleMusicProvider(services.applemusic, clientOptions);
     },
   },
+  {
+    name: "netease",
+    serviceName: "netease",
+    isAvailable: (services) => Boolean(services.netease),
+    create: (services, clientOptions) => {
+      if (!services.netease) {
+        throw new Error("netease 服务未加载");
+      }
+      return new NeteaseProvider(services.netease, {
+        neteaseCookie: clientOptions?.neteaseCookie,
+        neteaseQuality: clientOptions?.neteaseQuality,
+      });
+    },
+  },
 ];
 
 function getProviderRegistryItem(

package/providers/netease-provider.ts

@@ -0,0 +1,88 @@
+import type { NeteaseServiceApi } from "mioku-service-netease";
+import type {
+  DownloadSongResult,
+  MusicAlbumDetail,
+  MusicProvider,
+  MusicProviderClientOptions,
+  MusicProviderName,
+  MusicSearchResult,
+  MusicSongDetail,
+} from "../types";
+
+export class NeteaseProvider implements MusicProvider {
+  readonly name: MusicProviderName = "netease";
+  private readonly client: ReturnType<NeteaseServiceApi["createClient"]>;
+
+  constructor(api: NeteaseServiceApi, options?: MusicProviderClientOptions) {
+    this.client = api.createClient({
+      cookie: options?.neteaseCookie,
+      quality: options?.neteaseQuality,
+    });
+  }
+
+  async searchSongs(query: string, limit: number = 15): Promise<MusicSearchResult> {
+    const result = await this.client.searchSongs({ query, limit });
+    return {
+      query,
+      provider: this.name,
+      tracks: result.songs.map((item) => ({
+        id: item.id,
+        provider: this.name,
+        title: item.name,
+        artist: item.artistName,
+        album: item.albumName,
+        coverUrl: item.artworkUrl,
+        durationMs: item.durationInMillis,
+      })),
+    };
+  }
+
+  async getSongDetail(songId: string): Promise<MusicSongDetail> {
+    const detail = await this.client.getSongDetail({ songId });
+    return {
+      id: detail.id,
+      provider: this.name,
+      title: detail.name,
+      artist: detail.artistName,
+      album: detail.albumName,
+      coverUrl: detail.artworkUrl,
+      releaseDate: detail.releaseDate,
+      durationMs: detail.durationInMillis,
+    };
+  }
+
+  async getAlbumDetail(albumId: string): Promise<MusicAlbumDetail> {
+    const detail = await this.client.getAlbumDetail({ albumId });
+    return {
+      id: detail.id,
+      provider: this.name,
+      title: detail.name,
+      artist: detail.artistName,
+      coverUrl: detail.artworkUrl,
+      releaseDate: detail.releaseDate,
+      tracks: detail.tracks.map((track) => ({
+        id: track.id,
+        title: track.name,
+        artist: track.artistName,
+        durationMs: track.durationInMillis,
+      })),
+    };
+  }
+
+  async downloadSong(songId: string): Promise<DownloadSongResult> {
+    const result = await this.client.downloadSongAac({ songId });
+    return {
+      filePath: result.filePath,
+      sourceType: result.sourceType,
+    };
+  }
+
+  async downloadCover(coverUrl: string, fileName?: string): Promise<string> {
+    const result = await this.client.downloadCover({
+      artworkUrl: coverUrl,
+      fileName: fileName || "cover",
+      size: 1200,
+    });
+    return result.filePath;
+  }
+}

package/providers/provider-labels.ts

@@ -2,6 +2,7 @@ import type { MusicProviderName } from "../types";
 
 export const MUSIC_PROVIDER_LABELS: Record<MusicProviderName, string> = {
   applemusic: "Apple Music",
+  netease: "NetEase Cloud Music",
 };
 
 export function getMusicProviderLabel(provider: MusicProviderName | string): string {

package/runtime-core/service.ts

@@ -1,6 +1,7 @@
 import type { AIService } from "mioku";
 import type { ScreenshotService } from "mioku";
 import type { AppleMusicServiceApi } from "mioku-service-applemusic";
+import type { NeteaseServiceApi } from "mioku-service-netease";
 import { MUSIC_DEFAULTS } from "../config";
 import {
   createMusicProvider,
@@ -28,6 +29,7 @@ interface MusicPluginRuntimeDeps {
   aiService?: AIService;
   screenshotService?: ScreenshotService;
   applemusicService?: AppleMusicServiceApi;
+  neteaseService?: NeteaseServiceApi;
 }
 
 function parseListenIndex(text: string): number | null {
@@ -193,8 +195,8 @@ export class MusicPluginRuntime {
     if ("tracks" in result && Array.isArray((result as any).tracks)) {
       this.deps.logger.warn(`[music] downloadSong 返回了 tracks 字段`);
     }
-    if (result.sourceType !== "hls") {
-      throw new Error("当前未获取到高质量 HLS 音频，请检查 media user token");
+    if (result.sourceType !== "hls" && result.sourceType !== "file") {
+      throw new Error("当前未获取到高质量音频，请检查 provider 配置");
     }
     const isPrivate = event?.message_type !== "group";
     const sendAsFile = isPrivate || options?.forceFile === true;
@@ -346,20 +348,29 @@ export class MusicPluginRuntime {
 
   private createProvider(provider: MusicProviderName, mediaUserToken?: string) {
     const resolvedProvider = this.resolveProviderName(provider);
+
+    const amDefaults = this.deps.applemusicService?.getDefaultOptions();
+    const neDefaults = this.deps.neteaseService?.getDefaultOptions();
+
     const finalMediaUserToken =
       String(mediaUserToken || "").trim() ||
-      String(this.config.applemusic.defaultMediaUserToken || "").trim() ||
+      String(amDefaults?.mediaUserToken || "").trim() ||
       undefined;
+    const neteaseCookie =
+      String(neDefaults?.cookie || "").trim() || undefined;
 
     return createMusicProvider(
       resolvedProvider,
       {
         applemusic: this.deps.applemusicService,
+        netease: this.deps.neteaseService,
       },
       {
         mediaUserToken: finalMediaUserToken,
-        storefront: this.config.applemusic.storefront,
-        language: this.config.applemusic.language,
+        neteaseCookie,
+        neteaseQuality: (neDefaults?.quality || "exhigh") as any,
+        storefront: String(amDefaults?.storefront || "cn"),
+        language: String(amDefaults?.language || "zh-CN"),
       },
     );
   }
@@ -389,6 +400,7 @@ export class MusicPluginRuntime {
   private getProviderServices() {
     return {
       applemusic: this.deps.applemusicService,
+      netease: this.deps.neteaseService,
     };
   }
 

package/types.ts

@@ -1,15 +1,12 @@
-export type MusicProviderName = "applemusic";
+export type MusicProviderName = "applemusic" | "netease";
 
-export const MUSIC_PROVIDER_NAMES: MusicProviderName[] = ["applemusic"];
+export const MUSIC_PROVIDER_NAMES: MusicProviderName[] = ["applemusic", "netease"];
+
+export type MusicProviderQuality = "standard" | "exhigh" | "lossless" | "hires";
 
 export interface MusicBaseConfig {
   searchLimit: number;
   defaultProvider?: MusicProviderName | string;
-  applemusic: {
-    storefront: string;
-    language: string;
-    defaultMediaUserToken?: string;
-  };
 }
 
 export interface MusicTrack {
@@ -59,13 +56,15 @@ export interface MusicSearchResult {
 
 export interface DownloadSongResult {
   filePath: string;
-  sourceType: "hls" | "preview";
+  sourceType: "hls" | "preview" | "file";
 }
 
 export interface MusicProviderClientOptions {
   mediaUserToken?: string;
   storefront?: string;
   language?: string;
+  neteaseCookie?: string;
+  neteaseQuality?: MusicProviderQuality;
 }
 
 export interface MusicProvider {