这个项目有什么用
Lichii 是一个用 C++ 编写的实验性开源 Nintendo Switch 与 Switch 2 模拟器,基于 Eglantine、Eden、yuzu 和 Sudachi 的代码继续开发,重点在游戏兼容性与渲染修复。它面向想在 PC 上运行 Switch 游戏、并愿意参与兼容性反馈的开发者与玩家。
它解决什么问题
- 为上游项目(Eglantine、Eden、yuzu、Sudachi)的代码提供一个持续维护的分支,保留原有贡献并叠加本分支的渲染与兼容性改动。
- 通过社区兼容性网站汇总不同玩家在各自构建与硬件配置下的运行结果,减少逐个游戏盲试的成本。
- 提供桌面端兼容性报告提交流程,让玩家把实际运行情况回传给项目。
典型使用场景
- 在 Windows 上解压构建包后直接运行
lichii.exe测试游戏。 - 在兼容性网站上查找某款游戏的社区报告,对比他人的构建与配置。
- 遇到问题时按项目要求整理构建号、游戏版本、CPU/GPU/驱动版本等信息提交 issue。
适合愿意折腾实验性构建、能自行排查渲染错误与崩溃的开发者或进阶玩家;不适合期待开箱即用稳定体验的普通用户。
核心特性
- 基于多个上游项目的分支开发:代码继承 Eglantine、Eden、yuzu 与 Sudachi,并保留原有版权声明与第三方许可证。
- 兼容性数据公开可查:配套网站提供游戏条目与社区兼容性报告,可按玩家的构建与配置对比结果。
- 桌面端报告提交:在包含 PR #303 的构建中,运行并停止一款 Switch 2 游戏后,右键该游戏选择 Submit compatibility report 即可提交;仅当前 Lichii 进程中的最近一次会话可提交。
- 提交前需显式确认:报告会预填机器、游戏、配置与已启用附加组件信息,需核对网站目录条目、查看公开预览并明确同意后才会上传,不会自动上传;原生 v1 报告器不读取也不上传日志或文件。
- 沿用旧数据目录:改名后仍保留 Eden/Eglantine 的数据目录与配置键,不会移动或删除存档、设置与着色器缓存。
- 自带品牌资源:logo、图标与库美术资源位于
dist/branding,Windows、Linux、macOS 的图标资源由Generate-LichiiIcons.ps1生成。
怎么安装
README 未提供从源码编译的安装章节,只说明了获取构建包的方式。前提是你需要自行准备合法获得的游戏与系统文件——游戏、密钥与固件均不随项目提供。
- 只从本仓库的 releases 页面下载 Lichii,不要使用其他下载站:https://github.com/zortos293/Lichii/releases。README 明确说明
lichii.org等渠道提供的压缩包并非本项目构建,且已有报告称其中一个会安装恶意软件(#545)。 - 在 Windows 上解压整个构建压缩包。
- 运行
lichii.exe启动模拟器。 - 测试实验性构建前,先备份你的存档。
Lichii 没有官方网站。README 顶部特别提示了这一点。
怎么使用
最基础的用法就是解压后运行主程序:
lichii.exe
启动后使用你合法获得的游戏与系统文件进行测试。兼容性与性能会因游戏、硬件和驱动不同而变化,渲染错误、卡顿与崩溃仍可能出现。
进阶用法一:提交兼容性报告
- 确认所用构建包含 PR #303(build 88 不包含该功能)。
- 运行一款 Switch 2 游戏,然后停止它。
- 右键该游戏,选择 Submit compatibility report。
- 确认匹配的网站目录条目,核对预填的机器、游戏、配置与已启用附加组件信息,查看公开预览后明确同意提交。
进阶用法二:提交 issue 时附上必要信息
README 要求在报告问题时包含:确切的构建版本、游戏版本、CPU、GPU 与驱动版本;相关设置与复现步骤;受影响会话的截图与日志(上传前先检查是否含个人信息)。不要上传游戏文件、密钥、固件或私人账号信息。
适用场景与注意事项
适合的情况
- 你希望跟进一个活跃分支的渲染与兼容性修复,并愿意接受实验性构建的不稳定。
- 你愿意把运行结果通过桌面端报告器或 issue 反馈给项目。
不适合的情况
- 你需要稳定、可预期的游戏体验。README 明确说明通过自动化测试并不代表游戏能正确渲染,项目也不对帧率作任何通用保证。
- 你无法自行准备合法获得的游戏、密钥与固件。
其他注意点
- 下载渠道:仅使用本仓库 releases 页面,第三方站点存在恶意软件风险。
- 数据兼容:改名后沿用 Eden/Eglantine 的数据目录与配置键,存档与设置不会被迁移或删除,但实验性构建仍建议先备份。
- 报告器限制:仅当前进程的最近一次会话可提交;原生 v1 报告器不读取或上传日志与文件。
- 许可证:GPL-3.0,具体条款见仓库中的
LICENSE.txt与各源文件。 - 非官方关系:Lichii 是独立分支,并非上述上游项目的官方发行版,也与 Nintendo 无关联。
- 捐赠:README 提供了 Solana、Ethereum、Bitcoin、BNB Smart Chain、Polygon 的加密捐赠地址,并提醒必须使用对应网络转账,发错网络的币无法找回。
项目地址
- 仓库地址:https://github.com/zortos293/Lichii
- 作者/组织:zortos293
- 兼容性网站:https://lichii.zortos.me
- 许可证:GPL-3.0
Lichii 是一个明确标注为「非常实验性」的 Switch / Switch 2 模拟器分支,价值主要在于延续上游代码并公开收集社区兼容性数据;是否适合使用,取决于你对不稳定构建的容忍度以及自行准备合法游戏文件的能力。
















cqlbgzs@163.com
1年前0
d好