文件 / 疑難排解

疑難排解

遇到問題了嗎?以下是最常見問題的解決方法。每張卡片都會說明一種特定症狀及其解決方式。

權限

「BetterStage 無法控制我的視窗」

BetterStage 需要輔助使用權限才能讀取和移動視窗。打開「系統設定」>「隱私權與安全性」>「輔助使用」,確認 BetterStage 已列出並已開啟。如果原本就已開啟,請嘗試將它關閉後再重新開啟。變更權限後,請重新啟動 BetterStage。如果在 BetterStage 執行時撤銷了權限,App 會提醒你,並還原被隱藏的視窗,而不會讓它們留在畫面外。撤銷輔助使用權限後,BetterStage 不會再攔住鍵盤或滑鼠輸入。重新授予權限也不會中斷正在進行的已儲存工作區、連續性或喚醒還原。

「快速鍵沒有作用」

BetterStage 的鍵盤快速鍵使用原生的 Carbon 熱鍵 API,因此不需要「輸入監控」權限。如果快速鍵沒有作用,請先確認已開啟輔助使用權限。同時確認沒有其他應用程式使用相同的按鍵組合、滑鼠按鈕或觸控板手勢 — 衝突的快速鍵會讓 BetterStage 收不到這些事件。可在「設定」>「快速鍵」中重新設定鍵盤、滑鼠和觸控板操作。

「偵測不到視窗」

視窗偵測使用 macOS 輔助使用 API,由輔助使用權限涵蓋。請確認已在「系統設定」>「隱私權與安全性」>「輔助使用」中開啟。請注意,部分應用程式使用非標準的視窗類型(例如浮動面板或自訂的 Chrome 視窗),輔助使用 API 可能偵測不到。

視窗行為

「我應該同時使用 BetterStage 和 macOS 幕前調度嗎?」

不應該。使用 BetterStage 前,請先關閉 Apple 內建的「幕前調度」。兩個工具都會管理視窗的可見性,同時執行可能導致令人困惑的切換、視窗被隱藏,或視窗出現在錯誤的位置。打開「系統設定」>「桌面與 Dock」>「幕前調度」並關閉「幕前調度」;如果工作環境看起來仍不正確,請重新啟動 BetterStage。

「Firefox/Chrome 視窗會播放動畫,而不是立即貼齊」

部分瀏覽器(Firefox、Chrome 及以 Electron 為基礎的 App)會開啟名為 AXEnhancedUserInterface 的輔助使用旗標,導致視窗移動時播放動畫,而不是直接貼齊。BetterStage 會自動偵測並為受影響的 App 停用此旗標。如果仍看到移動動畫,請嘗試結束並重新打開瀏覽器,讓 BetterStage 重新套用修正。

「Firefox 視窗會閃爍、難以定位,或跟不上工作台切換」

Firefox 以非標準的方式處理其視窗,因此不一定能與視窗管理功能順利配合 — 你可能會看到視窗短暫閃爍、難以精確定位,或跟不上工作台切換。這是已知問題,我們正持續改善與 Firefox 的相容性。

「切換到空白工作台時出現 Finder」

當前景應用程式沒有可見視窗時,macOS 可能會啟用 Finder。BetterStage 2.2.0 會將個別視窗隱藏在私有空間中,而不是隱藏整個應用程式。如果有視窗意外出現在空白工作台上,請回報該 App 名稱,以及觸發問題的工作台或桌面切換順序。

「睡眠或螢幕保護程式後,視窗被移到錯誤的工作台」

請等待螢幕排列穩定下來。已記住的螢幕佈局會自動回來;如果出現復原提示,請選擇「還原工作區」或「保留目前佈局」。對於移除桌面後仍被隱藏的視窗,或螢幕變動後跑到畫面外的視窗,請使用選單列中的「救援視窗」。如果 BetterStage 回報無法使用 macOS 空間,請等待桌面切換完成,然後選擇「重試」。如果問題持續,請重新啟動 BetterStage。

「對話框或浮動視窗卡在 TabStack 後面」

打開輪盤選單,從「更多操作」中選擇「將浮動視窗移到最前面」。這會將此螢幕上浮動及未追蹤的視窗移到前方,而不會改變佈局或顯示被隱藏的標籤頁。「救援視窗」也能救回 BetterStage 隱藏在私有空間中的視窗,包括原本所在桌面已被移除的視窗。

「當機後視窗不見了」

BetterStage 會記錄被移入私有空間的視窗,並執行獨立的復原輔助程式。如果 BetterStage 意外結束,輔助程式會根據這些記錄,將被隱藏的視窗送回其已儲存的桌面。如果視窗仍然不見,請重新啟動 BetterStage 並使用「救援視窗」。若桌面已被移除或螢幕已中斷連接,可能需要一個可用的替代目的地。

App 設定

「從終端機執行與使用 .app 套件的差異」

在終端機中透過 swift run 執行 BetterStage 時,macOS 會將輔助使用權限授予你的終端機 App,而不是 BetterStage 本身。若要正確處理權限,讓 BetterStage 以自己的名稱出現在「系統設定」中,請改為建置並執行 .app 套件。

「工作台列不會出現」

工作台列可透過觸發邊緣(將指標移到螢幕頂端)或鍵盤快速鍵 Opt+Up Arrow 叫出。請確認已在「設定」中開啟觸發邊緣。如果工作台列仍未出現,請檢查 BetterStage 是否已取得所需的輔助使用權限。

在有瀏海的 Mac 內建螢幕上,「設定」>「工作台」>「工作台列」>「避開螢幕瀏海」可略過瀏海本身,同時讓頂端邊緣的其餘部分保持作用。

「重新連接後無法辨識螢幕」

BetterStage 會依據型號和序號等硬體資訊來辨識螢幕,而不只是依據 macOS 指派的螢幕 ID。在少數情況下,例如更新驅動程式後,或改用不同的連接埠或轉接器時,這些資訊會改變。請嘗試中斷並重新連接螢幕,然後重新啟動 BetterStage。如果仍無法辨識螢幕,請在「設定」>「螢幕」中重新設定。

「⌘Tab 仍然顯示 macOS 的 App 切換器」

BetterStage ⌘Tab 切換器為選用功能,預設為關閉。請在「設定」>「⌘Tab 切換器」中開啟「使用 BetterStage ⌘Tab」,並確認 Pro、試用或每日 Pro 試用正在作用中。沒有預覽時會顯示 App 圖像;允許螢幕錄製即可顯示即時縮覽圖。請參閱 ⌘Tab 切換器指南。

「降回 2.0.x 後,我的工作台無法載入」

BetterStage 2.2 儲存的工作台無法由較早的版本開啟。如果你重新安裝了 2.0.x,你的工作台將無法載入;請改從下載頁面更新至最新版本。

回報錯誤

BetterStage 會保留一份上限為 10 MB 的循環診斷日誌,絕不會佔滿你的磁碟。若要將它附加到錯誤回報中,請打開 BetterStage 選單列圖像並選擇「顯示診斷日誌…」— Finder 會打開並顯示該日誌檔案,讓你將它拖到 Discord 訊息、GitHub issue 或電子郵件中。

正式版本會避免記錄可能擷取到視窗標題的詳細日誌。如果你正在重現問題並想取得更詳細的追蹤記錄,請執行 Beta 或候選發布版本,擷取日誌後再切換回正式發布通道。

仍需要協助?

如果上述內容沒有涵蓋你的問題,歡迎與我們聯絡,我們會協助你解決。