# 權限

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

Source: https://dockspark.app/zh-TW/docs/getting-started/permissions

## 輔助使用

### 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 圖示，不讀取網頁。更偏產品說明的版本見 [隱私權](/privacy)。

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

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

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

在終端機中結束 DockSpark：

```bash
osascript -e 'tell application "DockSpark" to quit'
```

刪除輔助使用權限：

```bash
/usr/bin/tccutil reset Accessibility app.dockspark.DockSpark
```

刪除自動化權限：

```bash
/usr/bin/tccutil reset AppleEvents app.dockspark.DockSpark
```

刪除完全取用磁碟權限：

```bash
/usr/bin/tccutil reset SystemPolicyAllFiles app.dockspark.DockSpark
```

清除 DockSpark 的設定項目：

```bash
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 懸停監聽。