my-tesla

🚗 安全可控的特斯拉远程管家

基于 teslapy 的特斯拉车辆远程控制工具,支持状态监控、充电/空调管理、安全锁车等操作,采用本地凭证存储与二次确认机制保障安全。

收藏
7.4k
安装
2.7k
版本
2.0.0
CLS 安全性认证2026-05-01
点击查看完整报告 >

使用说明

核心用法

My Tesla 是一款专为 macOS 设计的特斯拉车辆控制 Skill,基于 teslapy 库与 Tesla Owner API 交互。用户通过命令行即可完成车辆状态查询、远程控制、充电管理、空调调节等操作。首次使用需通过 TESLA_EMAIL 环境变量完成 OAuth 认证,令牌缓存至本地 ~/.tesla_cache.json(权限 0600)。支持多车辆管理,可通过名称、索引或环境变量指定目标车辆。

主要功能模块包括:

  • 状态监控summaryreportstatus 提供从简洁到详细的多层级车辆信息输出
  • 安全控制lock//unlocktrunk//frunkwindows 控制车门及储物空间
  • 能源管理charge 子命令管理充电启停、限流、定时充电;climate 控制空调与除霜
  • 位置服务location 默认返回模糊位置,需 --yes 授权获取精确坐标
  • 数据追踪mileage 基于本地 SQLite 实现里程记录与导出

显著优点

1. 安全设计完善:所有敏感操作(解锁、充电控制、车窗操作等)强制要求 --yes 显式确认,避免误触;位置信息默认脱敏处理
2. 隐私保护到位:凭证与配置仅本地存储,文件权限严格限制为 0600,无第三方数据传输

3. 输出格式灵活:支持聊天友好的文本输出与 --json 机器可读格式,便于脚本集成

4. 功能边界清晰--no-wake 选项避免唤醒休眠车辆,减少不必要的能耗与 API 调用

5. 文档详尽:安全使用指南、隐私政策、风险提示一应俱全,降低用户误用概率

潜在缺点与局限性

1. 平台限制:明确设计用于 macOS,跨平台兼容性未验证
2. 依赖外部库:核心功能依赖 teslapy,若该库更新滞后或出现兼容性问题,可能影响使用

3. T3 来源风险:作者为个人开发者,虽代码质量良好,但长期维护与审计透明度不及企业级项目

4. 功能深度有限:相比官方 App,缺少可视化地图、导航下发、软件更新等高级功能

5. 单点凭证风险:Tesla 账户凭证泄露将导致车辆完全失控,需用户自行保障环境安全

适合的目标群体

  • 特斯拉车主中的技术爱好者:偏好命令行工具,希望将车辆控制集成到自动化工作流
  • macOS 重度用户:日常在终端环境工作,追求效率最大化
  • 隐私敏感型用户:不信任云端服务,希望数据完全本地化处理
  • 开发者与运维人员:需要将车辆状态集成到监控系统或自定义通知方案

使用风险

  • 车辆物理安全风险unlocktrunk` 等操作若被恶意利用,可能导致车内财物失窃
  • 位置隐私泄露:尽管默认模糊处理,但 --yes 授权后的精确坐标输出需用户自行管控
  • API 速率限制:频繁调用可能触发 Tesla API 限流,影响正常使用
  • 凭证管理责任:用户需确保 ~/.tesla_cache.json 不被备份同步至不安全位置(如云盘)
  • 第三方依赖风险teslapy 或 Tesla API 的变更可能导致功能中断

安全解读

核心用法

my-tesla 是一款面向 macOS 的 Tesla 车辆远程控制工具,基于 teslapy 库与 Tesla Owner API 通信。用户通过环境变量 TESLA_EMAIL 完成 OAuth 认证后,可在终端执行多种车辆操作:

  • 状态查看summary / report / status 提供从精简到详细的车辆状态,支持 --no-wake 避免唤醒休眠车辆
  • 车辆控制lock/unlockclimate on/off/tempcharge start/stop/limittrunkwindowssentryhonkflash
  • 充电管理:实时状态、启停控制、电流限制(1-48A)、定时充电设置
  • 位置与胎压location 默认返回近似位置,需 --yes 获取精确坐标;tires 读取 TPMS 数据
  • 里程追踪:本地 SQLite 数据库记录里程变化,支持 CSV/JSON 导出

显著优点

1. 安全设计合理:所有破坏性操作(解锁、充电控制、车窗/后备箱操作、鸣笛闪灯等)强制要求 --yes 确认,降低误操作风险
2. 隐私保护意识:认证令牌本地缓存(~/.tesla_cache.json,权限 0600),位置信息默认模糊化,文档明确警示不提交敏感数据至版本控制

3. 输出格式友好:提供聊天友好的文本摘要、详细报告及 JSON 格式,满足不同场景需求

4. 功能覆盖全面:涵盖日常用车核心场景(空调预调节、充电管理、安防模式),并附带里程追踪增值功能

潜在缺点与局限性

1. 代码文件缺失:Skill 为纯 Markdown 文档型,引用的 {baseDir}/scripts/tesla.py 未包含在目录中,属动态代码加载模式,用户无法直接审查实际执行代码
2. 依赖未锁定:无 requirements.txtteslapy 版本未固定,存在传递依赖风险

3. 来源可信度有限:作者为个人开发者(T3),GitHub API 查询失败,无法验证历史信誉与社区反馈

4. 平台限制:明确面向 macOS,其他系统兼容性未说明

5. 网络依赖:所有功能依赖 Tesla API 在线服务,无离线降级方案

适合人群

  • Tesla 车主:需频繁远程查看车辆状态、预处理车内环境的用户
  • macOS 高级用户:熟悉终端操作、环境变量配置的技术用户
  • 自动化爱好者:可通过脚本集成实现定时充电、里程统计等自动化工作流
  • 隐私敏感用户:认可本地令牌缓存、位置模糊化等设计原则

常规风险

| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 令牌泄露 | 本地缓存的 OAuth 令牌若被窃取可导致车辆被远程控制 | 文件权限 0600,用户需保护主目录安全 |
| 误操作 | 尽管有 `--yes` 门槛,用户仍可能误执行破坏性命令 | 仔细阅读确认提示,建议先在安全环境测试 |
| API 变更 | Tesla 官方 API 可能调整导致功能失效 | 关注 `teslapy` 更新与 Tesla 开发者公告 |
| 代码完整性 | 动态加载的 `tesla.py` 来源未经验证 | 建议联系作者确认代码获取渠道,或自行审查代码 |
| 位置隐私 | 精确坐标需显式确认,但数据仍经 Tesla 服务端 | 非必要不使用 `--yes` 获取精确位置 |

my-tesla 内容

手动下载zip · 2.4 kB
SKILL.mdtext/markdown
请选择文件