文档 / 故障排除

故障排除

遇到问题了?下面列出了最常见问题的解决方法。每张卡片都针对一种具体症状,并说明如何解决。

权限

“BetterStage 无法控制我的窗口”

BetterStage 需要辅助功能权限才能读取和移动窗口。打开“系统设置 > 隐私与安全性 > 辅助功能”,确认 BetterStage 已列出并已开启。如果已经开启,请尝试将其关闭后再重新打开。更改权限后请重新启动 BetterStage。如果在 BetterStage 运行期间权限被撤销,应用会提醒你并恢复被隐藏的窗口,而不会让它们留在屏幕之外。撤销辅助功能权限后,BetterStage 不会再占用键盘或鼠标输入。重新授权也不会中断正在进行的已存储工作区恢复、连续性恢复或唤醒恢复。

“快捷键不起作用”

BetterStage 的键盘快捷键使用原生 Carbon 热键 API,因此不需要“输入监控”权限。如果快捷键不起作用,请先检查辅助功能权限是否已开启。同时确认没有其他应用程序在使用相同的组合键、鼠标按键或触控板手势——冲突的快捷键会使 BetterStage 无法接收到这些事件。你可以在“设置 > 快捷键”中重新绑定键盘、鼠标和触控板操作。

“检测不到窗口”

窗口检测使用 macOS 辅助功能 API,由辅助功能权限覆盖。请确认已在“系统设置 > 隐私与安全性 > 辅助功能”中开启该权限。请注意,部分应用程序使用非标准的窗口类型(例如浮动面板或自定义 Chrome 窗口),辅助功能 API 可能无法检测到它们。

窗口行为

“我应该同时使用 BetterStage 和 macOS 台前调度吗?”

不应该。使用 BetterStage 之前,请先关闭 Apple 内置的台前调度。两者都会管理窗口的可见性,同时运行可能导致令人困惑的切换、窗口被隐藏,或窗口出现在错误的位置。打开“系统设置 > 桌面与程序坞 > 台前调度”并关闭台前调度;如果工作区看起来仍然不对,请重新启动 BetterStage。

“Firefox/Chrome 窗口会播放动画,而不是立即吸附到位”

部分浏览器(Firefox、Chrome 以及基于 Electron 的应用)会启用一个名为 AXEnhancedUserInterface 的辅助功能标记,导致窗口移动时播放动画,而不是直接吸附到位。BetterStage 会自动检测受影响的应用并停用此标记。如果仍然看到移动动画,请尝试退出并重新打开浏览器,让 BetterStage 重新应用此修复。

“Firefox 窗口闪烁、难以准确摆放,或在切换工作台时滞后”

Firefox 以非标准的方式处理其窗口,因此并不总能与窗口管理良好配合——你可能会看到窗口短暂闪烁、难以精确摆放,或在切换工作台时滞后。这是一个已知问题,我们正在持续改进对 Firefox 的兼容性。

“切换到空工作台时出现访达”

当前台应用程序没有可见窗口时,macOS 可能会激活访达。BetterStage 2.2.0 会把单个窗口隐藏在私有空间中,而不是隐藏整个应用程序。如果有窗口意外出现在空工作台上,请报告应用名称,以及触发该问题的工作台或桌面切换顺序。

“睡眠或屏幕保护程序之后,窗口被移到了错误的工作台”

请等待显示器排列稳定下来。已记住的显示器会自动恢复其布局;如果出现恢复提示,请选取“恢复工作区”或“保留当前布局”。对于在移除桌面后仍处于隐藏状态的窗口,或在显示器变动后跑到屏幕外的窗口,请使用菜单栏中的救援窗口。如果 BetterStage 报告 macOS 空间不可用,请等待桌面切换完成后选取“重试”。如果问题仍然存在,请重新启动 BetterStage。

“对话框或浮动窗口被卡在 TabStack 后面”

打开轮盘菜单,从“更多操作”中选取前置浮动窗口。这会把此显示器上的浮动窗口和未被跟踪的窗口移到前面,而不会改变布局或显示隐藏的标签页。“救援窗口”还能找回 BetterStage 隐藏在私有空间中的窗口,包括原桌面已被移除的窗口。

“崩溃后窗口不见了”

BetterStage 会记录被移入私有空间的窗口,并运行一个独立的恢复助手。如果 BetterStage 意外退出,助手会根据这些记录把隐藏的窗口送回它们所存储的桌面。如果窗口仍然不见,请重新启动 BetterStage 并使用“救援窗口”。如果桌面已被移除或显示器已断开,可能需要一个可用的替代目标位置。

应用配置

“从终端运行与使用 .app 包的区别”

在终端中通过 swift run 运行 BetterStage 时,macOS 会把辅助功能权限授予你的终端应用,而不是 BetterStage 本身。若要正确处理权限,让 BetterStage 以自己的名称出现在“系统设置”中,请改为构建并运行 .app 包。

“工作台栏不出现”

工作台栏可以通过触发边缘(将指针移到屏幕顶部)或键盘快捷键 Opt+Up Arrow 调出。请确认已在“设置”中启用触发边缘。如果工作台栏仍然不出现,请检查 BetterStage 是否已获得所需的辅助功能权限。

在带刘海的 Mac 内建显示器上,“设置 > 工作台 > 工作台栏 > 避开显示器刘海”可以跳过刘海本身,同时让顶部边缘的其余部分保持可触发。

“重新连接后无法识别显示器”

BetterStage 通过型号和序列号等硬件信息识别显示器,而不仅仅依靠 macOS 分配的显示器 ID。在少数情况下,例如更新驱动程序后,或换用其他端口或转接器时,这些信息会发生变化。请尝试断开并重新连接显示器,然后重新启动 BetterStage。如果仍然无法识别,请在“设置 > 显示器”中重新配置。

“⌘Tab 仍然显示 macOS 应用切换器”

BetterStage ⌘Tab 切换器为可选功能,默认关闭。请在“设置 > ⌘Tab 切换器”中开启使用 BetterStage ⌘Tab,并确认 Pro、试用或每日 Pro 体验处于有效状态。未开启预览时,它会显示应用图标;允许“屏幕录制”权限即可显示实时缩略图。请参阅⌘Tab 切换器指南。

“退回 2.0.x 后,我的工作台无法加载”

BetterStage 2.2 存储的工作台无法被更早的版本打开。如果你重新安装了 2.0.x,你的工作台将无法加载;请改为从下载页面更新到最新版本。

报告错误

BetterStage 会保留一份滚动更新的诊断日志,上限为 10 MB,绝不会占满你的磁盘。若要将它附加到错误报告中,请点按 BetterStage 菜单栏图标并选取显示诊断日志…——访达会打开并定位到日志文件,你可以把它拖进 Discord 消息、GitHub issue 或电子邮件中。

正式版不会进行可能记录窗口标题的详细日志记录。如果你正在复现问题并希望获得更详细的跟踪信息,请运行 Beta 版或候选发布版,捕获日志,之后再切换回正式版通道。

仍需帮助?

如果上面没有涵盖你遇到的问题,请联系我们,我们会帮你解决。