小牛电动车全能信息查询

要解决什么问题

小牛车主想查电量、续航和车辆位置时，往往要打开 App 或翻多个页面；若还想在「满电后骑了多少公里、该不该充电」上做简单判断，纯手动记里程很容易漏记或算错。本技能把 NIU MCP API 的单车状态拉取和本地规则（满电基准、骑行累计、阈值提醒）串在一起，让对话或脚本里能直接拿到结构化结果。

技能如何工作

在 config.json 里配置从小牛 App「API-Key 管理」拿到的 Key 后，技能通过 GET https://ai-mcp.niu.com/claw/scooter_info?key={API_KEY} 查询（超时 15 秒），无需小牛账号密码。返回字段包括 batteryLevel、isCharging、chargingRemainingTime、estimatedRange、totalMileage、location、lastUpdate 等。

本地侧会做几件事：

• 满电检测：电量 ≥99% 时记录满电里程与时间（以 99% 为准，非 100%）
• 骑行计算：从最近一次满电起累计骑行距离
• 预警：累计 ≥60km 提醒充电，≥70km 警告停止骑行；若电量上升或处于充电中，充电豁免会忽略骑行警告
• 历史：保留最近 100 条记录

可选定时任务用于周期性拉取；运行依赖 Python requests。

适用边界与注意

API Key 需自行在小牛 App 创建并妥善保管；网络或接口异常时以 15 秒超时后的失败为准。骑行预警是基于满电后里程的启发式规则，不能替代车辆 BMS 或官方 App 的精确判断；非充电场景下才应严肃对待高里程警告。