# 安装

> 下载并安装 DockSpark：官方 DMG、Homebrew，或从 0.3.2 检查更新到 0.4.0，再把应用放入「应用程序」并完成首次权限。

Source: https://dockspark.app/zh/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 notarization 的 `DockSpark-0.4.0.dmg`，也可使用 ZIP。不要下载 GitHub 自动打包的 Source code。安装后从 Applications 打开，按提示打开 Accessibility。之后若要控制 Safari、Google Chrome 或 Firefox，再处理 Automation；只有刷新 Chromium 或 Firefox 个人资料列表失败时，才需要 Full Disk Access。