Skip to content

fnmusic-ext 2.3.0

Choose a tag to compare

@github-actions github-actions released this 23 Sep 16:40
· 51 commits to main since this release

新增

  • 在线曲目加入/移出自建歌单闭环:拦截官方 add-track / remove-track 接口,在线曲目记入本地持久化存储(按用户/按歌单隔离),自建歌单曲目列表透传官方后自动合并下发在线条目(带收藏状态、分页翻页不重不漏),playlist/detail 与 batch-detail 歌单曲目总数实时并入在线曲目数;删除歌单时自动级联清理本地关联数据,代理重启后支持自愈重建伪装映射。
  • 全链路 e2e 冒烟测试脚本 (scripts/e2e_check.sh):一键自动化覆盖代理接管、多源搜索、边界分页、在线取流播放、收藏增删联动、播放上报与历史、歌单增删歌曲闭环全链路。
  • 曲库自动重扫通知钩子:新增 FNMUSIC_LIBRARY_SCAN_PATH 环境变量,边听边存落盘后支持按凭证合并触发官方媒体库重新扫描(3 秒合并窗口 + 90 秒节流)。

修复

  • 构建与安装镜像源加速:针对阿里云镜像 CDN 在 HTTP/1.1 连接下单连接限速(~350KB/s)导致构建/安装耗时过长问题,默认 apt/pip 镜像源全面切换至腾讯云镜像(实测 20MB/s+),全新安装与无缓存构建时间从十几分钟大幅缩减至约 2 分钟;存量 .env 默认镜像自动平滑迁移。
  • 搜索翻页跨页重复与截断修复:官方搜索接口越界页回声导致多页重复拼接问题修复;全局起点越过官方段时正确丢弃官方回声;支持推荐歌单 size=-1 返回全量。
  • 网易云多项稳定性与体验修复:
    • 扫码登录态更新迟滞:扫码成功立即重建常驻客户端实例,增加登录态探测缓存失效与过期自动重读。
    • 点播取链超时优化:由每次起 CLI 子进程改为服务进程内直调(毫秒级响应并带 10 分钟短缓存),代理层解析超时放宽至 6 秒。
  • 流媒体播放与边听边存稳定性:
    • 在线流读取超时从 10 秒放宽至 60 秒,避免 CDN 限速抖动掐断流;流中断加入审计日志便于取证。
    • 曲目结束时的文件落盘与标签写入移入后台异步线程,避免阻塞代理其它请求。
    • 分段拉流(Range 请求)客户端边听边存失效修复:针对此类客户端在首次取流时由后台整轨异步拉取完整曲目落盘曲库。
    • 本地歌曲播放响应透传精确 Content-Length,消除分块传输带来的起播卡顿或播放器内核时长计算异常。
  • 播放历史与数据维护:拦截 play-history/delete,支持在线条目从本地播放历史彻底删除;官方条目正常转发。
  • 安装、升级与部署边界鲁棒性:
    • 完善代理 systemd unit 归属校验,旧路径失效或跨卷迁移时提供自动接管与自愈指引。
    • fpk 升级与卸载失败时降级兜底处理,确保应用管理不卡死。