Bark 推送通知

Polar Sponsor
爱发电 赞助
.NET 9.0

iOS 上最好的免费通知工具,没有之一。通过 Bark 向 iPhone 发送自定义推送通知的技能。支持官方云服务(api.day.app)与自托管 bark-server,覆盖标题/副标题/分组/声音/图标/URL跳转/时效性/紧急警报/归档等全部参数,并提供开箱即用的 Python 与 Bash 发送脚本,纯标准库零依赖。

Bark 推送通知 (bark-push)

功能概述

Bark 推送通知 (bark-push)是一项面向实际任务的技能,主要用于Overview;Bark 是一款免费、轻量、注重隐私的 iOS 推送工具,依赖苹果 APNs,及时稳定、不耗电;

核心要点

  • 本技能让你在 WorkBuddy 中一键向自己的 iPhone 发送自定义推送通知——适用于脚本完成提醒、服务器/任务告警、定时播报、CI 结果通知等场景;
  • 核心能力:;
  • 支持 官方云服务 https://api.day.app 与。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

Bark 推送通知 (bark-push)

Overview

Bark 是一款免费、轻量、注重隐私的 iOS 推送工具,依赖苹果 APNs,及时稳定、不耗电。本技能让你在 WorkBuddy 中一键向自己的 iPhone 发送自定义推送通知——适用于脚本完成提醒、服务器/任务告警、定时播报、CI 结果通知等场景。

核心能力:

  • 支持 官方云服务 https://api.day.app 与 自托管 bark-server
  • 覆盖 Bark 全部 API 参数(标题、副标题、分组、声音、图标、URL 跳转、时效性、紧急警报、归档、TTL、角标、复制等)
  • 提供 Python / Bash 双脚本,纯标准库实现,零依赖,开箱即用
  • 同时支持 GET(V1)与 POST JSON(V2)两种调用方式

触发场景

用户表达 触发方式
"用 Bark 给我发个通知" / "bark push ..." 直接触发
"脚本跑完提醒我一下" / "任务结束推送到手机" 触发,使用本技能发送
"服务器告警发到 iPhone" / "CI 结果通知我" 触发
"send bark / 推送一下" 直接触发

前置准备:获取 Device Key

  1. App Store 安装 Bark(搜索 "Bark - 自定义通知",或访问 bark.day.app)。
  2. 打开 App,复制首页的测试 URL,形如:
    https://api.day.app/你的KEY/这里是标题/这里是内容
    
  3. 其中的 你的KEY 即 device_key(也可在 App 内「注册设备」生成自托管用的 key)。
  4. 建议将 key 存入环境变量 BARK_KEY,自托管时把服务器地址存入 BARK_SERVER。

快速开始(推荐用脚本)

# 设置 key(或写入 ~/.zshrc / ~/.bashrc 持久化)
export BARK_KEY="你的KEY"

# 最简:发一条通知(标题 + 内容)
python3 scripts/bark_push.py "服务器备份完成 ✅" "定时任务"

# 进阶:分组 + 声音 + 点击跳转
python3 scripts/bark_push.py "新订单 #12345" "订单提醒" 
  --group orders --sound bell --url https://shop.example.com/order/12345

# 紧急警报(忽略静音/勿扰,持续响铃 30 秒)
python3 scripts/bark_push.py "机房温度超标!" "告警" --level critical --call

# 自托管服务器
BARK_SERVER="https://bark.your.domain" python3 scripts/bark_push.py "hello" "self-hosted"

Bash 版本(适合塞进 shell 脚本 / crontab):

export BARK_KEY="你的KEY"
bash scripts/bark_push.sh "部署完成" "CI" -g deploy -u https://ci.example.com

API 参数速查

参数 说明 取值 / 示例
body 推送内容(必填) 文本,n 换行
title 标题(字号大于 body) 文本
subtitle 副标题 文本
group 分组名,按组查看 任意字符串
sound 提示音 alarm / bell / minuet 等
icon 自定义图标 URL(iOS 15+) 图片 URL
url 点击通知跳转的 URL https://...
level 通知级别 active / timeSensitive / passive / critical
badge App 角标数字 整数
copy 长按复制的内容 文本
autoCopy 自动复制 body 到剪贴板 1
call 响铃 30 秒(call 模式) 1
isArchive 是否归档 1
ttl 归档存活秒数(过期自动删) 整数
volume 紧急警报音量 0–10 字符串数字
action 设为 none 点击无动作 none
ciphertext 加密推送密文 见 Bark 加密文档

完整参数表、类型与默认值见 references/api.md。

原生调用(不依赖脚本)

V2 REST(推荐,自托管首选)

curl -X POST "https://api.day.app/push" 
  -H 'Content-Type: application/json' 
  -d '{"device_key":"你的KEY","title":"标题","body":"内容","group":"g1","sound":"minuet"}'

V1 URL(官方云简单场景)

https://api.day.app/KEY/标题/内容?group=g1&sound=bell&url=https://example.com

响应

{ "code": 200, "message": "success", "timestamp": 1690000000 }

code == 200 即成功;非 200 时 message 含错误原因。

自托管 bark-server(可选)

docker run -dt --name bark -p 8080:8080 -v $PWD/bark-data:/data finab/bark-server
curl "http://127.0.0.1:8080/ping"   # 返回 pong 即正常

随后把 BARK_SERVER 指向 http://你的域名:8080 或反代到 HTTPS 域名即可。

注意事项

  • 官方云服务 api.day.app 由作者免费运营(承诺至 2031.7);敏感内容建议自托管或启用加密推送。
  • 不要把 device_key 提交到公开仓库,用环境变量管理。
  • critical 级别会忽略静音/勿扰,谨慎使用以免打扰。
  • 脚本统一从环境变量 BARK_KEY / BARK_SERVER 读取默认值,也可通过 --key / --server 覆盖。

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

0

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

0

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习