核心用法
idfm-journey 是一款专为法兰西岛大区（Île-de-France）设计的公共交通查询 Skill，底层调用 IDFM PRIM/Navitia 官方 API。用户通过简单的 Python 脚本即可完成三类核心操作：
1. 地点解析（Places）：将自然语言地址（如 "Ivry-sur-Seine"）解析为标准化的 stop_area 或 POI ID，支持返回多条候选结果供人工确认。
2. 行程规划（Journeys）：输入自由文本的起点与终点，自动完成地点解析后返回多方案路线，涵盖地铁、RER、公交、Transilien 等全部 IDFM 运营网络，支持 --count 参数控制返回方案数量。
3. 实时中断查询（Incidents）：按线路 ID（如 line:IDFM:C01727）或状态过滤器查询当前生效的服务中断与运营异常，帮助用户规避延误风险。
所有命令均支持 --json 标志输出原始 API 响应，便于与其他工具链集成。
显著优点
- 官方数据源：直接对接 Île-de-France Mobilités 官方 PRIM 平台，数据权威性与实时性有保障
- 零依赖设计：纯 Python 脚本实现，无需安装额外 SDK 或复杂依赖
- 自然语言友好：支持模糊地址输入，自动完成地理编码解析
- 多模式整合：覆盖巴黎大区全域公共交通网络，单一接口统一查询
- 灵活输出：支持人类可读格式与原始 JSON 双模式，兼顾终端用户与开发者需求
潜在缺点与局限性
- API Key 门槛：需用户自行申请并配置
IDFM_PRIM_API_KEY，对非技术用户存在使用门槛 - 仅限法兰西岛：服务范围严格限定于 IDFM 管辖区域，无法查询外省或国际路线
- 无持久化存储：每次查询独立执行，不支持历史记录、收藏地点或个人偏好学习
- 地址歧义风险：复杂地名（如多站点城镇）可能返回多个候选，需人工干预选择正确
stop_area - 离线不可用：完全依赖 API 在线服务，网络中断或 PRIM 平台维护时功能失效
适合人群
- 常住或短期访问巴黎大区的通勤者与旅客
- 需要集成公共交通数据至自有应用的技术开发者
- 对 RER/Metro 实时运营状态敏感的专业用户（如商务出行、时间敏感行程）
- 熟悉命令行操作、具备基础环境变量配置能力的用户
常规风险
- API 配额与速率限制：PRIM 平台对免费账户存在调用频次上限，高频使用可能触发限流
- 数据延迟：实时中断信息存在分钟级同步延迟，极端情况下可能与现场实际不符
- 密钥泄露风险：
IDFM_PRIM_API_KEY以环境变量形式存储，共享环境或日志输出不当可能导致密钥暴露 - 服务中断依赖：IDFM/Navitia 平台维护或故障将直接影响本 Skill 可用性，无本地降级方案
- 隐私考量：行程查询会暴露起止地点信息至第三方 API，敏感位置规划需注意数据合规性