指南适用 2.1.2macOS · Windows核验 2026-08-09

安装 Agent Island 并通过首次启动

这是五分钟的初始设置。做完之后,灵动岛在菜单栏或托盘里,通知已授权,你的第一个编码会话会出现在里面

开始之前

  • 一台 macOS 13 及以上的 Mac,或者 Windows 10/11 的 PC
  • 至少装好并跑过一次某个 AI 编码工具

1. 装上它

macOS —— Homebrew:

brew install tristan666666/tap/agentisland

Windows —— WinGet:

winget install TristanTang.AgentIsland

也可以直接从 最新发布页下载 DMG 或 x64 压缩包

你应该看到:启动一两秒内,灵动岛出现在菜单栏(macOS)或系统托盘(Windows)

2. 越过首次启动提示

这个 App 是 ad-hoc 签名而不是花钱买的开发者签名,所以 macOS 可能拒绝第一次打开。Homebrew 会替你清掉隔离标记,手动装 DMG 则不一定:

xattr -dr com.apple.quarantine /Applications/AgentIsland.app

Windows 上,右键下载好的压缩包 → 属性 → 勾选解除锁定,再解压

你应该看到:下次打开一切正常

3. 授权通知,只需一次

首次运行时接受权限请求。Agent Island 只申请提醒权限,不申请辅助功能,也不申请屏幕录制

你应该看到:系统设置的通知列表里出现 Agent Island,并且是允许状态

4. 让它自己找到你的 Agent

不需要配置。它读的是各家编码工具本来就写在本地的会话记录,你登录过哪家就自动认出哪家

Agent Island 紧凑灵动岛显示两个服务槽位
紧凑灵动岛带两个服务槽位,各自显示百分比与重置倒计时
你应该看到:你那家服务的百分比与重置倒计时出现在灵动岛上

5. 打开开机自启

设置 → 通用,打开登录时启动,以后每天开机灵动岛都在,不用你想着它

你应该看到:重启之后 Agent Island 仍在运行

如果没成功

macOS 上打不开

那是隔离标记,不是下载损坏。执行第 2 步,注意 -r 不能省——嵌套的更新器包也需要它

灵动岛里什么都没有

没有检测到登录就没有对应行。先登录至少一家编码工具,再等一个刷新周期

Windows 更新后托盘图标消失

App 在运行时被替换了。从开始菜单再启动一次就好

下一步:读懂灵动岛在告诉你什么

← 全部指南