| 1 | # Desktop graphics recovery / 桌面图形故障恢复 |
| 2 | |
| 3 | Hardware acceleration remains enabled by default. To change the saved preference, |
| 4 | open **Settings → General → System → Hardware acceleration** and restart Reasonix. |
| 5 | Disabling acceleration can help with graphics compatibility, but a successful |
| 6 | restart alone does not establish the cause of a freeze. |
| 7 | |
| 8 | 默认开启硬件加速。可在 **设置 → 通用 → 系统 → 硬件加速** 修改偏好，重启后生效。 |
| 9 | 关闭加速可能改善图形兼容性，但重启成功本身不能确认卡死原因。 |
| 10 | |
| 11 | Repeated GPU failures or renderer failures can offer a native recovery dialog. |
| 12 | A renderer is automatically reloaded at most once within 60 seconds; a window |
| 13 | that remains unresponsive for 15 seconds can also offer recovery. Memory growth |
| 14 | or an unclean exit alone is not classified as a GPU failure. |
| 15 | |
| 16 | 连续 GPU 故障或页面故障会提供原生恢复对话框。页面在 60 秒内最多自动刷新一次； |
| 17 | 界面持续无响应 15 秒也可提供恢复入口。仅凭内存增长或异常退出不会判定为 GPU 故障。 |
| 18 | |
| 19 | **Restart in compatibility mode** disables acceleration for that launch only. |
| 20 | After startup, choose **Keep disabled** to save the preference, or **This launch |
| 21 | only** to use the existing preference next time. Restart interrupts running tasks. |
| 22 | Reasonix attempts to save drafts before shutting down; if saving fails or takes |
| 23 | more than five seconds during recovery, proceeding requires confirmation that |
| 24 | unsaved draft changes may be lost. |
| 25 | |
| 26 | **以兼容模式重启** 仅对本次启动关闭加速。启动后选择 **保持关闭** 可保存偏好， |
| 27 | 选择 **仅本次关闭** 则在下次启动时使用原有偏好。重启会中断正在执行的任务。 |
| 28 | Reasonix 会先尝试保存草稿；恢复过程中保存失败或超过五秒时，必须确认可能丢失 |
| 29 | 未保存草稿修改后才能继续重启。 |
| 30 | |
| 31 | **Open diagnostics** opens the local logs directory. Recent unacknowledged GPU |
| 32 | failures may offer recovery on the next launch of the same build, within 24 hours. |
| 33 | Graphics records remain local and do not upload diagnostics. If no recovery |
| 34 | dialog is available, fully quit Reasonix and launch with `REASONIX_DISABLE_GPU=1` |
| 35 | for a temporary override that does not change the saved preference. |
| 36 | |
| 37 | **查看诊断** 打开本地日志目录。同版本在 24 小时内再次启动时，尚未确认的 GPU |
| 38 | 故障可再次提供恢复提示。图形故障记录仅保存在本地，不会上传诊断数据。 |
| 39 | 若无法使用恢复弹窗，可完全退出 Reasonix 后带 `REASONIX_DISABLE_GPU=1` 启动， |
| 40 | 临时关闭加速，不改变已保存的偏好。 |
| 41 | |
| 42 | ## Linux display backend / Linux 显示后端 |
| 43 | |
| 44 | Under a Wayland session that also provides XWayland (`DISPLAY` is set), Reasonix |
| 45 | starts its window with `--ozone-platform=x11`, because some drivers fail to |
| 46 | initialise EGL on Electron's Wayland backend and the app exits before a window |
| 47 | appears. A pure Wayland session without `DISPLAY` keeps the native backend. Set |
| 48 | `REASONIX_OZONE_PLATFORM=wayland` to use native Wayland anyway, `x11` to force |
| 49 | X11, or `auto` for the default. An `--ozone-platform` argument given on the |
| 50 | command line always wins. |
| 51 | |
| 52 | 在同时提供 XWayland（设置了 `DISPLAY`）的 Wayland 会话下，Reasonix 默认以 |
| 53 | `--ozone-platform=x11` 启动窗口：部分驱动在 Electron 的 Wayland 后端上无法初始化 |
| 54 | EGL，应用会在窗口出现前退出。没有 `DISPLAY` 的纯 Wayland 会话保持原生后端。 |
| 55 | 设置 `REASONIX_OZONE_PLATFORM=wayland` 可仍使用原生 Wayland，`x11` 强制 X11， |
| 56 | `auto` 为默认行为。命令行显式传入的 `--ozone-platform` 始终优先。 |
| 57 | |
| 58 | See the [shell implementation and validation notes](../desktop/electron/README.md#hardware-acceleration-recovery). |
| 59 | 实现及验证说明见上述链接。 |
| 60 |