bark

name	bark
description	Send Bark-compatible notifications with Python standard library while keeping the device key in the private Skill data environment.
version	0.1.8

Bark Push Skill

把 Bark 兼容 HTTP API 封装为 AgentDock 原生 Skill，用于 Dock 通知。

能力

• send：发送普通 Bark 推送。
• event：发送格式化的 Dock 运行事件通知。
• health：验证 Bark server URL 与 device key 配置；live: true 会真实发送一条健康检查通知。
• url：生成兼容 GET 调用 URL，但输出中会隐藏 device key。

配置

默认连接 https://api.day.app。可设置 BARK_SERVER_URL / BARK_BASE_URL / BARK_URL，或在调用中传 server_url 指向自建 Bark server。

设备 key 只从 BARK_DEVICE_KEY / BARK_KEY / .env 读取，不接受 action input 或命令行参数。可通过 BARK_ENV_FILE 或调用参数 env_file 指定 .env 文件。

安全约束

• server_url 仅允许 http / https，禁止 URL 内嵌用户名和密码。
• 默认使用 POST /push，device key 不进入 URL。
• url 操作只生成 URL 不发送，并对 device key 做脱敏。
• 不依赖第三方 Python 包。

辅助脚本执行

Skill 本体是本说明文档。确需调用包内辅助脚本时，在 Skill 包根目录使用相对路径执行；运行宿主负责切换到包根目录并把所需变量注入当前子进程。

printf '%s' '{"skill_action":"<动作>"}' | python3 run.py

输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。

动作	用途
send	Send a Bark push notification.
event	Send a formatted Dock event notification through Bark.
health	Verify Bark configuration and optionally perform a dry or live connectivity check.
url	Build a Bark-compatible GET URL without sending it. The device key is redacted in output.