OpenStrap Edge自动化指南:用iOS Shortcuts和Tasker让手环隔空振动
OpenStrap Edge自动化指南:用iOS Shortcuts和Tasker让手环隔空振动
OpenStrap Edge 是一款开源健康应用,让你摆脱订阅、继续使用自己的健康手环,支持锻炼追踪、睡眠、恢复与 Strain 等数据。本指南带你解锁它的自动化能力:在 Android 上用 Tasker 发送一条广播 Intent,就能让手环隔空振动;在 iOS 上则可用 Shortcuts 免开 App 静默同步数据。全程无需写代码,几分钟即可配好。
两个平台能做什么,先看懂这张表
Edge 的自动化能力由平台机制决定,两侧并不对等,先认清边界再动手:
| 能力 | Android (Tasker) | iOS (Shortcuts) |
|---|---|---|
| 外部触发手环振动 | ✅ 广播 BUZZ_STRAP Intent |
❌ 不支持 |
| 同步手环数据 | ✅ 应用内自动同步 | ✅ Sync Data 快捷指令 |
| 同步完成后触发自动化 | ✅ 收到 SYNC_COMPLETE 广播 |
❌ Apple 未开放此机制 |
💡 iOS 的限制来自系统本身:Shortcuts 个人自动化只能由 Apple 固定的系统事件触发,应用无法注册新的触发器。因此 iOS 上你能"调用" App,但不能被 App 的事件"调用"。
设置入口在 App 内的 Settings → Automation 页面(源码见 settings.dart),下面分平台讲解。
Android:Tasker 让手环隔空振动的完整步骤
第 1 步:拿到广播 Action 和 automation token
打开 Edge 的 Settings → Automation,你会看到两样东西:
- 广播 Action:
wtf.openstrap.openstrap_edge.BUZZ_STRAP(长按可复制) - automation token:一个每次安装独立生成的密钥(长按可复制)
token 是安全核心:广播不带 token 或 token 不匹配时会被静默丢弃,手机上任何其他应用都没法替你振动手环。
第 2 步:创建 Tasker 的 Send Intent 动作
在 Tasker 中新建 Task,添加动作 System → Send Intent,按下表填写:
| 字段 | 填写值 |
|---|---|
| Action | wtf.openstrap.openstrap_edge.BUZZ_STRAP |
| Package | wtf.openstrap.openstrap_edge |
| Extra | token:你的AUTOMATION_TOKEN |
| Target | Broadcast Receiver |
⚠️ Tasker 表单容易踩的 4 个坑:
- Action 填在最上方的 Action 字段,不要填进 Package 或 Extra;
- Package 只填应用包名
wtf.openstrap.openstrap_edge,而不是完整 Action 字符串。此字段必须设置——App 会拒绝未明确指定目标包的广播; - Extra 用
key:value格式,token 必须完整写成token:你的TOKEN(冒号后粘贴)。缺少token:键时 App 永远看不到 token,直接拒振; - Target 必须选 Broadcast Receiver(在 Package 下方往下滚动才能看到),选 Activity 或 Service 都到不了 App。
然后把 Task 挂到任意 Profile(来电、定时器、地理围栏、时间……),触发时手环就会振动。
第 3 步(可选):用 pattern 参数挑选振动节奏
再加一个 Extra 即可换振动模式:
pattern:1
这是一个整数参数,缺省时默认 2(快速双振)。pattern:1 会一直振动直到你轻触手环确认,非常适合当"来电提醒"用。完整模式列表见 BUZZ_MEANINGS.md:
| pattern | 效果 |
|---|---|
0 |
短促振动一次 |
1 |
持续振动,直至轻触手环确认 |
2 |
快速双振(默认) |
接收端的校验逻辑(包名校验 → token 比对 → 1.5 秒限频 → 分发振动)实现在 TaskerReceiver.kt 中,如果 App 当时已被杀死,振动请求会排队持久化,等重连后补发。
反向通道:同步完成时让 Edge 唤醒 Tasker
当一次手环数据卸载(offload)完成时,App 会发出广播 wtf.openstrap.openstrap_edge.SYNC_COMPLETE,携带两个 Extra:
records(int):本次同步入库的记录条数at(int):完成时刻的 unix 秒数
用 Tasker Profile → Event → System → Intent Received 匹配该 Action 即可捕获(Package 留空)。事件限频为每分钟一次,重连风暴不会刷屏。
官方明确说明:这个广播不携带 token,也不携带任何 readiness、recovery、strain、sleep 数值——缺失的数字一旦离开 App 就会被误读成"得分为 0",所以只同步"同步本身的事实"。详见 TASKER_INTEGRATION.md。
iOS:用 Shortcuts 免开 App 同步手环
添加 Edge 快捷指令
iOS 16 及以上,打开"快捷指令"App,搜索并添加 Edge → Sync Data 动作。前提:已在 Edge 中配对手环并允许蓝牙。该动作会在后台完成同步,全程不打开 App。
一个实用选项是 Ignore Connectivity Errors(默认关):蓝牙关闭或手环超出范围时,返回 Skipped: 结果而不是报错,适合放进自动化里避免打扰;配对、权限等其他错误仍会正常报告。
配置时间触发:让同步自动发生
在快捷指令中选择 Time of Day(时间) 触发器,并开启 Run Immediately(立即运行)。一天设多个触发点 = 多次同步机会——但没有任何触发器能保证手环当时在范围内。
注意单次要预留约 25 秒(含 App 启动时间);积压数据较大时可能需要跑多次,或手动打开 Edge 补同步。
各结果含义:
- Band data synchronized:传输完成,已开始轻处理
- Sync is incomplete:超时或传输中断,已存数据保留,重跑即可
- A sync request is already active:另一同步正占用手环,未启动新同步
- Skipped:蓝牙不可用或手环不可达(仅在开启上述选项时)
iOS 27:长时间同步与 Siri 直达
iOS 27 + Xcode 27 构建的版本额外提供 Sync Data (Long Running):同样的同步逻辑,但 iOS 给予更长的后台执行时间(Edge 封顶 10 分钟),并带系统级 Live Activity 进度条和停止按钮。
Edge 还注册了零配置 Siri 短语,可直接说"Hey Siri, Sync data in OpenStrap Edge"。全部 Intent(Check Readiness、Check Strain、Check Sleep、Get Today's Numbers、Start Breathing Session 等)定义在 OpenStrapIntents.swift 中,桥接层见 ShortcutSyncBridge.swift。
常见问题排查
| 现象 | 原因与解决 |
|---|---|
| 广播发了但手环不振 | 依次检查:Target 是否 Broadcast Receiver、Package 是否已设、token 是否完整带 token: 前缀。logcat 过滤 TaskerReceiver 可看到拒绝原因 |
| Tasker 循环里振动"断断续续" | 正常:接收端限频约 1.5 秒一次,紧密循环不会每次都振 |
| App 被杀死后振动"迟到" | 正常:请求已排队,重连后自动补发 |
iOS 上想用 SYNC_COMPLETE 触发自动化 |
系统不支持,Apple 未开放 App 自定义触发器,属平台限制而非设置问题 |
参考资料
- Tasker 完整集成文档:guides/TASKER_INTEGRATION.md
- iOS Shortcuts 同步文档:guides/IOS_SHORTCUTS.md
- 振动模式含义:guides/BUZZ_MEANINGS.md
- 自动化设置页源码:lib/ui2/profile/settings.dart
- Token 桥接层:lib/platform/tasker_bridge.dart
配好之后,打电话来手环替你"响铃"、手环数据落地时自动通知 Tasker——这就是订阅之外,开源带来的自由。
