OnionOS 定制系统从零到一安装教程Miyoo Mini 掌机升级上手指南【免费下载链接】OnionOS overhaul for Miyoo Mini and Mini项目地址: https://gitcode.com/gh_mirrors/on/Onion刚把 Miyoo Mini 从包装盒里拿出来那天我对着原厂界面发了好一会儿呆功能说不上有错可总感觉这台小掌机藏着没被挖出来的潜力。直到朋友丢过来一句试试 OnionOS 定制系统我才意识到原来给这台机器换一套系统就能从能玩直接跳到很好玩——内置 100 多个模拟器、自动存档断点续玩、主题和工具随手换。这篇 Miyoo Mini 定制系统安装教程就是照着我亲手踩过的坑写的你顺着走一遍就能把系统装好、让游戏跑起来。换系统前后一次升级两种完全不同的体验原厂固件更像开箱即用的样板间能住但处处留白。OnionOS 是把整个操作体验重做了一遍的定制系统官方默认与它之间的差距用一张表就能看明白对比项原厂默认系统OnionOS 定制系统模拟器阵容数量有限100 内置模拟器FC、GB、GBA、PS1 等主流平台全覆盖存档方式手动折腾自动保存 断点续玩关机前不用惦记进度界面主题固定一套主题可随意更换社区资源丰富系统工具几乎没有电池监控、活动追踪、包管理器等一应俱全更新维护等厂商跟随社区版本持续迭代说白了官方默认系统是够用OnionOS 是好用。换一次系统相当于给掌机换了个更聪明的大脑。开机画面的变化是最直观的换代证据——装上 OnionOS 之后点亮屏幕看到的将不再是原厂那张一成不变的图出发前先对照这张检查单三分钟省掉一小时装系统本身不复杂但前提条件少一条后面就可能多踩一个坑。动手之前先逐项打钩一台 Miyoo Mini 或 Miyoo Mini本教程以这两款型号为准一张靠谱的 SD 卡强烈建议换掉原装卡改用 SanDisk、三星等品牌的 32GB 或 64GB 高速卡。原装卡速度慢轻则游戏卡顿重则存档丢失读卡器和电脑Windows / macOS / Linux 都可以固件不要太旧进入设备设置 设备信息 版本查看OnionOS 需要较新的原厂固件支撑OnionOS 安装包从发布页下载Onion-v4.x.x.zip或用命令拉取仓库源码git clone https://gitcode.com/gh_mirrors/on/Onion这份清单里最容易让人栽跟头的是第二项。如果手里只有原装卡建议先买张新卡再开工这笔投入绝对值得。闯关式安装三关走完OnionOS 就装好了我把整个安装过程拆成三个关卡每关开头写了通关目标结尾给了验证方法做完就知道自己有没有走错。第一关给 SD 卡搬家把安装文件放进去通关目标得到一张装满 OnionOS 安装文件、随时能插进掌机的 SD 卡。第一步把 SD 卡格式化成 FAT32注意不是 exFATWindows用 Rufus 工具引导类型选非引导分区方案选 MBR文件系统选大容量 FAT32簇大小设 32KB点开始macOS打开磁盘工具选中 SD 卡点抹掉格式选 MS-DOS (FAT)方案选主引导记录Linux用 GNOME 磁盘工具格式化或命令行mkfs.vfat文件系统选 FAT第二步解压安装包把 7 个文件夹整体复制到 SD 卡根目录.tmp_update/ BIOS/ Media/ miyoo/ miyoo354/ RetroArch/ Themes/其中.tmp_update是隐藏文件夹复制前记得打开显示隐藏文件Windows 在资源管理器查看里勾选隐藏的项目macOS 按 CommandShift.Linux 用ls -a确认。拷贝完毕插卡开机后系统会先用一个引导页跟你打个招呼验证方法在电脑上点开 SD 卡能看到上面 7 个文件夹包括隐藏的.tmp_update第一关就通过了。第二关第一次点亮屏幕让系统自己装自己通关目标一台跑着 OnionOS 定制系统、能正常开关机的掌机。把 SD 卡插进掌机长按电源键开机系统自动开始安装全程不用你动手装完会弹出 Quick Guide快速指南相当于系统自带的说明书接着进入 Package Manager包管理器勾选想启用的系统和应用按 START 两次确认全部完成后按 A 键机器会关机或重启安装引导里有一页专门讲游戏列表的用法装完后你马上就会用到它验证方法重启后能看到全新的主界面不再是原厂那套菜单在游戏标签页按 SELECT 能弹出刷新选项就说明系统已经成功接管掌机。第三关把游戏请进门让列表出现你的收藏通关目标一台真正能玩游戏的完整掌机。把游戏 ROM 按平台放进Roms目录下对应的子文件夹常见的有 FC、SFC、GB、GBA、PS 等部分模拟器需要 BIOS 文件统一放进BIOS文件夹原装卡的RetroArch/.retroarch/system目录里能翻出不少回到主界面游戏标签页按 SELECT 选择刷新所有游戏等扫描完成验证方法刷新后游戏列表里能看到你放进去的游戏随便挑一个按 A 启动能正常进入游戏画面这一关就通关了。如果某个游戏进不去九成是缺 BIOS回到第 2 步补上即可。装完只是开始这些加分项值得挨个开一遍系统能跑了接下来才是最好玩的部分。所有锦上添花的功能都集中在这一章按兴趣挑着用就行。主题切换器让界面长成你喜欢的样子在应用里打开主题切换器Theme Switcher浏览可选主题、选中后一键应用界面立刻变样。换主题是入门门槛最低、视觉反馈最直接的一项强烈建议第一个试。包管理器装应用、换模拟器核心包管理器Package Manager相当于 OnionOS 的应用商店。第一次安装时你见到的就是它之后随时能回来加装应用、切换模拟器核心、更新组件都在这里完成。电池监控心里有数续航不慌电池监控工具会把当前电量、本次会话时长、剩余时间估算画成图表。长途通勤想玩多久、出门要不要带充电宝看一眼就有数。游戏活动追踪看看时间都花在哪个游戏上了活动追踪会记录每个游戏的游玩时长和最近记录。想知道自己到底在哪个游戏上投入最多打开它一目了然还能反过来帮你规划碎片时间。充电动画连充电都变得赏心悦目插上电源充电时屏幕会显示一个发光的电池图标随着电量上涨逐格点亮。等待充电不再是干瞪眼反而成了观察系统细节的小乐趣。新手最容易踩的五个坑症状、原因、解法一次说清坑 1装到一半卡住不动症状开机后长时间停在同一个画面原因多半是 SD 卡没格式化干净或者 7 个文件夹没拷全解法重新格式化为 FAT32确认全部文件夹含隐藏的.tmp_update都在根目录再插回去重来坑 2找不到.tmp_update文件夹症状拷贝时看不到它怀疑自己漏拷了原因它是隐藏文件夹文件管理器默认不显示解法Windows 勾选隐藏的项目macOS 按 CommandShift.Linux 用ls -a查看坑 3某个游戏进不去症状按 A 启动后黑屏或退回菜单原因缺对应模拟器的 BIOS 文件或 ROM 格式不被支持解法先补 BIOS 到BIOS文件夹再确认 ROM 是模拟器支持的格式坑 4游戏列表里空空如也症状刷新之后还是看不到游戏原因ROM 没放进对应的平台子文件夹或文件夹命名不对解法对照平台文件夹快速参考表确认路径放对位置后重新刷新坑 5电池显示不准症状电量百分比与实际使用时间对不上原因统计被校准前的旧数据干扰解法在设置里重置电池统计再用几次完整充放电循环让数据回归正常最后有一条铁律必须单独拎出来千万别手痒删除.tmp_update文件夹。名字像临时文件其实是系统核心删了系统直接罢工。装好了接下来往哪走走到这里你的 Miyoo Mini 已经装上 OnionOS 定制系统能玩、能换主题、有工具可用。回头看这一路格式化一张卡、拷一遍文件、开一次机、放进游戏四步而已。接下来可以继续探索的方向整理游戏库按平台分好 ROM配合列表刷新找游戏会越来越顺手收藏喜欢的主题在主题切换器里多试几套界面风格随心情切换吃透存档机制熟悉自动保存与断点续玩开荒多难的游戏都不怕掉进度跟进系统更新跟着版本升级新功能和修复会陆续到来想深入研究的可以参考这些项目资料功能总览文档website/docs/01-features/index.md全新安装官方步骤website/docs/02-installation/01-fresh-install.mdx旧版本升级指南website/docs/02-installation/02-upgrading.mdx主题切换器源码src/themeSwitcher/电池监控工具源码src/batteryMonitorUI/游戏活动追踪源码src/playActivityUI/现在把卡插回掌机挑一款游戏好好享受这套定制系统带来的复古游戏体验吧。【免费下载链接】OnionOS overhaul for Miyoo Mini and Mini项目地址: https://gitcode.com/gh_mirrors/on/Onion创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
