← 返回
AI智能 中文

barkpush

智能 Bark 推送助手,支持多用户管理、智能内容识别、历史记录追踪和消息更新功能
智能 Bark 推送助手,支持多用户管理、智能内容识别、历史记录追踪和消息更新功能
liberalchang
AI智能 clawhub v1.2.0 1 版本 99783.7 Key: 无需
★ 3
Stars
📥 1,785
下载
💾 123
安装
1
版本
#latest

概述

Bark Push Skill

🔔 智能 Bark 推送助手,为您提供便捷、灵活的消息推送服务。

功能特性

🎯 智能内容识别

自动识别您发送的内容类型,以最优方式推送:

  • 纯图片:直接推送图片 URL(使用 image 参数)
  • 纯链接:直接推送链接(使用 url 参数)
  • 纯文本:推送文本内容(使用 body 参数)
  • 混合内容:自动整理为 Markdown 格式

👥 多用户管理

  • 支持单用户推送:--user alice
  • 支持多用户推送:--user alice,bob,charlie
  • 支持全员推送:--user all
  • 使用别名简化操作,无需记忆复杂的 device_key
  • 未指定用户时智能提示可用用户列表

📝 智能标题生成

  • 用户未输入标题时,自动根据内容生成 title 和 subtitle
  • 用户指定标题时,优先使用用户提供的标题

📂 分组管理

  • 支持查询和使用 Bark 分组功能
  • 可指定消息分组或使用默认分组
  • 分组不存在时自动使用默认分组

🔄 历史记录与更新

  • 保存推送历史记录(推送 ID、用户、参数等)
  • 支持查询历史并更新已推送的消息内容
  • 支持删除已推送的消息
  • 历史记录自动管理,超过限制自动删除最旧记录

⚙️ 灵活参数配置

通过 JSON 配置文件管理默认推送参数:

  • level:消息级别(passive/active/time-sensitive/critical)
  • volume:警告通知音量(0-10)
  • badge:应用角标数字
  • sound:通知声音
  • icon:自定义图标 URL
  • call:是否呼叫
  • autoCopy:是否自动复制
  • copy:复制到剪贴板的内容
  • isArchive:是否自动归档
  • action:自定义动作

用户指定的参数优先于默认配置。

📊 智能结果反馈

根据操作结果返回清晰的信息:

  • 推送成功:显示推送 ID、成功用户列表、参数摘要、内容简要
  • 推送失败:显示失败原因、失败用户列表、参数摘要、内容简要
  • 指令错误:显示错误原因、解析的参数列表、内容简要

快速开始

配置文件

首次使用前,创建配置文件 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.jsonusers 字段中配置用户别名:

{
  "users": {
    "alice": "device_key_alice_123",
    "bob": "device_key_bob_456",
    "charlie": "device_key_charlie_789"
  }
}

默认参数配置

config.jsondefaults 字段中配置默认推送参数:

{
  "defaults": {
    "level": "active",
    "volume": 10,
    "badge": 1,
    "sound": "bell",
    "group": "default"
  }
}

分组配置

config.jsongroups 字段中定义可用分组:

{
  "groups": ["work", "personal", "urgent", "family"]
}

历史记录限制

config.jsonhistory_limit 字段中设置历史记录保存数量:

{
  "history_limit": 100
}

加密密文配置

{
  "ciphertext": "your_encryption_key"
}

使用场景

场景 1:日常提醒

bark-push --user alice --content "别忘了下午3点的会议"

场景 2:系统监控告警

bark-push --user all --title "服务器告警" --content "CPU使用率超过90%" --level critical --sound alarm

场景 3:团队协作通知

bark-push --user alice,bob,charlie --title "项目进度" --content "前端开发已完成,请开始测试" --group work

场景 4:图片分享

bark-push --user bob --content "https://example.com/screenshot.png"

场景 5:消息更新

# 首次推送
bark-push --user alice --content "会议将在10分钟后开始"
# 返回推送 ID:abc123

# 更新消息
bark-push --update abc123 --user alice --content "会议时间改为15分钟后"

故障排查

配置文件找不到

如果提示配置文件不存在,请在当前目录或 ~/.bark-push/ 目录下创建 config.json 文件。

推送失败

  1. 检查网络连接是否正常
  2. 验证 device_key 是否正确
  3. 确认 Bark 服务地址是否可访问
  4. 查看错误日志获取详细信息

用户不存在

如果提示用户不存在,使用 --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 个版本

  • v1.2.0 当前
    2026-03-28 19:00 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

content-creation

frontendslides

liberalchang
从零开始或通过转换 PowerPoint 文件,制作精美、动画丰富的 HTML 演示文稿,适用于需要构建或转换演示的场景。
★ 1 📥 839
ai-intelligence

ontology

oswalpalash
类型化知识图谱,用于结构化智能体记忆与可组合技能。支持创建/查询实体(人员、项目、任务、事件、文档)及关联...
★ 709 📥 243,539
ai-intelligence

self-improving agent

pskoett
捕获经验教训、错误和纠正,以实现持续改进。使用时机:(1)命令或操作意外失败;(2)用户纠正……
★ 4,056 📥 796,111