汽车油价与充电站对比推荐技能 (Car Fuel & Charge)

技能概述

本技能提供汽车燃油价格与新能源充电站的全方位查询、对比、推荐服务，帮助用户做出最优的出行能源决策。

核心功能矩阵

| 功能模块 | 支持内容 | 数据来源 | |---------|---------|---------| | 油价查询 | 92#、95#、98#汽油，0#/-10#/-20#/-35#柴油 | 国家发改委 + 多源API聚合 | | 油价对比 | 跨省份、跨城市价格差异分析 | 全国31省市实时数据 | | 油价趋势 | 历史价格走势图 + 涨跌预测 | 近12个月历史数据 | | 充电站查询 | 国家电网、特来电、星星充电等主流平台 | 多平台数据聚合 | | 充电价格 | 电费 + 服务费分项展示，尖峰平谷电价 | 各运营商实时报价 | | 位置匹配 | 基于用户位置的最近站推荐 | 高德/百度地图POI | | 路线规划 | 沿途加油/充电点优化推荐 | 导航路线算法 | | 成本计算 | 燃油车 vs 电动车出行费用对比 | 综合能耗模型 |

工作流程

📌 流程一：油价查询与对比

触发场景

"今天92号汽油多少钱"
"北京上海油价差多少"
"最近油价涨了还是跌了"
"全国哪个省油价最低"

执行步骤

识别查询意图
- 判断用户需要：当前价格 / 历史对比 / 预测趋势 / 地区差异
- 提取关键参数：油品类型（92/95/98/柴油）、地区（省份/城市）
调用油价查询脚本
```
python scripts/fuel_price.py --action query --fuel_type <类型> --province <省份> --city <城市>
```
参数说明：
- --action: query(查询) / compare(对比) / trend(趋势) / predict(预测)
- --fuel_type: 92 / 95 / 98 / diesel0 / diesel_10 / diesel_20 / diesel_35
- --province: 省份名称（可选，默认全国概览）
- --city: 城市名称（可选）
处理返回数据
- 解析JSON格式的油价数据
- 格式化为用户友好的表格或图表

输出结果格式

单地查询示例：

📊 [城市] 今日油价报告 (更新时间: YYYY-MM-DD HH:mm)
┌────────────┬──────────┬──────────┬─────────┐
│ 油品型号    │ 元/升    │ 较昨日    │ 较上周   │
├────────────┼──────────┼──────────┼─────────┤
│ 92号汽油   │ 7.52     │ ▲ 0.05   │ ▲ 0.15  │
│ 95号汽油   │ 8.01     │ ▲ 0.06   │ ▲ 0.18  │
│ 98号汽油   │ 9.31     │ ▲ 0.07   │ ▲ 0.21  │
│ 0号柴油    │ 7.14     │ ▲ 0.05   │ ▲ 0.16  │
└────────────┴──────────┴──────────┴─────────┘
💡 下次调价日: YYYY-MM-DD (预计涨/跌约X元)

多地区对比示例：

🗺️ [油品] 全国TOP10 低价省份 (YYYY-MM-DD)
排名 | 省份    | 价格(元/升) | 与均价差 | 推荐指数
────────────────────────────────────────────────
 1   | 陕西    |   7.23     │  -0.29  | ⭐⭐⭐⭐⭐
 2   | 新疆    |   7.25     │  -0.27  | ⭐⭐⭐⭐⭐
 ...

🔌 流程二：充电站查询与推荐

触发场景

"附近哪有充电站"
"哪里充电便宜"
"去[目的地]路上在哪充电"
"特来电和国家电网哪个便宜"

执行步骤

识别需求
- 判断用户需要：位置搜索 / 价格对比 / 运营商偏好 / 充电速度要求
- 提取参数：位置（坐标/地址）、半径范围、充电类型（直流/交流）、运营商偏好
调用充电站查询脚本
```
python scripts/charging_station.py \
  --action search \
  --location "<经度,纬度>" or "<地址>" \
  --radius <公里数> \
  --type <dc/ac/all> \
  --operator <operator_id>
```
参数说明：
- --action: search(搜索) / compare(比价) / route(沿途) / detail(详情)
- --location: 经纬度坐标或地址文本
- --radius: 搜索半径(km)，默认5km
- --type: dc(直流快充) / ac(交流慢充) / all
- --operator: 运营商ID（见下表）
运营商ID对照表

| ID | 运营商 | 说明 | |----|--------|------| | 1 | 国家电网(e充电) | 覆盖最广，高速服务区主力 | | 2 | 特来电(TELD) | 数量最多，商场停车场密集 | | 3 | 星星充电 | 社区覆盖好 | | 4 | 蔚来(NIO) | 蔚来车主专属+超充 | | 5 | 特斯拉(Tesla) | 特斯拉专用 | | 6 | 小鹏 | 小鹏车主专属 | | 7 | 云快充 | 第三方聚合平台 | | 8 | 南方电网 | 南方区域主力 | | 0 | 全部 | 不限运营商 |

输出结果格式

附近充电站列表：

🔋 附近充电站 (<radius>km内共N个) - [地址]
┌──────┬─────────────┬──────┬────────┬────────┬──────────┬────────┐
│ 排名 │ 站点名称    │距离  │ 价格    │ 空闲桩  │ 运营商  │ 评分   │
├──────┼─────────────┼──────┼────────┼────────┼──────────┼────────┤
│  1   │ XX充电站    │ 0.8k │ 1.2元/度│ 8/12   │ 特来电   │ 4.8    │
│  2   │ XX充电站    │ 1.2k │ 0.98元/度│ 15/20  │ 电网     │ 4.9    │
└──────┴─────────────┴──────┴────────┴────────┴──────────┴────────┘
💰 价格说明: 电费 X.XX元/度 + 服务费 X.XX元/度 = 总价 X.XX元/度
📱 导航: 复制地址打开地图导航

价格明细展开：

📋 [站点名称] 详细价格信息
┌─────────────┬──────────┬──────────┬──────────┐
│ 时段         │ 电费(元/度)│ 服务费   │ 合计     │
├─────────────┼──────────┼──────────┼──────────┤
│ 尖峰(XX-XX)  │  1.25    │  0.40    │  1.65    │
│ 峰时(XX-XX)  │  1.00    │  0.40    │  1.40    │
│ 平时(XX-XX)  │  0.65    │  0.40    │  1.05    │
│ 谷时(XX-XX)  │  0.35    │  0.40    │  0.75    │
└─────────────┴──────────┴──────────┴──────────┘
✅ 最佳充电时段: 谷时 XX:00-XX:00 (仅0.75元/度)

🛣️ 流程三：位置匹配与路线规划

触发场景

"[出发地]到[目的地]在哪加油/充电"
"从A到B的最佳补能方案"
"高速上哪里有加油站"

执行步骤

获取起终点信息
- 出发地（可自动获取当前位置）
- 目的地
- 车辆类型（燃油/电动/混动）
- 续航/油箱参数

调用路线规划脚本（已集成腾讯地图，自动使用真实路线数据）

python scripts/route_planner.py \
  --start "<起点>" \
  --end "<终点>" \
  --vehicle_type <fuel/ev/hybrid> \
  --range_km <续航里程> \
  --prefer <cheapest/fastest/nearest>

🆕 腾讯地图升级: 配置 TENCENT_MAP_CONFIG["key"] 后，路线规划将自动：

使用真实驾车距离（非直线估算）

沿线搜索真实充电站/加油站/服务区

返回预计时间、过路费等详细信息

腾讯地图独立测试命令:
python scripts/tencent_maps.py --health-check          # 健康检查
python scripts/tencent_maps.py --search-charging -l "116.39,39.92"  # 搜充电站
python scripts/tencent_maps.py --route --from "北京" --to "武汉"     # 规划路线
python scripts/tencent_maps.py --along-route --from "北京" --to "武汉"  # 沿线搜索

输出结果格式

🗺️ 补能路线规划: [起点] → [终点] (全程 XXX km)

🚗 车辆: [车型] | 续航: XXXkm | 当前电量/油量: XX%

┌────┬─────────────────┬────────┬────────┬──────────┬─────────┐
│ #  │ 推荐站点        │ 途经点  │ 累计km  │ 预计费用  │ 备注    │
├────┼─────────────────┼────────┼────────┼──────────┼─────────┤
│ 1  │ XX加油站/充电站  │ XX服务区│  180   │ ¥XXX     │ 必停    │
│ 2  │ XX加油站/充电站  │ XX出口  │  380   │ ¥XXX     │ 可选    │
└────┴─────────────────┴────────┴────────┴──────────┴─────────┘

💰 总计补能费用: 约 ¥XXX
⏱️ 预计补能耗时: 约 X小时X分钟

📊 方案对比:
┌──────────┬──────────┬──────────┬──────────┐
│ 方案      │ 费用     │ 时间     │ 便利性   │
├──────────┼──────────┼──────────┼──────────┤
│ 最省钱    │ ¥XXX     │ Xh Xm    │ ★★★☆☆   │
│ 最快捷    │ ¥XXX     │ Xh Xm    │ ★★★★☆   │
│ 最均衡    │ ¥XXX     │ Xh Xm    │ ★★★★★   │
└──────────┴──────────┴──────────┴──────────┘

💰 流程四：油电出行成本对比

触发场景

"买车选油还是电"
"跑长途油车电车哪个划算"
"一年能省多少钱"

执行步骤

收集车辆信息
- 燃油车：油耗(L/100km)、油箱容量
- 电动车：电耗(kWh/100km)、电池容量
- 年行驶里程

调用成本计算脚本

python scripts/cost_calculator.py \
  --fuel_car "<油耗L/100km>" \
  --ev_car "<电耗kWh/100km>" \
  --annual_km <年里程> \
  --years <年限> \
  --province <省份>

输出结果格式

💵 油电成本全面对比 (年行驶 XX,000km · [省份]油价)

┌─────────────────────┬──────────────┬──────────────┐
│ 对比项              │ 燃油车       │ 电动汽车     │
├─────────────────────┼──────────────┼──────────────┤
│ 百公里能耗          │ X.X L汽油    │ XX kWh电     │
│ 单次补能费用        │ ¥XXX (满油)  │ ¥XX (满电)   │
│ 百公里费用          │ ¥XX.XX       │ ¥XX.XX       │
│ 年燃料费用          │ ¥XX,XXX      │ ¥X,XXX       │
├─────────────┬───────┴──────────────┴──────────────┤
│ 年节省金额   │            💚 省 ¥XX,XXX           │
│ N年总节省    │            💚 省 ¥XX,XXX           │
└─────────────┴────────────────────────────────────┘

📈 盈亏平衡分析:
• 电动车溢价: ¥XX,XXX (相比同级燃油车)
• 回本周期: 约 X.X 年 (X万公里)
• 第N年起净赚!

⚠️ 其他考虑因素:
+ 保养费: 电车每年少花约¥X,XXX
+ 保险费: 电车通常高¥X,000左右
+ 残值率: 燃油车3年~65% vs 电动车3年~55%
- 保值折损: 电车多损失约¥X,XXX

数据源与API配置

油价数据源优先级

主数据源: 国家发改委官方调价信息（通过免费API获取）
备用数据源:
- 阿里云API市场 - 油价查询接口
- xxapi.cn 免费油价API
- 笒鬼鬼公益API

充电站数据源优先级

主数据源:
- 🆕 腾讯地图 WebService API（推荐，支持沿线搜索）
- 高德地图充电站POI API
- 百度地图充电桩数据
备用数据源:
- 各运营商开放API（特来电、星星充电）
- 充电桩聚合平台数据

地图数据源说明

| 数据源 | 用途 | 优势 | Key 申请 | |--------|------|------|----------| | 🗺️ 腾讯地图 | 路线规划、地点搜索、沿线搜索、地理编码 | 沿线 POI 搜索独有优势 | lbs.qq.com/console | | 高德地图 | 周边搜索 POI | 覆盖广 | console.amap.com | | 百度地图 | 备用 POI 数据 | 补充数据源 | lbsyun.baidu.com |

💡 推荐配置腾讯地图 Key：它提供独有的「沿途搜索」能力，可沿驾车路线自动查找充电站/加油站/服务区，非常适合长途出行补能规划！

配置文件

编辑 scripts/config.py 存储API密钥：

# ==================== 地图API配置 ====================

TENCENT_MAP_CONFIG = {
    "key": "你的腾讯位置服务Key",  # ⭐ 推荐！支持路线规划+沿线搜索
    # 申请地址: https://lbs.qq.com/console/key/manage
}

AMAP_CONFIG = {
    "key": "你的高德地图API Key",
    # 申请地址: https://console.amap.com/dev/key/app
}

环境变量方式：

export TENCENT_MAP_KEY="你的Key"  # 覆盖配置文件

腾讯地图核心 API 能力

| API | 端点 | 功能 | 应用场景 | |-----|------|------|----------| | 地点搜索 | /ws/place/v1/search | 周边/城市内 POI 搜索 | 找附近充电站 | | 驾车路线规划 | /ws/direction/v1/driving/ | 两点间真实驾车路径 | 精准距离/时间/费用 | | ⭐ 沿途搜索 | /ws/place/v1/searchalongroute | 沿路线搜索 POI | 长途补能规划核心！ | | 关键词提示 | /ws/place/v1/suggestion | 输入框自动补全 | 地址联想 | | 地理编码 | /ws/geocoder/v1/ | 地址↔坐标转换 | 文本定位 | | 逆地址解析 | /ws/geocoder/v1/ | 坐标→地址描述 | 定位展示 | | 距离矩阵 | /ws/distance/v1/matrix | 批量距离计算 | 多点对比 | }, "charging": { "amap_poi_url": "https://restapi.amap.com/v3/place/around", "teld_api": "", "star_charge_api": "" } }


## 油品知识参考

详细油品规格、适用车型、季节选择等信息请参阅 `references/fuel_knowledge.md`。

## 充电知识参考

充电标准、充电速度、运营商特点等信息请参阅 `references/charging_knowledge.md`。

## 使用建议

1. **首次使用**: 先运行一次无参数查询，确认API连接正常
2. **位置服务**: 允许位置权限可获得更精准的附近站点推荐
3. **价格时效**: 油价每日7点更新，充电价格实时变动
4. **数据免责**: 价格仅供参考，实际以现场为准

汽车能源助手

汽车油价与充电站对比推荐技能 (Car Fuel & Charge)

技能概述

核心功能矩阵

工作流程

📌 流程一：油价查询与对比

触发场景

执行步骤

🔌 流程二：充电站查询与推荐

触发场景

执行步骤

🛣️ 流程三：位置匹配与路线规划

触发场景

执行步骤

💰 流程四：油电出行成本对比

触发场景

执行步骤

数据源与API配置

油价数据源优先级

充电站数据源优先级

地图数据源说明

配置文件

腾讯地图核心 API 能力