Alive 音乐上报插件

适用于 Salt Player for Windows（SPW）的独立 Alive 音乐上报插件。它不加载或依赖音乐标签工作台，也不会上报设备状态；仅访问 Alive 的音乐 API。

功能

• 立即上报当前歌曲、艺术家、专辑、歌词、播放/暂停状态。
• 可选上传当前本地音频；必须在插件设置页选择允许上传的文件夹，未选择时只能上报状态。
• 本地音频在后台查询和上传，不会阻塞当前音乐状态上报。
• 先按原文件名复用服务器音乐库中的已有文件；未命中时才上传当前文件，不会扫描或计算整库哈希。
• 以原文件名上传到 Alive 音乐库；同名不同内容自动加短后缀。
• 使用心跳保持音乐卡片在线，不同步访客进度。
• SPW 正常退出或卸载插件时主动清空音乐卡片；异常退出仍由服务端超时兜底。

服务器地址需填写完整的 http:// 或 https:// 地址；可以填写根地址或 /api/music/set 完整地址。反向代理强制 HTTPS 时，必须填写 https:// 地址。

安装

导入 build/distributions/SPW-Alive-Music-Reporter-*.zip 到 SPW 本地插件管理，然后在插件设置页填写 Alive 地址、密钥和允许上传的音乐文件夹。

构建

需要 Java 21：

.\gradlew.bat plugin

产物位于 build/distributions。