> ⚠️ 本软件完全免费且开源，请勿通过任何付费渠道下载。
>
> 🤡 如果你是付费获取的，说明你被骗了。

## [2.2.3-beta.10] - 2026-05-05

### 新增

- 新增外部歌单导入功能
- 新增「听歌识曲」功能，支持麦克风录音和系统音频捕获两种识别方式
- Windows/Linux 标题栏新增全屏按钮，支持切换全屏模式
- 实验性新增 DSD 臻品音质选项（支持的歌曲较少）
- 试验性新增均衡器功能

### 修复

- 修复单曲循环第一首歌永远是列表第一首歌曲的问题
- 修复登录页面二维码刷新按钮与等待扫码文案重叠的问题
- 修复Linux下libmpv相关依赖问题

### 重构

- 播放引擎从 mpv 子进程迁移到 libmpv 内嵌方案，通过 Rust NAPI addon 直接调用 libmpv C API
- 音质和音效逻辑以及触发按钮分开，音效和均衡器合并

### 优化

- 优化播放逻辑和UI层面阻塞和竞态问题
- 适当调整页面歌词翻译/音译文字大小
- 当播放时长与原曲差异较大时，在页面歌词和桌面歌词中提示歌词可能不同步

## [2.2.2] - 2026-04-27

### 重构

- 播放引擎升级为 mpv，独立进程播放，支持更多音频格式，解码质量更高
- 人声/伴奏音轨切换更快更稳定
- 音量均衡和淡入淡出适配新引擎
- 音频输出设备列表更准确，切换更可靠
- 评论回复改为内联展开/折叠，交互更统一

### 新增

- 新增「独占音频设备」开关，绕过系统混音器直接输出，获得更高音质
- 新增「自动检查更新」开关，可在设置中关闭启动时自动检查
- 退出登录增加确认弹窗，防止误触
- 歌词页面新增评论按钮，可查看当前歌曲评论
- 评论内容超长时自动截断，支持展开/收起

### 优化

- 歌词页面亮色主题下背景可读性改善
- 歌词页面播放按钮和封面卡片视觉统一
- 音频设备状态提示布局更紧凑
- 播放队列、批量操作、评论抽屉统一贴底展示

### 修复

- 弹窗被播放栏遮挡的问题
- 歌词翻译和音译行颜色跟随自定义颜色
- 进度条拖动时拖拽柄滞后跟随鼠标

### 已知变更

- 应用包体积略有增加

## [2.2.1] - 2026-04-24

### 新增

- 音效新增「人声」和「伴奏」选项，支持分离播放
- 已提取的音轨数据缓存，同一首歌切换人声/伴奏秒切
- 写真模式歌词自动收起：无操作后自动收起歌词至底部两行，支持开关和延迟配置
- 写真模式按钮自适应颜色：根据写真背景亮度自动切换深浅配色，支持开关
- 歌词页面改为覆盖层模式，解决打开/关闭歌词导致页面缓存失效的问题
- 歌词页面打开/关闭过渡动画
- 字体设置功能

### 优化

- 写真模式下深色/浅色主题统一表现
- 写真模式封面卡片和控制器布局优化
- 歌词页面弹出层层级适配覆盖层模式
- 播放队列改为直接拖拽排序
- 桌面歌词锁定/解锁交互优化，锁定后无需移出窗口即可再次操作
- 桌面歌词文字阴影改为轻柔投影风格
- 桌面歌词支持多显示器，记住窗口所在显示器位置
- 新增「禁用 GPU 加速」开关，遇到渲染异常时可尝试开启

### 修复

- 快速切歌时歌词可能一直显示「加载中」
- 退出登录后换账号登录，个人信息仍显示上一个账号
- 歌词页面快捷键无法打开
- 打开/关闭歌词页面导致页面缓存失效
- 「我最喜爱」页面定位当前歌曲位置偏移
- Windows 下桌面歌词每次打开位置偏移
- 切换音质或音效时进度条闪烁
- 音量均衡在无有效响度数据时错误应用默认衰减
- 桌面歌词行切换延迟
- 返回页面时滚动位置未保留
- 歌词已播/未播颜色默认值不一致
- 歌手详情页信息展示完善（粉丝数、生日、MV 数量）
- 专辑详情页展示专辑类型和语种，吸顶栏增加收藏按钮
- 歌单详情页吸顶栏增加收藏按钮
- 侧边栏布局间距调整

## [2.2.0] - 2026-04-21

### 新增

- 搜索页新增「歌词」和「MV」搜索标签页，支持按歌词内容和 MV 搜索
- MV 搜索结果以卡片网格展示，复用已有 MV 卡片组件
- 标题栏搜索框展开无内容时，右侧显示「搜索页」快捷入口按钮
- 新增音量均衡功能，基于曲目 LUFS 响度数据自动调整增益，使不同歌曲播放音量保持一致

### 优化

- 播放引擎从 Howler.js 重构为原生 HTML5 Audio，消除中间层导致的事件丢失和状态不同步问题
- 通过 Web Audio API（GainNode）实现音量均衡，复用同一音频元素，切歌无需重建处理链路
- 淡入淡出重构为双 GainNode 架构（fadeGainNode + normGainNode），淡入淡出使用 Web Audio API 原生 linearRampToValueAtTime 调度，不依赖 JS 定时器，窗口最小化时也能正常工作
- 歌词页面逐字动画升级为渐变填充效果，与桌面歌词一致，基于 rAF 实时插值实现逐字平滑过渡
- 直接监听原生 audio 的 durationchange 事件，修复流式音频 duration 不准确的问题

### 修复

- 修复播放中突然卡住、进度条停止且拖动无响应的问题
- 修复歌曲进度条已到末尾但 ended 事件未触发、延迟切换下一首的问题
- 修复自动切歌时淡入淡出导致歌曲没声音的问题
- 修复英文歌词中 HTML 实体未解码的问题（如 `&apos;` 显示为原始文本）

## [2.1.9] - 2026-04-20

### 新增

- 新增「我最喜爱」页面，包含歌曲、歌手、专辑、视频四个标签页
- 歌词写真自动轮播
- 新增 API 缓存层（LRU，200 条上限，30 分钟 TTL），写操作自动清除关联缓存
- 新增页面缓存（KeepAlive）设置，可自定义缓存哪些页面及最大缓存数
- 新增多选下拉组件 MultiSelect

### 优化

- 移除全局请求时间戳，改由主进程缓存层统一管理缓存策略
- 标题栏刷新按钮点击时清空 API 缓存，确保获取最新数据
- 侧边栏「我喜欢」歌单回归自建歌单列表展示
- 侧边栏收藏专辑移至「我最喜爱」页面集中管理
- 重构歌词页面翻译/音译为独立开关
- 歌词写真背景遮罩及工具栏视觉优化
- 歌词非当前行及未播颜色可读性提升

### 修复

- 歌词颜色选择器默认值不正确
- 设置中音质音效徽标开关、播放列表歌曲数量徽标开关在歌词页面不生效

## [2.1.8] - 2026-04-19

### 新增

- 歌手详情页新增 MV 标签页，支持分类筛选和滚动加载
- 设置新增音质音效徽标显示开关
- 设置新增静默安装开关，更新时后台自动完成无需安装向导
- Linux arm64 构建

### 优化

- 采用原生 CSS 拖动方案，彻底解决 Windows 高 DPI 下拖动窗口闪烁问题
- 移除 PlayerBar 无效的毛玻璃特效，降低 GPU 开销
- 歌手详情页专辑和 MV 改为懒加载，切换 Tab 时才请求数据
- 歌手详情页专辑支持滚动分页加载
- 弹窗和抽屉组件兼容原生拖动层，打开时不影响交互

### 修复

- 歌词页面写真图片无法加载
- 登录失效检测在断网时误触发，错误清除用户登录态
- 登录过期弹窗未经用户确认就提前清除登录态
- 单曲循环模式下手动切歌现在按列表顺序切换，不再重复当前歌曲
- 路由切换后页面滚动位置未重置
- macOS 更新弹窗缺少在线更新按钮

## [2.1.7] - 2026-04-19

### 新增

- 设置页新增更新日志入口

### 修复

- Windows 高 DPI 下拖动窗口导致窗口缓慢变大
- 版本更新内容样式未正确显示

## [2.1.6] - 2026-04-18

### 新增

- 探索发现新增歌手列表页面
- 版本更新日志，检查更新时可查看更新内容
- Windows 和 Linux 应用内在线更新功能

### 优化

- 重构内部通信架构，提升API调用稳定性和响应速度
- 再次减小安装包体积
- 启动速度优化
- 请求日志格式优化

### 修复

- 歌词页面播放队列与窗口控制按钮重叠
- 长时间使用后API服务无响应，无法加载内容，需重启应用
- 软件API服务端口占用
- 网络代理导致无法使用
- 标题栏在某些页面无法拖动窗口
