更新日志
版本 1.1.0
(2026年6月6日)
根据用户反馈,对程序进行了以下改进:
- 播放列表多选: 实现了在主屏幕右侧面板按住 CTRL 键选择多个播放列表的功能。所选列表中的曲目将在后台自动合并为统一的播放队列。在多选状态激活时,列表内容编辑功能(添加、删除、导入文件)将被强制锁定,相关界面按钮也将视觉上呈现禁用状态。
- 悬停时间提示: 在波形图上方开发了悬停提示面板,可动态显示鼠标当前悬停位置的精准时间。
- 窗口拖放与吸附优化: 重新调整了自定义窗口的行为。窗口拖拽现已切换至原生的
window.drag_window() 调用,消除了移动延迟。吸附算法现通过 Windows GDI 的 GetMonitorInfoW 调用动态获取屏幕工作区(Work Area)边界,从而精确避开任务栏的实际尺寸和位置。
- 下拉菜单重构: 将下拉菜单(Dropdown)组件统一整合至
widgets.rs 模块中的通用 popup_menu 小部件。实现了可靠的外部点击拦截,以便在用户点击菜单区域外时自动收起已展开的列表。
- 系统托盘运行稳定化: 优化了托盘图标工具提示的更新逻辑,以降低系统资源消耗;托盘状态仅在切换曲目或暂停播放时才会更新。这有效解决了在 Windows 下由于图标更新过于频繁而导致鼠标移动时托盘上下文菜单立即关闭的问题。此外,“显示/隐藏播放器”操作已从最小化窗口改为隐藏窗口。
- 图像解码链路重构与清理(AVIF): 完全移除了对重型图像解码库(包括
image crate)的依赖。封面导入逻辑已迁移至基于 zenavif 和 ravif 的轻量化 100% AVIF 运行链路。修复了 wgpu 验证错误:来自 AVIF 的原始 3 通道 RGB 数据现在会在加载到显存之前手动填补 alpha 通道以转换为 4 通道 RGBA,从而避免了加载图像时发生崩溃。ravif 的编码速度固定在安全范围内(speed = 6)。
- 本地数据库(回退机制): 增加了数据库初始化时对文件系统访问异常的处理。若音乐库目录被设置为只读,数据库将自动回退并在应用程序的本地目录中进行初始化。
- 随机播放算法修复(智能随机): 通过引入已访问位置映射并反转索引遍历方向,消除了确定性随机播放(deterministic shuffle)算法中的级联效应(“多米诺骨牌效应”)。同时引入了
is_initial 标志,用于区分首次完全随机与自动播放切换时的确定性周期,防止播放顺序失真。
- 背景环境音保持: 修复了在切换 DSP 滤波器或激活
SoundUP 采样提升时导致后台环境音被重置的缺陷。现在重新启动音频解码器时,背景环境音的文件路径仍会被正确保留。
- 界面视觉微调: 调整了顶部设置面板中最小化和关闭控制按钮的高度,使其与整体导航元素的比例保持协调。清理了代码中未使用的可变变量,并消除了编译器警告。
- 消除切歌时的崩溃问题: 修复了解码线程(
decoder.rs)中的一处错误,即手动切歌时未重置 decoder_eof 标志。此前该错误会导致新曲目瞬间终止,并在尝试读取空缓冲区时引发恐慌。
- DSP 切换过渡优化: 在清理和重新创建音频引擎时,增加了对内部滤波器状态、自动增益控制(AGC)的 RMS 检测器以及前瞻限制器(
DynamicsPre::reset 和 DynamicsPost::reset)的重置逻辑。这避免了启动新曲目时出现音量骤增的情况。
- 保证数据库命名唯一性: 改进了
data.rs 模块中的分类与播放列表创建方法。增加了自动生成带有递增数字后缀的唯一名称的逻辑,防止因重复点击添加按钮导致 SQLite 违反 UNIQUE(唯一性)约束而触发事务错误。
- 应用程序图标解码优化: 托盘图标现改为从跨平台的虚拟 AVIF 容器中进行读取。
avif_icons.rs 模块使用 zenavif 提取出接近目标分辨率的资源,并利用内部的双线性缩放算法进行动态缩放,从而有效减少了二进制文件体积和编译时间。
- 极简文件体积优化: 从
Cargo.toml 中移除了 rand、walkdir、enough 以及 rgb 等重型依赖项。随机数生成器已替换为极致轻量级的 fastrand crate。symphonia 库配置为仅编译必要解码器,并对 Release 配置文件(codegen-units = 1、LTO、opt-level = "z")进行了极限优化设置,使最终生成的可执行文件体积缩减了数倍。
版本 1.0.0
(2026.05.23)
- Windows集成 (winres): 引入了基于
winres 的原生 Windows 资源编译。执行文件现在附带内置高分辨率图标 (icon.ico)。
- 系统托盘: 在
setup.rs 中编写了 ICO 文件解析器,可直接从二进制资源中提取高清晰度图标,以便在系统托盘中完美呈现。
- 频谱分析仪 (FFT): 开发了基于快速傅里叶变换 (FFT) 与汉宁窗的异步高分辨率频谱分析。其画面渲染与动画完全基于自定义 WGSL 着色器实时处理。
- 交叉渐变稳定性: 修复了
cubeb_host.rs 中的 Bug:音轨结束标志 (track_eof) 现在被正确拆分为逻辑解码结束 (decoder_eof) 与环形缓冲区物理清空。这防止了在交叉渐变处于活动状态时提前切换音轨。
- UI选项: 设置菜单中新增了“关于”信息页。
- 排版布局微调: 将 A-B 循环控制按钮的大小优化为 20x20 像素,并为所有的主要 DSP 链滑块添加了文本标签。
版本 0.9.0
(2026.05.21)
- 3D HRTF 虚拟器: 研发了
Hrtf3DVirtualizer 模块,用于模拟耳机听觉下的三维声学空间:包括 Mid/Side 信号分解、在 3 kHz 处的峰值滤波器(模拟耳道共鸣)、在 6.5 kHz 处的陷波滤波器(使人声靠前)、早期反射声学模拟(0.9 ms, -15.5 dB)、Side 通道的 8 kHz 陷波滤波、ITD(双耳时间差)模拟(0.28 ms)以及头部声学阴影模型。
- DynamicsPre (输入动态): 实现了次声波切除滤波器(基于级联双极子的 20Hz HPF, 4阶 Linkwitz-Riley 滤波器)以减轻功放负载、超声波切除 (22kHz LPF) 以及配备慢速 RMS 探测器的自动增益控制 (AGC) 模块(目标电平 -16 dBFS)。
- DynamicsPost (输出限制器): 研发了带 2 ms 延迟缓冲器的预见性(Look-ahead)峰值限制器(0.5 ms 启动时间,50 ms 释放时间),防止输出端出现数字剪切(Clipping)。
- A-B 循环 (A-B Looping): 实现了 A-B 段落循环播放功能,并支持在交互式波形上直观锁定起始点和结束点。
- 音量曲线: 新增了对数和混合硬件音量缩放曲线。
版本 0.8.0
(2026.05.20)
- SoundUP RT — 低音共鸣器: 利用 4阶 Linkwitz-Riley 滤波器隔离 100 Hz 以下的低频,并通过 ADAA-tanh 非线性饱和来生成次谐波,从而增加低音的厚重感。
- SoundUP RT — 哈斯去相关器 (Haas Decorrelator): 通过将其中一个通道中的高频分量(800 Hz 以上)延迟 1.2 ms 来展宽立体声场。
- SoundUP RT — ATR 模块: 利用快速和慢速包络探测器定位中高频(约 6.5 kHz)处的尖锐瞬态与打击乐攻击,动态强化其启动阶段。
- SoundUP RT — 高频激励器: 从 4.5 kHz 频段提取谐波,通过多项式合成生成 11 kHz 以上的奇偶超音,并调入经过调制的粉红噪声以重建空气感质感(16–36 kHz 巴特沃斯滤波器)。
- SoundUP RT — 磁带饱和器: 模拟 Mid 通道上的软磁带饱和,并配备过载控制。
- SoundUP RT 界面: 设置菜单中新增了“SoundUP RT”选项卡,内含针对这五个模块的独立强度滑块。
- 控制面板: 播放器的主要控制面板上新增了实时频谱分析仪的激活控制按键。
版本 0.7.0
(2026.05.16)
- 变速与变调: 研发了变速变调引擎 (
TimeStretchEngine),支持 WSOLA、Phase Vocoder 及 Resampling (Pitch Linked) 算法。
- 施罗德混响器 (Schroeder Reverb): 实现了空间
SchroederReverb,基于梳状和全通施罗德滤波器的反馈网络,支持虚拟房间大小微调。
- 交叉馈送 (Crossfeed): 新增了 Crossfeed 模块(在耳机听觉下引入 320 μs 延迟的声道横向混合,以模拟扬声器音响)。
- 信号微调 (SignalCorrector): 创建了信号微调模块,支持毫秒级声道延时对齐(Time Alignment)、各声道相位反转和单声道混音。
- 贝塞尔曲线编辑器: 引入了对 Fade-In 和 Fade-Out 渐变过程中交互式贝塞尔曲线编辑的支持。用户可直接在网格上调整渐变衰减形状,对数插值器实时计算混音音量。
- 智能随机播放 (Smart Shuffle): 实现了“随机洗牌 + 随机性算法近似”算法,可重新打乱播放列表,并防止在循环交界处产生重复,同时将当前播放的音轨固定在零索引处。
- 快速 DSP 设置 (Quick DSP): 控制面板新增了“Quick DSP Settings”弹出按钮,可直观控制速度、音调、节拍、混响、立体声混合和声道平衡。
版本 0.6.0
(2026.05.13)
- Cubeb 音频后端: 将底层的 CPAL 引擎全面替换为 Cubeb 多媒体音频库,以实现在 Windows 平台下更稳定的输出(支持 WASAPI Shared、WASAPI Exclusive 和 ASIO 驱动)。
- 音频设备选择: 实现了物理硬件音频输出设备的选择与扫描 (
audio_device)。
- 无缝交叉渐变 (Crossfade): 彻底重构了解码控制流线程 (
decoder.rs)。支持无缝音轨重叠淡入淡出(Crossfade)。音频引擎现在可在单个 DecStream 实例中,根据独立渐变参数同时并行解码并混合多个音频流。
- 圆角自定义: 在设置菜单中添加了圆角形状自定义拉杆(
ui_rounding 参数)。
- 浅色主题: 研发了全新的亮色珍珠主題
Light Pearl。
版本 0.5.0
(2026.05.11)
- 重采样器: 引入了重采样算法 (
StreamResampler),支持线性插值、三次埃尔米特样条(Hermite spline)和带 Lanczos 窗口的 16 点 Sinc 滤波器,以进行实时平滑。
- 抖动处理 (Ditherer): 研发了 TPDF 三角抖动、噪声整形误差和 5阶噪声整形 (NS5) 抖动处理模块,以便在 16位和 24位整型输出时使用。
- DSD调制: 实现了 5阶 Sigma-Delta 调制器 (SDM) 模拟,用于将高精度 PCM 音频流转换为高位深 1位 DSD。
- 32位浮点架构: 将整个信号处理和混合通道全面升级为高精度 32位浮点(32-bit Float)立体声架构。
- 自动协商: 实现了采样率和硬件缓冲区大小与音频设备之间的自动协商(Sample Rate/Buffer Size Negotiation)。
- 设置界面: 重新开发了“Settings UI”控制页,具备层级侧边树形目录结构,并集成交互式“Documentation Box”技术文档展示框,能够实时更新选中参数的详细解释。
- 音频流监视器: 引入了音频流参数监视器 (Info Monitor),可在界面上实时展示当前 API、采样率、缓冲区延迟、抖动状态及限制器状态。
版本 0.4.0
(2026.05.10)
- 窗口吸附 (Aero Snap): 实现了拖曳播放器窗口接近屏幕边缘时的自动磁吸机制,使其自适应吸附在屏幕边沿。
- 递归式播放列表迁移: 在数据库管理器中实现了递归式类别迁移 (
ChangePlaylistCategory)。当修改父级播放列表的类别属性时,系统自动在数据库中递归更新其下属的所有子播放列表。
- 重复项控制: 强化了拖拽导入文件时的多重校验,消除了数据库中产生重复文件路径的可能性。
- 播放控制修复: 修复了交互问题:在特定触发条件下点击 Play/Pause 会被错误判别为彻底停止播放信号 (
StopPlayback) 的缺陷。
版本 0.3.0
(2026.05.07)
- 垂直菜单: 数据库编辑器转为垂直排列:标签选项卡被移入左侧。着色器中新增
Mode 3u 渲染技术,支持将动态渲染出的字符纹理完美映射在发生旋转后的倾斜几何多边形上。
- 封面渲染: 集成了 Lanczos3 像素图像重采样模块 (
image_proc.rs),以此来实现对播放列表封面的支持(封面以 PNG/JPG/WebP 的二进制数据格式直接存在 SQLite 的 BLOB 字段中)。
- 封面预览: 在播放器主面板中添加了封面渲染,同时在数据库编辑器的列表条目上,实现了鼠标悬停时弹出封面浮窗的功能。
- 拖拽导入: 实现了将操作系统文件直接拖放到播放器视窗内的 Drag-and-Drop 导入技术。程序将异步扫描文件,提取歌曲元数据标签并写入数据库,同时自动绑定到当前播放列表。
- 导入摘要: 新增了导入结果弹出对话框(DnD Summary),汇总展示成功添加和跳过的文件数。
- 分类过滤: 数据库编辑器中添加了专门的下拉筛选菜单,用于按类别对播放列表进行过滤。
- 缺失项过滤: 新增了智能开关,支持对磁盘中已不存在的音频文件快速打上
[Absent] 标签并进行一键筛查。
版本 0.2.0
(2026.05.05)
- 元数据扩展: SQLite 数据表 (
tracks) 中补充了新字段:包括发行年份 (release_date)、歌手 (artist) 以及原始音轨名称标签 (tag_title)。
- 自动标签解析: 基于 Symphonia 框架在导入歌曲时加入了完善的后台异步元数据及 ID3 标签解析机制。
- 标签编辑: 提供了完备的歌曲元数据编辑对话框,用户可直接在播放器中点击查看并对歌曲属性进行手动编辑。
- 本地化系统: 实现了基于独立
.loc 本地化资源的本地化系统,创建了俄文 (ru-RU.loc) 和英文 (en-US.loc) 本地化翻译文件。
- 会话保存: 实现了会话状态持久化(保存至
settings.json),在下次开启播放器时,自动恢复上次关闭前的活动播放列表、当前播放歌曲及准确的播放进度。
- 数据库编辑器: 重新梳理了数据库编辑器 UI,分化为“类别”、“播放列表”与“音轨”三个独立选项卡,彻底告别旧版单一密集界面的混乱。
- 文件校验: 新增了磁盘文件完整性扫描,发现不存在物理文件时在数据库中高亮标注。
- 文件结构视图: 添加了文件结构视图切换,支持在扁平列表展示和树形文件夹目录之间随时切换。
- 排序和过滤: 增加了针对音轨按字母表、发行日期等维度进行排序和过滤的功能。
- 路径重定位: 支持对数据库中已保存音频文件记录进行文件路径重新映射。
版本 0.1.0
(2026.05.03)
- 核心架构与存储: 开发了专用的
core_db 库,用于管理基于 SQLite 驱动的 music.db 数据库文件(使用 rusqlite 底层静态链接)。
- 关系型数据库结构: 建立了合理的表关联结构,包含:
categories 分类表、playlists 播放列表表(支持层级树状 parent_id 自关联、联动删除和 JSON 参数持久化)、tracks 音轨表(包含相对路径、音频时长及各种元数据标签)以及多对多 playlist_tracks 关联表(包含歌曲的次序控制字段 track_order)。
- 递归查询: 编写了高效的递归 CTE 查询语句,在选择父播放列表时,会自动向下递归遍历子树,并返回下属所有子播放列表包含的全部音轨,同时维护其自定义的播放次序。
- 音频输出: 基于 CPAL 设计了跨平台音频输出硬件接口,内部借助一个完全无锁、单生产单消费(SPSC)的高性能环形缓冲区(
ringbuf)进行缓冲。
- 音频解码: 深度集成了
symphonia 音频解码模块,完美支持 MP3, FLAC, WAV, OGG, OPUS, M4A 等流媒体和无损格式。
- 多线程信号通道: 建立了安全的多线程音频信号通道:主要的歌曲文件解码运行在独立的后台线程中,环境垫乐(Ambient 背景声道)的解码和混合则在另一条专用线程中进行。
- 均衡器: 实现了参数化 12 波段均衡器,基于高保真 2阶双极子峰值滤波器级联构建(中心频段涵盖 16 Hz 至 16 kHz)。
- Soundgoodizer: 集成了 Soundgoodizer 多波段响度增强处理器:基于高陡度 4阶 Linkwitz-Riley 的三分频交叉滤波器(在中频 250 Hz 和高频 4000 Hz 进行精确分割),并配备独立压缩器与 tanh 非线性饱和。
- 软剪切: 在混音器输出通道中追加了基于双曲正切函数 (
tanh) 的软限制(Soft Clip)剪切。
- 硬件渲染: 利用 WGPU 视窗规范和
winit 编写了全硬件渲染界面,文本排版与渲染由 glyphon 提供支持。
- 界面视觉效果: 编写了专门的 WGSL 渲染代码,实现了元素平滑圆角和利用交错梯度噪声与多次离屏缓冲区采样的动态毛玻璃效果(Glassmorphism)。
- 自定义无边框窗口: 实现了自定义无边框视窗逻辑,支持拖动顶部标题栏移动、系统右键菜单、窗口缩放、最小化和关闭动画。
- 系统集成: 增加了对 Windows 系统托盘图标(
tray-icon)和右键上下文菜单(muda)的支持。
- 应用屏幕: 分离并设计了两个主屏幕:“播放器”屏幕(带有互动式波形进度条、支持点击定位及波形渲染)与“数据库编辑器”配置屏幕。