| name | bark-cli |
| description | 通过 bark-cli 发送推送通知。当用户要求发送通知、推送消息、提醒、告警到 iOS 设备时使用。触发词：发送推送、推送通知、发通知、提醒我、bark、iOS 通知。 |
bark-cli Push Skill
通过 bark-cli 向 iOS 设备发送推送通知。前提：用户已配置好 bark 实例（bark-cli server add），本 skill 只负责推送，不涉及实例管理。
前置检查
推送前执行 bark-cli server list 确认已有可用实例。若无实例，提示用户先运行 bark-cli server add <name> --device-token <token> 配置。
基本推送
bark-cli push "消息内容"
完整参数
bark-cli push [body] \
-t "标题" \
-s "副标题" \
-b "正文" \
--level critical \
--group "分组名" \
--sound "1107" \
--volume 7 \
--badge 1 \
--url "https://example.com" \
--icon "https://example.com/icon.png" \
--copy "复制内容" \
--archive \
--call \
--server <实例名>
| 参数 | 说明 | 示例 |
|---|
body（位置参数） | 通知正文 | "消息内容" |
-t / --title | 标题 | "会议提醒" |
-s / --subtitle | 副标题 | "3楼会议室" |
-b / --body | 正文（与位置参数二选一） | "内容" |
--level | 通知级别：critical（紧急）、active（活跃）、timeSensitive（时效）、passive（静默） | critical |
--sound | 提示音名称 | "1107"、"alarm"、""（静音） |
--volume | 音量 0-10 | 7 |
--badge | App 角标数字 | 1 |
--group | 通知分组（相同分组可折叠） | "work" |
--url | 点击通知跳转的 URL | "https://..." |
--icon | 通知图标 URL | "https://..." |
--copy | 复制到剪贴板的内容 | "订单号: 12345" |
--archive | 保存到 Bark 通知历史 | — |
--call | 持续响铃 30 秒 | — |
--server | 指定目标实例 | ipad |
--json | JSON 格式传参 | 见下方 |
JSON 参数
需要复杂参数时使用 JSON：
bark-cli push --json '{"title":"告警","body":"CPU 使用率 95%","level":"critical","group":"monitor","sound":"alarm"}'
指定实例
多实例时用 --server 指定目标：
bark-cli push --server iphone "发到 iPhone"
bark-cli push --server ipad "发到 iPad"
不指定时使用默认实例。
输出格式
bark-cli push --format json "消息"
bark-cli push --format jsonl "消息"
使用规范
- 推送前确认有可用实例（
bark-cli server list），无实例时提示用户配置，不要自行执行 server add
- 不要执行
server add、server remove、server use、chat、mcp 等管理命令
--level critical 仅用于真正紧急的场景（告警、紧急通知）- 使用
--group 对同类通知分组，避免通知刷屏
- 消息内容简洁明确，标题控制在 20 字以内
