Onion 4.1 系统部署指南：从环境准备到功能优化

核心价值速览

• 全流程兼容性管理：针对Miyoo Mini/Mini+设备提供精准固件匹配方案，避免因版本不兼容导致的设备故障
• 模块化安装架构：采用分层部署策略，将系统核心、应用套件与用户数据分离，简化升级维护流程
• 性能与体验双提升：通过核心优化与新功能集成，实现游戏加载速度提升30%，新增61款移植游戏支持

1 环境验证：确认系统兼容性

1.1 设备固件要求

目标：确保设备固件版本满足Onion 4.1最低运行条件

方法：

1. 进入设备设置界面，导航至"关于设备"菜单
2. 记录固件版本号，对照兼容性矩阵验证

设备兼容性矩阵：

设备型号	最低固件版本	推荐固件版本	不兼容版本
Miyoo Mini	202204190828	202306111426	202112110956、202201082152
Miyoo Mini+	202305052130	202306282128	202302181113及更早

成功验证指标：设备固件版本号高于矩阵中"最低固件版本"要求

⚠️ 风险提示：安装前未确认固件兼容性可能导致设备无法启动或功能异常

1.2 硬件环境准备

目标：配置符合性能要求的存储介质

方法：

1. 准备32GB及以上容量SD卡（推荐SanDisk或三星品牌）
2. 使用读卡器连接至电脑，验证SD卡读写性能

SD卡性能分级：

• 基础要求：读取速度≥10MB/s，写入速度≥5MB/s
• 推荐配置：读取速度≥20MB/s，写入速度≥10MB/s
• 最佳实践：UHS-I Class 10级别以上存储卡

替代方案：若暂无高速SD卡，可使用现有SD卡但需关闭后台资源扫描功能

📌 要点总结：

• 避免使用设备原厂附赠SD卡，通常性能不足
• 确保SD卡无物理损坏，使用前进行错误扫描
• 容量建议64GB，平衡存储空间与文件系统性能

2 核心部署：系统安装与配置

2.1 存储介质准备

目标：创建符合Onion系统要求的文件系统环境

方法：

1. 在Windows系统中使用Rufus工具格式化SD卡
   • 分区方案：MBR
   • 文件系统：Large FAT32
   • 簇大小：32KB
2. 执行格式化命令，确认返回"成功完成"提示

替代方案：

• Mac系统：使用磁盘工具，格式选择"MS-DOS (FAT)"
• Linux系统：执行sudo mkfs.fat -F 32 /dev/sdb1（需替换正确设备路径）
• Chrome OS：通过内置文件管理器格式化功能

成功验证指标：格式化完成后，SD卡可用空间应与标称容量基本一致

2.2 系统文件部署

目标：正确复制Onion 4.1系统文件至SD卡

方法：

1. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/on/Onion
2. 进入项目目录：cd Onion
3. 将以下核心目录复制到SD卡根目录：
   • .tmp_update/
   • BIOS/
   • Media/
   • miyoo/
   • miyoo354/
   • RetroArch/
   • Themes/

图1：Onion OS启动界面，显示系统加载状态

成功验证指标：SD卡根目录下存在上述7个文件夹，且文件结构完整

⚠️ 风险提示：.tmp_update文件夹虽名称包含"tmp"，但为系统核心组件，必须保留

2.3 安装程序执行

目标：完成系统自动部署流程

方法：

1. 安全弹出SD卡并插入Miyoo设备
2. 开机启动，系统将自动进入安装流程
3. 等待进度完成，设备将自动重启

图2：Onion安装向导初始界面，展示版本更新说明

成功验证指标：设备重启后进入包管理器界面，无错误提示

3 功能配置：系统优化与个性化

3.1 基础设置配置

目标：完成系统初始设置

方法：

1. 在包管理器中选择必要系统组件
2. 配置语言、时区等基础参数
3. 执行系统更新检查

图3：包管理器加载界面，显示系统组件安装进度

成功验证指标：系统设置保存成功，无功能异常

3.2 存储结构优化

目标：建立合理的文件组织架构

方法：

1. 在SD卡根目录创建以下文件夹结构：

   ├── BIOS/           # 存放各模拟器BIOS文件
   ├── Roms/           # 游戏ROM文件主目录
   │   ├── ARCADE/     # 街机游戏
   │   ├── GBA/        # GBA游戏
   │   └── PS/         # PlayStation游戏
   └── Saves/          # 游戏存档文件
   

2. 按系统类型分类存放ROM文件

技术原理：SD卡分区就像给抽屉做隔断，不同区域存放不同类型文件，既方便管理又能提高系统文件检索效率

成功验证指标：游戏列表能正确识别并显示所有ROM文件

3.3 电源管理配置

目标：优化电池使用效率

方法：

1. 进入系统设置 → 电源管理
2. 配置自动休眠时间为5分钟
3. 启用电量显示精确模式

图4：电池充电状态界面，显示当前电量和充电进度

成功验证指标：电池状态显示准确，待机时间延长20%

4 故障排除：常见问题解决

4.1 启动故障处理

症状：设备开机后停留在logo界面

可能原因：

• 文件系统错误
• 系统文件损坏
• 固件版本不兼容

解决方案：

1. 重新格式化SD卡并重新部署系统文件
2. 确认固件版本符合要求
3. 检查SD卡是否损坏（可使用fsck命令）

4.2 游戏加载问题

症状：游戏列表不显示或加载失败

可能原因：

• ROM文件路径不正确
• 文件格式不受支持
• 缺少必要BIOS文件

解决方案：

1. 确认ROM文件存放于正确的系统子目录
2. 验证文件格式是否为支持的类型（.zip, .7z, .gba等）
3. 检查BIOS文件夹是否包含对应模拟器的必要文件

5 进阶探索：高级功能应用

5.1 主题系统定制

目标：个性化系统界面外观

方法：

1. 进入设置 → 主题设置
2. 选择内置主题或安装自定义主题
3. 调整图标样式和系统配色

图5：主题切换功能界面，支持自定义系统外观

5.2 性能优化调整

目标：提升游戏运行流畅度

方法：

1. 进入RetroArch设置 → 视频
2. 调整渲染分辨率和帧率
3. 启用硬件加速（如适用）

5.3 开发模式探索

目标：了解系统扩展可能性

方法：

1. 启用开发者选项
2. 探索系统API文档
3. 尝试安装社区开发的应用插件

📌 要点总结：

• Onion系统支持主题定制和功能扩展
• 高级用户可通过开发模式实现个性化功能
• 定期访问社区获取最新插件和系统更新

通过本指南，您已完成Onion 4.1系统的完整部署与优化。系统不仅提供了丰富的游戏体验，还支持深度个性化定制。随着使用深入，建议探索社区资源获取更多高级技巧和功能扩展，持续优化您的游戏体验。