🧩 插件系统概览
EchoMusic 从 v2.2.6-beta.11 起支持完整的插件系统。插件可以扩展界面、添加功能、修改外观,让你打造专属的音乐播放体验。
插件系统定位
EchoMusic 内置一套完全自研、深度耦合主程序的定制化插件运行体系,整体设计思路与 Chromium 系浏览器插件有着本质区别——不兼容 Chrome 插件规范、沙盒隔离模型与权限清单机制。
超高拓展自由度
插件运行环境与主程序原生打通,不存在分层安全沙盒隔离。主程序向插件完整开放音频内核、本地文件、数据库、窗口、网络、外设等底层接口。开发者可基于完整程序能力实现音源接入、界面重构、音频实时处理、系统联动、本地媒体批量管理等深度定制功能,拓展边界不受框架硬性限制。
安全权责交由用户自主把控
程序不会主动限制插件操作权限。插件的安装、启用、卸载、信任与否全部由用户自主决策,第三方插件带来的使用风险由用户自行知悉并承担。项目不做强制插件审核,充分下放使用选择权。
配套安全模式
为解决无沙盒环境下插件异常、恶意代码、逻辑崩溃导致主程序卡死、闪退、配置损坏等问题,系统内置安全模式(详见 管理与安全 → 章节)。
什么是插件
插件是由社区成员或你自己编写的小型代码包,可以在 EchoMusic 中:
- 📌 注册独立页面或侧边栏入口
- 🎨 注入自定义 CSS 样式、修改界面风格
- 🎵 监听播放器状态、控制播放
- 🖼️ 创建桌面浮窗(如任务栏歌词、灵动岛等)
- 📝 提供自定义歌词内容或歌词动效
- 🔍 接管特定歌曲的音源解析(如 WebDAV 云音乐)
- ⚙️ 添加设置面板
- 📋 在歌曲右键菜单中添加选项
- 📊 读取音频频谱数据,实现可视化效果
插件定位接近 VS Code / Obsidian 的高自由度本地扩展:EchoMusic 提供宿主 API,插件自由发挥。