[
  {
    "path": "README.md",
    "content": "# PushMe - Android 消息通知客户端\n\n<p align=\"center\">\n  <strong>简单 · 轻量 · 支持插件 · 可自部署</strong>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/yafoo/pushme/releases/latest\">\n    <img src=\"https://img.shields.io/github/v/release/yafoo/pushme?label=Latest%20Release\" alt=\"Latest Release\">\n  </a>\n  <a href=\"https://github.com/yafoo/pushme\">\n    <img src=\"https://img.shields.io/badge/Android-7.0%2B-brightgreen\" alt=\"Android Version\">\n  </a>\n  <a href=\"https://t.me/pushme_channel\">\n    <img src=\"https://img.shields.io/badge/Telegram-Channel-blue\" alt=\"Telegram Channel\">\n  </a>\n</p>\n\n---\n\n## 📱 项目简介\n\nPushMe 是一款专为 Android 设计的轻量级消息通知客户端，帮助你及时接收各类推送消息。\n\n### ✨ 核心特性\n\n- **🔌 插件功能**：支持消息插件，消息灵活二次处理\n- **🏠 自部署服务**：支持私有化部署，数据完全掌控\n- **⚡ 轻量高效**：资源占用低，后台运行稳定\n- **📲 广泛兼容**：支持 Android 7.0 及以上版本\n- **🔔 状态监控**：提供 StateChannel 通道，实时查看服务在线状态\n\n---\n\n## 🖼️ 应用预览\n\n<table>\n  <tr>\n    <td><img src=\"./assets/1.jpg\" width=\"200\"/></td>\n    <td><img src=\"./assets/2.jpg\" width=\"200\"/></td>\n    <td><img src=\"./assets/3.jpg\" width=\"200\"/></td>\n    <td><img src=\"./assets/4.jpg\" width=\"200\"/></td>\n  </tr>\n  <tr>\n    <td><img src=\"./assets/5.jpg\" width=\"200\"/></td>\n    <td><img src=\"./assets/6.jpg\" width=\"200\"/></td>\n    <td><img src=\"./assets/7.jpg\" width=\"200\"/></td>\n    <td><img src=\"./assets/8.jpg\" width=\"200\"/></td>\n  </tr>\n  <tr>\n    <td><img src=\"./assets/9.jpg\" width=\"200\"/></td>\n    <td><img src=\"./assets/10.jpg\" width=\"200\"/></td>\n    <td><img src=\"./assets/11.jpg\" width=\"200\"/></td>\n    <td><img src=\"./assets/12.jpg\" width=\"200\"/></td>\n  </tr>\n</table>\n\n---\n\n## 📥 下载安装\n\n### 系统要求\n\n- **Android 版本**：7.0 及以上\n\n### 下载渠道\n\n| 平台 | 下载地址 |\n|------|----------|\n| GitHub | [点击下载最新版本](https://github.com/yafoo/pushme/releases/latest) |\n| Gitee（国内） | [点击下载最新版本](https://gitee.com/yafu/pushme/releases/latest) |\n\n---\n\n## 🔧 接口文档\n\n详细的 API 接口参数说明，请访问官方网站：\n\n👉 [https://push.i-i.me/](https://push.i-i.me/)\n\n---\n\n## ⚙️ 手机权限设置指南\n\n> ⚠️ **重要提示**：由于 Android 系统对后台应用的严格管理，为确保消息能及时送达，请按照以下步骤配置应用权限。\n\n### 快速设置\n\n在 PushMe 应用中，进入 **`权限设置`** 页面，可快速跳转至相关设置项。\n\n### 详细配置步骤\n\n#### 1️⃣ 基础权限配置\n\n- ✅ **自启动权限**：允许应用开机自启\n- ✅ **后台运行权限**：允许应用在后台持续运行\n- ✅ **通知权限**：允许发送和显示通知\n- ✅ **电池优化豁免**：设置为\"允许后台高耗电\"（实际功耗很低）\n\n#### 2️⃣ 系统特定配置\n\n##### Android 12 用户\n- 🔔 必须开启 **闹钟（Alarm）权限**\n\n##### 多任务锁定（推荐）\n- 📌 在多任务页面长按 PushMe，选择\"锁定\"或点击锁图标\n- 锁定后可安全清理其他后台应用\n\n##### 网络优化设置\n- 🌐 部分机型需关闭\"后台网络优化\"或\"智能网络加速\"\n- 防止系统在息屏后切断网络连接\n\n---\n\n## 📱 各品牌系统适配说明\n\n### 🟢 Vivo - OriginOS 3\n\n**问题**：睡眠模式会导致后台被杀\n\n**解决方案**：\n```\n设置 → 电池管理 → 更多设置 → 睡眠模式 → 关闭\n```\n\n**注意事项**：\n- ⚠️ 关闭睡眠模式后，夜间其他应用（如微信、今日头条）可能会增加耗电\n- 建议权衡消息及时性与电量消耗\n\n---\n\n### 🟢 Xiaomi - MIUI 14\n\n**解决方案**：\n```\n1. 打开多任务页面\n2. 长按 PushMe 应用卡片\n3. 点击\"锁定\"按钮（锁图标）\n4. 锁定后即可正常清理其他应用\n```\n\n---\n\n### 🔴 Huawei - HarmonyOS 2\n\n**现状**：经实测，HarmonyOS 2 无法保证应用稳定后台运行\n\n**建议**：\n- 尝试上述所有权限设置\n- 如仍无法解决，可能需要考虑升级系统或使用其他设备\n\n---\n\n### 📋 其他系统\n\n其他品牌系统暂未进行详细测试，欢迎反馈遇到的问题。\n\n**通用建议**：\n1. 给予应用最大权限（自启动、后台运行、通知）\n2. 关闭电池优化\n3. 在多任务页面锁定应用\n4. 关闭后台网络优化\n\n---\n\n## 💡 使用技巧\n\n### 保持服务在线的最佳实践\n\n1. **完成上述权限设置**\n2. **开启 StateChannel 通知**\n   - 位置：PushMe 左上角设置菜单\n   - 作用：实时监控服务连接状态\n   - 如不需要可在设置中关闭\n\n3. **清理后台时的正确操作**\n   - 完成权限设置和多任务锁定后\n   - 可以安全地从多任务页面划掉 PushMe\n   - 服务会继续在后台运行\n\n---\n\n## 📞 获取帮助\n\n### 官方渠道\n\n- 🌐 **官方网站**：[https://push.i-i.me/](https://push.i-i.me/)\n- 📢 **Telegram 频道**：[https://t.me/pushme_channel](https://t.me/pushme_channel)\n- 💬 **问题反馈**：[GitHub Issues](https://github.com/yafoo/pushme/issues)\n\n### 常见问题\n\n**Q: 为什么收不到消息推送？**  \nA: 请检查是否完成了所有权限设置，特别是电池优化和多任务锁定。\n\n**Q: 应用耗电严重吗？**  \nA: 实际测试显示功耗很低，\"允许后台高耗电\"只是防止系统杀进程的设置，并非真的耗电。\n\n**Q: 可以自己部署服务端吗？**  \nA: 可以，PushMe 支持私有化部署，具体方法请参考官网文档。\n\n---\n\n<p align=\"center\">\n  <sub>Made with ❤️ by <a href=\"https://github.com/yafoo\">yafoo</a></sub>\n</p>\n"
  }
]