从零开始：4步打造专属Onion系统

Onion系统是为Miyoo Mini和Mini+设备打造的操作系统增强方案，通过简单几步就能让你的掌上游戏机获得更强大的功能和更流畅的体验。本文将带你完成从环境准备到系统优化的全过程，即使是新手也能轻松掌握。

准备工作清单

在开始安装前，请确保准备好以下物品：

项目	要求	备注
SD卡	32GB以上，品牌推荐SanDisk或三星	原厂SD卡性能较差，不建议使用
读卡器	支持SD卡读写	确保连接稳定
电脑	Windows/Mac/Linux/Chrome OS	任一操作系统均可
备份文件	ROMs、Saves、BIOS文件夹	重要数据务必备份

兼容性检测指南

检查固件版本

1. 进入 设置 → 设备信息 → 版本
2. 或如果已安装Onion：设置 → 关于设备 → 固件版本

固件版本要求

Miyoo Mini	兼容性	Miyoo Mini+	兼容性
202112110956	不兼容	202302181113及更早	不兼容
202201082152	不兼容	202305052130	最低要求
202204190828	兼容(Onion v3.10+)	202306092122	推荐版本
202212160314	需社区补丁	202306282128	最新推荐
202301041337	社区修补版
202306111426	推荐版本
202310271401	MM v4专用

系统安装实施步骤

第一步：SD卡格式化

重要：必须格式化为FAT32文件系统，不能使用exFAT！

1. Windows系统：使用Rufus工具

   • 选择SD卡设备
   • 分区方案：MBR
   • 文件系统：Large FAT32
   • 簇大小：32KB
   • 点击START开始格式化

2. Mac系统：使用磁盘工具

   • 选择SD卡驱动器
   • 点击"抹掉"
   • 格式：MS-DOS (FAT)
   • 方案：主引导记录
   • 点击"抹掉"等待完成

3. Linux系统：使用终端命令

   sudo fdisk -l  # 查看设备标识
   sudo umount /dev/sdb1
   sudo mkfs.fat -F 32 /dev/sdb1
   

第二步：获取Onion系统文件

1. 克隆项目仓库

   git clone https://gitcode.com/gh_mirrors/on/Onion
   

2. 进入项目目录

   cd Onion
   

图1：Onion系统安装欢迎界面

第三步：文件部署

1. 将以下7个文件夹复制到SD卡根目录

   • .tmp_update/
   • BIOS/
   • Media/
   • miyoo/
   • miyoo354/
   • RetroArch/
   • Themes/

2. 出现文件覆盖提示时，选择"是"或"替换"

第四步：系统安装

1. 将SD卡插入Miyoo设备并开机
2. 设备将自动启动安装程序
3. 按照屏幕提示完成初始设置
4. 安装完成后设备会自动重启

图2：Onion系统启动界面

系统配置与优化

BIOS文件配置

1. 将各模拟器所需BIOS文件复制到SD卡的BIOS/文件夹
2. 确保文件名和格式符合模拟器要求

ROM文件管理

1. 在SD卡根目录创建对应系统的文件夹（如GBA、NES等）
2. 将游戏文件放入相应文件夹
3. 支持的格式：.zip、.7z、.gb、.gba等

系统更新与维护

1. 定期检查系统更新
2. 备份重要数据
3. 清理临时文件

常见问题解决

无法启动系统

• 检查SD卡格式是否为FAT32
• 确认固件版本是否符合要求
• 重新复制系统文件

游戏不显示

1. 按SELECT键进入游戏列表选项
2. 选择"刷新所有游戏"
3. 等待重新索引完成

电池显示异常

图3：Onion系统电池状态指示

• 确保充电接口接触良好
• 检查电池电量是否充足
• 重启设备尝试修复

进阶使用建议

系统自定义

1. 更换主题：在设置中选择喜欢的主题
2. 自定义图标：替换Themes/文件夹中的图标文件
3. 调整系统设置：根据个人喜好配置显示、声音等选项

性能优化

1. 关闭不必要的动画效果
2. 调整CPU频率
3. 优化游戏设置

学习资源与社区支持

• 项目文档：website/docs/
• 社区讨论：通过项目issue系统提交问题
• 教程资源：website/blog/

通过以上步骤，你已经成功安装并配置了Onion系统。享受更强大的游戏体验吧！如有任何问题，欢迎参与社区讨论获取帮助。