Skip to content

fnmusic-ext 2.6.0

Choose a tag to compare

@github-actions github-actions released this 28 Sep 15:05
· 29 commits to main since this release

自 2.5.0 以来的变更收拢为本次正式版。2.6.0a–2.6.0e 仅为测试构建,未单独发版。

修复

  • 搜索分页跨页重复:飞牛官方 2026-09-25 更新后搜索接口忽略 size 参数全量返回结果集(total=11、size=10 时第 1/2 页返回同样 11 条),代理此前只透传官方页内容,导致本地歌曲在每个分页整段重复出现(第 2 页起每页都带全部 11 首本地结果)。现检测到"返回条数超过单页窗口"时按请求窗口对本地段切片:第 1 页恰好 size 条、第 2 页为余量本地歌曲接在线结果,跨页零重复、total 稳定,官方正常分页时行为不变。
  • 网易账号歌单点开能看到歌曲:账号歌单与热门推荐一样标为虚拟歌单,曲目列表按每日推荐补齐时间与歌手/专辑字段后再下发。
  • 推荐歌单落盘不再变成 unknown:每日推荐、热门推荐和网易账号歌单的曲目不进搜索缓存。边听边存、后台整轨下载和断点续传落盘时,按曲目 id 回查这些歌单缓存,再回查播放历史、收藏和自建歌单;本地仍没有标题时,后台下载再向源站要一次歌曲信息。文件名用歌手和歌名,不再写成 unknown (n)。
  • 专辑标签不再写入对象文本:前端曲目的专辑是 {name, guid, ...}。落盘、写音频标签和播放历史上报都先取出专辑名、歌名和歌手的纯字符串,已有的专辑名不会被另一份缓存覆盖。

新增

  • 网易账号歌单(FNMUSIC_NETEASE_MY_PLAYLISTS,默认关闭,热重载):「网易云音乐盒子」音源启用并扫码登录后,网易账号里自己创建的歌单(含"我喜欢的音乐")以只读歌单出现在音乐页——「热门推荐」下方、官方歌单上方,点开即听;收藏的他人歌单不显示。曲目经可播过滤(VIP/试听片段自动剔除),播放、取链、歌词与封面沿用既有网易链路。歌单为只读:在音乐页往里加歌、移歌或删除均不回写网易(请求被静默吸收,不报错)。开关在管理台「音乐源」页「搜索超时时间」下方。摘要 5 分钟缓存、拉取失败 2 分钟冷却并回落 24 小时磁盘缓存(musicbox 重启窗口不塌列表);列表注入后串行后台预取各歌单曲目,大歌单首开不等待批量详情;代理重启后从磁盘缓存恢复伪装 id 反查,旧会话卡片仍可打开。歌单上限 100 个、每歌单曲目上限 1000 首。
  • 自动下载歌词(FNMUSIC_LYRIC_AUTO_DL,默认关闭,热重载):边听边存与「收藏自动绑定本地」后台下载的歌曲在完整落库后,自动下载同名 .lrc 歌词文件放到歌曲同一文件夹,官方 App 扫描入库后播放即显示歌词;歌曲下载成功后才去下歌词,不产生"只有歌词没有歌"的残留文件。酷我源歌词接口已失效,该源暂无歌词。开关在管理台「边听边存」页。
  • 自动下载封面(FNMUSIC_AUTO_COVER,默认开启,热重载):边听边存与「收藏自动绑定本地」后台下载的歌曲在完整落库后,自动从源站下载封面并内嵌进音频文件(MP3 APIC / FLAC Picture / MP4 covr / OGG),官方音乐 App 里下载的歌曲即显示封面图。封面在歌曲保存成功后才处理、直接嵌进音频文件本身——不产生独立封面文件,不存在"歌曲下载失败、封面文件残留"的垃圾文件;源站文件自带内嵌封面时自动跳过不重复下载。已实证飞牛官方扫描器只读音频内嵌标签(不支持 cover.jpg 等外置封面文件),内嵌是官方 App 显示封面的唯一途径。

音源

  • musicdl 跟随上游升级到 2.14.0:带入酷狗歌词获取修复与 QQ 第三方接口更新。平台注册表仍为 57 个,编号表不变。网易云音乐盒子维持 0.5.3。

安全

  • 管理页使用飞牛管理员身份:在已登录的飞牛管理员页面打开,安装不再询问或保存单独密码。管理接口只接受网关注入的管理员身份。8774 只监听本机。
  • 音源端口只留在本机:musicbox 宿主机发布为 127.0.0.1:8770。网易扫码走已登录管理页里的反代。
  • 洛雪源来源提醒:导入 URL 或 .js 前必须自行确认来源安全,不要导入来历不明的脚本。脚本在容器内执行。