🚀 安装与启动

macOS 提示「无法验证开发者」

这是 macOS 的安全机制，不影响正常使用。解决方法：

# 方法1：终端执行
xattr -cr /Applications/EchoMusic.app

# 方法2：系统设置
# 系统设置 → 隐私与安全性 → 点击「仍要打开」

Windows 提示「Windows 已保护你的电脑」

点击「更多信息」→「仍要运行」即可。

Windows 安装后没有主程序，只有卸载程序

安装了与电脑架构不匹配的安装包。若你不知道自己电脑是什么架构的，优先使用 x64 安装包（可在群文件获取）。

Linux AppImage 无法运行

确保已赋予可执行权限：

chmod +x EchoMusic-*.AppImage
./EchoMusic-*.AppImage

启动后闪退

1. 检查系统版本是否满足最低要求
2. 尝试以管理员/root 权限运行
3. 检查是否有安全软件拦截

启动显示「播放引擎初始化失败」

请更新到最新版本。如果已经是最新版，请联系开发者。

启动显示「设备注册失败」

1. 检查当前网络环境
2. 关闭代理/加速器后重试
3. 如果仍无法使用，可以更换网络热点尝试

无法启动或启动失败

在程序根目录使用以下命令运行，将终端日志截图发到群里寻求帮助：

.\EchoMusic.exe --console