Mornye-Extension韩国音乐平台接入指南:Bugs、Melon、Genie三大插件一次看懂
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 歌单支持:
- TOP100 与 HOT100 分榜呈现:
getHomeFeed中分别拉取 Melon 的两个榜单页,即使 HOT100 暂时不可用,TOP100 也能正常展示(内置 15 分钟缓存,减少重复请求)。 - 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 中安装。
- 打开 registry.json,定位目标插件条目。以 Bugs 为例,条目包含:
version: 1.6.2、min_app_version: 3.0.1(确认你的应用版本 ≥ 3.0.1)sha256:用于校验下载文件完整性
- 通过条目中的
download_url下载对应的.sflx文件(如extensions/bugs-music.sflx)。 - 在 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 中,建议每次更新应用后顺手核对一下插件版本,即可获得最佳的浏览体验。🎵