My Tesla

🚗 安全远程控车,状态一手掌握

iot榜 #1

通过特斯拉官方 API 安全控制车辆,支持状态查看、远程控车、充电管理等功能,本地缓存认证信息。

收藏
29.2k
安装
9.6k
版本
0.1.56
CLS 安全性认证2026-07-01
点击查看完整报告 >

使用说明

核心用法

My Tesla 是一个基于 teslapy 的特斯拉车辆控制工具,专为 macOS 设计。用户通过命令行界面与特斯拉 Owner API 交互,实现车辆状态查询和远程控制。

主要功能模块:

  • 车辆信息list 列出车辆,summary/report/status 获取不同详细程度的状态
  • 安全控制lock/unlock 车门锁,trunk/frunk 开启前后备箱
  • 空调系统climate 控制空调开关、温度、除霜模式
  • 充电管理charge 查看状态、启停充电、设置限值/电流,scheduled-charging 预约充电
  • 位置服务location 获取车辆位置(默认模糊,精确坐标需确认)
  • 辅助功能tires 胎压监测,windows 车窗控制,seats 座椅加热,sentry 哨兵模式
  • 数据记录mileage 本地 SQLite 里程追踪

认证流程:首次使用需运行 auth 子命令,通过 OAuth 流程获取令牌,缓存在 ~/.tesla_cache.json(权限 0600)。

显著优点

1. 分层隐私保护summary --jsonreport --json 默认输出清洗后的数据(不含精确位置),而 status --json 输出原始数据,用户可按需选择
2. 安全确认机制:解锁、充电操作、车窗控制、鸣笛等 15+ 项敏感操作强制要求 --yes 确认

3. 本地凭证管理:令牌仅本地存储,支持环境变量配置默认车辆,避免反复认证

4. 睡眠保护--no-wake 选项避免唤醒休眠车辆,减少耗电

5. 聊天友好输出summaryreport 专为即时通讯场景优化,单屏可读

潜在缺点与局限性

1. 依赖第三方库:基于非官方的 teslapy,非特斯拉官方 SDK,API 变更可能导致兼容性问题
2. 仅限 macOS:明确为 macOS 设计,跨平台支持未说明

3. Python 版本要求:需 Python 3.10+

4. 无图形界面:纯命令行工具,对非技术用户门槛较高

5. 速率限制风险:频繁调用特斯拉 API 可能触发账户限制

6. 令牌安全:虽有 0600 权限设置,但仍依赖本地文件系统安全

适合人群

  • 技术型特斯拉车主:熟悉命令行操作,需要自动化车辆管理
  • 隐私敏感用户:希望精确控制位置数据分享范围
  • 多车家庭:支持多车辆管理和默认车辆切换
  • 开发者/极客:需要 JSON 输出进行进一步数据处理或集成

常规风险

| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | 本地令牌文件被盗 | 0600 权限、勿提交到版本控制、系统全盘加密 |
| 误操作 | 远程解锁、开窗等 | 强制 `--yes` 确认、操作前核对车辆名称 |
| API 变更 | 特斯拉官方 API 更新导致功能失效 | 关注 `teslapy` 项目更新、作者维护状态 |
| 位置暴露 | 精确坐标泄露 | 默认使用模糊位置,敏感场景避免 `--yes` |
| 车辆唤醒 | 频繁查询导致额外耗电 | 合理使用 `--no-wake` 选项 |

安全解读

核心用法

my-tesla 是基于 teslapy 的特斯拉车辆远程控制工具,专为 macOS 设计。用户需先设置 TESLA_EMAIL 环境变量并完成 OAuth 认证(令牌本地缓存于 ~/.tesla_cache.json,权限 0600)。

主要功能分类

状态查询(安全只读):

  • summary / report / status:多层级车辆状态输出,支持 --json 脱敏格式
  • list:多车辆账户管理
  • tires / openings / location(默认模糊坐标):轮胎压力、门窗状态、位置

远程控制(需 --yes 确认):

  • lock/unlock:车门锁控
  • climate on/off/temp/defrost:空调与温度管理
  • charge start/stop/limit/amps:充电控制与限流
  • trunk/frunk / windows vent/close / seats set:物理部件操作
  • sentry on/off / honk / flash:哨兵模式与警示功能

进阶功能

  • scheduled-charging:定时充电设置
  • mileage:本地 SQLite 里程追踪(~/.my_tesla/mileage.sqlite

显著优点

1. 分层安全设计:破坏性操作强制 --yes 确认;location 默认 1km 模糊精度,精确坐标需二次确认
2. 隐私优先输出summary --jsonreport --json 主动脱敏地理位置;原始数据需显式 --raw-json

3. 灵活的唤醒控制--no-wake 选项避免不必要唤醒车辆,降低能耗与数据暴露

4. 本地化凭证管理:OAuth 令牌仅本地存储,无云端同步;SQLite 里程数据完全离线

5. 代码质量过硬:2,079 行模块化 Python,无危险函数调用,输入验证完善

潜在缺点与局限性

1. T3 来源风险:作者为个人开发者(@officialpm),非企业/基金会背书,存在维护连续性与供应链攻击风险
2. 网络权限敏感:需连接 Tesla 官方 API,虽目的地可信,但权限本身属于敏感类别

3. 平台限制:专为 macOS 设计,其他平台兼容性未验证

4. 非官方 API 依赖:基于社区 teslapy 库,Tesla 官方 API 变更可能导致功能中断

5. 令牌泄露风险:虽本地存储,但用户 home 目录备份不当可能导致凭证外泄

适合人群

  • 注重隐私安全的特斯拉车主(尤其 macOS 用户)
  • 需要命令行/自动化工作流集成车辆控制的技术用户
  • 偏好本地数据存储、反对云端同步的用户
  • 愿意承担个人开发者项目风险的早期采用者

常规风险

| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | `~/.tesla_cache.json` 权限被篡改或备份外泄 | 定期检查 0600 权限,避免公开云备份 |
| 误操作 | `--yes` 绕过确认导致意外解锁/开窗 | 脚本/别名中谨慎使用 `--yes` |
| 位置隐私 | `--yes` 获取精确坐标后截图分享 | 优先使用脱敏输出,清理历史命令 |
| 供应链攻击 | 作者账号被盗,恶意代码通过更新注入 | GitHub Watch 仓库,变更前审阅 diff |
| API 弃用 | Tesla 官方 API 变更导致功能失效 | 关注社区动态,保留官方 App 备用 |

My Tesla 内容

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