MateDroid(Andriod)

一、项目基础概述

1. 产品定位

MateDroid 是安卓原生开源客户端，专为私有化 TeslaMate 打造，仅对接开源中间层 teslamateapi（tobiasehlert/teslamateapi），不直接请求特斯拉官方 API，所有车辆数据存储在你自建硬件内，零第三方云端上传，是安卓车主专属本地数据监控工具。
开源仓库：https://github.com/vide/matedroid
配套 API 项目：https://github.com/tobiasehlert/teslamateapi

2. 数据完整流转链路

特斯拉官方 API → 自建 TeslaMate（PostgreSQL 数据库 + Mosquitto MQTT）→ TeslaMateApi 接口服务 → MateDroid 安卓 APP

3. 分发渠道与收费规则

1. 完全开源免费，无广告、无内购、无功能阉割；
   

2. 安装渠道：F-Droid 开源应用商店、GitHub Releases 手动下载 APK；
   

3. 无账号注册机制，仅填写自建服务地址 + 密钥即可连接，不收集任何个人隐私信息。

4. 核心核心优势：纯本地隐私闭环

• APP 不会向开发者服务器上传车辆定位、电池、行程、充电记录；
  

• API 访问 Token、服务地址采用安卓系统加密密钥库安全存储；
  

• 仅在访问你自己的 HTTPS 服务时传输车辆数据，其余数据缓存本地，支持离线查看历史记录。

二、MateDroid 全功能详解

（一）实时车辆总览仪表盘（首页核心）

• 3D 车辆模型自动匹配你的车身颜色、轮毂样式，APP 主题跟随车身色自适应深浅模式；
  

• 实时核心状态：剩余电量、表显 / 真实续航、内外环境温度、四轮胎压、门锁 / 后备箱 / 充电口 / 哨兵开关状态；
  

• 充电实时数据流：当前交直流功率、电池温度、充满剩余时长、峰值功率实时曲线；
  

• 车辆状态识别：休眠 / 驻车 / 行驶 / 快充 / 家充自动区分，地理围栏自动标记家、公司、超充点位；
  

• 一键远程控车：唤醒车辆、开关空调、锁解锁、启停哨兵、设置充电上限、开关充电盖板（依赖 teslamateapi 开启指令权限）。

（二）完整行程历史分析

• 单行程详情：行驶时长、总里程、平均 / 最高时速、总耗电、动能回收电量、全程海拔曲线、沿途气温记录；
  

• 彩色轨迹地图回放：路线按时速 / 能耗 / 海拔分层上色，直观区分高速、爬坡、拥堵路段耗电差异；
  

• 周期统计：日 / 周 / 月/ 年度总里程、百公里平均能耗、高低温续航衰减对比；
  

• 驾驶行为统计：急加速、高速占比、短途冷车损耗量化图表。

（三）精细化充电成本账本

• 自动区分家用交流桩、第三方快充、特斯拉超充全部充电会话；
  

• 自定义峰谷分时电价，自动计算单次、月度、年度充电花费；
  

• 完整充电曲线：电压、电流、电池温升变化，记录静置待机 “吸血鬼掉电” 损耗；
  

• 充电分类占比统计：AC 家充 / DC 快充时长、充电量饼图汇总。

（四）电池健康长期追踪（车主刚需）

• 长期记录满电可用容量、电池健康百分比、完整充放电循环次数；
  

• 多年容量衰减趋势曲线图，对比新车基准容量，直观查看电池损耗速度；
  

• 统计高温 / 低温环境对电池损耗的影响，给出充放电习惯优化参考；
  

• 记录长期静置掉电速率，判断车辆休眠是否正常。

三、适合使用人群

• 在 H618 盒子、树莓派、家用 NAS、闲置小主机私有化部署 TeslaMate 的安卓特斯拉车主；
  

• 长期关注电池健康衰减，需要精细化统计充电成本、长途能耗分析用户；
  

• 注重数据隐私，拒绝将行程、定位、电池数据交给第三方云端平台；
  

• 安卓平板、备用机专门做车辆监控大屏；
  

• 多特斯拉家庭，需要统一管理多台车辆数据；
  

• 开源爱好者，偏好无广告、完全免费无付费功能的本地客户端。

四、配置

按照开源 API 项目地址：[github.com/tobiasehl... 设置好teslamateapi。手机端设置如下：