🔔 智能 Bark 推送助手,为您提供便捷、灵活的消息推送服务。
自动识别您发送的内容类型,以最优方式推送:
image 参数)
url 参数)
body 参数)
--user alice
--user alice,bob,charlie
--user all
通过 JSON 配置文件管理默认推送参数:
用户指定的参数优先于默认配置。
根据操作结果返回清晰的信息:
首次使用前,创建配置文件 config.json:
{
"default_push_url": "https://api.day.app",
"ciphertext": "",
"users": {
"alice": "your_device_key_1",
"bob": "your_device_key_2"
},
"defaults": {
"level": "active",
"volume": 10,
"badge": 1,
"sound": "bell",
"icon": "",
"group": "default",
"call": false,
"autoCopy": false,
"copy": "",
"isArchive": true,
"action": ""
},
"groups": ["work", "personal", "urgent"],
"history_limit": 100,
"enable_update": true
}
# 推送简单文本消息
bark-push --user alice --content "Hello, World!"
# 推送带标题的消息
bark-push --user alice --title "重要通知" --content "会议将在10分钟后开始"
# 推送图片
bark-push --user bob --content "https://example.com/photo.jpg"
# 推送给多个用户
bark-push --user alice,bob --title "团队通知" --content "项目已上线"
# 推送给所有用户
bark-push --user all --title "系统公告" --content "服务器维护通知"
# 指定消息级别
bark-push --user alice --content "紧急事件" --level critical
# 指定分组
bark-push --user alice --content "工作提醒" --group work
# 更新已推送的消息
bark-push --update abc123 --user alice --content "会议时间改为15分钟后"
# 删除已推送的消息
bark-push --delete abc123 --user alice
# 查看历史记录
bark-push --list-history --history-limit 20
# 查看用户列表
bark-push --list-users
# 查看帮助信息
bark-push --help-skill
| 参数 | 说明 | 示例 |
|------|------|------|
| --config | 配置文件路径 | --config ./config.json |
| --user, -u | 指定推送用户(别名或 device_key) | --user alice |
| --title, -t | 消息标题 | --title "重要通知" |
| --subtitle | 消息副标题 | --subtitle "10分钟后" |
| --content, -c | 消息内容 | --content "消息内容" |
| --group | 指定分组 | --group work |
| --help-skill | 显示帮助信息 | --help-skill |
| 参数 | 说明 | 取值范围 |
|------|------|----------|
| --level | 消息级别 | passive, active, time-sensitive, critical |
| --volume | 音量 | 0-10 |
| --badge | 角标数字 | 整数 |
| --sound | 通知声音 | bell, chime, glass 等 |
| --icon | 图标 URL | 完整的 HTTPS URL |
| --call | 是否呼叫 | 1/0/true/false |
| --autoCopy | 自动复制 | 1/0/true/false |
| --copy | 复制内容 | 字符串 |
| --isArchive | 自动归档 | 1/0/true/false |
| --action | 自定义动作 | JSON 字符串 |
| --ciphertext | 加密密文 | 字符串 |
| 参数 | 说明 | 示例 |
|------|------|------|
| --update | 更新已推送的消息 | --update abc123 |
| --delete | 删除已推送的消息 | --delete abc123 |
| --list-users | 列出所有用户 | --list-users |
| --list-groups | 列出所有分组 | --list-groups |
| --list-history | 列出历史记录 | --list-history --history-limit 20 |
| --history-limit | 历史列表条数 | --history-limit 20 |
在 config.json 的 users 字段中配置用户别名:
{
"users": {
"alice": "device_key_alice_123",
"bob": "device_key_bob_456",
"charlie": "device_key_charlie_789"
}
}
在 config.json 的 defaults 字段中配置默认推送参数:
{
"defaults": {
"level": "active",
"volume": 10,
"badge": 1,
"sound": "bell",
"group": "default"
}
}
在 config.json 的 groups 字段中定义可用分组:
{
"groups": ["work", "personal", "urgent", "family"]
}
在 config.json 的 history_limit 字段中设置历史记录保存数量:
{
"history_limit": 100
}
{
"ciphertext": "your_encryption_key"
}
bark-push --user alice --content "别忘了下午3点的会议"
bark-push --user all --title "服务器告警" --content "CPU使用率超过90%" --level critical --sound alarm
bark-push --user alice,bob,charlie --title "项目进度" --content "前端开发已完成,请开始测试" --group work
bark-push --user bob --content "https://example.com/screenshot.png"
# 首次推送
bark-push --user alice --content "会议将在10分钟后开始"
# 返回推送 ID:abc123
# 更新消息
bark-push --update abc123 --user alice --content "会议时间改为15分钟后"
如果提示配置文件不存在,请在当前目录或 ~/.bark-push/ 目录下创建 config.json 文件。
如果提示用户不存在,使用 --list-users 命令查看可用用户列表,并在 config.json 中添加用户配置。
确保 ~/.bark-push/ 目录具有写入权限,历史记录文件会自动创建。
如果配置了 ciphertext,所有推送将使用加密方式发送:
{
"ciphertext": "your_encryption_key"
}
支持 Bark 的自定义动作功能,可以在通知中添加交互按钮:
bark-push --user alice --content "是否同意?" --action '{"action":"confirm","text":"同意"}'
使用脚本批量推送消息:
#!/bin/bash
for user in alice bob charlie; do
bark-push --user $user --content "批量通知消息"
done
欢迎提交问题和改进建议!
MIT License
共 1 个版本