SU音乐

"sufo1/SUmusic" 这个仓库（README 已包含在对话里）。按仓库内容和公开信息归纳一下，顺便说怎么用、怎么改、有哪些坑。

一、项目定位

- 名称：SU音乐 / SUmusic，口号“纯粹·简约·无广告·开源音乐播放器” - 技术栈：HTML + AndLua，依赖系统 WebView 内核；仓库语言占比 HTML 约 88.4%、Lua 约 11.6% - 平台：Android 7.0+，安装包约 3.64 MB，MIT 许可证 - 文件：index.html、init.lua、main.lua、main2.lua、main3.lua、icon.png、README；Releases 有 1.63.1（最终开源版）和 1.63.8“重新开源”

二、能做什么 / 不能做什么

按 README 明确说明：

- 已移除所有在线音乐相关代码，不内置任何音乐播放 API，在线搜索/播放默认不可用 - 保留本地能力：本地音乐播放、文件管理、10 段均衡器/音效预设、自动加载同目录 .lrc 歌词 - 零开屏广告、零推送，纯离线可用

换句话说：它现在更接近“本地播放器壳”，不是洛雪/MusicFree 那种聚合在线音源的工具。 三、普通用户怎么用

1. 进 Releases 下源码或作者发布的包（1.63.8 为重新开源最新、1.63.1 为默认展示版） 2. 用 AndLua 类环境或按作者说明打包/运行；手机装好 WebView 内核 3. 只放本地 MP3/FLAC 等，歌词放同目录 "xxx.lrc" 4. 别期待直接搜“周杰伦/网易云/QQ”在线放——除非自己接 API

四、开发者接“在线音乐”的正确姿势

仓库 README 只说“自行搭建/对接第三方/改 api 模块”，没给具体接口。结合 AndLua+HTML 架构可这样落地：

- 本地扫描示例（AndLua 侧）：用 "File" 遍历目录筛 ".mp3/.flac"， "MediaPlayer" 播放，ListView 绑歌词 - HTML 侧播放： "<audio>" 标签 + JS 控制，若走 WebView 直接播网络 URL 最省事 - 自建音乐 API：用 Node/Python 写 search/songUrl/lyric 三个接口，返回 JSON；SUmusic 的 HTML/lua 发起 "fetch" 或 AndLua "Http" 请求 - 正规授权音源（推荐，合规）：Spotify/Apple Music/YouTube Music 等官方授权方式；其中 Spotify 走 OAuth+Web API、Web Playback SDK 控制播放 - 网易云等社区非官方 API 只建议“个人学习”：如 NeteaseCloudMusicApi 可拿 song_url/lyric ，但用于公开分发、破解会员、商业用途会有版权/条款问题

五、合规与安全风险（重点）

- 接第三方未授权音源风险高：聚合抓取网易/QQ/酷狗/酷我等可能涉及版权，国内法律与平台账号都有风险 - 音乐流媒体本身涉及表演权/母带权/同步权，公开服务通常要授权；用免版税、公有领域、原创，或接已授权平台 API 最稳 - MIT 只管代码授权，不管音乐内容授权；“代码开源”≠“随便放歌” - 该仓库已声明纯空壳、自行接入第三方需遵守服务条款、勿商用 https://xn--69w.top/