INSTALLATION / 01—05

按步骤来
别跳过启动器要求

补丁必须通过支持 fsoverlay= 的 Hekate 版本加载。先备份 SD 卡,再开始安装。

开始安装 ↓
适用:已列出固件版本
启动器:Hekate FS Overlay fork
!
先备份,再动 SD 卡。

固件补丁存在启动失败或数据损坏风险。请确认使用匹配版本的 KIP,并保留原有启动项作为回退入口。

回退方法 ↓

THE SETUP

安装步骤

01

确认固件版本与启动方式

先确认主机当前 HOS 版本,并使用支持 FS Overlay 的 Hekate FS Overlay fork。这是基于 CTCaer/hekate 上游的非官方修改版;普通 Hekate 不支持本补丁的加载方式。

Daybreak 安装系统时请选择“FAT32 + exFAT”系统变体。此条件下,SD 卡本身使用 FAT32 或 exFAT 格式都支持;真实系统(SysNAND)和虚拟系统(emuMMC)均可使用。各固件版本的实机验证状态见右侧表格。

不确定自己的环境?先查看项目发布说明中的兼容状态。

02

下载匹配的发布文件

从发布页下载 fs_codecvt_dual_unpacked.kip 和配套的 Hekate fork 文件。使用同一版本说明中提供的文件,不要混用旧版 KIP。

↓ 打开 nx-fs-utf8 v3.3.0 发布页 ↗
03

将发布包复制到 SD 卡根目录

按发布包目录结构复制文件。确认以下文件存在;即使只启动真实系统,也必须保留 emummc.kipm。

✓bootloader/update.binHekate 启动器
✓bootloader/fsoverlays/fs_codecvt_dual_unpacked.kipUTF-8 补丁
✓bootloader/sys/emummc.kipm必须保留
✓atmosphere/reboot_payload.bin重启载荷

补丁不要用 kip1 选项加载,请使用 fsoverlay 选项。也不要设置 kip1patch=emummc。

04

在 Hekate 配置中添加启动项

编辑 SD 卡上的 bootloader/hekate_ipl.ini。根据要启动的系统选择配置,保留其他现有启动项。

虚拟系统(emuMMC)
[虚拟系统-中文路径]
pkg3=atmosphere/package3
emummcforce=1
fsoverlay=bootloader/fsoverlays/fs_codecvt_dual_unpacked.kip
真实系统(SysNAND)
[真实系统-中文路径]
pkg3=atmosphere/package3
emummc_force_disable=1
fsoverlay=bootloader/fsoverlays/fs_codecvt_dual_unpacked.kip

两种启动项都使用同一个 KIP。不要额外添加 kip1patch=emummc。

05

启动后检查中文路径

从 Homebrew Menu 运行项目提供的测试程序。三项全部成功才表示路径与目录显示均正常:

  • 01创建中文目录与文件
  • 02通过中文路径查询、读写
  • 03列出中文目录和文件名

仅能创建或读写,不代表目录枚举也已通过。

i

本项目面向自制软件与开发者场景。项目不分发固件文件或密钥。安装前请备份重要数据,并仅在自己拥有或有权使用的设备上操作。

原始安装说明 ↗