简单 · 轻量 · 支持插件 · 可自部署
PushMe 是一款专为 Android 设计的轻量级消息通知客户端，帮助你及时接收各类推送消息。
- 🔌 插件功能：支持消息插件，消息灵活二次处理
- 🏠 自部署服务：支持私有化部署，数据完全掌控
- ⚡ 轻量高效：资源占用低，后台运行稳定
- 📲 广泛兼容：支持 Android 7.0 及以上版本
- 🔔 状态监控：提供 StateChannel 通道，实时查看服务在线状态
graph TB
USER["👤 用户<br/>Web 请求"]
subgraph 远程服务
OFFICIAL["🌐 官方服务<br/>官方 API"]
SELFHOST["🏠 自建服务<br/>自建 API"]
end
subgraph 局域网
APP["📱 Android App<br/>内置 API · 转发服务"]
WIN1["💻 Windows 客户端<br/>内置 API · 转发服务"]
WIN2["💻 Windows 客户端<br/>内置 API · 转发服务"]
end
USER -->|"HTTP 请求"| OFFICIAL
USER -->|"HTTP 请求"| SELFHOST
USER -->|"局域网直接请求"| APP
USER -->|"局域网直接请求"| WIN1
APP -->|"转发消息"| WIN1
WIN1 -->|"转发消息"| WIN2
APP -.-|"TCP / WebSocket"| OFFICIAL
APP -.-|"TCP / WebSocket"| SELFHOST
WIN1 -.-|"WebSocket"| SELFHOST
style USER fill:#e74c3c,stroke:#333,color:#fff
style OFFICIAL fill:#4a90d9,stroke:#333,color:#fff
style SELFHOST fill:#7b68ee,stroke:#333,color:#fff
style APP fill:#50c878,stroke:#333,color:#fff
style WIN1 fill:#ff8c00,stroke:#333,color:#fff
style WIN2 fill:#ff8c00,stroke:#333,color:#fff
🔗 统一 API 接口：官方服务、自建服务、App API、Windows API 接口规范完全一致
📡 消息路径：
- 用户发起：用户通过 Web 请求官方 API、自建服务 API，或局域网直接请求 App/Win API
- 远程推送：消息通过 App 与官方服务/自建服务的 TCP/WebSocket 连接传输至手机
- 局域网直达：通过局域网 IP 直接调用 App API 或 Win API，消息直达设备
- 消息转发：手机可将消息转发至局域网内的 Windows 客户端
- 链式转发：Windows 客户端之间可互相转发消息
- 后台连接：App 与官方服务/自建服务保持 TCP/WebSocket 长连接；Windows 客户端可连接自建服务（WebSocket）
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
- Android 版本：7.0 及以上
| 平台 | 下载地址 |
|---|---|
| GitHub | 点击下载最新版本 |
| Gitee（国内） | 点击下载最新版本 |
详细的 API 接口参数说明，请访问官方网站：
通过 HTTP 请求即可发送消息，GET 或 POST 均可：
# GET
https://push.i-i.me/?push_key=你的KEY&title=标题&content=内容
# POST
curl -d "push_key=你的KEY&title=标题&content=内容" https://push.i-i.me/返回值为 success 表示发送成功，否则为失败原因。
PushMe 支持两种密钥，二选一（使用 temp_key 时无需传 push_key）：
| 密钥 | 说明 |
|---|---|
push_key |
永久推送密钥，在 App 内获取，日常使用 |
temp_key |
临时推送密钥，在 App 内获取，时效短 |
✅ 官方服务与自建服务均支持
push_key和temp_key（自建服务可在 Web 管理界面的 PushKey 页面配置）。
消息类型分为通知消息与数据消息两大类：
| 类别 | 类型 | 是否发出通知 | 用途 |
|---|---|---|---|
| 通知消息 | text markdown html url |
✅ 会 | 告警、提醒、任务通知等需及时感知的消息 |
| 数据消息 | data markdata chart echarts svg note |
❌ 不会 | 手机端数据小屏，展示实时数值、图表、仪表盘 |
⚠️ 注意：数据消息不会发出状态栏通知，仅用于数据展示。若需提醒用户，请使用通知消息类型。
接口兼容企业微信、钉钉、飞书群机器人格式，直接替换 URL 即可迁移，无需改动代码。
本仓库提供开箱即用的 AI Agent 技能，让 AI 助手直接帮你编写、调试 PushMe 推送代码：
| 技能 | 目录 | 说明 |
|---|---|---|
| 发送消息 | skill/pushme-send-message |
完整的接口用法、密钥说明、消息类型选择指引与排查手册 |
技能遵循 Agent Skills 规范（SKILL.md）。将 skill/pushme-send-message 复制到你的技能目录即可使用，例如：
# WorkBuddy / 通用项目级技能目录
cp -r skill/pushme-send-message .workbuddy-ai/skills/
# Claude Code
cp -r skill/pushme-send-message .claude/skills/💡 技能内置了「通知消息 vs 数据消息」的判断规则——数据消息不弹通知，选错会导致消息静默无提示。
⚠️ 重要提示：由于 Android 系统对后台应用的严格管理，为确保消息能及时送达，请按照以下步骤配置应用权限。
在 PushMe 应用中，进入 权限设置 页面，可快速跳转至相关设置项。
- ✅ 自启动权限：允许应用开机自启
- ✅ 后台运行权限：允许应用在后台持续运行
- ✅ 通知权限：允许发送和显示通知
- ✅ 电池优化豁免：设置为"允许后台高耗电"（实际功耗很低）
- 🔔 必须开启 闹钟（Alarm）权限
- 📌 在多任务页面长按 PushMe，选择"锁定"或点击锁图标
- 锁定后可安全清理其他后台应用
- 🌐 部分机型需关闭"后台网络优化"或"智能网络加速"
- 防止系统在息屏后切断网络连接
问题：睡眠模式会导致后台被杀
解决方案：
设置 → 电池管理 → 更多设置 → 睡眠模式 → 关闭
注意事项：
⚠️ 关闭睡眠模式后，夜间其他应用（如微信、今日头条）可能会增加耗电- 建议权衡消息及时性与电量消耗
解决方案：
1. 打开多任务页面
2. 长按 PushMe 应用卡片
3. 点击"锁定"按钮（锁图标）
4. 锁定后即可正常清理其他应用
现状：经实测，HarmonyOS 2 无法保证应用稳定后台运行
建议：
- 尝试上述所有权限设置
- 如仍无法解决，可能需要考虑升级系统或使用其他设备
其他品牌系统暂未进行详细测试，欢迎反馈遇到的问题。
通用建议：
- 给予应用最大权限（自启动、后台运行、通知）
- 关闭电池优化
- 在多任务页面锁定应用
- 关闭后台网络优化
-
完成上述权限设置
-
开启 StateChannel 通知
- 位置：PushMe 左上角设置菜单
- 作用：实时监控服务连接状态
- 如不需要可在设置中关闭
-
清理后台时的正确操作
- 完成权限设置和多任务锁定后
- 可以安全地从多任务页面划掉 PushMe
- 服务会继续在后台运行
-
🌐 官方网站：https://push.i-i.me/
-
📢 Telegram 频道：https://t.me/pushme_channel
-
💬 问题反馈：GitHub Issues
-
💬 微信交流群：
Q: 为什么收不到消息推送？
A: 请检查是否完成了所有权限设置，特别是电池优化和多任务锁定。
Q: 应用耗电严重吗？
A: 实际测试显示功耗很低，"允许后台高耗电"只是防止系统杀进程的设置，并非真的耗电。
Q: 可以自己部署服务端吗？
A: 可以，PushMe 支持私有化部署，具体方法请参考官网文档。
Made with ❤️ by yafoo