Skip to content

🧩 插件系统概览

EchoMusic 从 v2.2.6-beta.11 起支持完整的插件系统。插件可以扩展界面、添加功能、修改外观,让你打造专属的音乐播放体验。

插件系统定位

EchoMusic 内置一套完全自研、深度耦合主程序的定制化插件运行体系,整体设计思路与 Chromium 系浏览器插件有着本质区别——不兼容 Chrome 插件规范、沙盒隔离模型与权限清单机制。

超高拓展自由度

插件运行环境与主程序原生打通,不存在分层安全沙盒隔离。主程序向插件完整开放音频内核、本地文件、数据库、窗口、网络、外设等底层接口。开发者可基于完整程序能力实现音源接入、界面重构、音频实时处理、系统联动、本地媒体批量管理等深度定制功能,拓展边界不受框架硬性限制。

安全权责交由用户自主把控

程序不会主动限制插件操作权限。插件的安装、启用、卸载、信任与否全部由用户自主决策,第三方插件带来的使用风险由用户自行知悉并承担。项目不做强制插件审核,充分下放使用选择权。

配套安全模式

为解决无沙盒环境下插件异常、恶意代码、逻辑崩溃导致主程序卡死、闪退、配置损坏等问题,系统内置安全模式(详见 管理与安全 → 章节)。

什么是插件

插件是由社区成员或你自己编写的小型代码包,可以在 EchoMusic 中:

  • 📌 注册独立页面或侧边栏入口
  • 🎨 注入自定义 CSS 样式、修改界面风格
  • 🎵 监听播放器状态、控制播放
  • 🖼️ 创建桌面浮窗(如任务栏歌词、灵动岛等)
  • 📝 提供自定义歌词内容或歌词动效
  • 🔍 接管特定歌曲的音源解析(如 WebDAV 云音乐)
  • ⚙️ 添加设置面板
  • 📋 在歌曲右键菜单中添加选项
  • 📊 读取音频频谱数据,实现可视化效果

插件定位接近 VS Code / Obsidian 的高自由度本地扩展:EchoMusic 提供宿主 API,插件自由发挥。

快速导航