TeslaMate v2.0.0 重大版本升级指南与技术解析

TeslaMate 是一款专为特斯拉车主设计的开源数据记录与分析工具，它能够持续记录车辆的各种数据（如位置、充电状态、能耗等），并通过 Grafana 提供强大的可视化仪表盘。最新发布的 v2.0.0 版本带来了多项重要更新，特别是对数据库系统的重大升级要求。

数据库升级：PostgreSQL 16.7/17.3 强制要求

本次版本最显著的变化是对 PostgreSQL 数据库系统的版本要求提升。TeslaMate 现在强制要求使用 PostgreSQL 16.7 或 17.3 及以上版本，这是因为项目升级了内置的 earthdistance 扩展至 v1.2 版本。

升级注意事项：

1. 必须按照特定顺序完成升级：先备份数据 → 升级 PostgreSQL → 升级 TeslaMate → 再次备份
2. 对于手动安装且已撤销管理员权限的用户，需要临时重新授予该权限以完成 earthdistance 扩展的迁移
3. 升级过程涉及数据迁移，原有数据库将被清除，因此备份环节至关重要

功能增强与改进

轮胎压力监测显示优化

新版本在 Web 界面中改进了轮胎压力监测系统(TPMS)的显示方式，当压力过低时，工具提示中会直接显示具体的压力数值，使车主能更直观地了解轮胎状态。

仪表盘与可视化改进

• 升级至 Grafana 11.6.1 版本
• 电池健康仪表盘中改进了"当前可用容量"的计算逻辑
• 位置仪表盘新增了车辆筛选器和时间过滤器功能
• 统一了各仪表盘中的额定续航里程计算方式
• 修复了时区处理问题，确保时间截断操作与 Grafana 时区设置一致
• 改进了日期格式处理，现在基于浏览器区域设置显示日期

技术架构与安全改进

项目在持续集成和部署流程方面进行了多项优化：

• 替换已弃用的 Magic Nix Cache 为 cache-nix-action
• 移除了 pull_request_target 工作流触发器以提高安全性
• 修复了包含反斜杠的分支名称导致的镜像构建问题
• 升级了多个依赖项以修复已知问题，包括 esbuild 和 esbuild-sass-plugin 的重要更新

开发者注意事项

项目默认分支已从 master 更名为 main，贡献者需要相应更新本地仓库配置。同时，项目继续强化了对依赖项的管理，新增了针对路径依赖的 Dependabot 忽略规则。

升级建议与最佳实践

对于生产环境用户，建议：

1. 仔细阅读升级文档，严格按照指定顺序执行升级步骤
2. 升级前后都进行完整数据备份
3. 在测试环境中先行验证升级流程
4. 关注时区和日期格式变化对现有仪表盘的影响
5. 检查自定义仪表盘是否与新版本的计算逻辑兼容

这次升级虽然带来了短暂的升级复杂性，但从长远来看，新版 PostgreSQL 将提供更好的性能和稳定性，为 TeslaMate 的未来功能扩展奠定更坚实的基础。