核心用法
Tesla skill 是面向 Tesla 车主的车辆远程控制工具，基于非官方但广泛社区验证的 Tesla Owner API（tesla-api.timdorr.com）。用户通过 OAuth 授权后，可在命令行或对话界面中执行车辆控制指令。
认证流程：首次使用需运行 TESLA_EMAIL=xxx python3 tesla.py auth，在浏览器完成 Tesla 官方登录后粘贴回调 URL，令牌缓存至 ~/.tesla_cache.json 并自动续期约30天。
多车支持：--car 或 -c 参数指定车辆昵称，默认操作首辆车；list 命令查看所有绑定车辆。
功能覆盖：
- 状态查询（电量、位置、锁止状态）
- 门锁控制（lock/unlock）
- 气候系统（开关、温度设定）
- 充电管理（启停、状态查看）
- 车辆唤醒（wake）及寻车辅助（honk/flash）
显著优点
1. 官方级安全架构：采用 Tesla 官方 OAuth 2.0 流程，不存储密码，仅缓存 refresh token，通信全程 TLS 加密
2. 零第三方介入：直接与 Tesla API 通信，无中间服务器，数据不出本地
3. 防护性设计：disable-model-invocation: true 强制人工触发，杜绝 AI 自主误操作
4. 社区生态成熟：基于 teslapy 库和 timdorr 文档，API 接口经多年社区验证
5. 多车家庭友好：昵称式车辆切换，无需记忆 VIN
潜在缺点与局限
- 非官方性质：Tesla 可随时变更 API 导致功能中断
- 令牌单点故障：缓存文件丢失需重新授权
- 唤醒延迟：车辆深度睡眠时命令可能失败，需先
wake - 地域限制：部分功能（如 summon）受当地法规限制未开放
- 依赖本地 Python 环境：需维护 python3 及依赖库
适合人群
- 拥有 Tesla 车辆且熟悉命令行操作的技术型车主
- 多车家庭需快速切换管理
- 追求本地化、不依赖第三方云服务（如 Tesla 官方 App 服务器）的用户
- 希望将车辆状态集成至个人自动化工作流（如定时充电、温度预设）的极客用户
常规风险
| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| 令牌泄露 | `~/.tesla_cache.json` 被恶意读取 | 文件权限限制，仅个人可信设备使用，定期清理 |
| 物理安全风险 | 远程解锁/启动可能被恶意利用 | `disable-model-invocation` 强制人工确认，避免自动化脚本滥用 |
| API 变更 | Tesla 官方接口调整导致功能失效 | 关注社区更新，及时升级脚本 |
| 车辆唤醒失败 | 指令发送时车辆处于深度睡眠 | 显式 `wake` 命令或重试机制 |