更新日志

车辆与使用体验

  • 修正充电详情峰值电压、电流、环境温度数据异常问题。
  • 车况提醒推送时机优化。
  • 充电详情新增平均电压、平均电流。
  • 优化版本更新提醒。

车辆与使用体验

  • 修正通勤与每日总结推送时机。
  • 修复全国足迹部分数据繁体字问题。

全国足迹与行程探索

  • 新增全国足迹:可在足迹页面查看省份、城市和区/县的到访地图,支持日期筛选、逐级浏览、热门区域、最近到访、历史行程补全。
  • 初始化全国足迹前建议先在个人中心->基本信息->扩展配置 配置高德地图API KEY。

通勤、天气与地址服务

  • 通勤提醒更贴近实际工作日:会识别法定节假日与周末补班日;节假日不发送通勤提醒,补班日会套用稳定的工作日通勤计划。
  • 天气提醒改为聚焦预计出发时段,降低全天其他时段的雷暴、降雨信息造成误提醒的概率;轻微或低概率降水不再反复触发降雨文案。
  • 个人中心新增高德地图逆地理编码服务配置,车辆位置、行程城市等地址识别更稳定;服务不可用时会按既有回退策略继续尝试。

车辆与使用体验

  • 车辆管理新增「校验全国足迹」功能,用于检查全国足迹数据是否生成完整。 操作路径:个人中心 → 车辆管理 → 数据同步 → 校验全国足迹。
  • 修复足迹时间夸过大,部分数据异常展示问题。
  • 修复事件白名单筛选覆盖全局选择集。
  • 优化车辆状态提醒、充电/行程时长及月度报告展示,信息更准确清晰。

重要提醒

  • 本版本升级时会批量加密敏感数据,升级完成后不支持直接回滚。请务必在升级前手动备份数据。
  • 如升级失败,请回滚至原版本,使用升级前的手动备份恢复数据,并提交 Issue

数据安全与备份

  • 敏感信息加密:小米账号凭据、通知密钥等敏感信息现已加密保存;升级时会兼容已有数据,进一步降低配置泄露风险。
  • 新增加密备份与全量恢复:可生成加密的 .xmbak 备份文件,恢复前先完成文件校验;恢复口令需由用户自行妥善保管。
  • 新增自动备份计划:可按小时、每天、每周或每月的指定时间自动备份、设置保留数量,并在最近执行记录中查看结果和下载可用备份;功能路径:个人中心 → 数据备份。

体验优化

  • 个人中心“关于项目”新增当前版本、最新版本与重要通知展示。
  • 充电详情新增平均充电速度;
  • 行程详情会在数据可靠时展示起始和结束续航。
  • 修复已知问题

部署与维护

  • Docker Compose(后端 xiaomiev-mate 服务)新增持久化配置
  • ./config:/config:将宿主机的 config 目录挂载到容器,用于持久化字段加密密钥环和自动备份文件。
  • XIAOMIEV_CONFIG_DIRECTORY=/config:指定应用统一配置目录,使密钥环保存至 /config/.secrets/field-keyring.json,自动备份保存至 /config/backup
  • 上述两项建议同时配置。若都不配置,服务仍兼容旧版部署,继续使用 /var/log/xiaomiev 下的旧路径;若仅配置挂载而未配置环境变量,应用不会自动改用 /config;若仅配置环境变量而未挂载目录,容器重建后其中的密钥和备份可能丢失。

安全优化

  • 优化 JSON 处理组件,移除 Fastjson2 依赖,降低第三方组件潜在安全风险,提升系统整体安全性。
  • 建议所有用户升级至最新版本,以获得更安全稳定的使用体验。

新增功能

  • 新增开放平台:可通过 API Key 查询本人车辆、实时车况和当前充电状态,并提供 Xiaomi EV Mate iOS 快捷指令;使用说明、接口示例和调用限制请查看开放 API 调用文档
  • 未完成的历史充电记录支持手动标记完成;正在采样的当前充电会话仍会受到保护,避免误操作影响实时充电数据。

体验优化

  • 优化充电会话恢复与采样稳定性:服务重启、短暂接口异常或状态延迟后,尽量续接原有充电记录,减少同一次充电被拆分为多条记录的情况。
  • 优化车门、车窗、前后备箱和电动尾门提醒:仅在相邻两个正常十分钟车况周期持续异常时通知,降低临时开关门带来的误提醒;哨兵等明确异常仍会及时提醒。

新增功能

  • 新增浅色、深色和跟随系统三种外观模式。
  • 新增车况健康中心,可查看车辆状态变化、关键数据和历史记录;点击行程、充电等状态可查看对应时段的详情。
  • 新增驾驶与能耗概览,帮助了解不同距离行程的能耗表现。
  • 新增每日用车总结提醒,方便回顾当天的行程与补能情况。
  • 新增更多车辆状态提醒,例如低电量、温度异常、胎压和久停等。
  • 支持选择真实存在行驶数据的月份进行补同步,补齐历史数据更方便。

体验优化

  • 全面优化控制台、行程、补能、车况和个人中心的界面,信息更清晰、操作更顺手。
  • 优化手机端布局与底部导航,小屏设备查看数据更舒适。
  • 升级行程中心,支持查看行程列表、路线地图、常去地点和常用路线。
  • 充电时展示当前充电功率、电压、电流和预计补能速度;充电记录支持更完整的过程数据、曲线和更准确的接口类型。
  • 优化车况趋势展示,数据不足时不再生成容易造成误解的趋势图。
  • 优化月度报告和数据统计,周期对比更准确。
  • 优化智能通勤提醒,可分别调整每天的提醒时间,并显示天气信息。
  • 优化车辆与账户信息展示,车辆信息更新和账号操作更清晰。
  • 优化数据同步与刷新稳定性,减少重复记录和状态显示不准确的情况。

问题修复

  • 修复仅插枪未开始充电时可能生成无效充电记录的问题。
  • 修复部分页面在手机端显示不完整、地图或图表异常、行程详情显示不稳定等问题。
  • 修复旧版 x86_64 CPU 不支持 x86-64-v3 指令集时,后端容器启动失败的问题。

安全性提升

  • 进一步加强数据访问保护。

充电检测与体验优化

  • 新增充电状态智能检测功能:车辆充电时进入系统首页会自动触发检测并同步;充电记录页面右上角也可手动触发检测与自动补录。
  • 新增充电数据一键修复功能

    在充电记录卡片中提供「修复数据」选项,如果充电电量或续航有偏差,可一键对比并自动修正。

  • 修复同步进度条遮挡问题

    优化了同步全部历史行程时的界面层级,解决了进度条盖住操作按钮的显示异常。

  • 修复车况历史车辆状态部分数据展示未知问题
  • 系统稳定性与数据优化

    优化了服务运行架构,大幅提升了数据同步时的流畅度与系统的整体稳定性。

新增充电采样

  • 新增充电过程采样表

    记录充电过程中的 SOC、续航、功率、电压、电流、充电速度、充电上限和异常码。

  • 充电记录新增效率汇总

    支持展示平均功率、峰值功率、平均充电速度、峰值充电速度、采样次数和估算电池健康。

  • 充电记录详情支持曲线查看

    前端可查看功率/SOC、充电速度、电压/电流曲线。

  • 后台配置项新增-天地图api_key

    用于展示车辆实时定位。配置路径个人中心 -> 基本信息 -> 扩展配置。

账号配置与通知体验优化

  • 优化事件订阅推送格式,企业微信通知兼容性更好。
  • 小米手机支持自动获取设备信息,减少手动配置成本。
  • 调整个人中心界面,账号相关操作更集中。

足迹地图与历史同步进度

  • 新增足迹地图,支持查看全部路线、高频路线和起终点分布。
  • 添加车辆时可自动获取当前小米账号下的车辆。
  • 同步全部历史行程时支持查看实时进度。
  • 新增预警、智能通勤提醒等事件订阅类型。
  • 优化充电识别逻辑并修复已知问题。

通知订阅与扫码登录

  • 新增机器人通知订阅能力,支持企业微信、钉钉和飞书。
  • 新增小米二维码登录能力,可在个人中心扫码登录并保存登录态。
  • 修复已知问题。

行程体验与权限隐私升级

  • 行程轨迹展示更完整,轨迹数据同步能力增强。
  • 访问日志按用户隔离,用户默认只查看自己的数据。
  • 同步任务链路优化,异常记录和排查信息更清晰。
  • 修复已知问题。

项目上线发布

  • Xiaomi EV Mate 首个正式版本发布。
  • 提供车辆管理、行程记录、数据统计、充电管理、车辆状态和月度报告等核心能力。
  • 支持私有化部署,适合 NAS、家庭服务器或个人云主机环境。