OnionUI/Onion 项目常见问题解答（FAQ）技术指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00816/article/details/148552623

OnionUI/Onion 项目常见问题解答（FAQ）技术指南

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

游戏管理篇

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

在Onion系统中，游戏封面图和截图需要满足以下要求：

文件格式：PNG
最大尺寸：250×360像素
存放路径：Roms/<游戏系统>/Imgs（注意Imgs必须大写）

推荐使用Skraper工具自动抓取封面图：

选择"Recalbox"模式
勾选"包含非标准Rom文件夹"
在"media"标签页设置：
- 调整宽度为250像素
- 保持图片比例
设置输出路径为%ROMROOTFOLDER%\Imgs
选择系统后点击运行按钮

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

Onion系统使用miyoogamelist.xml文件来管理游戏显示信息：

创建标准的gamelist.xml文件
使用xmlstarlet工具进行格式转换
将转换后的文件重命名为miyoogamelist.xml
放入对应的Rom文件夹

注意：修改后需要通过SELECT键调出菜单选择"刷新所有Rom"使更改生效。

多碟游戏的最佳管理方案

对于PS1等多碟游戏，推荐以下管理方式：

为每个多碟游戏创建单独文件夹（如Roms/PSX/游戏名）
将所有碟片的cue/bin文件放入该文件夹
在Rom主目录创建.m3u播放列表文件
在.m3u文件中指定各碟片的相对路径

示例.m3u内容：

../../Roms/PSX/Driver 2/Driver 2 (Disc 1).cue
../../Roms/PSX/Driver 2/Driver 2 (Disc 2).cue

系统设置篇

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

系统名称和排序通过以下方式控制：

编辑Emu/[系统名]/config.json文件
修改"label"字段值
保存文件

排序技巧：

系统默认按字母顺序排列
可在名称两侧添加空格控制排序位置（空格越多越靠前）

如何添加游戏金手指？

添加RetroArch金手指的步骤：

获取.cht格式的金手指文件
将文件放入RetroArch/.retroarch/cheats对应系统目录
修改retroarch.cfg文件：
```
quick_menu_show_cheats = "true"
```
游戏中通过MENU+SELECT进入RetroArch菜单
选择"Cheats"加载金手指文件

故障排除篇

游戏无法启动的常见原因

新添加游戏后未刷新Rom缓存
Rom扩展名不受支持
BIOS文件命名不正确
存档状态不兼容
Rom文件本身质量问题

解决方法：

通过SELECT键刷新Rom
检查Rom和BIOS文件命名
删除对应系统的存档状态文件夹
尝试其他来源的Rom文件

黑屏循环问题处理

如果系统陷入黑屏启动循环：

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

电池电量显示异常

这是正常现象，因为：

Onion通过电压计算电量百分比
不同游戏负载会导致百分比波动
充满电时顶部LED会变蓝

省电建议：

降低屏幕亮度
使用5V 1A充电器
避免使用USB-C to USB-C充电线

存档管理篇

如何导入游戏存档？

确保存档文件为.srm格式（或重命名.sav为.srm）
将存档文件放入： Saves/CurrentProfile/saves/[核心名]
删除对应游戏的存档状态（如有）

存档状态管理

存档状态存放位置： Saves/CurrentProfile/states/[核心名]

禁用自动加载存档状态：

游戏中进入RetroArch菜单
设置 › 保存 › 关闭"自动加载状态"
保存核心或游戏覆盖

高级调试

启用RetroArch日志

进入RetroArch › 设置 › 日志
启用"记录到文件"
保存当前配置
日志将输出到.tmp_update/logs/retroarch.log

修复收藏夹问题

收藏夹损坏时：

进入应用 › 调整 › 工具
选择"修复收藏夹缩略图和重复项"

恢复游戏时间记录

游戏时间记录备份位于： /Saves/CurrentProfile/saves/PlayActivityBackup/

恢复步骤：

找到最新的有效备份文件
重命名为playActivity.db
复制到/Saves/CurrentProfile/saves/

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考