故障排查
本页汇总 Mirage 使用中的常见问题。创意工坊相关的登录与下载问题请见创意工坊故障排查。
壁纸不显示或黑屏
Section titled “壁纸不显示或黑屏”- 确认壁纸目录根部有
project.json，且类型受支持（场景 / 网页 / 视频）。 - 若是刚导入或下载的壁纸，尝试在壁纸库中刷新。
- 复杂的 Wallpaper Engine 场景可能存在兼容性差异，换一个作品验证是否为个例。
- 网页壁纸首次应用需要在安全提示中确认信任，否则不会显示。见网页壁纸安全。
壁纸卡顿或占用高
Section titled “壁纸卡顿或占用高”- 在性能设置中降低帧率（建议 30）或调低渲染质量。
- 关闭抗锯齿。
- 场景壁纸通常比视频、网页更吃资源。
壁纸意外暂停或停止
Section titled “壁纸意外暂停或停止”这通常是播放规则在起作用，属于预期的省电行为。检查性能设置中的规则：
- 其他应用全屏 / 获得焦点 / 播放音频时；
- 显示器睡眠时；
- 笔记本使用电池时。
多个条件同时命中时取最强动作（停止 > 暂停 > 静音 > 保持运行）。
多显示器问题
Section titled “多显示器问题”- 每块屏幕可独立设置壁纸，确认你操作的是目标屏幕。
- 插拔显示器或改变排列后，可刷新壁纸库或重新应用。详见多显示器。
- 若自动更新关闭，用菜单栏「检查更新…」手动检查。
- 测试版需在软件更新设置中开启。
- 首次安装可能需要在 macOS Gatekeeper 中手动允许 Mirage 运行。
- 在屏保设置确认已安装组件。
- 安装后仍需在系统设置的屏保面板中选中 Mirage。
- 更新 Mirage 后若屏保行为异常，点「重新安装」同步到最新版本。