核心用法
jisu-oil 是一个基于极速数据（JisuAPI）官方接口的油价查询工具，提供两个核心功能：
1. 省市油价查询 (query)：传入省/直辖市名称，返回该地 89/92/95/98 号汽油及 0 号柴油的实时零售价，附带更新时间戳。
2. 全部省市列表 (province)：返回当前支持查询的所有省/直辖市名称数组，便于用户确认可用范围或做自动补全。
脚本通过 Python3 执行，需预先配置 JISU_API_KEY 环境变量。返回数据为精简后的 JSON 格式，字段命名直观（如 oil92、oil0），可直接解析呈现。
显著优点
- 数据来源权威：极速数据是国内老牌 API 服务商，油价数据直接对接官方渠道，更新频率高（通常每日零点前后同步）。
- 覆盖全面：支持全国 31 个省级行政区，含直辖市与自治区，满足绝大多数用户查询需求。
- 接口简洁：无需复杂参数，仅需省名即可查询；返回结构扁平，易于解析和格式化输出。
- 场景明确：特别适合车载助手、出行规划、物流成本估算等对话场景，响应迅速。
潜在缺点与局限性
- 需外部 API Key：用户必须自行注册极速数据账号并申请接口权限，存在首次配置门槛；免费额度有限，高频调用需付费。
- 数据粒度较粗：仅提供省级统一定价，无法精确到具体城市或加油站，实际成交价可能存在浮动。
- 依赖第三方服务：若极速数据服务异常、限流或调整接口，技能将失效；历史上出现过 107（维护中）、108（停用）等状态码风险。
- 无历史数据：仅返回最新价格，不支持趋势分析或历史对比。
适合人群
- 需要快速了解某省今日油价的普通用户
- 开发出行类、车载类对话应用的开发者
- 物流、货运从业者进行成本估算
- 希望对比多省油价以规划长途路线的车主
常规风险
- 密钥泄露风险：
JISU_API_KEY需妥善保管，避免硬编码或泄露至公共仓库，否则可能导致额度被盗刷或 IP 被封禁（错误码 105/106）。 - 调用超限风险：免费账户有日调用次数上限，超出后返回 104 错误；生产环境建议监控用量并配置降级策略。
- 数据时效风险：油价调整窗口为发改委统一定价，API 同步可能存在延迟，紧急决策建议以加油站现场标价为准。