# 安裝

> 下載並安裝 DockSpark：官方 DMG、Homebrew，或從 0.3.2 檢查更新到 0.4.0，再把應用程式放入「應用程式」並完成首次權限。

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

## 下載 DockSpark

免費版無需註冊帳號或邀請碼，可同時啟用 1 個瀏覽器、最多 3 個具名設定檔；付費授權可擴充瀏覽器、設定檔與 Mac 數量上限。

[下載 DockSpark](/download)

## 使用 Homebrew 安裝

如果你使用 Homebrew，可透過 DockSpark 官方 tap 安裝。Homebrew 6 起需要先信任該第三方 cask，再執行安裝：

```bash
brew trust --cask dockspark/tap/dockspark && brew install --cask dockspark/tap/dockspark
```

## 從 0.3.2 更新

如果已經安裝 DockSpark 0.3.2，請在應用程式內選擇「檢查更新」，即可升級到 0.4.0。也可從選單列狀態項目或設定中開啟「檢查更新…」。

## 手動安裝應用程式

1. **下載應用程式 DMG。** 請選擇 `DockSpark-0.4.0.dmg`，不要下載 GitHub 自動產生的原始碼壓縮檔。ZIP 也可使用。
2. **開啟磁碟映像檔並移到「應用程式」。** 將 `DockSpark.app` 拖到「應用程式」。不要從唯讀的 DMG 直接執行應用程式。
3. **啟動 DockSpark。** 從「應用程式」開啟，並依首次執行時的權限提示操作。

> **系統需求**
>
> DockSpark 需要 macOS 14.0 或以上版本。

## 保持執行

關閉主視窗並不會結束 DockSpark。它會留在背景，繼續回應 Dock 懸停。需要時可從選單列或 Dock 圖示重新開啟主視窗，或選擇「結束 DockSpark」完全結束。

在「設定 → 一般」中，可以顯示或隱藏選單列圖示和 Dock 圖示。隱藏 Dock 圖示時，設定視窗會保持在前景。若兩個圖示都已隱藏，關閉視窗後請從啟動台或「應用程式」重新開啟。

首次啟動後，macOS 會要求輔助使用權限。沒有這項權限，懸停面板無法出現。部分瀏覽器操作稍後還會要求自動化權限；讀取 Chromium 或 Firefox 設定檔時，也可能需要完全取用磁碟權限。說明見 [權限](/docs/getting-started/permissions)。

請將瀏覽器圖示留在 Dock 裡。DockSpark 辨識的是游標下的 Dock 圖示，不會從啟動台或 Spotlight 附著到瀏覽器。支援的應用程式清單見 [支援的瀏覽器](/docs/reference/supported-browsers)。

官方包是已簽署、經 Apple 公證的 `DockSpark-0.4.0.dmg`，也可使用 ZIP。不要下載 GitHub 自動打包的原始碼。安裝後從「應用程式」開啟，依提示開啟「輔助使用」。之後若要控制 Safari、Google Chrome 或 Firefox，再處理「自動化」；只有更新 Chromium 或 Firefox 設定檔清單失敗時，才需要「完全取用磁碟」。