Beam Bench文档

Linux 启动或空白窗口

调查 AppImage 渲染失败并收集原生启动诊断信息。

如果 Beam Bench 在启动期间关闭或打开空白窗口,请先检查已安装的版本。版本 0.2.15 修正了 AppImage 运行时库冲突,这些冲突可能会在 Kubuntu 以及使用较新 Mesa 驱动的其他发行版上导致 EGL_BAD_PARAMETER。

0.2.28 版本使用单色替代字体,避免较新彩色字体引起的 WebKit 渲染器崩溃。AppImage 遵循显式设置的 GDK_BACKEND,并在 X11 不可用时使用原生 Wayland。报告包含当前和上一次启动日志中限制长度、移除个人信息的片段。

修复 Linux 启动问题

0.2.33 修复了 AppImage 0.2.31 和 0.2.32 因内置 systemd 库而无法在较新的 Linux 发行版上启动的问题。如果应用无法打开并自行更新,请下载 0.2.33 或更新版本。

如果终端显示 LIBSYSTEMD_254,且未生成新的 startup.log,说明启动器在原生日志开始前已失败。报告时请附上终端错误和发行版版本。

检查当前软件包

从 Beam Bench 网站下载当前 Linux AppImage。使用适用于 x86_64 Linux 的软件包,并按照安装说明操作。保留现有项目文件。

正常工作的桌面图形栈和必需的系统库仍是必要条件。打包修复不能保证每种发行版或驱动组合都能正常工作。

收集启动日志

Beam Bench 会将早期 GTK、WebKit、EGL 和 Rust 启动诊断信息记录在原生日志中。如果嵌入式界面失败,原生错误对话框会显示日志位置,并且无需使用 Web 界面即可打开其文件夹。

记录应用版本、发行版、桌面会话、图形硬件和错误信息。在报告中加入相关启动日志详细信息。避免公开发布无关的个人路径或系统信息。

区分启动问题和串行问题

空白窗口不同于串行权限失败。如果界面正常工作,但无法打开激光端口,请使用 Linux 串行权限和连接故障排除。

不要更改激光固件设置来修复应用启动失败。

On this page