网站简介

Ceru Music（澜音）是一款基于 Electron 和 Vue 3 开发的跨平台桌面音乐播放器应用。它本身不提供任何音乐源文件，仅提供插件运行框架与播放功能，用户通过自行选择并安装合规插件来获取公开的音乐信息与播放能力。该项目代码完全开源，遵循 GNU AGPL v3.0 许可，面向开发者提供技术实践与学习案例，同时也为普通用户提供了一个界面优雅、功能丰富的音乐播放工具。

主要功能

跨平台支持

• 支持 Windows、macOS、Linux 三大操作系统
• 原生桌面应用，基于 Electron 构建，性能表现稳定

多平台解析

• 支持通过合规插件对接网易云音乐、QQ音乐等多个音乐平台
• 插件框架提供统一的接口，便于扩展更多平台

歌词与元数据

• 实时歌词显示，支持专辑封面、歌手等公开元数据的获取
• 歌词组件基于 applemusic-like-lyrics 项目，视觉体验出色

数据性能优化

• 采用虚拟滚动列表，优化大量音乐数据的渲染性能
• 使用 Pinia 管理状态，响应式 UI 流畅自然

本地播放列表管理

• 用户可手动创建和管理本地播放列表
• 数据仅保存在用户设备本地，不进行云端备份，保障隐私

插件生态框架

• 提供完整的插件开发文档和接口文档
• 插件需用户自行获取并确保合规性，框架本身不包含默认插件

特点说明

技术栈先进

项目采用 Electron + Vue 3 + TypeScript + Pinia + Vite 的组合，代码结构清晰，类型安全，便于二次开发和维护。CeruPlugins 提供了独立的插件运行环境，仅包含框架，不包含任何默认插件。

高度开放与合规

• 遵循 GNU AGPL v3.0 开源协议，允许学习和二次开发
• 插件开发文档明确要求开发者遵守数据来源平台的用户协议与版权法
• 禁止开发、传播获取非公开数据的插件，体现了对知识产权的尊重

界面优雅

采用现代化设计语言，配合流畅的动画效果，为用户带来愉悦的视觉体验。首页展示了详细的介绍、功能亮点、安装使用说明等内容，整体设计清晰简洁。

开发者友好

• 提供产品设计文档、插件开发文档、接口文档，便于开发者快速上手
• 支持 Windows、macOS、Linux 的构建指令，方便打包发布
• 社区通过 Gitee 私信联系维护者，技术交流氛围良好

使用场景

• 作为日常音乐播放工具，替代第三方在线播放器
• 作为学习 Electron 和 Vue 开发桌面应用的参考项目
• 作为插件开发框架，供开发者扩展更多音乐数据源

总结

Ceru Music（澜音）是一个注重合规性和开源精神的跨平台音乐播放器框架。它不直接提供音乐资源，而是通过插件机制让用户自主选择数据源，既规避了版权风险，又保持了灵活性和可扩展性。对于喜欢自定义音乐播放体验的用户和希望学习桌面应用开发的开发者，这是一个非常有价值的项目。