用途
Tessie(特斯拉车辆控制)技能用于通过 tessie-api 命令行工具列出车辆、检查车辆状态与状态快照,并运行明确的 Tessie 车辆命令。它面向需要以命令行方式监控和操作特斯拉车辆的场景。
主要能力
该技能提供以下核心子命令:
- authorize-url:获取授权链接。
- set-token --token '<TOKEN>':设置 API 令牌。
- disconnect:断开并移除已存储的认证信息。
- verify:验证连接状态。
- vehicles:列出车辆。
- status --vin '<VIN>':查看指定车辆状态。
- state --vin '<VIN>':查看指定车辆状态快照。
- command --vin '<VIN>' --command <command_name> [--wait-for-completion] [--extra-query k=v]:执行明确的 Tessie 命令。
- request --method GET --path '/<VIN>/battery' [--query k=v] [--json-body '{"...":"..."}']:发起原始 API 请求。
JSON 输出约定:
- authorize-url:解析 ok、authorize_url 和 connect_url。
- set-token:解析 ok 和 action。
- disconnect:解析 ok、action、path 和 removed。
- verify:解析 ok、action 和 error。
- 所有读取/命令调用:解析顶层 ok、status 和 body。
- 常见 body 字段包括 results[]、battery_level、battery_range、status 和 result。
使用方式
认证管理仅通过 CLI 辅助命令完成:
- 当连接状态未知时,先运行 tessie-api verify 再使用 Tessie API。
- 如果未配置 API 密钥,运行 tessie-api authorize-url。当返回 connect_url 时,将 <connect_url> 替换为返回的 URL,并仅分享这个 Markdown 链接:Connect Tessie;不要单独粘贴原始 URL。
- 用户可在 https://dash.tessie.com/settings/api 生成令牌。
- 如果用户通过 CLI 流程提供密钥,仅通过 tessie-api set-token --token '<TESSIE_API_TOKEN>' 存储;不要直接写入认证文件。
- 仅通过 tessie-api disconnect 移除已存储的认证信息。
- 永远不要打印令牌值。
操作规则:
- 如果未提供 VIN,调用 vehicles,并在存在多辆车时让用户选择。
- 当车辆当前状况重要时,在执行有影响的命令前使用 status 或 state。
- honk、flash、remote_boombox、软件更新计划或取消,以及车队遥测配置,可以在明确、无歧义的请求下直接执行,无需额外确认。其他车辆命令和原始 API 写入使用连接器审批门;直接调用解析后的命令,不要添加重复的聊天确认。永远不要发明命令或推断用户未请求的物理操作。
- 仅对明确的 Tessie 命令名称使用 command --command <name>。不要发明强制预唤醒流程或未文档化的辅助行为。
- 遇到 HTTP 或 API 错误时,清晰报告状态和 body。常见情况为 401、408 和 503。
- 永远不要打印令牌值。
- 读取结果保留 Tessie 的原始时间戳,并为状态观测、最后可见值以及记录创建/更新时间添加语义化的 UTC 和用户本地时间形式。
适用场景
适用于需要以命令行方式监控特斯拉车辆、检查实时状态、执行明确车辆命令或发起原始 API 请求的场景。
限制
资料未提供关于收费、价格、平台支持范围、具体效果或额外使用步骤的信息,暂未提供。