次元音乐：免费开源的二次元PWA音乐播放器

次元音乐是什么？一款为二次元爱好者打造的音乐应用

「次元音乐」是一款专为二次元爱好者设计的开源免费音乐播放器，基于 PWA（Progressive Web App）技术构建，支持 Windows、macOS、Android、iOS 等多平台安装使用。项目采用全栈开发方式完成，同时也是 Vibe Coding 理念的一次有趣实践，非常适合新手开发者学习参考。

核心特性：多音源聚合 + PWA 跨平台体验

三大主流音乐平台接入

次元音乐目前聚合了三个主流音乐平台的资源：

• QQ音乐（企鹅）：腾讯系音乐资源
• 网易云音乐：网易系音乐资源
• B站（哔哩哔哩）：B站音频资源

多音源聚合是指通过统一的后端接口层，将多个不同平台的音乐资源整合到一个应用中呈现。其技术实现通常涉及几个关键环节：首先是各平台 API 的逆向分析或官方接口对接，获取歌曲搜索、详情、播放链接等数据；其次是数据格式的标准化处理，因为不同平台返回的 JSON 结构、字段命名、音质参数各不相同，需要在后端统一映射为一致的数据模型；最后是播放链接的动态解析，许多平台的音频 URL 带有时效性签名，需要在用户点击播放时实时获取有效链接。这种架构模式在 UnblockNeteaseMusic、YesPlayMusic 等知名开源音乐项目中也被广泛采用，是音乐类聚合应用的经典技术方案。

需要说明的是，由于版权限制，次元音乐只能播放各平台上的免费歌曲，付费或VIP专属内容无法获取。不过对于日常听二次元歌曲、翻唱、同人音乐而言，免费资源的覆盖范围已经相当广泛。二次元音乐是一个庞大且活跃的亚文化音乐生态，涵盖动画原声（OST）、角色歌、Vocaloid/虚拟歌手作品、游戏音乐、翻唱、同人音乐等多个细分类别。其中同人音乐（Doujin Music）是指基于已有作品进行二次创作的音乐，在日本的 Comiket 等同人展会上有着深厚的传统，东方 Project 系列更是催生了数以万计的同人音乐作品。在中国，B 站是二次元音乐创作和传播的核心平台，大量 UP 主在此发布翻唱、编曲、原创虚拟歌手作品。由于这类内容大多由个人创作者免费发布，版权限制相对宽松，这也解释了为什么次元音乐虽然只能播放免费歌曲，但对二次元用户的覆盖度依然很高。

PWA 技术带来的体验优势

PWA 即渐进式 Web 应用，是 Google 在 2015 年前后大力推广的一种 Web 应用形态。它的核心思想是让网页应用具备原生应用的能力——包括离线访问、推送通知、桌面安装等。PWA 依赖三项关键技术：Service Worker（负责缓存和离线逻辑）、Web App Manifest（定义应用名称、图标、启动方式等元信息）以及 HTTPS（确保传输安全）。与传统的 Electron 或 Tauri 等桌面打包方案相比，PWA 无需打包二进制文件，用户通过浏览器即可完成安装，应用体积极小。不过 PWA 也有局限：对系统底层 API 的调用能力有限，且不同浏览器和操作系统对 PWA 标准的支持程度参差不齐，这也是为什么次元音乐推荐使用 Chromium 系浏览器的原因。

作为一款 PWA 应用，次元音乐在使用体验上有几个明显的优势：

• 可安装到桌面：通过浏览器直接"安装"到桌面或手机主屏幕，打开后接近原生应用的体验
• 真正的跨平台：一套代码覆盖 Windows、macOS、Android、iOS，无需分别下载不同版本
• 极致轻量：不用从应用商店下载安装包，几乎不占额外存储空间

浏览器方面，推荐使用 Google Chrome 安装，体验最佳。Microsoft Edge 同样基于 Chromium 内核，效果也不错。Chromium 是 Google 主导的开源浏览器项目，也是 Chrome 浏览器的技术基础。2018 年微软宣布放弃自研的 EdgeHTML 引擎，转而基于 Chromium 重建 Edge 浏览器，这使得当前桌面浏览器市场中 Chromium 系占据了超过 80% 的份额。Chromium 对 PWA 的支持最为完善，包括完整的 Service Worker 生命周期管理、Web App Manifest 解析、独立窗口运行等。相比之下，Apple 的 Safari 虽然在 iOS 16.4 之后开始支持 PWA 推送通知，但在安装体验、后台运行等方面仍有诸多限制；Firefox 则在 2021 年移除了桌面端的 PWA 安装支持（仅保留移动端），这些差异直接影响了 PWA 应用的实际体验。因此，Safari 和 Firefox 对 PWA 的支持程度有限，建议优先选择 Chromium 系浏览器。

安装与使用教程

如何安装次元音乐

安装过程非常简单，只需四步：

1. 使用 Chrome 或 Edge 浏览器打开次元音乐的网页地址
2. 浏览器地址栏右侧会出现安装图标（也可以通过菜单中的"安装应用"选项触发）
3. 点击安装，应用会自动添加到桌面或应用列表
4. 之后直接从桌面图标启动即可，不需要再手动打开浏览器

日常使用体验

安装完成后，应用界面简洁清爽，整体视觉风格贴合二次元审美。用户可以在三个音源节点之间自由切换，搜索并播放喜欢的歌曲。

有一个小细节值得留意：在部分系统环境下，PWA 应用可能存在录屏时无法捕获音频的情况。这个问题的根源在于操作系统对音频流的路由机制。PWA 应用虽然运行在独立窗口中，但其音频输出仍然通过浏览器进程的音频上下文（AudioContext）进行管理。在 Windows 系统中，部分录屏软件依赖「应用级音频捕获」（WASAPI Loopback）来录制特定窗口的声音，但 PWA 的音频流可能被归属到浏览器主进程而非 PWA 独立窗口进程，导致录屏软件无法正确识别和捕获。macOS 上的情况类似，系统级的音频沙箱机制也可能阻止第三方录屏工具获取 PWA 的音频输出。解决方案通常是选择录制「系统全局音频」而非「应用音频」，或使用虚拟音频设备（如 VB-Cable）进行音频路由。这是 PWA 音频输出机制导致的，并非应用本身的 Bug。

技术亮点：全栈开发 + Vibe Coding 实践

适合新手的全栈学习项目

次元音乐作为一个完整的全栈项目，涵盖了前端界面开发、后端 API 聚合、多音源数据对接等多个技术环节。项目结构清晰、规模适中，对于正在学习全栈开发的新人来说，是一个很好的实战参考。

用兴趣驱动代码：Vibe Coding

这个项目践行了 Vibe Coding 的开发理念——把个人兴趣（二次元音乐）和技术实践结合起来，在轻松愉快的状态下写代码。Vibe Coding 这一概念在 2025 年初由 Andrej Karpathy（前 Tesla AI 总监、OpenAI 联合创始人）在社交媒体上提出并迅速走红。他描述的 Vibe Coding 是一种全新的编程方式：开发者不再逐行编写代码，而是通过自然语言向 AI 描述需求，由大语言模型生成代码，开发者只需验证结果是否符合预期。这种方式大幅降低了编程门槛，让非专业开发者也能快速构建功能完整的应用。在更广义的理解中，Vibe Coding 也被延伸为一种以兴趣和直觉驱动的轻松编程状态——不追求工程上的完美，而是享受创造的过程。次元音乐项目正是这种理念的典型实践：将个人对二次元文化的热爱融入技术实现，在愉悦的心流状态中完成开发。这种以热爱驱动的开发方式，往往能做出更有温度、更有灵魂的作品。

完全开源，欢迎参与

项目代码完全开源，任何人都可以查看源码、学习实现思路，也可以提交 PR 参与贡献。无论是二次元社区还是开源社区，这类深耕垂直领域的小工具都有其独特的存在价值。

总结：小而美的二次元音乐解决方案

次元音乐是一个小而美的开源项目，它把 PWA 技术和二次元音乐需求巧妙地结合在一起，为用户提供了一个轻量、免费、跨平台的音乐播放方案。虽然受版权限制只能播放免费歌曲，但对于日常听二次元歌曲、翻唱和同人音乐来说已经足够好用。

同时，作为一个全栈学习项目，次元音乐的代码结构和技术选型也值得新手开发者仔细研究。如果你既喜欢二次元音乐，又想找一个实战项目练手，不妨从这个项目开始。