| 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. |