核心用法
本技能通过调用 Île-de-France Mobilités（IDFM）官方 PRIM/Navitia API，为法兰西岛（Île-de-France）地区提供完整的公共交通查询服务。主要功能模块包括：
1. 地点解析（Place Resolution）：将自由文本地址（如 "Ivry-sur-Seine"）解析为官方 stop_area ID，支持返回多候选结果供人工选择
2. 行程规划（Journey Planning）：自动完成起点/终点的 ID 解析，计算最优公共交通路线，支持返回多条备选方案
3. 实时故障查询（Incidents/Disruptions）：按线路 ID 或状态过滤器查询当前生效的延误、中断信息
所有命令通过 python3 scripts/idfm.py 统一入口执行，无需额外依赖，仅需配置 IDFM_PRIM_API_KEY 环境变量。
显著优点
- 官方数据源：直接对接 Île-de-France Mobilités 官方 PRIM API，数据权威性高
- 零依赖部署：仅需 Python 3 标准库，无需安装额外包
- 自由文本输入：支持自然语言地点描述，自动完成 ID 解析
- 多格式输出：默认友好格式 +
--json原始 API 输出，便于二次开发 - 实时性：覆盖 RER、Metro、Bus、Tram 等全网络的实时故障信息
潜在缺点与局限性
- 地域限制：仅限法兰西岛（Paris 及周边），不支持法国其他地区或国际城市
- API 密钥依赖：必须提前申请并配置 IDFM PRIM API key，存在准入门槛
- 歧义处理弱：复杂地名可能返回多个候选，需人工增加
--count参数筛选 - 无多模态混合：专注公共交通，不包含共享单车、网约车等接驳方案
- 法语环境为主：API 返回数据以法语为主，国际化支持有限
适合人群
- 法兰西岛居民及通勤者：日常出行规划、突发故障查询
- 开发者/数据分析师：需要标准化公共交通数据的本地处理工具
- 旅游规划者：巴黎及周边自由行游客的公共交通方案制定
常规风险
- API 配额限制：PRIM 免费层存在调用频次限制，高频使用需关注用量
- 密钥泄露风险：
IDFM_PRIM_API_KEY需妥善保管，避免硬编码或日志泄露 - 服务可用性依赖：IDFM 官方服务中断将直接影响功能，无本地降级方案
- 数据时效性：虽然标注实时，但极端情况下（如突发事件）可能存在数分钟延迟
- 隐私考量：行程查询会暴露起终点位置信息，敏感场景需谨慎使用