Authorization: Bearer {accessToken}
  Content-Type: application/json
  

何时使用

在以下场景中应用本技能：

• - 用户查询车辆位置信息
• 用户询问我的车在哪儿或车辆在哪里
• 用户请求查询车况信息（电压、电量、里程、续航等）
• 用户询问车辆状态（车锁、车门、车窗、空调是否开启）
• 用户请求获取车辆详细信息（SN、VIN、档位、电源状态等）
• 需要自动获取认证信息时，引导用户提供 token信息

功能

• - 认证管理: 支持 accessToken 和 vehicleToken 的缓存与验证
• 车况查询: 调用 /iot/v1/condition 接口获取车辆实时状态
• 位置查询: 从车况信息中提取车辆位置信息（经纬度、地址、更新时间）
• 环境选择: 支持 UAT 和 PROD 两种环境

认证信息

认证方式

本 Skill 使用双 Token 认证机制:

• - accessToken: 平台访问令牌
• vehicleToken: 设备访问凭证

Token 格式

用户提供认证信息格式为:

vehicleToken####accessToken

两个字段以 #### 分隔（必须是4个#）：

• - vehicleToken: 设备令牌（用于请求体）
• accessToken: 访问令牌（用于 Authorization 头）

缓存机制

Skill 会将认证信息缓存在本地文件中:

• - 缓存文件位置: ~/.nokeyvehicleinfo_cache.json
• 缓存内容: accessToken, vehicleToken, env
• 验证逻辑: 检查缓存文件是否存在，且 accessToken 和 vehicleToken 字段都存在且不为空
• 环境字段: env 用于指定 API 环境，值为 UAT 或 PROD

- 读取缓存时，如果 env 为 UAT 则使用 UAT 环境，其他情况使用 PROD 环境

使用方法

首次使用（无认证信息）

当 Skill 检测到没有缓存的认证信息时，会引导用户提供:

请提供认证信息，格式为：vehicleToken####accessToken
例如：sk-api-R44YuYJmggYqQi3nMch1uY8jBhJ...####eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...

查询车况信息

提供认证信息后，可以直接查询:

帮我查询车辆信息

或者查询位置:

查询我的车辆位置

完整流程示例

1. 1. 首次使用:

用户：我要查询车辆信息
助手：请提供认证信息，格式为：vehicleToken####accessToken
用户：xxxx####xxxx
助手：认证信息已保存。查询成功！车辆位置：上海市浦东新区 xxx

1. 2. 后续使用（已有缓存）:

用户：查询车辆位置
助手：查询成功！车辆位置：...

接口说明

查询车况接口

请求信息:

• - URL:

- UAT: https://uat-openapi.ingeek.com/iot/v1/condition
- PROD: https://openapi.nokeeu.com/iot/v1/condition

• - 方法: POST
• 请求头:

Authorization: Bearer {accessToken}
Content-Type: application/json

• - 请求体:

json { vehicleToken: {vehicleToken} }

响应格式:
json
{
code: 0,
message: 成功,
data: {
sn: AD62241PVH4225,
vin: LFV88888888888888,
vehiclePosition: {
longitude: 121.63449835646132,
latitude: 31.21975016303934,
address: 上海市浦东新区唐镇吕三路,
positionUpdateTime: 1762332036501
},
vehicleCondition: {
power: 2,
trunk: 0,
gear: 1,
door: {
frontLeft: 0,
frontRight: 0,
rearLeft: 0,
rearRight: 0
},
lock: {
frontLeft: 0,
frontRight: 0,
rearLeft: 0,
rearRight: 0
},
window: {
frontLeft: 0,
frontRight: 0,
rearLeft: 0,
rearRight: 0
},
airConditionerState: {
acRightTemp: 0.0,
acLeftTemp: 0.0
}
}
}
}

字段说明:

• - sn: 数字钥匙 SN，银基侧唯一标识
• vin: 车架号
• vehiclePosition: 车辆实时位置

- longitude: GPS 经度
- latitude: GPS 纬度
- address: 地址
- positionUpdateTime: 实时位置更新时间戳（毫秒）

• - vehicleCondition: 车辆实时状态

- power: 电源状态（0-熄火，1-ACC，2-ON）
- trunk: 后备箱状态（0-关闭，1-开启）
- gear: 档位（0-无效，1-P档，2-N档，3-D档，4-R档，5-S档）
- door: 车门状态
- frontLeft: 左前门（0-关闭，1-开启）
- frontRight: 右前门（0-关闭，1-开启）
- rearLeft: 左后门（0-关闭，1-开启）
- rearRight: 右后门（0-关闭，1-开启）
- lock: 车锁状态
- frontLeft: 左前门锁（0-解锁，1-上锁）
- frontRight: 右前门锁（0-解锁，1-上锁）
- rearLeft: 左后门锁（0-解锁，1-上锁）
- rearRight: 右后门锁（0-解锁，1-上锁）
- window: 车窗状态
- frontLeft: 左前车窗（0-关闭，1-开启）
- frontRight: 右前车窗（0-关闭，1-开启）
- rearLeft: 左后车窗（0-关闭，1-开启）
- rearRight: 右后车窗（0-关闭，1-开启）
- airConditionerState: 空调状态
- acRightTemp: 右侧温度设定（℃）
- acLeftTemp: 左侧温度设定（℃）

调用方式（使用 curl）

本 Skill 通过 curl 命令直接调用 API，无需 Python 脚本依赖。

1. 检查认证信息

bash

检查缓存文件是否存在，以及 accessToken 和 vehicleToken 是否有效

CACHEFILE=~/.nokeyvehicleinfocache.json

if [ -f $CACHE_FILE ]; then
accessToken=$(jq -r .accessToken // empty $CACHE_FILE)
vehicleToken=$(jq -r .vehicleToken // empty $CACHE_FILE)

if [ -n $accessToken ] && [ -n $vehicleToken ]; then
echo 认证信息已存在
echo accessToken: $accessToken
echo vehicleToken: $vehicleToken
else
echo 认证信息不完整，请提供 vehicleToken####accessToken
fi
else
echo 未找到认证信息，请提供 vehicleToken####accessToken
fi

2. 保存认证信息

bash

解析用户输入的 token（格式为 vehicleToken####accessToken）

AUTH_INPUT=xxxxxx####xxxxx
vehicleToken=$(echo $AUTH_INPUT | awk -F #### {print $1})
accessToken=$(echo $AUTH_INPUT | awk -F #### {print $2})

保存到缓存文件（默认使用 PROD 环境）

cat > ~/.nokeyvehicleinfo_cache.json << EOF { accessToken: $accessToken, vehicleToken: $vehicleToken, env: PROD, last_updated: $(date -Iseconds) } EOF

echo ✅ 认证信息已保存

3. 查询位置信息/车况信息

bash

从缓存读取 token 和环境配置

accessToken=$(jq -r .accessToken ~/.nokeyvehicleinfo_cache.json)
vehicleToken=$(jq -r .vehicleToken ~/.nokey_