MusicFreeTV

已经拿到仓库的核心信息。下面为你整理一份完整分析。

MusicFreeTV 项目分析

GitHub：https://github.com/Lostonelzq/MusicFreeTV 定位：面向 Android TV、电视盒子、遥控器的插件化音乐播放器 一、项目本质

MusicFreeTV 是 maotoumao/MusicFree（原 Android 版）的独立派生项目，并非原作者发布的官方 TV 版本。它在保留原版全部能力的基础上，为「10-foot UI + D-pad 遥控器操作」重做了整套界面。

核心逻辑：把手机上"触屏点按"的音乐 App，改造成电视上"方向键 + 确认键"可完整操控的版本。

二、功能特性

继承原 Android 版能力：

- 插件系统、搜索、推荐歌单、榜单、收藏 - 本地音乐、歌词、下载、历史记录、备份、播放控制

TV 化改造重点：

模块 设计要点 全局 D-pad 焦点 方向键移动、确认键执行、返回键回退；焦点有可见描边 + 缩放反馈 TV 首页 固定功能侧栏 + 正在播放卡片 + 四列歌单区，适配 16:9 横屏 遥控媒体键 播放/暂停、上/下一首、菜单键可直接控制播放队列

三、技术架构

- 框架：React Native（基于原 MusicFree Android 版） - 只提供 Android TV 目标，不支持其他平台 - 插件协议：与原 Android 版完全兼容，插件是可执行的 CommonJS 模块，可实现搜索、播放地址、歌词、歌手、专辑、推荐歌单、榜单、歌单导入等接口

环境要求：

- Node.js 18+ - JDK 17 - Android SDK（API 35） - Android NDK

构建方式：

npm install npm run start # 开发 npm run android # 运行到设备

# Release 构建：先在 android/keystore.properties 配置签名 npm run build-tv

四、许可证与合规（重要）

- 许可证：GNU Affero General Public License v3.0（AGPL-3.0） - 使用/修改/分发/通过网络提供修改版时，必须履行 AGPL 的源代码提供义务 - 须保留原作者 猫头猫（maotoumao）、原项目地址、原许可证及本项目的 NOTICE - 遵循原作者附加说明：保持免费、合法合规、不用于商业用途，不以"VIP/破解"为噱头宣传

⚠️ 几个关键风险提示（README 明确声明）：

1. 应用不提供、破解或绕过任何付费音源——音源完全依赖第三方插件 2. 插件可能联网并执行代码，只应安装信任且有权使用的插件；插件及其数据由提供者和使用者自负责任 3. 无账号系统、无 UGC 社区、不收集个人信息；设置/歌单/历史默认本地存储 4. 第三方插件的网络请求、认证、数据处理不属于 MusicFreeTV，安装前需自行审查源码与权限

五、一句话总结

MusicFreeTV = MusicFree Android 版的 TV 遥控器适配分支：技术栈沿用 React Native + CommonJS 插件协议，核心价值是把插件化音乐体验搬上大屏；但音源、插件安全、版权合规均需用户自行把控，且分发受 AGPL-3.0 强约束。

需要我进一步帮你做哪一步？比如：

- 📱 本地编译打包 APK 的详细步骤 - 🔌 插件开发入门（如何写一个 CommonJS 插件） - ⚖️ AGPL-3.0 合规清单（修改后分发要注意什么） - 🆚 与原版 MusicFree / 其他 TV 音乐 App 的对比 一个插件化的音乐播放器 https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json https://gitee.com/maotoumao/plugins-list1/raw/master/qq.js https://gitee.com/kevinr/tvbox/raw/master/musicfree/plugins/ghyinyue.js https://mf.ikunshare.com/plugins.json https://gitee.com/kevinr/tvbox/raw/master/musicfree/plugins/5sing.js https://gitee.com/kevinr/tvbox/raw/master/musicfree/plugins/gequbao.js https://gitee.com/kevinr/tvbox/raw/master/musicfree/plugins/htqyy.js https://gitee.com/kevinr/tvbox/raw/master/musicfree/plugins/at.js https://gitee.com/kevinr/tvbox/raw/master/musicfree/plugins/zz.js https://gitee.com/kevinr/tvbox/raw/master/musicfree/plugins/anting.js