如何在 Mac 上安装 Otterdock：DMG、Homebrew 或 Mac App Store

直下载版：从官网下载 .dmg，把 Otterdock 拖进「应用程序」，打开后只在想用自定义弹窗时才授予辅助功能权限；或者运行 brew install --cask savetimefor-fun/otterdock/otterdock。Mac App Store 版：在 App Store 点「获取」（仅 Apple 芯片）。然后建一个 3 到 5 项的分组，放进程序坞：直下载版点「立即同步」，商店版把分组卡片拖到程序坞废纸篓旁边。

Otterdock 有两个版本，安装方式不同，在程序坞里的行为也不同。本文从选版本开始，一直走到第一个分组出现在程序坞里，并把文件位置、权限、更新机制讲清楚，免得以后有意外。

第 0 步：选版本

两个版本都免费提供 2 个分组、每组最多 8 项，都包含小组件，分组概念完全一样。Intel Mac 只能用直下载版。更深入的对比见 直下载版与 Mac App Store 版对比。

第 1a 步：用 .dmg 安装直下载版

1. 从 下载页 下载 Otterdock.dmg。文件已用 Developer ID 证书签名并经 Apple 公证。
2. 双击 .dmg，窗口里有 Otterdock 图标和一个「应用程序」快捷方式。
3. 把 Otterdock 拖到 应用程序 上，等复制完成，再在访达边栏里点推出按钮退出镜像。
4. 从「应用程序」或聚焦打开 Otterdock。首次启动有一个简短引导帮你建第一个分组，可以跳过。

macOS 可能提示这个 App 是从互联网下载的，点「打开」即可。因为已经公证，不应出现「无法打开」的提示；如果出现，多半是下载中断，删掉重新下载，不要绕过 Gatekeeper。

第 1b 步：用 Homebrew 安装直下载版

已经在用 Homebrew 的话，一条命令从我们的公开 tap 安装同一个已签名的 App：

brew install --cask savetimefor-fun/otterdock/otterdock

Homebrew 会用公开的校验值核对下载文件，并把 Otterdock 放进「应用程序」。以后用 brew upgrade --cask otterdock 更新；cask 跟踪的是应用内更新器用的同一个发布源，两条路拿到的都是当前版本。这是我们自己维护的 tap，不是 Homebrew 主仓库收录的 cask。

第 1c 步：安装 Mac App Store 版

1. 打开 App Store 搜索「Otterdock」，或直接打开 商店页面。
2. 点 获取，再点 安装。需要时登录 Apple 账户。
3. 从启动台（macOS 26 是「应用程序」窗口）或聚焦打开 Otterdock。

商店版运行在 Apple 的沙盒里，永远不会请求辅助功能权限，因为它做的事都不需要。

第 2 步：建第一个分组

Otterdock 常驻菜单栏，点它的图标打开主窗口。

1. 点 新建分组，用一件你反复做的事命名，比如「写稿」「客户评审」。一眼能认出来的名字，比「工具」这种类别词好用。
2. 先加 3 到 5 项。用 应用程序 选已安装的 App，从程序坞 把已固定的 App 拉进来，文件 或 文件夹 选文稿和项目目录；把网页链接从浏览器地址栏拖进分组就是一个链接项。文件和文件夹也可以直接从访达拖进来。
3. 拖动调整顺序。顺序很重要：直下载版弹窗里前九项对应 Command-1 到 Command-9，小组件也按这个顺序显示。
4. 可以给分组选一个图标样式，方便在程序坞里认出来。

免费版允许 2 个分组、每组最多 8 项。在设置过程中碰到上限，才是 Pro（一次性购买）开始有意义的时候；具体变化见 免费版与 Pro 对比。

第 3 步：把分组放进程序坞

直下载版：点 立即同步。Otterdock 把分组写进程序坞的文件夹区，程序坞短暂重启一下。从此之后，每次修改分组，编辑器里会出现一个短倒计时，然后自动同步到程序坞；你不需要拖任何东西。

Mac App Store 版：把分组卡片从 Otterdock 窗口拖到 程序坞分隔线右侧、废纸篓旁边；拖动时 Otterdock 会显示「拖到程序坞以添加」的提示。落进程序坞的是 Otterdock 为这个分组生成的文件夹，以原生堆栈的形式出现。以后往分组里加项目，Otterdock 会刷新文件夹内容，堆栈自然跟上，程序坞条目本身不用重拖。拖放的细节，以及程序坞拒绝接收时怎么办，见 如何把 Otterdock 分组添加到程序坞。

第 4 步（仅直下载版）：决定是否授予辅助功能权限

第一次选择 Otterdock 的自定义弹窗或悬停模式时，macOS 会请你在 系统设置 > 隐私与安全性 > 辅助功能 里允许 Otterdock。有了这个权限，Otterdock 才能察觉你点按了它自己的程序坞图标，并用自己的弹窗取代原生堆栈。

你可以拒绝。没有这个权限，直下载版的分组就以原生堆栈打开，和商店版一样，其他一切照常：全局快捷键、小组件、程序坞同步都不依赖它。三种交互方式各需要什么，见 点击模式与悬停模式。

第 5 步：添加小组件（可选）

两个版本都有桌面和通知中心小组件。按住 Control 点桌面空白处选 编辑小组件，找到 Otterdock，把一个尺寸拖到桌面，再点 编辑小组件 选分组。小尺寸显示 4 项，中 8 项，大 12 项，每格打开一项。设置和排障见 桌面小组件指南。

东西都在哪里

• 直下载版：App 在 /Applications；分组配置、生成的分组文件夹和皮肤在 ~/Library/Application Support/Otterdock；设置在标准的偏好设置位置。
• Mac App Store 版：同样的结构，放在 ~/Library/Containers 下该 App 的沙盒容器里。
• 程序坞条目：由 macOS 存在程序坞自己的偏好设置里，和你添加的任何文件夹一样。
• 网络：直下载版的更新检查、授权或购买验证、以及可在设置里关闭的使用统计。分组内容从不离开你的 Mac。

权限、文件和网络使用的完整清单见 隐私、权限与本地数据。

更新与卸载

直下载版启动时检查更新并在应用内提供安装；Homebrew 用户也可以改用 brew upgrade --cask otterdock。商店版的更新和其他 App 一样走 App Store。

卸载直下载版：退出 Otterdock，从程序坞移除分组（拖出去，或先在编辑器里点「从程序坞移除」），把 Otterdock.app 移到废纸篓；如果不想为重装保留分组，再删掉 ~/Library/Application Support/Otterdock。Homebrew 用 brew uninstall --cask otterdock。卸载商店版就像删除任何 App Store 应用，macOS 会连同容器一起移除。