tesla-smart-charge

核心用法

Tesla Smart Charge 是一款专为 Tesla 车主设计的自动化充电调度工具，通过 JSON 配置文件和 cron 定时任务实现智能充电管理。用户需在 memory/tesla-charge-schedule.json 中预设充电计划（包含日期、目标电量、完成时间），系统每日自动检查并执行。工具提供两种运行模式：--check-schedule 用于每日初始化检查，--manage-session 用于实时管理充电会话中的限制调整。支持自动计算最佳充电开始时间（基于电池容量、当前电量、充电器功率和充电效率），并在充电完成后自动将限制调整至 80% 以保护电池健康。

显著优点

电池健康管理：自动在充电会话期间维持 100%（或自定义）限制，会话结束后自动降至 80%，显著延长电池寿命。自动化程度高：一次配置即可通过 cron 每日自动运行，无需人工干预，支持预设多周充电计划。安全设计完善：v1.1.0+ 版本采用参数列表替代 shell=True（主要路径），通过正则表达式验证邮箱格式，限制充电百分比在 0-100 有效范围，敏感凭证通过环境变量传递而非命令行。灵活可配置：支持自定义充电器功率、电池容量、缓冲时间等参数，适应不同家庭充电环境。透明可控：所有操作均本地执行，不上传数据至第三方服务器，用户完全掌控数据源。

潜在缺点与局限性

外部依赖风险：核心功能依赖外部 tesla skill（T3 来源），需用户单独安装配置 Tesla API 凭证，存在供应链安全风险。灵活性受限：仅支持基于预设日期的调度，无法根据实时电价、天气或突发行程动态调整充电计划。配置门槛较高：需要用户具备基础的 Linux/cron 配置知识，手动编辑 JSON 文件并设置环境变量，对非技术用户不够友好。无回滚机制：操作失败时无自动回滚，虽设计为幂等操作，但错误配置可能导致非预期的充电限制变更。来源可信度：作者为个人开发者（thibautrey），非 Tesla 官方或知名开源组织，长期维护存在不确定性。

适合的目标群体

固定通勤车主：有规律的上下班时间，需要车辆在工作日早晨保持特定电量的用户。电池健康敏感者：长期停放或日常使用中希望严格控制充电上限（80%）以延长电池寿命的车主。技术型用户：熟悉命令行操作、环境变量配置和 cron 定时任务，具备基础 Python 环境搭建能力的 Tesla 车主。多车家庭：需要为不同车辆制定差异化充电计划（通过不同配置文件或实例实现）的高级用户。

使用风险与注意事项

API 凭证安全：需妥善保管 TESLA_EMAIL 环境变量和 tesla skill 的 API 凭证，避免在共享环境或日志中泄露。依赖项风险：外部 tesla skill 的更新或 API 变更可能导致功能失效，建议锁定依赖版本并定期检查兼容性。shell 注入残留：虽然主要路径已修复，但 start_charging 方法仍使用 shell=True（已验证邮箱输入），极端情况下存在理论风险。硬件兼容性：默认 2.99kW 充电功率适用于家庭慢充，若使用快充桩需手动调整参数，否则时间计算将严重偏差。网络依赖：依赖 Tesla 官方 API 可用性，网络中断或 API 限流可能导致调度失败，建议保留手动充电能力作为备份。