fixed crash
启动游戏后 Ocarina of Time 构建着色器时在 amdvlk64.dll 中发生 Crash
解决方案 更新至版本 117：#583 的矩阵分支现仅在 RDNA3 及更新架构上运行
Lichii 黑屏与崩溃：按症状查修复
Lichii 黑屏修复、AMD 崩溃修复以及夜间白条修复方案均汇总在下表中。下方记录的 21 个已知问题均对应了修复它的构建版本或缓解该问题的临时设置，数据均整理自 Lichii 更新说明与 Pull Request。请先确认当前运行的版本号：绝大部分问题只需升级到版本 117 即可解决。
21已记录问题
17已在发布版修复
3需调整设置规避
1仍在排查中
匹配故障现象
Crash 4
fixed crash
当图像尺寸超出 VRAM 容量时发生 Crash
解决方案 更新至版本 116 或更高版本：显存分配失败时现会平稳报错退出
fixed crash
随机崩溃：访问未分配的 SparseLargeVector 区域
解决方案 更新至版本 95（标签 build-94）或更高版本
fixed crash
过场动画及指令页面卡顿后发生 Crash
解决方案 更新至版本 70 或更高版本
图形 13
workaround graphics
夜间出现白色条纹或拖影（Navi、萤火虫、烟雾）
解决方案 关闭 Emulation > Configure > Graphics > 勾选的“使用 NVIDIA DLSS 替代游戏的 DLSS”
fixed graphics
进入 Link 的家或城下町后，Hyrule Field 草地消失
解决方案 更新至版本 116 或更高版本
fixed graphics
AMD 天空过曝与雾气异常
解决方案 更新至版本 116 或更高版本
fixed graphics
网格着色器（Mesh Shader）场景丢失几何体（如德库树内部）
解决方案 更新至版本 116 或更高版本：网格着色场景改走计算着色器管线
fixed graphics
靠近时树叶和灌木淡出消失
解决方案 更新至版本 95（标签 build-94）或更高版本
fixed graphics
移动镜头时画面闪白
解决方案 更新至版本 95（标签 build-94）或更高版本
fixed graphics
植被缺失及材质数据错误
解决方案 更新至版本 83 或更高版本：修复额外的着色器指针与存储缓冲区绑定
fixed graphics
门道异常发光
解决方案 更新至版本 83 或更高版本：修复网格着色器寄存器处理机制
fixed graphics
AMD 下 3D 场景黑屏
解决方案 更新至版本 83 或更高版本：修复着色器嵌套返回（nested-return）处理
fixed graphics
游戏画面白屏无法显示世界
解决方案 更新至版本 75 或更高版本：约 80 个着色器现已支持正常转译
fixed graphics
黑屏、严重涂抹感及几何体拉伸畸变
解决方案 更新至版本 70 或更高版本：DLSS 网络现通过抗抖动代理转接
fixed graphics
世界全白
解决方案 更新至版本 70 或更高版本
investigating graphics
角色过暗、画面偏绿且 FPS 偏低
解决方案 暂无修复补丁；版本 117 已列为排查中
启动 3
fixed launch
游戏启动约 20 秒后异常中止
解决方案 更新至版本 75 或更高版本：合并上游 Eglantine #567 的 64 位 wait-on-address 修复
workaround launch
无法分配 14336 MiB 后备内存
解决方案 将 Windows 分页文件设为系统管理
workaround launch
macOS 拒绝打开 lichii.app
解决方案 右键点击 lichii.app 选择“打开”，或运行 xattr -dr com.apple.quarantine lichii.app
输入 1
fixed input
Controller 输入无响应
解决方案 更新至版本 70 或更高版本：输入已改走 HID 300 号命令
无匹配项。请清空搜索关键词或选择其他分类。
当前可通过设置规避的问题
有三个问题暂无代码级修复，但可通过调整本地设置予以消除。
Ocarina of Time 夜间白色条纹
- 打开 Emulation > Configure > Graphics。
- 取消勾选“使用 NVIDIA DLSS 替代游戏的 DLSS”。
- 重启游戏。Navi、萤火虫和烟雾渲染将不再出现拖影。
The 白色条纹是由 RTX 显卡上的 DLSS 替代功能引起的；修复补丁正在测试中。
无法分配 14336 MiB 后备内存
- 依次打开 Windows 设置 > System > 关于 > 高级系统设置。
- 在“性能”下选择 设置 > 高级 > 虚拟内存 > 更改。
- 勾选“System 管理的大小时”，点击确定并重启计算机。
The Build 75 已知问题列表中，将设置系统托管的分页文件列为此报错的变通解决方法。
macOS 拒绝打开 lichii.app
- 在“应用程序”文件夹中右键点击 lichii.app 并选择“打开”。
- 确认弹出提示一次即可；后续即可正常双击启动。
- 或者，也可以在 Terminal 中运行 xattr -dr com.apple.quarantine lichii.app。
The Mac 构建版未经公证，因此首次双击打开时会被 Gatekeeper 拦截。
各版本修复统计
更新版本是最有效的解决手段。The 图表统计了各版本已解决的已知问题数量；点击每个标签即可在下载归档中打开对应版本的软件包列表。
在提交新问题报告前
01
先更新版本
从 GitHub 安装 Build 117 并重试。Build 95 是在 build-94 标签下发布的，因此请在“关于”界面中查看实际的构建版本号。
02
尝试另一分支版本
若 PGO 软件包运行异常，可尝试同版本的标准包。A 仅在某一特定变体中复现的问题对开发者排查极具价值。
03
提取日志
打开 File > Open Lichii Folders > Log Folder 并附上 eden_log.txt。同时注明 GPU、驱动版本，以及是否启用了 DLSS 或 Mod。
04
发帖前先搜索
先查阅 GitHub 的 Issue 列表以及对应游戏的兼容性报告。包含 PR #303 的版本可直接在桌面客户端提交兼容性报告；版本 88 则不支持。
常见问题解答
在 Ocarina of Time 中，为什么 Lichii 会在我配备的 AMD Radeon 显卡上崩溃？
Build 116 在游戏启动后构建着色器时，会在 RX 6000、RX 5000、Vega 及 Polaris 显卡上导致 amdvlk64.dll 崩溃。原因是 The 驱动报告了这些显卡并不具备的矩阵核心支持。Build 117 已将该高速矩阵路径限制为仅限 RDNA3 及更新架构使用，请更新至 Build 117。
如何修复 Star Fox 黑屏？
升级至版本 70 或更新版本。该版本将游戏的 DLSS 网络改走抗抖动代理转接，解决了黑屏、严重涂抹感和几何体拉伸畸变问题，同时让手柄输入能正常通过 HID 300 号命令生效。
为什么 Splatoon Raiders 画面过暗且偏绿？
这是 Build 117 的已知问题：角色模型过暗、画面偏绿，且帧率低于早期构建版本。The 开发者已将其列入调查中，目前尚无有效设置能修复此问题。请关注后续版本的发布说明。
前往海拉鲁城邑后 Hyrule Field 的草地消失了，该怎么办？
该 Bug 已在版本 116 及更高版本中通过 PR #551 针对植被的改动得到修复。建议更新至版本 117，该版本包含相同修复及 AMD 崩溃补丁。整体植被缺失问题在此前的版本 83 中也已通过追加着色器指针和存储缓冲区绑定获得了改善。