cicbyte 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 "消息" # JSON 输出
bark-cli push --format jsonl "消息" # JSONL 输出
使用规范
- 推送前确认有可用实例（
bark-cli server list），无实例时提示用户配置，不要自行执行server add - 不要执行
server add、server remove、server use、chat、mcp等管理命令 --level critical仅用于真正紧急的场景（告警、紧急通知）- 使用
--group对同类通知分组，避免通知刷屏 - 消息内容简洁明确，标题控制在 20 字以内