nx2 · 最新 build 117 89440b2 发布于 2026年11月7日 12 个安装包 官方下载仅限 GitHub Releases

Lichii 设置:安装、密钥、固件与存档

开始之前的重要提示在尝试任何实验性构建版本前,请务必备份存档。Lichii 更新频繁,且 README 要求每位测试人员在测试前先留存一份备份。

Lichii Switch 2 模拟器的配置分为六步:从 GitHub 下载对应软件包、解压、导入个人密钥与固件、确认原有数据目录迁移正常,最后启动游戏。下载的文件不含任何游戏、密钥或固件,均需从你自有的主机和游戏中提取。下方的 The 清单会在当前浏览器中保存进度,重启电脑或更新驱动后可随时继续。

6配置步骤总览
4官方桌面客户端版本
2.39Linux 平台最低 glibc 要求
15Apple Silicon 平台最低 macOS 要求

配置核对清单

0 / 6 项步骤已完成

01

切记仅从 GitHub 官方源下载

打开 github.com/zortos293/Lichii 的 Releases 页面,挑选适用于你系统的 Build 117 软件包。Windows 使用 zip,Linux 使用 AppImage 或 tar.gz,Apple Silicon Mac 则使用 dmg 或 zip。推荐选用 The PGO 软件包。

Windows x86_64 · Linux x86_64 或 aarch64 · macOS arm64
原理解析与必要性类似 lichii.org 的第三方网站绝非官方项目。Issue #545 明确指出从该类网站下载的 zip 会暗中从 %TEMP% 目录拉起 node.exe 执行恶意代码。
挑选适配文件 →
02

解压或安装到本地

Windows 安装包均为绿色便携 zip:将其完整解压至普通文件夹后直接双击运行 lichii.exe,或在终端命令行调用 eden-cli.exe。在 Linux 上,使用 chmod +x 为 AppImage 赋予运行权限,或解压 tar.gz 后执行 ./lichii。在 Mac 苹果系统上,打开 dmg 镜像并将 lichii.app 拖拽放入 Applications 应用程序文件夹。

AppImage:需要 glibc 2.39+ · tar.gz:依赖系统 Qt 6 · macOS 15+,未经官方公证
原理解析与必要性若未先完整解压便直接在 zip 压缩包内强行双击 lichii.exe,会导致程序缺少关联动态链接库而启动失败。
03

导入自备的系统解密密钥

出于合规要求,Lichii 本身不附带任何解密密钥。若在缺少密钥的情况下启动,日志会明确报错“Decryption keys are missing: NCA, NSP and XCI games need them”。请从你拥有的 Switch 2 主机中提取这些密钥;本项目绝不提供密钥文件或任何下载渠道。

从自有正版硬件中提取的密钥文件
原理解析与必要性缺失密钥将导致游戏列表完全空白或游戏报错拒绝加载,这种现象常被误认为是模拟器程序崩溃。
启动排错指南 →
04

安装系统固件

若未安装固件,日志中将显示“Installed firmware: No firmware available”。请安装从自有主机提取的正版系统固件。众多游戏依赖其中的共享系统字体和系统核心组件才能正确运行,且代码仓库中的 Bug 反馈通常也会核验固件版本与游戏版本的匹配情况。

从自有正版主机提取的固件文件
原理解析与必要性缺少固件字体或系统归档组件会导致游戏内文本排版错乱、文字丢失或引发各种在完整运行环境下根本不会出现的异常崩溃。
已知问题说明 →
05

备份并继承现有数据目录

Lichii 能够直接继承并沿用现有的 Eden 与 Eglantine 数据目录及配置项,绝不会随意迁移或清理你原有的游戏存档、偏好设置和着色器缓存。在首次运行全新版本之前,请务必先将该数据目录手动复制到安全位置。点击顶部菜单“文件”>“打开 Lichii 文件夹”即可快速直达。

用于存放一份完整游戏存档备份的可用磁盘空间
原理解析与必要性实验性版本仍可能损坏存档。在模拟器目录外保留一份 A 备份是唯一可靠的回滚方式。
Repository 须知 →
06

首次启动与验证

启动 Lichii,添加游戏目录或使用“文件 > 加载文件”运行游戏。The 首次运行时需要编译着色器,因此前几分钟会出现卡顿。如果出现异常,日志位于 File > Open Lichii Folders > Log Folder > eden_log.txt。

合法提取的正版游戏 Dump 镜像
原理解析与必要性在提交 Bug 反馈时,随附完整的 eden_log.txt 日志文件以及具体的构建版本号,是开发者定位并解决问题的先决条件。
游戏兼容性列表 →

各系统平台特性差异

Windows

解压 zip 文件,运行 lichii.exe。The PGO zip 采用了针对 Ocarina of Time 训练优化的 ThinLTO 配置文件进行编译。在 Build 117 的全部下载量中,Windows 占了 122,388 次。

Linux

The AppImage 需要 glibc 2.39 或更高版本:Ubuntu 24.04、Fedora 40、Debian 13 或 Arch。较旧的发行版建议使用搭配系统 Qt 6 运行库的 tar.gz。软件包支持 x86_64 与 aarch64。

macOS

仅支持运行在 macOS 15 或更高版本上的 Apple Silicon。The 应用未经公证,因此 macOS 会在首次启动时进行拦截,需前往 System“系统设置”的“隐私与安全性”中放行。

各平台 Build 117 下载量柱状图
Build 117 各平台下载量。Android 无官方软件包。

更新至更新版本

01

使用更新器

从版本 75 开始,应用内置更新器会检查 GitHub 上的 Lichii 发布版本,并为系统匹配合适安装包(#82)。

02

或直接替换文件夹

下载新包并解压覆盖到全新文件夹中。存档保存在数据目录中,不在程序文件夹内。

03

再次备份存档

每次升级到新版本前请重新备份,特别是当更新说明中提到存档或文件系统改动时。

常见问题解答

Lichii 是否自带密钥、固件或游戏?

不包含。The README 明确指出软件包中不含游戏、密钥及固件,用户应仅使用合法获取的游戏和系统文件。缺少这些文件首次启动时,Lichii 会在日志中记录解密密钥缺失且未安装固件。

Lichii 的存档保存在哪里?

保存在现有的 Eden 与 Eglantine 数据目录中,Lichii 会沿用这些目录及其配置项。模拟器绝不会移动或删除存档、设置与着色器缓存。可通过“文件 > 打开 Lichii 文件夹”打开该路径,方便在测试新版本前复制备份。

每次更新版本都需要重新配置吗?

不需要。密钥、固件、设置与存档均存放在数据目录中,新版本会自动读取。从版本 75 开始,内置更新器还可自动从 GitHub 获取对应更新包。但每次更新前仍建议备份存档。

为什么我的 Mac 无法打开 Lichii?

The macOS 构建版未经公证,首次启动时会被 Gatekeeper 拦截。请前往 System“系统设置”的“隐私与安全性”中点击允许。此外该版本还需要运行在 macOS 15 或更新版本上的 Apple Silicon Mac;Intel Mac 暂无官方软件包。