SuperAPI AI 工具集

tessie

通用与其它

查看项目

更新于 10-26 18:17

技能介绍

用途

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 请求的场景。

限制

资料未提供关于收费、价格、平台支持范围、具体效果或额外使用步骤的信息,暂未提供。