🌐 由轻量后端服务支撑的现代化网页音乐播放器，整合多种音乐聚合接口，覆盖搜索、播放、歌词同步与音频下载全流程。

感谢 GD音乐台(music.gdstudio.xyz)提供的免费API

感谢 来自Linux.do 牛就是牛@ufoo 大佬 https://linux.do/t/topic/942415提供的灵感

• 🔍 跨站曲库检索：一键切换数据源，支持分页浏览并批量导入播放队列。
• 📻 队列管理灵活：新增、删除、清空操作即时生效，并自动持久化到浏览器 localStorage。
• 🔁 丰富的播放模式：列表循环、单曲循环与随机播放随手切换，记忆上次偏好。
• 📱 竖屏移动端：全新竖屏布局匹配移动端手势与屏幕比例，按钮、列表与歌词均针对单手操作优化。
• 📝 动态歌词视图：逐行滚动高亮，当前行自动聚焦，手动滚动后短暂锁定视图。
• 📥 多码率下载：可挑选 128K / 192K / 320K / FLAC 等品质并直接获取音频文件。
• 📤 播放列表导入导出：一键导出当前队列或导入备份的播放列表，快速迁移到其他设备。
• ☁️ 轻量后端代理：通过 Cloudflare Pages Functions 统一聚合各数据源并处理音频跨域，摆脱浏览器直接访问的限制。
• 🎨 主题美学：内置亮/暗模式与玻璃拟态界面，桌面与移动端均具备沉浸体验。
• 📱 竖屏移动端：全新竖屏布局匹配移动端手势与屏幕比例，按钮、列表与歌词均针对单手操作优化。
• 🖼️ 沉浸式背景：根据当前曲目封面自动取色，实时渲染模糊背景，氛围与音乐保持一致。
• 🌊 青绿基调：参考 Emby 等播放器打造统一青绿色视觉体系。
• 🔒 锁屏播放控制：锁屏界面自动显示专辑封面与播放控件，无需解锁即可进行播放控制。
• 🛠️ 调试控制台：按下 Ctrl + D 呼出实时日志面板，便于排查接口或交互异常。

⚠️ 项目完全依赖 Cloudflare Pages Functions，目前仅支持部署到 Cloudflare Pages 环境运行。

1. Fork 或克隆本仓库。
2. ☁️ 按照 Cloudflare Pages 文档创建站点，并将本仓库作为构建来源或直接上传静态资源。
3. 🚀 部署完成后，通过 Cloudflare Pages 分配的域名访问站点即可体验播放器。

• 🔗 API 基地址定义在 index.html 中的 API.baseUrl（约 1300 行），可替换为自建接口域名。
• 🎚️ 默认主题、播放模式等偏好可在 state 初始化逻辑中按需调整。

• 若希望为站点加密访问，可在 Cloudflare Pages 站点设置中启用 访问策略，随后点击“管理”跳转至 Cloudflare Zero Trust。
• 在 Zero Trust 控制台中新建策略，设置登录验证并限制仅允许特定邮箱访问。
• 详细步骤可参考指南：https://blog.galois21.com/archives/2360 。
• 配置了策略一定要在Zero Trust-应用程序里确认是否绑定 不绑定不生效

1. 输入关键词并选择想要的曲库后发起搜索。
2. 在结果列表中可试听、播放、下载或加入播放队列。
3. 右侧播放列表展示当前队列，可拖动播放、移除或一键清空。
4. 底部控制栏提供播放控制、播放模式切换、进度条与音量滑块。
5. 打开歌词面板即可查看实时滚动的高亮歌词。

• 将网页添加到手机主屏或通过移动浏览器访问，即可自动切换至竖屏布局；
• 底栏控件重新排布，保证竖向滑动不遮挡核心信息；
• 点击封面可以切换到歌词面板，可通过点击展开/收起。

• 搜索没有结果怎么办？ 检查浏览器控制台日志，如接口被阻挡可尝试切换数据源或更新 API.baseUrl 至可用服务，很有可能是免费API炸了。
• 如何重置本地数据？ 在浏览器开发者工具的 Application / Storage 面板清理 localStorage，即可恢复默认播放列表和配置。

Music-Player/
├── functions/   # Cloudflare Pages Functions 后端代理
├── index.html   # 主界面、样式与业务逻辑
└── README.md    # 项目说明

本项目采用 CC BY-NC-SA 协议，禁止任何商业化行为，任何衍生项目必须保留本项目地址并以相同协议开源。