使用指南

让 Agent 通知直达你的 iPhone

更新于 2026 年 8 月 4 分钟读完

从 1.0.44 起,Vibe Island 可以把审批请求、Agent 提问、任务完成和警告推送 到你的 iPhone。通道用的是 Bark,一个免费开源 的 iOS 推送 App。不用注册账号,消息也不经过我们的服务器,Mac 直接发给 Bark 的推送服务。配置大概两分钟。下面每一步都写全了,群里大家踩过的坑 也都收进来了。配不通的话,答案多半在这一页。

你需要什么

Mac 上的 Vibe Island 升到 1.0.44 或更新,一台 iPhone,再从 App Store 装个免费的 Bark

先说清楚边界

这条通道只发通知。批准和回答还是回到 Mac 上做。戴 Apple Watch 的话,iOS 会自动把通知镜像过去,不用额外设置。

第 1 步:在 iPhone 上安装 Bark

App Store 装 Bark。如果 Vibe Island 的配置面板已经开着,展开 还没有 Bark App?,用相机扫码也一样。

装好第一次打开时,iOS 会问要不要允许通知,记得点允许。这一步划掉的 话,之后服务器照样收消息,手机就是不弹,而且哪里都不报错。

第 2 步:复制设备密钥

配置失败的十有八九错在这一步,所以说细一点。Bark 首页列着几条示例 URL,长这样:https://api.day.app/AbCdEfGh/...。域名后面 那段短代码就是设备密钥,Vibe Island 只要这一个东西。 首页每条示例里的这段都是同一个。

Bark App 首页的推送 URL 列表,设备密钥是每条 URL 中 api.day.app 后面的那一段
密钥在域名和第一个斜杠之间。截图来自 Bark 官方文档(MIT 许可)。

经典错误

Bark 的设置页里有一个 Device Token(设备令牌),看着比密钥 正式多了,其实是 Apple 的推送令牌。「发送测试」一直失败,八成是把 它贴进来了,先检查这里。

第 3 步:连接 Vibe Island 并发送测试

01

打开配置面板

Mac 上进 设置 > 通知,打开 通知我的 iPhone,配置面板会自己弹出来。以后想 改,点「连接」一行的配置…

02

粘贴设备密钥

服务器保持 Bark 公共服务,自建了 bark-server 的选自托管。把第 2 步的密钥贴进设备密钥

03

发送测试,然后保存

发送测试。Mac 上要出现「Bark 已接受,请 检查设备。」,iPhone 上要真的弹横幅。两个都见到了,再点 保存

值得知道

「发送测试」不走离开检测,人在 Mac 前也能收到。真实事件会走,几乎 每个人都在这里愣过一下。往下看。

什么时候会推送,什么时候保持安静

仅在离开这台 Mac 时通知默认开着。锁屏、熄屏,或者 Mac 闲置两分钟左右,算离开。所以边用电脑边盯着手机等推送,是等不来 的,这不是故障。人在桌前,刘海已经把事情摆在你眼前了,手机管的是你 不在的时候。想每条都推,把这个开关关掉就行。

通知事件里选哪些事上手机:审批请求提问已完成任务警告, 默认全开。同一个会话只占一条通知,状态变了原地更新,不会叠一摞; 处理完的还会尽量撤回。

通知默认只写哪个 Agent、哪个项目在等你。打开包含对话详情 会附上对话标题和内容片段。有用,但这些文字从此要经过推送服务器。想开 的话,先看下面的加密一节。

可选:加密通知内容

开了加密,标题和正文先在 Mac 上用 AES-256-GCM 加密再发出去,推送 服务器只经手它读不懂的密文。两台设备各配一半:

01

Mac 这一半

配置面板里打开加密通知内容,Vibe Island 会生成 Key 和 IV,用复制 Key复制 IV 拿走。

02

iPhone 这一半

在 Bark 首页(第一个 tab)往下滑,找到 推送加密,进加密设置,选 AES256GCMNoPadding,贴上 Key 和 IV,保存。

大家都找错的地方

「推送加密」在首页示例 URL 下面,不在设置 tab 里。群里一半人先去 设置里翻了一圈,你不是一个人。

开了加密,服务器还是能看到设备密钥和投递元数据。加密也不影响推送到 不到,它只管别人能不能读。

常见问题排查

发送测试一直失败,怎么贴都不对

多半是把 Bark 设置页里的 Device Token 贴进来了。它看着比密钥正式多了,但它是 Apple 的推送令牌,不是密钥。密钥在 Bark 首页的 URL 里:https://api.day.app/AbCdEfGh/... 中间的 AbCdEfGh 就是。只贴这一段,再测一次。

Mac 显示已接受,手机没动静

「已接受」只说明 Bark 服务器收下了消息,弹不弹横幅是 iPhone 的事。去 iOS 设置 > 通知 > Bark,确认「允许通知」开着。另外,如果你在 Vibe Island 开了加密、Bark 那边还没配完,手机读不了收到的内容。先把加密配完,或者暂时关掉再测。

人在 Mac 前收不到,是不是坏了

不是,默认就是这样。「仅在离开这台 Mac 时通知」默认开启,锁屏、熄屏或闲置两分钟左右才算离开。边用电脑边盯着手机不算离开。想每条都推,把这个开关关掉。

能在 iPhone 上直接批准或者回答吗

现在不能。手机只负责告诉你有事在等,操作回 Mac 上做。手机端审批要做就得认真做一个产品出来,硬塞进通知通道不如不做。

通知会到 Apple Watch 吗

会,走 iOS 标准的通知镜像:iPhone 锁屏时,通知自动转到已配对的 Watch 上。Vibe Island 这边不用配置,具体表现归 Apple 管。

开了加密之后好像收不到了

加密不影响推送发不发,所以是别的原因。最常见的是默认的离开检测在你用 Mac 时把推送压住了。如果通知到了但内容不对,是 Bark 那边没配对:必须选 AES256、GCM、NoPadding,Key 和 IV 要跟 Vibe Island 里复制的一字不差。

可以用自己的服务器吗

可以。配置面板里选「自托管」,填 bark-server 的 HTTPS 地址,纯 HTTP 不收。其他用法一样。想最严格,自托管加内容加密一起上。

一个刘海,看住所有 Agent

iPhone 推送只是 Vibe Island 的一小块。主体是刘海:它盯着你跑的每一个 编码 Agent,Claude Code、Codex、Gemini CLI 这些加起来 28 个。完成、 审批、提问收在一个面板里,点一下跳回对应会话。可以看看 多 Agent 同时监控,或者回 首页逛逛。

下载免费试用

macOS 14+ · Intel & Apple Silicon · 2 天免费试用,全部功能可用