一款 Windows 桌面音乐播放器,覆盖「音乐库 → 播放 → 歌词 → 音效 → 系统集成」完整闭环。
音乐库:递归扫描本地文件夹,按文件夹 / 歌手 / 专辑分组浏览,提供专辑封面墙视图;文件夹内容增删热监控自动同步,支持增量去重与启动自动扫描。
播放与列表:单击播放、拖拽排序、表头排序、列表即时过滤搜索、右键菜单(播放 / 下一首 / 收藏 / 详情 / 定位文件),自动读取音频元数据,支持 mp3 / flac / wav / ogg / m4a / aac / opus / wma / ape 等格式。
歌词:同目录 .lrc 自动匹配并做 UTF-8 / GBK 转码,支持双语对照、逐字卡拉 OK 高亮、全屏歌词页与桌面歌词悬浮窗(位置记忆、点击穿透可开关)。
音频处理:10 段图示均衡器 + 8 种预设、多组 DSP 音效预设、0.5x–2x 倍速、切换淡入淡出、响度均衡与音量增益。
系统集成与个性化:系统托盘、任务栏缩略图按钮、系统媒体键与全局快捷键、开机自启、切歌桌面通知、迷你模式、5 套主题色与自定义背景图;歌单支持 m3u / JSON 导入导出,ID3 标签(标题 / 歌手 / 专辑 / 封面)可就地编辑。
架构:Electron 43(Chromium 150 内核)主进程 / 渲染进程分离,渲染层基于原生 Web 技术栈实现,无重型前端框架;通过 preload 的 contextBridge 白名单 IPC 与主进程通信。主进程负责窗口、托盘、全局快捷键、系统媒体键与文件系统访问,渲染进程负责界面与播放状态机。
音频:基于 Web Audio API 实现 10 段均衡器、DSP 音效预设、增益与淡入淡出;音频元数据解析使用 music-metadata,标签写回使用 node-id3。
性能:元数据做磁盘缓存实现启动秒开,封面采用视口懒加载,万首规模列表滚动不卡顿。
工程化:electron-builder 产出 NSIS 安装包与免安装便携版,通过 asarUnpack 配置资源使安装后无需 Node.js 环境;自研打包产物自检脚本核对 app.asar 内关键文件是否齐全;内置本地 HTTP 控制接口用于自动化,配套 31 项断言的端到端测试脚本;另有一套冒烟测试覆盖启动、音频服务、在线链路、UI 状态机与桌面歌词五个部分。主进程与渲染进程共 17 个 JS 模块,约 9,400 行代码。