核心用法
my-tesla 是一款面向 macOS 用户的 Tesla 车辆远程控制工具,基于 teslapy 库与 Tesla Owner API 交互。用户需预先设置 TESLA_EMAIL 环境变量,首次使用时通过 OAuth 流程完成认证,令牌缓存于本地 ~/.tesla_cache.json(权限尝试锁定为 0600)。
功能覆盖四大场景:
- 状态查询:
summary/report/status提供从精简到详细的多层级车况输出,支持--no-wake避免唤醒休眠车辆 - 安全控制:锁车/解锁、后备箱/前备箱开关、车窗通风/关闭,均强制要求
--yes确认 - 舒适与能源:空调开关、除霜、温度设定(支持摄氏度)、充电启停、电流限制(1-48A)、定时充电设置
- 增值功能:胎压监测(TPMS)、座位加热调节、Sentry 模式、鸣笛/闪灯、本地 SQLite 里程追踪
输出格式灵活,默认友好文本便于聊天场景,--json 选项支持机器解析,report --json 特别提供去地理位置化的隐私安全版本。
显著优点
1. 安全设计优先:所有破坏性操作(解锁、充电控制、车窗/后备箱开关、鸣笛等)强制 --yes 二次确认,避免误触;定位功能默认返回模糊位置,精确坐标需额外确认
2. 隐私保护:认证令牌完全本地存储,无云端同步;提供 --json 隐私安全输出,主动过滤敏感字段
3. 多车管理:支持通过名称、部分匹配或索引指定车辆,可设置环境变量或本地配置文件默认车辆
4. 聊天场景优化:summary 与 report 命令专为简洁可读设计,适合快速查看车况
5. 里程本地化追踪:内置 SQLite 数据库,支持里程记录、状态查询与 CSV/JSON 导出,数据完全本地留存
潜在缺点与局限性
- 平台限制:仅支持 macOS,依赖 Python 3.10+,Windows/Linux 用户无法直接使用
- Tesla API 依赖:基于未官方文档化的 Owner API,Tesla 可能随时变更接口导致功能失效
- 认证维护:OAuth 刷新机制存在令牌过期风险,需定期重新授权
- 网络要求:车辆需联网,地下停车场等弱网环境可能命令失败
- 功能边界:不支持导航设置、媒体控制、FSD 相关操作,专注基础车况与远程控制
- 安全非绝对:虽设权限 0600,但若 macOS 用户账户被入侵,本地令牌仍可能泄露
适合人群
- 拥有 Tesla 车辆且主力使用 macOS 的技术用户
- 希望通过命令行快速查看车况、远程预调节车内环境的车主
- 需要本地记录行车里程用于报销或分析的用户
- 对第三方云服务持谨慎态度、偏好数据本地存储的隐私敏感用户
常规风险
- 车辆误操作风险:虽设确认机制,但
--yes脚本化使用可能绕过人工判断,导致车窗未关、充电中断等意外 - API 限流与封禁:频繁调用可能触发 Tesla 限流,极端情况或影响账户正常 App 使用
- 位置隐私泄露:
location --yes或status --json可能输出精确坐标,分享输出内容时需谨慎 - 依赖维护风险:
teslapy库更新滞后或 API 变更可能导致功能突然不可用