timeshiftsauce /CeruMusic

Ceru Music 是基于 Electron 和 Vue 开发的跨平台桌面音乐播放器工具,借鉴洛雪音乐插件思想,提供插件运行框架与播放功能,不直接存储、提供任何音乐源文件。用户需通过自行选择、安装合规插件获取音乐相关数据,项目旨在为开发者提供桌面应用技术实践与学习案例,为用户提供合规的音乐播放工具框架。

★ 2,064⑂ 113👁 8⑃ 23● 115▤ 93
VueNOASSERTIONCreated 2025-08-13ceru.docs.shiqianjiang.cn
Download: v2.4.0v2.4.0 ↓2.4.02026-10-21
+3
Daily
2,064
stars
113
forks
8
watchers
23
prs
115
issues
93
releases

README

Ceru Music(澜音)

一个跨平台的音乐播放器应用,支持基于合规插件获取公开音乐信息与播放功能。

 项目简介

Ceru Music 是基于 Electron 和 Vue 开发的跨平台桌面音乐播放器工具,仅提供插件运行框架与播放功能,不直接存储、提供任何音乐源文件。用户需通过自行选择、安装合规插件获取音乐相关数据,项目旨在为开发者提供桌面应用技术实践与学习案例,为用户提供合规的音乐播放工具框架。



!image-20251003173654569

 Star History



 技术栈

- Electron:用于构建跨平台桌面应用
- Vue 3:前端框架,提供响应式 UI
- TypeScript:增强代码可维护性和类型安全
- Pinia:状态管理工具
- Vite:快速的前端构建工具
- CeruPlugins:音乐插件运行环境(仅提供框架,不包含默认插件)

 项目结构


  点击查看目录结构

ast
CeruMuisc/
    ├── .github/
    ├── scripts/
    ├── src/
    │   ├── common/
    │   │   ├── types/
    │   │   │   ├── playList.ts
    │   │   │   └── songList.ts
    │   │   ├── utils/
    │   │   │   ├── lyricUtils/
    │   │   │   │   ├── kg.js
    │   │   │   │   └── util.ts
    │   │   │   ├── common.ts
    │   │   │   ├── nodejs.ts
    │   │   │   └── renderer.ts
    │   │   └── index.ts
    │   ├── main/
    │   │   ├── events/
    │   │   │   ├── ai.ts
    │   │   │   ├── autoUpdate.ts
    │   │   │   ├── directorySettings.ts
    │   │   │   ├── musicCache.ts
    │   │   │   ├── pluginNotice.ts
    │   │   │   └── songList.ts
    │   │   ├── services/
    │   │   │   ├── music/
    │   │   │   │   ├── index.ts
    │   │   │   │   ├── net-ease-service.ts
    │   │   │   │   └── service-base.ts
    │   │   │   ├── musicCache/
    │   │   │   │   └── index.ts
    │   │   │   ├── musicSdk/
    │   │   │   │   ├── index.ts
    │   │   │   │   ├── service.ts
    │   │   │   │   └── type.ts
    │   │   │   ├── plugin/
    │   │   │   │   ├── manager/
    │   │   │   │   │   ├── CeruMusicPluginHost.ts
    │   │   │   │   │   └── converter-event-driven.ts
    │   │   │   │   ├── index.ts
    │   │   │   │   └── logger.ts
    │   │   │   ├── songList/
    │   │   │   │   ├── ManageSongList.ts
    │   │   │   │   └── PlayListSongs.ts
    │   │   │   ├── ai-service.ts
    │   │   │   └── ConfigManager.ts
    │   │   ├── utils/
    │   │   │   ├── musicSdk/
    │   │   │   │   ├── api-source-info.ts
    │   │   │   │   ├── index.js
    │   │   │   │   ├── options.js
    │   │   │   │   └── utils.js
    │   │   │   ├── array.ts
    │   │   │   ├── index.ts
    │   │   │   ├── object.ts
    │   │   │   ├── path.ts
    │   │   │   ├── request.js
    │   │   │   └── utils.ts
    │   │   ├── autoUpdate.ts
    │   │   └── index.ts
    │   ├── preload/
    │   │   ├── index.d.ts
    │   │   └── index.ts
    │   ├── renderer/
    │   │   ├── public/
    │   │   │   ├── default-cover.png
    │   │   │   ├── head.jpg
    │   │   │   ├── logo.svg
    │   │   │   └── wldss.png
    │   │   ├── src/
    │   │   │   ├── api/
    │   │   │   │   └── songList.ts
    │   │   │   ├── components/
    │   │   │   │   ├── AI/
    │   │   │   │   │   └── FloatBall.vue
    │   │   │   │   ├── ContextMenu/
    │   │   │   │   │   ├── composables.ts
    │   │   │   │   │   ├── ContextMenu.vue
    │   │   │   │   │   ├── demo.vue
    │   │   │   │   │   ├── index.ts
    │   │   │   │   │   ├── README.md
    │   │   │   │   │   ├── types.ts
    │   │   │   │   

Top issues

Discussions

Latest release

v2.4.0 v2.4.0 2026-10-21
这次更新以「界面与手感」为主线:设置页整体重做(分组导航、本页目录、全局搜索),
播放页新增钛金属流沙背景并重做背景鼓点,Apple 风格歌词换用上游未发布快照后滚动更跟手、更省 CPU,
社区评论区支持贴纸 / Emoji / 颜文字与长文折叠,同时修掉一批下载、搜索与歌词时序问题。

 ⚙️ 设置页重做

- 左侧导航重排为 聆听体验 / 内容与扩展 / 应用管理 三组、共 11 个分类,并新增两个独立页面:
  「歌词」(歌词字体、桌面歌词、macOS 菜单栏歌词)与 「系统与性能」(窗口关闭行为、页面预加载、
  系统媒体控件高清封面)。
- 每个分类顶部新增标题与一句话说明;右上角新增 「本页目录」 下拉,可直接跳到本页任意设置项并高亮目标区块。
- 分类名更直白:外观设置 → 外观与主题、播放设置 → 播放与音效、音乐源 → 音乐源与音质、
  存储管理 → 下载与存储、网络设置 → 网络与代理、AI 功能 → AI 助手、关于 → 关于与更新。
- 搜索更准:结果始终显示中文分类名(不再出现英文 key),能搜到「全局背景」「页面预加载」
  「系统媒体控件高清封面」「播放画面与动效」「联系方式」等新增或迁移项;窄窗口下下拉不再溢出或被裁切。
- 切换分类会分别记住各自的滚动位置;页内跳转只滚动内容区(顶部留 16px),目标区块显示 2 秒描边高亮,
  系统开启「

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON