Loomscreen故障排除
按症状查找安装、渲染、自动切换、导入、创意工坊和更新问题的处理方法。
本页按场景列出常见问题。先看“先检查”一栏，再按“处理”一栏操作。仍然解决不了，见页尾的 还是不行？。
安装与启动
| 问题 | 先检查 | 处理 |
|---|---|---|
| 提示“Loomscreen.app 已损坏”或“无法打开” | Gatekeeper 可能拦截未公证的构建，但仅凭这条提示不能确定原因 | 先校验 DMG，再按 如果 macOS 拒绝打开 使用对应 Lite / Pro 的命令；仍然失败，就收集启动错误 |
| 菜单栏图标不见了 | 应用还在运行吗（用活动监视器查看）？菜单栏是不是太挤？ | 从 /Applications 重新启动；检查登录项限制 |
| 完全启动不了 | 是否为 macOS 14.6+？Pro 还需要 Apple Silicon | Lite 带一个未经测试的 Intel 版本；Pro 仅支持 Apple Silicon |
工作区与导航
| 问题 | 下一步 |
|---|---|
| 找不到旧的显示器侧栏，或独立的书签 / 航拍页 | 从全景选择显示器，从壁纸库及其筛选浏览内容。黄色书签标记本地壁纸库条目，粉色创意工坊喜欢保存线上条目供稍后下载。 |
| 引导显示时控件点不了 | 用关闭按钮或 Esc 退出浮动导览，再操作工作区。可以从设置 → 关于 → 欢迎导览重新打开。 |
| 关闭窗口后壁纸没有停止 | 关闭管理窗口不会退出应用。用菜单栏总开关隐藏壁纸，或选择退出退出应用。 |
| 已保存的修改没有出现在桌面上 | 检查总开关、显示器的播放 / 暂停原因和加载失败。封面预览或已保存的值，不能证明壁纸已经在渲染。 |
渲染
| 问题 | 先检查 | 处理 |
|---|---|---|
| 什么都没显示 / 壁纸全黑 | 在全景 → 点选显示器 → 壁纸中指定来源了吗？总开关开着吗？ | 指定来源；把菜单栏总开关关掉再打开 |
| 壁纸总是自己暂停 | 暂停规则：全屏、遮挡达到 85% 及以上、电池、低电量模式、按 App 的例外 | 菜单栏和该屏详情会写明是哪条规则让它暂停。可选规则可在设置 → 性能调整，或添加从不暂停例外；安全暂停不能覆盖。见 自动暂停 |
| 第二块显示器一直空白 | 来源的文件权限覆盖到那块显示器的配置了吗？ | 重新打开该显示器的详情面板，显式重新指定来源 |
| 大视频卡顿 | 源分辨率和编码、叠加层、资源压力 | 换用较低分辨率的来源，调整帧率上限，暂时关闭叠加层来排查。预载预算是在内存与磁盘读取、解码之间取舍 |
| 桌面点击像被挡住了（场景） | 场景的点击交互会捕获鼠标点击 | 关闭那块显示器的点击交互，然后重新加载 |
| 外接盘推出后壁纸不见了 | 视频或网页壁纸是不是存在那块盘上？ | 外接盘不在时，显示器的配置会保留。重新接上后，显示器会自动重新加载；如果没有，点击重新加载显示器 |
| 重启或拔插后壁纸一直暂停 | 之前是否在这块显示器上或用总开关暂停过？ | 手动暂停会一直保持。点击播放，或给这块显示器选一张壁纸 |
播放列表与计划
| 问题 | 先检查 | 处理 |
|---|---|---|
| 计划不切换 | 时段有重叠吗？时段引用的壁纸还有效吗？那个时间点应用是否处于暂停？ | 修正高亮显示的冲突，重新保存该时段。锁屏或休眠期间自动切换会停止，唤醒后只对齐一次，错过的时段不会补触发 |
| 播放列表间隔不生效 | 至少有两个有效条目吗？播放列表模式开了吗？ | 重新设置间隔并保存。手动选壁纸、应用方案或应用创意工坊条目，会让倒计时从头计算。离开期间倒计时冻结，回来后从剩余时间继续 |
| 某张壁纸被标为已跳过 | 它连续两次加载失败。壁纸自动切换中的已跳过的壁纸会写明原因 | 修好来源后，点击重新启用 |
自动切换的规则见 倒计时与跳过规则。
导入
| 问题 | 先检查 | 处理 |
|---|---|---|
| 网页文件夹加载不了 | 能从文件夹推断出入口文件吗？ | 直接选择那个 .html 文件 |
| 场景导入立刻失败（Pro） | 项目必须有 project.json；资源库文件夹必须包含项目子目录 | 选择项目文件夹或支持的资源库文件夹，查看具体错误。不支持 Windows 可执行程序壁纸 |
创意工坊（Pro）
| 问题 | 先检查 | 处理 |
|---|---|---|
| 下载失败 | SteamCMD 状态、Steam 登录 | 打开设置 → 创意工坊。Steam 连接一节会诊断 Steam 库、SteamCMD 和你的账号，并能自动配置。展开该节的诊断可以查看逐项检查 |
| 设置 SteamCMD（或引导中的安装 SteamCMD）失败 | 错误信息会指出是清单、下载、校验和还是签名验证失败 | 重试。不匹配可能来自下载不完整或信任验证失败，不能仅凭它判断原因。不要绕过验证；必要时改选一个已有的可信安装 |
| 自己指定的 SteamCMD 突然不能用了 | 它在每次运行时都会重新验证。如果某次升级改变了签名，就会被拒绝 | 用选择 SteamCMD重新指定，或改用托管安装 |
| 浏览页空白 | 筛选条件、网络、API 功能所需的 key | 清除过严的筛选后重试。公开浏览不需要 key；作者、预设等 API 查询可能需要。预设默认不出现在通用浏览网格中 |
| 导入时提示条目“已从其他文件夹加入壁纸库” | 同一个创意工坊条目在壁纸库里只保留一份 | 使用壁纸库里已有的那一份。同一条目的 Steam 下载在替换本地副本前会先询问 |
| 某张壁纸的预设列表是空的 | 列出预设需要 Steam Web API key，下载预设需要 SteamCMD | 先填好 key。如果显示“这张壁纸还没有人发布预设”，那就是字面意思 |
配置步骤见 下载前的配置。
叠加层、备份与更新
| 问题 | 检查与下一步 |
|---|---|
| Apple Music 进度或控制不可用 | 在 macOS 的隐私与安全性 → 自动化中允许 Loomscreen 控制 Music。没有可用播放位置的曲目，无法提供同步进度。 |
| 歌词缺失或不滚动 | 启用歌词，检查网络和曲目匹配。并非每首歌都有 LRCLIB 的带时间歌词。 |
| 天气组件没有当前天气 | 选择系统定位或手动位置，检查天气设置和网络。 |
| 导入的备份里有场景，Lite 却没有壁纸 | Lite 保留配置数据，但不能运行 Pro 场景。换成视频或网页来源，或在 Pro 中打开这份配置。 |
| 系统壁纸不可用 | 需要 macOS 26+ 和兼容的 provider。状态显示已暂停时，使用应用内原有的视频壁纸。添加视频后，仍需在 macOS 壁纸设置中选择它。见 系统壁纸。 |
| 关闭更新窗口后标记还在 | Sparkle 会话保留期间，标记可能继续显示。通过更新窗口操作即可，这不代表重复下载。 |
| 更新下载或校验失败 | 网络恢复后重试，不要绕过签名验证。GitHub Releases 提供对应版本的 DMG 和校验和，可以手动更新。 |
还是不行？
- 在设置 → 性能中切换相关的暂停规则，再试一次。
- 动手调整之前，先从设置 → 备份与恢复导出配置。
- 使用设置 → 关于 → 报告问题，它会自动填好诊断信息和最近的日志。附上复现步骤，提交到 GitHub Issues。