故障排查
创意工坊浏览无法工作
请先检查 Steam Web API 密钥。
- 打开设置。
- 确认 Steam Web API Key 已填写。
- 如有需要，从 https://steamcommunity.com/dev/apikey 创建或复制密钥。
- 确认你登录的是拥有 Wallpaper Engine 的 Steam 账号。
同时确认本机已安装 Steam 和 Wallpaper Engine。
壁纸可见但无法应用
查看 LWE 显示的兼容性状态。
可能原因包括：
- 壁纸类型可识别，但当前运行时不支持；
- 项目是超出当前支持水平的网页或场景壁纸；
- 本地创意工坊内容不完整或尚未同步完成；
- 当前桌面会话尚未验证。
- 运行时后端无法初始化 Wayland layer-shell、EGL 或目标输出。
视频类壁纸是首发运行时重点。不要假定所有 Wallpaper Engine 项目都能在 Linux 上运行。
应用壁纸后桌面没有变化
先确认你在受支持或已知可用的会话中测试。当前已验证环境是 Wayland + niri。
然后尝试：
- 在 LWE 中清除当前分配；
- 重新选择显示器；
- 再次应用壁纸；
- 如果会话状态看起来过期，重启 LWE。
从终端启动时，如果运行时错误能指出以下阶段，最有助于诊断：
- 后端启动；
- 输出发现；
- 首帧应用；
- 按显示器清除；
- 启动时恢复。
常见底层原因包括缺少 zwlr_layer_shell_v1、EGL 不可用、显示器/输出名称不匹配、本地视频资源缺失，或壁纸类型不受支持。
如果问题只在其他合成器上出现，报告问题时请附上合成器、会话类型和显示器布局。
AppImage 无法启动
确保 AppImage 具有可执行权限：
bash
chmod +x LWE*.AppImage然后从终端启动以捕获日志：
bash
./LWE*.AppImageAUR 包构建失败
尝试更新包数据库，并在干净环境中重新构建。如果失败与包本身相关，报告问题时请说明使用的是 lwe 还是 lwe-git。
语言或主题没有持久化
再次修改设置并重启应用。如果问题仍然存在，请附上发行版、桌面会话、安装包类型，以及应用是否能够写入其配置目录。