技能介绍

告别脚本盲跑：把通知塞进 iPhone 锁屏

当你在终端里跑完一个漫长的编译任务，或者服务器监控触发了阈值告警，你往往需要立刻知道结果。传统的日志轮询或邮件通知要么滞后，要么容易被淹没。Bark 是一款基于苹果 APNs 的轻量级 iOS 推送工具，它不耗电、推送及时且注重隐私。这个技能让你能在 WorkBuddy 中，甚至直接在 shell 脚本或 crontab 里，把脚本完成提醒、CI 构建结果或定时播报精准地推送到你的 iPhone 上，无需引入笨重的消息队列或第三方 SDK。

核心机制与参数控制

本技能封装了 Bark 的全部 API 能力，既支持官方云服务 https://api.day.app，也完美兼容自托管的 bark-server。它提供了 Python 与 Bash 双版本脚本，两者均使用纯标准库实现，零依赖，开箱即用。调用方式上，你可以根据网络环境选择简单的 GET (V1) 或更灵活的 POST JSON (V2)。

在参数层面，你不仅能设置基础的 title 和 body，还能精细控制：

sound（提示音）与 group（分组管理）
url（点击跳转）与 level（通知级别如 timeSensitive 或 critical）
ttl（过期自动删除）和 badge（角标）

前置工作只需在 Bark App 中复制 Device Key，并将其存入环境变量 BARK_KEY；如果使用自托管，再配置 BARK_SERVER 即可。脚本会统一从环境变量读取默认值，也支持通过 --key 和 --server 参数临时覆盖。

适用边界与安全注意

虽然 Bark 官方云服务承诺免费运营至 2031 年，但对于包含敏感信息的告警，强烈建议部署自托管服务或启用 ciphertext 加密推送。此外，device_key 等同于你的推送凭证，切勿将其硬编码或提交到公开的 Git 仓库中。最后需要注意的是，critical 级别的通知会强制响铃并忽略 iOS 的静音与勿扰模式，请仅在最高优先级的服务器宕机等紧急场景下谨慎使用，以免打扰他人。