OnionUI/Onion 项目常见问题解答：从游戏管理到故障排除

OnionUI/Onion 项目常见问题解答：从游戏管理到故障排除

Onion OS overhaul for Miyoo Mini and Mini+ 项目地址: https://gitcode.com/gh_mirrors/on/Onion

游戏组织与管理

如何为游戏添加封面图或截图？

Onion系统内置了封面抓取功能（仅限MMP机型）：

1. 在游戏列表中按Y键进入GLO菜单
2. 向下滚动找到"Scraper"选项

对于普通Mini机型或想在电脑上抓取封面的用户，建议：

• 确保游戏ROM命名规范
• 封面图片尺寸建议为400x300像素
• 图片格式支持JPG/PNG等常见格式

如何添加游戏说明书？

只需在ROM目录下创建Manuals文件夹，并放入与ROM同名的PDF文件即可。例如：

Roms/GB/
  Tetris.gb
  Manuals/
    Tetris.pdf

使用说明：

1. 在游戏列表中选中游戏并按Y键
2. 选择"Game manual"选项
3. 系统会自动调用Green PDF阅读器打开说明书

注意：如果PDF文件不存在或命名不规范，该选项将不会显示。

如何自定义游戏显示名称？

Onion支持使用miyoogamelist.xml文件来自定义游戏名称，创建方法：

1. 使用文本编辑器创建XML文件
2. 按照标准格式编写游戏信息
3. 将文件保存在ROM目录下

常见问题排查：

• 添加后需在游戏标签页按SELECT键刷新ROM
• 确保config.json中的extlist包含所有ROM扩展名
• 文件名区分大小写

新添加的游戏为何不显示？

解决方法：

1. 在游戏标签页按SELECT键选择"Refresh all roms"
2. 检查ROM是否放在正确的系统文件夹中
3. 确认ROM格式是否被支持
4. 文件夹名称需大写且符合规范

如何添加游戏金手指？

步骤指南：

1. 获取.cht格式的金手指文件
2. 将文件放入RetroArch/.retroarch/cheats目录
3. 修改retroarch.cfg启用金手指功能
4. 游戏中通过RetroArch菜单加载金手指

建议使用LibRetro数据库获取高质量金手指文件。

多碟游戏如何组织管理？

PSX等多碟游戏建议使用.m3u播放列表文件：

1. 通过Tweaks应用自动生成m3u文件
2. 支持多种命名格式(Disc/Disk等)
3. 可选择两种组织方式：
   • 每个游戏单独隐藏目录
   • 所有游戏共用隐藏目录

示例：

Roms/PS/
  Final Fantasy VII.m3u
  .multi-disc/
    Final Fantasy VII (Disc 1).chd
    Final Fantasy VII (Disc 2).chd

如何重命名或重新排序游戏系统？

修改方法：

1. 编辑Emu/[系统名]/config.json文件
2. 修改label字段
3. 使用空格调整排序位置（空格越多排序越前）

常见故障排除

游戏无法启动怎么办？

排查步骤：

1. 尝试刷新ROM缓存
2. 检查ROM和BIOS文件名是否正确
3. 删除可能不兼容的存档状态
4. 更换ROM来源测试

重要提示：

• 不建议使用原厂SD卡
• 文件名区分大小写

游戏运行速度异常？

解决方法：

1. 创建常规存档
2. 删除相关存档状态
3. 存档状态位于Saves/CurrentProfile/states/[核心名]

黑屏循环如何恢复？

应急方案：

1. 长按电源键10秒以上（直到第二次震动）
2. 如无效，删除.tmp_update/cmd_to_run.sh文件

收藏夹问题修复

已知问题：

• 重复游戏名可能导致收藏夹损坏

修复方法： 通过Tweaks应用中的修复工具： Apps › Tweaks › Tools › Favorites: Fix thumbnails and duplicates

游戏时长记录丢失？

恢复步骤：

1. 检查Saves/CurrentProfile/saves/目录
2. 从PlayActivityBackup恢复最新备份
3. 重命名备份文件为playActivity.db

电池百分比波动？

使用建议：

1. 充电指示灯说明：
   • MM v2：蓝色指示灯表示充满
   • MMP：红色指示灯熄灭表示充满
2. 波动属正常现象
3. 节电技巧：
   • 降低屏幕亮度
   • 使用耳机
   • 关闭Wi-Fi

应用声音异常？

解决方案：

1. 将应用的launch.sh重命名为launch2.sh
2. 替换为专用音频脚本

启用RetroArch日志

调试步骤：

1. RetroArch设置中启用日志记录
2. 保存当前配置
3. 日志将输出到.tmp_update/logs/retroarch.log

Wi-Fi连接问题

特殊字符解决方案：

1. 直接编辑wpa_supplicant.conf文件
2. 位于/appconfigs/wpa_supplicant.conf
3. 避免使用特殊字符

通过以上详细指南，用户可以更好地管理和优化他们的Onion系统体验，解决常见问题并充分发挥设备性能。

Onion OS overhaul for Miyoo Mini and Mini+ 项目地址: https://gitcode.com/gh_mirrors/on/Onion