mioku-plugin-music 2.1.0 → 2.3.0

package/config.md

@@ -15,6 +15,8 @@ fields:
     options:
       - value: applemusic
         label: Apple Music
+      - value: netease
+        label: NetEase Cloud Music
 
   - key: base.applemusic.storefront
     label: Apple Music Storefront
@@ -33,6 +35,26 @@ fields:
     type: secret
     description: Apple Music 下载高质量 AAC 必需 token，无token仅能下载30s音频
     placeholder: eyJ...
+
+  - key: base.netease.quality
+    label: NetEase 音质
+    type: select
+    description: 下载音质档位，lossless/hires 需要 VIP cookie
+    options:
+      - value: standard
+        label: 标准 (128k)
+      - value: exhigh
+        label: 极高 (320k，推荐)
+      - value: lossless
+        label: 无损 FLAC
+      - value: hires
+        label: Hi-Res
+
+  - key: base.netease.defaultCookie
+    label: NetEase Cookie
+    type: secret
+    description: 网易云 MUSIC_U cookie，无 cookie 仅能搜索；VIP 音质必须配置
+    placeholder: MUSIC_U=...; os=pc; appver=8.9.75;
 ---
 
 ```mioku-fields
@@ -41,9 +63,19 @@ keys:
   - base.defaultProvider
 ```
 
+### 以下为 Apple Music 的配置区域
+
 ```mioku-fields
 keys:
   - base.applemusic.storefront
   - base.applemusic.language
   - base.applemusic.defaultMediaUserToken
 ```
+
+### 以下为网易云音乐的配置区域
+
+```mioku-fields
+keys:
+   - base.netease.quality
+   - base.netease.defaultCookie
+```

package/config.ts

@@ -8,4 +8,8 @@ export const MUSIC_DEFAULTS: MusicBaseConfig = {
     language: "zh-CN",
     defaultMediaUserToken: "",
   },
+  netease: {
+    quality: "exhigh",
+    defaultCookie: "",
+  },
 };

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.1.0",
+  "version": "2.3.0",
   "description": "音乐插件：点歌、搜索音乐、听歌语音发送",
   "main": "index.ts",
   "type": "module",
@@ -17,6 +17,20 @@
       "ai",
       "screenshot"
     ],
+    "accessHooks": [
+      {
+        "id": "点歌",
+        "match": "/^\\/?点歌\\s+/"
+      },
+      {
+        "id": "听",
+        "match": "/^听\\d+$/"
+      },
+      {
+        "id": "原曲",
+        "match": "/^原曲\\d+$/"
+      }
+    ],
     "help": {
       "title": "音乐",
       "description": "点歌并发送语音，支持搜索结果图片列表",
@@ -45,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;
@@ -350,14 +352,19 @@ export class MusicPluginRuntime {
       String(mediaUserToken || "").trim() ||
       String(this.config.applemusic.defaultMediaUserToken || "").trim() ||
       undefined;
+    const neteaseCookie =
+      String(this.config.netease?.defaultCookie || "").trim() || undefined;
 
     return createMusicProvider(
       resolvedProvider,
       {
         applemusic: this.deps.applemusicService,
+        netease: this.deps.neteaseService,
       },
       {
         mediaUserToken: finalMediaUserToken,
+        neteaseCookie,
+        neteaseQuality: this.config.netease?.quality,
         storefront: this.config.applemusic.storefront,
         language: this.config.applemusic.language,
       },
@@ -389,6 +396,7 @@ export class MusicPluginRuntime {
   private getProviderServices() {
     return {
       applemusic: this.deps.applemusicService,
+      netease: this.deps.neteaseService,
     };
   }
 

package/types.ts

@@ -1,6 +1,8 @@
-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;
@@ -10,6 +12,10 @@ export interface MusicBaseConfig {
     language: string;
     defaultMediaUserToken?: string;
   };
+  netease: {
+    quality: MusicProviderQuality;
+    defaultCookie: string;
+  };
 }
 
 export interface MusicTrack {
@@ -59,13 +65,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 {