# 疑難排解

> 排查 DockSpark 常見問題：懸停面板不出現、設定檔打不開、Chromium 或 Firefox 清單更新失敗，以及主視窗關閉後應用程式仍在執行。回報問題時請附上系統與瀏覽器版本。

Source: https://dockspark.app/zh-TW/docs/reference/troubleshooting

## 面板不出現

1. 確認 DockSpark 仍在背景執行。
2. 開啟「系統設定」→「隱私權與安全性」→「輔助使用」。
3. 確保已啟用 DockSpark 的存取權限；必要時重新開啟應用程式。恢復輔助使用權限後，DockSpark 可自動重建 Dock 懸停監聽。
4. 確認該圖示屬於支援的瀏覽器。

游標離開 Dock 圖示和面板後，懸停面板應自動收起。從圖示斜向移入面板時，短暫經過相鄰圖示不應誤切換或關掉面板。

## 設定檔打不開

對於 Chrome 系列瀏覽器，請核對手動填寫的設定檔目錄名稱是否與瀏覽器中的實際值一致，例如 `Default` 或 `Profile 1`。較新版本可自動偵測 Chrome 設定檔目錄；若重新命名後的設定檔顯示異常，請在 DockSpark 中更新或重新新增。同時請回應 macOS 顯示的所有自動化權限提示。

## Chromium 或 Firefox 設定檔清單無法更新

如果 DockSpark 說明需要完全取用磁碟權限才能讀取 Chromium 或 Firefox 設定檔，請在「系統設定」中授予該權限後再更新。更新失敗時，錯誤提示會提供更明確的原因。

## 撤銷權限後功能無法使用

這是預期行為。關閉輔助使用後，懸停面板不會出現；關閉自動化後，開啟指定設定檔或隱私視窗可能失敗；關閉完全取用磁碟後，Chromium 或 Firefox 設定檔清單可能無法自動更新。在「系統設定」中重新開啟對應開關，或在 DockSpark 中再次授權即可恢復。用「終端機」刪除授權並清除本機設定的步驟見 [權限](/docs/getting-started/permissions)。

> **還是不行？**
>
> [回報問題](https://github.com/DockSpark/DockSpark/issues)時，請附上 macOS 版本、瀏覽器版本、Dock 位置，以及是否啟用了自動隱藏。也可以在應用程式中選擇「輔助說明 → 傳送意見回饋…」。

## 應用程式持續執行

這是預期行為。主視窗關閉後，DockSpark 會繼續執行，以便監聽 Dock 懸停。可從選單列或 Dock 圖示重新開啟，或從選單中選擇「結束 DockSpark」完全結束。若兩個圖示都已隱藏，請從啟動台或「應用程式」重新開啟。

自動隱藏 Dock 時，請將游標在圖示上多停一會兒，等 Dock 完全展開。多螢幕環境下，請確認游標和瀏覽器圖示在同一塊螢幕上。支援的應用程式見 [支援的瀏覽器](/docs/reference/supported-browsers)。

如果開啟的 Chrome 身分不對，先核對目錄名稱而不是顯示名稱，見 [管理設定檔](/docs/guides/manage-profiles) 與 [Chrome 設定檔指南](/guide/chrome-profiles)。