pathe-movie

Pathé Movie Skill 是一款专为荷兰 Pathé 影院设计的电影信息查询工具，通过与 Pathé 官方 API 深度集成，为用户提供完整的电影搜索、详情查询、影院检索和排片时间获取功能。

该 Skill 的核心用法围绕五个主要场景展开：首先是电影搜索，通过清理用户输入中的填充词（如 the、a、an 等）并调用 /api/search/full 端点，结合模糊匹配算法（difflib）精准定位目标影片，提取 slug、海报链接和分级信息；其次是详情查询，利用影片 slug 获取完整的故事简介、评分、导演演员信息及预告片链接；第三是影院检索，支持基于配置文件的白名单过滤或用户指定的影院查询，获取影院名称、城市和服务信息；第四是排片查询，按日期维度展示特定影院的放映时间表，包含放映厅、语言和格式等细节；最后是海报下载，自动将远程海报图片缓存至本地 /tmp 目录以便通过即时通讯工具分享，避免直接发送 URL。

显著优点体现在技术实现的稳健性与安全性上。该 Skill 仅依赖 Python 标准库（urllib、difflib、json、pathlib），完全规避了第三方依赖包的安全风险和版本冲突问题，实现零依赖部署。输入处理层通过 normalize_query() 函数净化搜索词，使用 urllib.parse.urlencode 进行标准 URL 编码，有效防止注入攻击。模糊匹配功能采用 difflib.get_close_matches 并设置 0.5 的相似度阈值，在多结果场景下智能选择最佳匹配项。此外，本地海报缓存机制不仅提升了重复查询的响应速度，也符合数据隐私保护的最佳实践，确保用户通过 WhatsApp 等渠道接收的是实际图片文件而非外部链接。

然而，该 Skill 也存在一定局限性。地域覆盖上，目前仅支持荷兰境内的 Pathé 连锁影院，无法查询其他品牌或国家的影院信息。架构层面，缺乏 API 响应缓存机制可能导致高频场景下对 Pathé 服务器的重复请求，影响性能。维护风险方面，作为个人开发者（T3 来源）维护的项目，长期更新和 API 适配的可持续性需要关注。功能边界上，由于 Pathé API 的限制，部分影片可能缺失简介或海报数据（null 值），需要调用方优雅处理空值情况。此外，排片查询结果可能为空（如影片已下线或尚未排片），需向用户明确提示。

适合使用该 Skill 的群体包括：居住在荷兰或计划前往荷兰观影的电影爱好者，需要快速查询附近 Pathé 影院的排片信息；本地生活服务开发者，希望集成影院信息查询功能到聊天机器人或客服系统；以及 Pathé 影院的常客，需要便捷获取影片评分、时长、格式（IMAX、3D 等）技术参数以辅助购票决策。

使用风险主要集中在对外部服务的依赖上。网络连通性是基础要求，离线环境无法使用任何功能。Pathé API 的服务稳定性直接影响 Skill 可用性，若官方调整接口、发生故障或实施限流，功能将暂时失效。虽然代码本身通过安全审计（A 级），但作为 T3 来源的代码，建议在生产环境部署前进行额外的安全审查。图片下载功能虽然使用 /tmp 目录符合安全规范，但用户应确保该目录有适当的写入权限且定期清理临时文件，避免磁盘空间占用。此外，API 响应时间受网络环境影响，在高峰时段可能出现延迟。