fix: v0.9.7——修复 v0.9.6 的两处回归

流光档设置重启后丢失 save_settings 的白名单里漏了 ambient_effect:写入时 merged 从 default_settings() 起算(该键默认 “solid”),后面只覆盖白名单内的键, 于是每次整份重写都把这个键重置回纯色。表现是切换流光后界面立刻生效、内存值也对,但任何一次设置落盘都会把它冲回纯色,重启自然丢失。 load_settings 一侧本来就有这个键,只有写入漏了。
任务栏缩略图按钮消失加流光初始化时在 MainWindow 里新建了一个 showEvent,覆盖掉了原来那个负责任务栏按钮注册的(同名方法后定义者生效),原版永远不执行, 于是 ThumbBarAddButtons 从未被调用。合并成一个 showEvent,两件事都保留。

测试

新增 TestAmbientEffectSetting 5 项:flow/solid 往返、旧值 off 映射、非法值回落、改其它设置不冲掉本键
已验证:撤掉修复后其中 2 项失败,恢复后通过
另扫一遍 main_window.py,确认没有其它同名方法重复定义

NeriPlayer Win

✨ 一个把网易云与 Bilibili 搬进 Windows 桌面的轻量音频播放器 🎵

NeriPlayer Win

[!WARNING] 本项目仅供学习与研究使用,请勿将其用于任何非法用途。请只在你拥有权利、授权或第三方平台规则允许的范围内访问、播放内容。本项目不提供媒体内容、密钥或规避付费/DRM/地区限制的方案, 也不提供任何公共媒体代理或再分发服务。

快速体验 / Getting Started

前往 Releases 下载最新的 NeriPlayer-win-*.zip;
解压到任意目录(保持文件夹结构完整,bin/ 内是 mpv 播放运行库);
双击 NeriPlayerWin.exe —— 免安装,无需预装 Python、mpv 或任何运行时。

[!NOTE] 首次使用请在应用内完成网易云 / Bilibili 登录:内嵌浏览器会打开平台官方登录页,扫码、手机号等方式均可,登录成功后自动进入应用,重启免再次登录。

核心特性 / Key Features

🎧 双音源:网易云音乐(「我喜欢的音乐」、自建歌单与收藏歌单) 与 Bilibili(收藏夹与「稍后再看」),以歌单视角统一呈现;
🔐 网页登录:内嵌浏览器打开官方登录页,支持平台提供的任意登录方式, 应用本身不经手账号密码;
📋 统一播放队列:网易云与 B 站歌曲混排进同一队列,支持顺序 / 随机 / 单曲循环,一首播完自动接下一首,队列窗口可查看与切跳;
⏭️ 下一首播放:任意列表里右键歌曲即可插到当前曲之后, 不必替换整个播放队列,插完接着听原列表;
🕘 最近列表:侧栏「最近」分区自动记录播放过的歌单 / 收藏夹 / 稍后再看 / 每日推荐(仅浏览不计),栈式去重置顶,条数可设(默认 8);
🌱 每日推荐:网易云每日推荐歌曲固定在「网易云 · 收藏」分区首位, 每天刷新一批;
▶️ 完整播放控制:播放 / 暂停、上一首 / 下一首、进度拖动、音量调节, 支持系统全局媒体键;音量跨会话记忆,重启沿用上次退出时的档位;
🎧 耳机断开自动暂停:播放中拔出耳机 / 关闭蓝牙或默认播放设备切离耳机时自动暂停(蓝牙断开短确认防抖),切回耳机类设备自动继续; 手动暂停不会被自动恢复;
🖼️ 封面与主题:播放条展示歌曲封面,Material 配色, 亮色 / 暗色外观可切换;
🎚️ 音质选择:无损 / 极高 / 标准三档偏好(默认无损,自动回退), 播放时展示实际生效音质;
🗂️ 侧栏折叠与排序:平台分区单击折叠(网易云·歌单 / 网易云·收藏 / B站·收藏夹),歌单 / 收藏夹在分区内拖拽排序,状态持久化;
💗 收藏歌单与稍后再看:网易云收藏的他人歌单独立分区与自建歌单并列; B站「稍后再看」并入收藏夹分区首位,一点即播;
🛟 失败不打断听歌:播放失败改为状态栏 + 托盘气泡提示并自动跳下一首(连续失败自动熔断);当前曲开播即预取下一首地址,切歌零等待;
📍 最小化到托盘:关窗口不退出,托盘图标常驻,后台继续播放 (进程优先级高于正常,游戏时切歌更跟手);
🔁 登录态本地持久化:重启免登录,过期可感知并提示重新登录。

平台特点 / Why Windows Native

原生桌面应用:基于 Qt(PySide6),窗口、托盘、媒体键都是 Windows 原生体验,双击即开,后台不驻留任何服务;
mpv 播放内核:音频播放由 libmpv 承担,解码能力与稳定性同 mpv 一致;
浏览器级风控兼容:登录发生在真实网页上下文里,指纹与风控由平台自身的 SDK 完成,比客户端直连方案更稳。

轻量与隐私 / Lightweight & Private

轻量是硬指标:实测冷启动中位约 0.75s、空闲常驻约 150MB (播放态约 220MB);无遥测、无统计 SDK、无开机自启;
磁盘占用有界:音乐流式播放不落盘;封面缩略图缓存上限 32MB, 启动时自动按 LRU 清理(最久未看的先删);
只访问官方接口:除 music.163.com / bilibili.com 及其 CDN 外, 不连接任何第三方服务器;
凭据纯本地:登录 Cookie 只保存在本机 %APPDATA%\neriplayer-win\, 不会上传到任何地方;
无痕登录会话:内嵌登录浏览器为 off-the-record 会话,不落盘浏览记录与缓存;删除上述本地目录即彻底清除全部数据。

问题反馈 / Bug Report

使用中遇到问题欢迎到 Issues 提交,附上 Windows 版本、应用版本与复现步骤即可。

发展规划 / Roadmap

正在计划的方向(不承诺时间表):

🌱 推荐内容:私人 FM 等更多网易云推荐源(每日推荐已上线);
🖼️ 应用图标与 About:补齐 GPL-3.0 合规标注(衍生自 NeriPlayer)。

欢迎到 Issues 提交 bug 与新功能建议——会在不破坏「轻量、简洁」的前提下尽可能考虑。

鸣谢 / Reference

NeriPlayer — 本项目衍生自它的 Android 实现,音源 API 行为以其为参考翻译;
mpv / mpv-winbuild — 播放内核与 Windows 运行库来源。

许可证 / License

本项目以 GPL-3.0 开源,详见 LICENSE。

✅ 你可以自由使用、修改和分发本软件;
⚠️ 分发修改版时须继续遵守 GPL-3.0,并保留对上游 NeriPlayer 的衍生标注;
🧩 发行包内含 Qt / QtWebEngine(PySide6)、libmpv、Python 及若干 PyPI 依赖,均按各自许可条款随包分发,对应源码见本仓库与各上游项目。