把 xd音源
装进你的 APP

# 洛雪音源脚本下载地址（key 必填）
https://xd.xm5201314.top/v2/index.php?key=你的Key

# Key 缺失或无效时返回 403 纯文本提示：
#   缺少 key 参数，正确格式: /v2/index.php?key=你的Key
#   Key 无效或已停用，请联系管理员

// ── v2 下发脚本内置逻辑（导入即用，无需手写）──

// 脚本头部常量（下发时已替换为你的专属值）
const API_URL = "https://xd.xm5201314.top/v1/index.php";  // v1 聚合接口
const API_KEY = "你的Key";                          // 鉴权凭证
const SCRIPT_MD5 = "脚本内容MD5";                 // 更新自检指纹

// 取歌曲ID：酷狗用 hash，QQ 用 songmid，其余平台用 id
const songId = musicInfo.hash ?? musicInfo.songmid ?? musicInfo.id;

// 请求播放链接：POST /music/url + X-Api-Key 鉴权头
const resp = await httpFetch(`${API_URL}/music/url?key=${API_KEY}`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": API_KEY,          // ★ 鉴权头，必带
  },
  body: {
    source: "kg",        // 平台标识：kg/kw/mg/wy/tx/bilibili/qishui…
    musicId: songId,     // 歌曲ID
    quality: "320k"      // 音质：128k/320k/flac/flac24bit/hires…
  }
});

// ── 响应契约（switch code）──
// 200 → { code: 200, url: "https://…" }        成功，url 即播放直链
// 403 → 鉴权失败（Key 无效或已停用）
// 429 → 请求过速，稍后重试
// 500 → { code: 500, message: "获取URL失败, …" } 具体失败原因看 message

# MusicFree 插件下载地址（key 必填）
https://xd.xm5201314.top/v3/index.php?key=你的Key

# 也可以在 MusicFree「插件管理 → 从网络安装」
# 直接填入上面的地址，省去手动下载

// ── v3 下发插件的元信息 ──
module.exports = {
  platform: "xd音源",            // 音源切换列表里显示的名字
  version: "1.1.0",
  appVersion: ">0.1.0-alpha.0",  // 兼容的 MusicFree 版本
  srcUrl: "https://xd.xm5201314.top/v3/index.php?key=你的Key",  // 自动更新源
  cacheControl: "no-cache",      // 每次拉取最新脚本
  primaryKey: ["id", "platform"],
  getMediaSource: getMediaSource,  // ★ 核心方法
};

// ── 核心方法：歌曲 → 播放地址 ──
async function getMediaSource(musicItem, quality) {
  // 1) 平台识别：中/英文名自动映射（"酷狗"→kg，"网易云"→wy）
  const source = mapPlatform(musicItem.platform || musicItem.$platform);

  // 2) 音质映射：low→128k / standard→320k / high→flac / super→hires
  const q = QUALITY_MAP[quality] || "320k";

  // 3) 歌曲ID：酷狗=hash，QQ=songmid，其余=id
  const musicId = musicItem.hash || musicItem.songmid || musicItem.id;

  // 4) 调 v1 聚合接口取直链（GET，参数全在 URL，兼容所有引擎）
  //    {API_URL}/music/url?key=…&source=…&musicId=…&quality=…
  const body = await callV1(source, musicId, q);

  return body ? { url: body.url } : null;  // null 时交给下一个插件
}