用途:tesla-pp-cli 面向 Tesla 车主账户,提供 JSON 优先的命令行接口,用于车辆状态查询、空调/锁车/充电等远程命令、充电成本分析,以及供 AI 智能体驱动的 MCP 接口。资料称其比 iOS 应用更适合一次性命令,也比 TeslaPy 更友好于智能体。
主要能力:
- ready:用单次调用的「可否 5 分钟内出发」判断,附带阻断原因列表(电量与行程距离、是否插枪、车门、哨兵、座舱温度、是否有安装中更新)。
- 本地分析:cost ledger(按会话成本、月度支出、家庭与超充比例)、cost what-if(若全在家充电可省多少)、timeline(拼接行程与充电)、vampire(静置掉电检测)。数据来自本地 SQLite。
- 充电智能:supercharger watch 单次或 --watch 轮询,输出空位变化。
- 安全审计:keys audit 列出已登记钥匙的最近使用时间、角色、形态,标记超过 90 天未使用为陈旧。
- doctor:识别是否需要签名命令,打印 tesla-control 注册 URL。
- 命令参考覆盖 charging、diagnostics、energy_sites、logs、notification_preferences、products、users、vehicles 等分组。
使用方式:先安装 CLI:npx -y @mvanhorn/printing-press-library install tesla --cli-only;若失败可用 go install github.com/mvanhorn/printing-press-library/library/devices/tesla/cmd/tesla-pp-cli@latest(需 Go 1.26.6 或更新版本)。验证:tesla-pp-cli --version,并确保安装目录在 $PATH 中。可用 tesla-pp-cli which "<能力描述>" 查找命令。示例:tesla ready <vin> --json;tesla cost ledger --since 2026-04-01 --group supercharger --json。远程命令需按资料中的 Fleet 路径完成 tesla-control 安装、密钥生成、注册、OAuth 登录,并在车上一次性 BLE+NFC 登记虚拟钥匙。
适用场景与限制:适合老旧 REST 端点的车辆(2021 年前 Model S/X 或 3/Y);较新车辆可经由 tesla reachability 提供兼容层。supercharger watch、成本账本等为本地分析。资料提到每次调用成本 $0.001 及唤醒 $0.02,并在 $10/月个人使用额度内大致净成本为零。若 --version 报 command not found,说明运行时未看到二进制目录,需修复后再使用。其余细节暂未提供。