RemoteMapper-ESP32/ROADMAP.md

🗺️ RemoteMapper-ESP32 路线规划与功能规划 (Roadmap)

本文档汇总了社区用户的需求反馈、已落地实现的功能以及项目后续的演进规划。

---

✅ 已完成落地功能 (Completed)

1. 局域网网络唤醒 (Wake-on-LAN / WOL)

• 关联需求：Issue #1 (添加WOL功能的建议)
• 实现版本：master / v1.2+
• 功能特性：
  • 在按键映射引擎中新增 ACTION_WOL (11) 动作模式。
  • 支持将任意按键的单击、长按或双击配置为唤醒目标电脑。
  • 自动向局域网广播标准 WOL Magic Packet（6 * 0xFF + 16 * 目标MAC）。
  • 支持灵活的 MAC 输入格式（AA:BB:CC:DD:EE:FF、AA-BB-CC-DD-EE-FF、连续 12 位十六进制）。
  • WebUI 内置“发送测试唤醒包”快捷调试按钮及持久化存储。

2. 遥控器电池电量显示与低电量提醒

• 关联需求：Issue #5 (是否有办法在配置页面补全充电提醒和电量提示)
• 实现版本：master / v1.2+
• 功能特性：
  • 自动发现并解析 BLE 标准电池服务（UUID 0x180F，特征 0x2A19）。
  • 连接建立时主动采集电量，并支持 Notification 订阅与 30 分钟低频保底轮询。
  • WebUI 顶部状态栏与蓝牙详情面板实时展示精确电量（🔋 85%），离线与低电量自适应状态指示。
  • 板载硬件级提醒：当遥控器电量 <= 15% 时，板载 RGB LED 会在正常连接状态下以 2 秒为周期执行白灯双脉冲闪烁（Double-pulse White Blink），提醒用户及时更换电池。

---

📌 近期与中远期规划 (Planned / Future)

1. 高级扩展模块落地

Web 控制台映射弹窗已完成“高级扩展”架构设计与交互占位符：

• 按键宏序列 (Key Macro Sequences)：支持单个按键触发一连串按键或文本输入（带毫秒级延时可调）。
• HTTP Webhook 网络请求：支持按键触发向局域网/互联网 REST API 发送 GET/POST 请求，深度联动智能家居、家庭服务器（如 Home Assistant、Node-RED）。
• MQTT 物联网推送：支持按键触发向指定 MQTT Broker 发送自定义 Topic 与 Payload。

2. 硬件与生态兼容性扩展

• 更多型号蓝牙遥控器适配：除小米蓝牙语音遥控器 2 Pro (RC003) 外，逐步适配常见的小米电视盒子系列及第三方标准 BLE 遥控器。
• Web 蓝牙直连/本地辅助工具：在免 Wi-Fi 模式下，探索基于 WebSerial / WebHID 直接在浏览器端免网配按键。

---

💡 欢迎贡献

如果你有兴趣实现上述规划，或有新的功能建议，欢迎提交 PR 或在 GitHub Issues 中发起讨论！