开始 · 01

开始使用 bluebell

先在 iPhone 或 iPad 完成配置，再把完整配置同步到 Apple Watch。同步成功后，训练、计时和 Flow 不依赖 iPhone 保持在线。

准备

设备与系统要求

设备	最低系统	用途
iPhone / iPad	iOS / iPadOS 17	同一个 App：编辑训练参数、Flow、提醒与本机 Agent 通知偏好。
Apple Watch	watchOS 10	执行震动活动，并接收 Agent 系统通知。
Mac	macOS 14	运行 bluebell Mac，连接本机 Coding 工具。

理解架构

普通训练参数先保存为本地草稿，主页“同步”发布完整配置。iPhone Agent 通知开关会立即作用于本机，同时保存在待发布配置中。

Watch 校验并缓存配置。一次活动开始后使用不可变快照，不被中途同步改写。

它接收 bluebellctl 事件、去重、保留历史，并把允许的字段写入 CloudKit。

iPhone 配置走 WatchConnectivity，iPad 配置经 iCloud 直达 Watch；Agent 事件使用独立通道，两者都不需要 iPhone 中转。

iPhone → Watch

在 iPhone 修改设置。
提肛、倒计时与 Flow 会先保存在 iPhone 本地。iPhone Agent 通知开关会立即控制本机通知注册，不必等待同步；主页同步仍会把这一偏好写入完整配置快照。
回到首页，确认 Watch 可即时到达。
若状态没有及时变化，可点圆形双箭头刷新。刷新只重读连接状态，不会发送配置。
点击“同步”。
bluebell 同时即时发送并保存最新完整快照；只在 Watch 完成解码、校验与持久化并返回匹配回执后显示成功。
下一次活动使用新设置。
正在运行的训练、倒计时或 Flow 继续使用启动时的旧快照。

例外

最多可建立 10 条每日提醒，分别绑定提肛、震动计时或某个 Flow。新增、编辑、开关与删除提醒会自动发布完整配置；会影响提醒引用的 Flow 保存或删除也会自动发布。

点击提醒只进入安全准备页，不会在后台直接开始活动或播放震动。若 Watch 上已有活动运行，新提醒不会打断它，而是保留最后一个待处理入口。

运行边界

提肛、倒计时和 Flow 使用 watchOS 的 extended runtime 支持用户停留在 bluebell 运行页、放下手腕后熄屏继续。它们不创建 HealthKit workout，也不保存健康训练记录。

按下 Digital Crown、切换 App、系统资源限制或运行窗口到期都可能终止当前活动。bluebell 会冻结状态并取消待播放震动，不补播错过的提示。已同步过的 Watch 可以离线运行这些活动。