My Tesla

🚗 安全掌控你的特斯拉座驾

productivity榜 #50

通过 Tesla Owner API 在 macOS 本地安全控制特斯拉车辆,支持状态查询、远程控车、充电管理等功能,采用本地令牌缓存与操作确认机制保护隐私安全。

收藏
48k
安装
9.6k
版本
0.1.60
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心用法

My Tesla 是一款基于 teslapy 构建的特斯拉车辆控制工具,专为 macOS 环境设计,允许用户通过命令行界面安全地管理特斯拉车辆。用户需先设置 TESLA_EMAIL 环境变量并完成首次 OAuth 认证,令牌将以 0600 权限本地缓存在 ~/.tesla_cache.json。支持多车辆管理,可通过车辆名称、部分匹配或索引指定目标车辆。

主要功能模块包括:

  • 状态查询:summary(单行摘要)、report(详细报告)、status(原始数据)、tires(胎压)、openings(门窗状态)
  • 车辆控制:lock/unlock、climate(空调/除雾/温度调节)、windows(通风/关闭)、trunk/frunk、seats(座椅加热)、sentry mode
  • 充电管理:charge start/stop、limit(限值设置)、amps(电流调节)、scheduled-charging(定时充电)、charge-port(充电口控制)
  • 位置服务:location(默认模糊坐标,--yes 获取精确位置)
  • 数据追踪:mileage(本地 SQLite 里程记录与导出)
  • 交互功能:honk、flash

输出支持友好文本与 JSON 两种格式,JSON 输出经过隐私处理(默认移除位置信息),适合自动化脚本集成。

显著优点

1. 隐私优先设计:认证令牌本地存储,不依赖云端服务;提供 --no-wake 选项避免唤醒休眠车辆;summary/report 的 JSON 输出默认去除地理位置
2. 安全意识强:所有潜在破坏性操作(解锁、充电控制、车窗/后备箱操作、鸣笛闪灯等)强制要求 --yes 确认;location 精确坐标需显式授权

3. 多车辆灵活管理:支持环境变量默认车辆与本地配置文件双重机制,车辆选择支持模糊匹配

4. 聊天友好输出:summary、report 命令优化为适合对话场景的单行或单屏格式

5. 离线能力:mileage 模块使用本地 SQLite 存储,支持 CSV/JSON 导出

潜在缺点与局限性

  • 平台限制:专为 macOS 设计,跨平台兼容性未明确说明
  • 单点依赖:基于 Tesla 官方 API,受限于 API 变更、速率限制及 Tesla 服务可用性
  • 功能边界:不支持车辆行驶中控制、Autopilot 相关操作等高级功能
  • 首次配置复杂度:OAuth 流程需要用户手动完成浏览器登录与回调 URL 粘贴
  • 电流调节保守:充电电流限制在 1-48A,可能不满足部分高功率场景

适合人群

  • 特斯拉车主中的技术用户,习惯命令行操作
  • 需要将车辆状态集成到自动化工作流(如 Shortcuts、Alfred、Raycast)的 macOS 用户
  • 重视数据隐私、希望避免第三方云服务的中高级用户
  • 需要本地里程追踪与数据导出的车主

常规风险

  • API 变更风险:Tesla 可能随时调整 Owner API,导致功能失效
  • 令牌安全:尽管本地存储,仍需防范物理访问或备份泄露
  • 误操作风险:尽管有确认机制,批量脚本中错误使用 --yes 可能造成意外解锁或充电中断
  • 车辆唤醒耗电:频繁查询可能增加车辆能耗,建议合理使用 --no-wake
  • 位置隐私:使用 --yes--raw-json 时需确保输出渠道安全,避免位置信息泄露

安全解读

核心用法

My Tesla 是一款面向 macOS 的 Tesla 车辆远程控制 Skill,基于 teslapy 库与 Tesla Owner API 通信。用户需先通过环境变量 TESLA_EMAIL 完成 OAuth 认证,令牌缓存于本地 ~/.tesla_cache.json(0600 权限)。核心功能覆盖:

  • 状态查询summary/report/status 三档输出,支持 --no-wake 免唤醒睡眠车辆,JSON 模式可选原始数据或隐私安全版本(默认隐藏精确位置)
  • 车辆控制:锁车/解锁、空调开关/温度/除霜、充电启停/限流/定时、座椅加热、哨兵模式、前后备箱、车窗通风/关闭
  • 位置服务:默认显示近似坐标(--digits 控制精度),精确位置需 --yes 显式确认
  • 扩展功能:TPMS 胎压监测、里程追踪(SQLite 本地存储)、鸣笛/闪灯

显著优点

1. 安全设计突出:所有破坏性操作(解锁、充电控制、车窗/后备箱操作、哨兵模式等)强制要求 --yes 确认门;位置输出默认模糊化,精确坐标需二次授权
2. 隐私优先summary --jsonreport --json 自动过滤位置字段;原始数据需显式 --raw-json;凭证本地存储并限制文件权限

3. 交互友好:聊天优化的单行/单屏输出(summary/report),支持车辆昵称模糊匹配与索引选择,多车用户可设置默认车辆

4. 技术债务低:单一依赖 teslapy>=2.0.0(成熟开源库),Python 3.10+ 类型注解完整,2146 行代码结构清晰

潜在缺点与局限性

  • 平台绑定:专为 macOS/Clawdbot 设计,其他环境需适配
  • 网络依赖:所有功能依赖 Tesla 官方 API(owner-api.teslamotors.com),服务中断或速率限制将完全失效
  • 令牌长期有效:OAuth 令牌缓存无自动过期机制,需用户手动轮换(建议 90 天)
  • 功能边界:不支持自动驾驶启动、召唤等高级功能,仅限车主 API 公开能力
  • 环境变量泄露风险TESLA_EMAIL 若配置于 shell 配置文件中,可能被进程枚举

适合人群

  • 已拥有 Tesla 车辆且熟悉命令行的 macOS 用户
  • 需在工作流中集成车辆状态查询或远程预处理的自动化场景(如出发前自动开启空调、检查充电状态)
  • 对隐私敏感、不愿依赖第三方云服务的车主

常规风险

| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | 本地缓存文件若权限设置失败或被恶意程序读取 | 定期检查 `~/.tesla_cache.json` 权限;不在共享环境使用 |
| API 滥用 | 令牌被盗用后可能远程控制车辆 | 启用 Tesla 账户 2FA;监控车辆活动日志;定期轮换令牌 |
| 位置隐私 | `--raw-json` 或 `--yes` 可能暴露精确坐标 | 默认使用模糊输出;谨慎分享日志 |
| 供应链攻击 | `teslapy` 库若被恶意更新 | 锁定版本并审计依赖更新 |

经 CLS-Certify v2.1.0 扫描,该 Skill 获 Grade A / Score 78,静态分析、依赖审计、隐私合规均通过,网络通信维度为功能必需的 warn 状态。

My Tesla 内容

scripts文件夹
tests文件夹
手动下载zip · 43.5 kB
run_tests.shtext/x-shellscript
请选择文件