說明文件
GitHub

入門

權限

說明 DockSpark 為何需要 macOS 輔助使用、自動化和完全取用磁碟權限,如何在系統設定裡關閉它們,以及如何用終端機刪除授權並清除本機設定。沒有輔助使用,懸停面板無法運作。

輔助使用

Dock 懸停所必需

DockSpark 透過 macOS 輔助使用 API 辨識游標下的 Dock 圖示並讀取其位置。沒有這項權限,就無法顯示懸停面板。

自動化

某些瀏覽器操作需要 macOS 自動化權限。DockSpark 僅會在你使用相關操作時要求授權,並由 macOS 顯示授權提示。

完全取用磁碟

讀取 Chromium 或 Firefox 設定檔時,可能需要完全取用磁碟權限。若確實需要,DockSpark 會先說明原因再開啟系統設定。你可以在那裡允許或拒絕。

控制權在你手上

這些權限都由 macOS 管理,可隨時查看或關閉。關閉後相關功能會停止;你仍可以在 DockSpark 中重新要求授權。

在系統設定中撤銷權限

  1. 開啟「系統設定」。 在側邊欄中選擇「隱私權與安全性」。
  2. 開啟要撤銷的權限。 選擇「輔助使用」、「自動化」或「完全取用磁碟」。
  3. 關閉 DockSpark 的存取。
    • 輔助使用和完全取用磁碟: 關閉 DockSpark 旁邊的開關。若要從清單中刪除,選取 DockSpark,再點清單下方的「−」。
    • 自動化: 展開 DockSpark,取消勾選它被允許控制的應用程式,例如 Safari、Google Chrome 或 Firefox。
  4. 依系統提示操作。 若 macOS 要求,請先選擇「結束 DockSpark」,再重新開啟應用程式。只關閉主視窗不夠,應用程式仍會在背景執行。

撤銷後會出現這些限制:沒有輔助使用,懸停面板無法出現;沒有自動化,開啟指定設定檔或隱私視窗可能失敗;沒有完全取用磁碟,Chromium 或 Firefox 設定檔清單可能無法自動更新,但仍可手動填寫 Chromium 的 Default 或 Profile 1。

路徑彙總:系統設定 →「隱私權與安全性」→「輔助使用」/「自動化」/「完全取用磁碟」。輔助使用只用於定位 Dock 圖示,不讀取網頁。更偏產品說明的版本見 隱私權。

用終端機刪除權限並清除設定

危險操作

下面的指令會刪除 macOS 已經授予 DockSpark 的權限,並清除應用程式的本機設定項目。這會導致功能受限:懸停面板、開啟指定設定檔或隱私視窗、自動讀取 Chromium 或 Firefox 設定檔目錄都可能無法繼續提供。設定檔的顯示名稱、顏色和排序也可能遺失。請只在你明確要重設時使用。之後你仍然可以在 DockSpark 中重新要求權限。

  1. 先結束 DockSpark。 從選單列或 Dock 圖示選擇「結束 DockSpark」,或在終端機中執行下面的結束指令。不要只關閉主視窗。
  2. 開啟「終端機」應用程式。 路徑是「應用程式」→「工具程式」→「終端機」。請使用 macOS 內建的「終端機」,把指令貼進去後按 Return 執行。
  3. 只執行你需要的指令。 每條指令都針對 DockSpark 的 bundle ID app.dockspark.DockSpark。不要省略這個 ID,否則可能重設其他應用程式的同類權限。

在終端機中結束 DockSpark:

範例
osascript -e 'tell application "DockSpark" to quit'

刪除輔助使用權限:

範例
/usr/bin/tccutil reset Accessibility app.dockspark.DockSpark

刪除自動化權限:

範例
/usr/bin/tccutil reset AppleEvents app.dockspark.DockSpark

刪除完全取用磁碟權限:

範例
/usr/bin/tccutil reset SystemPolicyAllFiles app.dockspark.DockSpark

清除 DockSpark 的設定項目:

範例
defaults delete app.dockspark.DockSpark
rm -f ~/Library/Preferences/app.dockspark.DockSpark.plist
rm -rf ~/Library/Application\ Support/DockSpark
rm -rf ~/Library/Containers/app.dockspark.DockSpark

如果 defaults delete 提示該偏好設定網域不存在,可以忽略,表示目前沒有可刪的設定。完成後重新開啟 DockSpark。應用程式會再次要求它仍需要的權限;你也可以回到「系統設定」裡重新開啟對應開關。恢復輔助使用後,DockSpark 可以重建 Dock 懸停監聽。