MusicFree 技术文档

1. 安装指南

1.1 系统要求

• 支持 Android 和 Harmony OS 系统
• 建议 Android 5.0 及以上版本

1.2 下载方式

1. 访问项目发布页获取最新版本安装包
2. 通过官方渠道获取下载链接
3. 注意：请从官方渠道下载，确保软件安全

1.3 安装步骤

1. 下载完成后，点击安装包文件
2. 如系统提示"未知来源安装"，需在设置中允许安装未知来源应用
3. 按照屏幕提示完成安装
4. 安装完成后可立即启动应用

2. 项目使用说明

2.1 基本功能

• 音乐搜索与播放
• 歌单管理
• 歌词显示与关联
• 主题自定义

2.2 插件管理

1. 进入侧边栏"设置"-"插件设置"
2. 可选择"从网络安装插件"或"本地安装插件"
3. 网络安装推荐使用官方插件源
4. 安装完成后可在插件列表中启用/禁用插件

2.3 主题设置

1. 进入侧边栏"主题设置"
2. 可选择浅色/深色模式
3. 可自定义背景图片
4. 支持调整字体大小等显示参数

3. 项目API使用文档

3.1 插件开发接口

插件需实现以下核心功能接口：

搜索功能

• 搜索音乐
• 搜索专辑
• 搜索作者

播放功能

• 获取音乐播放链接
• 获取音乐详细信息

歌单功能

• 导入单曲
• 导入歌单
• 获取歌单详情

歌词功能

• 获取歌词
• 歌词关联管理

3.2 插件协议规范

1. 插件必须为CommonJS模块
2. 需导出特定接口对象
3. 输入输出需符合指定格式
4. 分页、缓存等由主程序处理

4. 项目安装方式

4.1 移动端安装

1. 下载APK安装包
2. 允许安装未知来源应用
3. 执行标准安装流程

4.2 桌面版安装

1. 访问MusicFreeDesktop项目
2. 根据操作系统下载对应版本
3. 执行标准安装程序

4.3 插件安装

1. 本地安装：

   • 下载插件文件(.js或.json)
   • 通过应用内"本地安装"功能导入

2. 网络安装：

   • 在插件设置中输入插件URL
   • 应用将自动下载并安装插件

注意：请仅从可信来源安装插件，确保使用安全。