bark-notify

向手机发送 Bark 通知 的 Python 模块，覆盖全部通知类型与参数。uv 管理环境，零第三方依赖（仅标准库）。

服务器：标准 Bark 服务（Server: Bark），默认 http://47.108.226.213:10086，可用 BARK_BASE_URL 覆盖。
设备密钥：默认 pvd3kWwHNFjKXNjiC2sMe7，可用 BARK_DEVICE_KEY 覆盖。

安装

cd bark-notify
uv sync                       # 创建 .venv 并以可编辑方式安装本项目
uv run bark-notify --help     # 验证 CLI 可用

命令行用法

# 基础通知
uv run bark-notify "标题" "正文"

# 各级别（default / active / timeSensitive / critical / passive）
uv run bark-notify "紧急" "服务器告警" --level critical --sound alarm.caf --volume 10
uv run bark-notify "勿扰也提醒" "会议还有 5 分钟" --level timeSensitive
uv run bark-notify "只进通知中心" "静默内容" --level passive

# 特殊功能
uv run bark-notify "Markdown" "### 标题\n- 项1\n- 项2"          # 正文原生支持 Markdown
uv run bark-notify "分组" "第1条" --group 演示
uv run bark-notify "跳转" "点击打开百度" --url https://www.baidu.com
uv run bark-notify "复制" "长按复制此文本" --copy "OPC 云超服"
uv run bark-notify "带图" "附带图片" --image https://picsum.photos/seed/x/400/300
uv run bark-notify "角标" "数字角标" --badge 5 --ttl 60

Python API

from bark_notify import BarkClient, Level, Notification, Sound

client = BarkClient()  # 也可 BarkClient(base_url=..., device_key=...)

client.push(Notification(
    title="部署完成",
    body="**v2.4.0** 已上线 ✅",
    level=Level.ACTIVE,
    group="部署",
    url="https://example.com/status",
))

# GET 快捷方式（适合快速测试，参数走查询串）
client.notify("测试", "正文", level="critical", group="x")

参数一览

参数	CLI	说明
`title` / `body`	位置参数	标题 / 正文（正文支持 Markdown）
`level`	`--level`	`default` `active` `timeSensitive` `critical` `passive`
`sound`	`--sound`	内置铃声名或远程铃声 URL
`badge`	`--badge`	应用角标数字
`group`	`--group`	同组通知折叠
`icon`	`--icon`	通知图标 URL
`image`	`--image`	附带图片 URL
`copy`	`--copy`	长按复制的文本
`url`	`--url`	点击跳转 URL
`is_archive`	`--archive`	存入历史记录
`call`	`--call`	连续响铃（呼叫声）
`ttl`	`--ttl`	过期秒数，超时自动删除
`volume`	`--volume`	critical 通知音量 0-10

级别差异速查

级别	横幅	声音	勿扰可送达	说明
`default`	✅	✅	❌	跟随系统
`active`	✅	✅	❌	标准活跃通知
`timeSensitive`	✅	✅	✅	时效性
`critical`	✅	✅	✅	绕过静音强制响铃，需授权
`passive`	❌	❌	—	仅通知中心

内置铃声

alarm.caf alarms.caf anticipate.caf bell.caf bloom.caf calypso.caf chime.caf choir.caf complete.caf completion.caf electronic.caf emergency.caf fanfare.caf glass.caf goblin.caf healthnotification.caf horn.caf ladders.caf mario.caf minuet.caf multiwayinvitation.caf newmail.caf newsflash.caf noir.caf payment.caf shake.caf sherwoodfanfare.caf silence.caf spell.caf suspense.caf telegraph.caf tiptoes.caf typewriters.caf update.caf

环境变量

变量	默认值	说明
`BARK_BASE_URL`	`http://47.108.226.213:10086`	服务器地址
`BARK_DEVICE_KEY`	`pvd3kWwHNFjKXNjiC2sMe7`	设备密钥

README.md Unescape Escape