Xiaomi Plug V3 Electricity Calculator (小米插座V3电量统计)

这是一个基于 Flask 和 mijiaAPI 的 Web 应用程序，专为小米智能插座 V3 (cuco.plug.v3) 设计。它可以帮助你方便地统计指定日期范围内的用电量，并根据设定的电价计算总电费。

界面截图

主界面 (Main Interface)

登入界面 (Login Screen)

功能特点

• 扫码登录: 支持直接在网页端通过米家 APP 扫码登录小米账号。
• 设备过滤: 自动获取并筛选账号下的小米插座 V3 设备。
• 电量统计: 查询指定日期范围内的每日用电量。
• 电费计算: 输入电单价，自动计算总电费。
• 可视化展示: 清晰的表格展示每日详细数据。

安装与运行

前置要求

• Python 3.8+
• 米家 APP (用于扫码登录)

1. 克隆项目

git clone <repository-url>
cd <repository-directory>

2. 安装依赖

pip install flask requests mijiaAPI

注意: 本项目依赖 mijiaAPI 库。如果 pip install mijiaAPI 无法安装，请参考该库的官方文档或手动安装。

3. 运行应用

python app.py

4. 使用

1. 打开浏览器访问 http://127.0.0.1:5000。
2. 如果是首次使用，页面会弹出二维码，请使用米家 APP 扫码登录。
3. 登录成功后，在下拉框中选择你的插座设备。
4. 选择开始日期和结束日期。
5. 输入你的电单价（元/kWh）。
6. 点击“查询电量”按钮查看结果。

注意事项

• 数据延迟: 小米云端的电量数据通常不是实时的，建议查询“昨天”及以前的数据以获得准确结果。
• 安全性: 登录凭证保存在本地 ~/.config/mijia-api/auth.json (或类似路径)，请勿在公共计算机上使用。

致谢

• 感谢 mijia-api 项目提供的 API 支持。

许可证

MIT License