Mornye-Extension韩国音乐平台接入指南:Bugs、Melon、Genie三大插件一次看懂

原创2026-10-22 17:58:371,865 阅读

Mornye-Extension韩国音乐平台接入指南:Bugs、Melon、Genie三大插件一次看懂

Mornye-Extension 是 Mornye Browse 的社区扩展注册表(Extension Registry),收录了可提交、下载和更新的社区自建插件。本文聚焦其中三款韩国音乐平台插件:Bugs Music、Melon Music 与 Genie Music,帮助你一次性看懂它们各自的能力、版本与安装方式。

什么是 Mornye-Extension?📦

Mornye-Extension 仓库本质上是一个"插件商店":所有插件以 .sflx 压缩包的形式存放在 extensions/ 目录中,每个插件包含 manifest.json(元信息)、index.js(运行逻辑)和图标,外加 icon.png)。

每个插件在 registry.json 中都有对应条目,记录了版本号、SHA-256 校验值、最低应用版本(min_app_version)和下载地址。你可以把 registry.json 理解为插件商店的"货架清单"。

💡 本次介绍的三款韩国插件 category 均为 integration,属于元数据插件(metadata provider):它们提供搜索、详情、榜单和 URL 导入能力,本身不负责音频下载。

三大韩国音乐插件能力速览 🇰🇷

插件 包文件 版本 核心榜单 特色能力
Bugs Music extensions/bugs-music.sflx 1.6.2 TOP100 曲风分区(Ballad/Dance/Rap/OST)、URL 导入
Melon Music extensions/melon-music.sflx 1.2.4 TOP100 + HOT100 双榜 DJ 歌单导入、专辑/艺人目录
Genie Music extensions/genie-music.sflx 1.0.29 TOP200 10 个曲风分类榜单、艺人专辑分页

三款插件的共同点:

  • 都要求 Mornye Browse 最低版本 3.0.1
  • 都支持搜索(searchBehavior.enabled: true)
  • 都支持主页信息流(homeFeed: true),打开应用即可看到对应平台的实时榜单
  • 都支持URL 导入(urlHandler),粘贴平台网页链接即可识别为歌曲、专辑或艺人

Bugs Music 插件:TOP100 与曲风分区 🎧

Bugs Music 是三款中功能分区最细的插件。它的首页信息流会按顺序聚合以下板块:

  • 벅스 TOP 100:实时总榜,以"虚拟专辑"的形式呈现 100 首歌曲
  • 최신음악(最新音乐):优先使用韩国 K-POP 新歌源,避免混入海外曲目
  • 국내 인기곡(国内热门)/ 해외 인기곡(海外热门)
  • 四个曲风分区:Ballad(抒情)、Dance/Pop、Rap/Hip-Hop、OST

此外,插件内置了多级容错:榜单接口不可用时会自动切换备选路径(例如实时榜 → 日榜),封面图也会自动选择 1000px 的高清原图而非缩略图。

支持的 URL 导入格式(来自其 manifest.json 中的 urlHandler.patterns):

https://music.bugs.co.kr/track/、/album/、/artist/
https://m.bugs.co.kr/track/、/album/、/artist/

桌面版和移动版链接都可以直接导入。

Melon Music 插件:双榜 + DJ 歌单 📀

Melon Music 插件的两大亮点是双榜单与 DJ 歌单支持:

  1. TOP100 与 HOT100 分榜呈现:getHomeFeed 中分别拉取 Melon 的两个榜单页,即使 HOT100 暂时不可用,TOP100 也能正常展示(内置 15 分钟缓存,减少重复请求)。
  2. DJ 歌单导入:支持导入 melon.com/landing/playList.htm 和 mymusic/dj/... 两类 DJ 歌单页面,自动解析歌单名、封面和全部曲目。

它支持的 URL 导入范围是三款中最广的,涵盖歌曲详情(song/detail.htm)、专辑详情、艺人主页(timeline/song/album)、DJ 歌单等 8 种页面类型。

艺人名录方面,插件会抓取艺人"热门歌曲 Top 50"和完整专辑目录,专辑发布日期也会从 2024.05.17 这类格式统一转换为 2024-05-17。

Genie Music 插件:TOP200 与曲风榜单矩阵 🎼

Genie Music 插件主打大榜单 + 曲风矩阵:

  • 지니 TOP 200:200 首的超大榜单,同样以虚拟专辑呈现
  • 최신음악(最新音乐):最新上架歌曲
  • 10 个曲风分区:가요(流行)、POP、OST、트롯(Trot trot 民谣)、JAZZ、CLASSIC、EDM、JPOP、New Age、CCM,每个分区取前 50 首

它的艺人名录还支持分页加载——每页 10 张专辑,通过 genie-music:artist:<id>:albums:<page> 形式的 URI 逐页浏览,适合收藏整部作品的艺人。

支持导入的 URL 为 Genie 的三个详情页:

genie.co.kr/detail/songInfo  (歌曲)
genie.co.kr/detail/albumInfo (专辑)
genie.co.kr/detail/artistInfo(艺人)

如何安装韩国音乐插件:从注册表下载 .sflx 🔧

安装步骤非常简单,核心就一句话:找到 registry.json 里的条目 → 下载对应 .sflx → 在 Mornye Browse 中安装。

  1. 打开 registry.json,定位目标插件条目。以 Bugs 为例,条目包含:
    • version: 1.6.2、min_app_version: 3.0.1(确认你的应用版本 ≥ 3.0.1)
    • sha256:用于校验下载文件完整性
  2. 通过条目中的 download_url 下载对应的 .sflx 文件(如 extensions/bugs-music.sflx)。
  3. 在 Mornye Browse 中导入该文件,插件即会出现在搜索与主页信息流中。

📌 小技巧:如果你需要同时使用多款插件,它们互不冲突——每款插件拥有独立的 provider 前缀(如 bugs:、melon.com/),主页信息流会分别呈现各家榜单。

插件的构建与安全机制 🔒

仓库对插件质量有明确的工程化保障:

  • 可审查源码:Amazon、Apple Music、SoundCloud、Tidal、Qobuz、JioSaavn 等 6 个提供方的源码位于 sources/ 目录(sources/<provider>/ 下的 index.js 与 manifest.json),而三款韩国插件目前是"仅分发包"模式。
  • 可复现打包:scripts/build_packages.py 会生成字节级可复现的 .sflx 归档(固定时间戳、压缩等级 9),并自动把版本号与 SHA-256 摘要同步回 registry.json。运行 --check 参数可以校验产物是否与注册表一致。
  • 离线回归测试:tests/ 目录下的 *.test.cjs 测试使用 Node.js 22+ 和模拟数据,不真实访问音乐服务。
  • 审核流程:所有提交会经过人工审核,要求无恶意代码、描述清晰、下载与图标链接可用(详见 README.md)。

常见问题 FAQ ❓

Q1:三款插件能下载音乐吗? 不能。它们都是元数据插件,提供搜索、榜单、详情和 URL 导入;下载请配合仓库中其他 download 类插件使用。

Q2:安装后搜索框为什么没有变化? 三款插件的 primary 均为 false,它们不会抢占默认搜索源,而是在搜索中作为补充提供方出现。

Q3:榜单加载失败怎么办? 三款插件都内置了多级备选 URL 与缓存机制;若仍失败,可先确认网络能否访问韩国站点(music.bugs.co.kr、melon.com、genie.co.kr),再检查插件版本是否为 registry.json 中的最新版。

Q4:如何判断下载的 .sflx 没被篡改? 对文件计算 SHA-256,与 registry.json 中对应条目的 sha256 字段比对即可,两者一致才安全。

写在最后

Mornye-Extension 让韩国音乐生态与 Mornye Browse 的连接变得"开箱即用":Bugs 胜在曲风分区细致,Melon 强在双榜与 DJ 歌单,Genie 则以 TOP200 大榜和分页艺人名录见长。三款插件版本与校验值都维护在 registry.json 中,建议每次更新应用后顺手核对一下插件版本,即可获得最佳的浏览体验。🎵

登录后查看全文
Mornye-Extension