tesla-fleet-api

Tesla Fleet API Skill 提供了一套完整的特斯拉车辆远程控制解决方案，基于 Tesla 官方 Fleet API 构建，支持车辆数据读取与远程指令下发两大核心能力。

在核心用法方面，该技能通过 OAuth 2.0 流程完成身份认证，支持访问令牌的生命周期管理（包括刷新轮换）。用户可通过 command.py 执行丰富的车辆控制指令，涵盖空调预处理（定时启动、温度设定、座椅加热/通风）、充电管理（启停充电、设定充电限值）、车门锁控及寻车功能（鸣笛/闪灯）。对于敏感的车辆控制命令，技能集成了 Tesla 官方的 tesla-http-proxy 签名代理，通过本地 EC 私钥对指令进行加密签名，确保通信安全。同时，vehicle_data.py 支持读取电池状态、车辆位置、行驶数据、气候信息等多维度数据，并提供人类可读与原始 JSON 两种输出格式。

显著优点包括：采用官方 Fleet API，功能稳定且持续更新；本地签名架构确保私钥不出境，安全性优于纯云端方案；纯 Python 标准库实现，零第三方依赖，部署轻量；完善的输入验证机制（如充电限值 50-100% 范围检查、座位位置有效性验证）和错误处理；支持多车辆环境下的自动识别与指定操作。

潜在缺点与局限性主要体现在配置门槛较高：用户需注册 Tesla Developer 账号、申请应用凭证、注册并托管域名以完成虚拟密钥配对，还需生成并维护 EC 密钥对。此外，部分敏感操作依赖本地签名代理的持续运行，增加了运维复杂度。该技能采用单用户 OAuth 模式，不适合多用户共享场景，且访问令牌需定期刷新，长期使用需关注令牌轮换机制。

适合的目标群体包括：具备一定技术能力的特斯拉车主、智能家居自动化爱好者、车队管理开发者，以及需要通过 API 集成车辆数据到自有系统的开发者。对于无法完成域名托管或 Developer 注册的用户，该技能无法直接使用。

使用风险主要包括：私钥与 OAuth 凭证的管理风险，若泄露可能导致车辆被非法控制；配置复杂性带来的误操作风险（如错误的域名验证或证书配置）；本地签名代理的单点故障风险（代理宕机将导致命令执行失败）；以及网络环境要求，建议在可信网络下使用以避免中间人攻击。此外，作为个人开发者维护的项目（T3 来源），虽代码通过安全审计，但仍建议用户在使用前进行代码审查。