Pathé 电影技能

概要

• 始终使用所需的类浏览器请求头（参见 scripts/pathe_movie.py）调用 https://www.pathe.nl/api 接口。
• 使用 config/pathe_movie_config.json 中的配置，确定默认影院列表；仅当用户明确指定其他影院时才覆盖该配置。
• 复用 scripts/pathe_movie.py 中提供的工具函数（包括查询清洗、模糊匹配、最优匹配选择及下游接口调用等）。
• 如有不确定之处，请参考 references/api.md 获取有效载荷结构、字段名称及预期响应格式。

搜索流程

1. 清洗用户输入的影片名称，移除填充词（the、a、an、of、in、on、for、and）。
2. 使用清洗后的查询参数调用 /api/search/full?q=... 接口。
3. 若返回多个结果，执行基于 difflib 的模糊标题匹配，选取最接近的 title。保留后续请求所需的 slug、poster（优先使用 poster.lg）和 contentRating 字段。
4. 如需返回海报，应提供 poster.lg 的 URL；必要时可降级使用 poster.md 或 posterPath。

影片详情流程

• 根据给定的 slug，调用 /api/show/{slug}?language=nl 接口。
• 提取 contentRating.description 和 synopsis 字段（部分条目中这两个字段可能为 null，需容错处理），并尽可能获取上下文信息，例如 genres、directors、actors 和 trailers 等。
• 海报路径现优先取自 posterPath 字段；若该字段缺失，则回退至搜索响应中的 poster 字段。

影院流程

• 调用 /api/show/{slug}/cinemas?language=nl 查询支持该影片的影院列表，并依据配置文件中的 approvedCinemas 进行过滤；仅当用户明确要求其他影院时才跳过此过滤。
• 对需要进一步详细信息的每个影院，调用 /api/cinema/{cinema}?language=nl 获取其官方 name、citySlug 及服务与告警元数据（services/alerts）。

场次时间表

• 使用 /api/show/{slug}/showtimes/{cinema}?language=en 获取排片信息。响应为以日期（YYYY-MM-DD）为键的字典，每个键对应的值为一场次数组；每场次至少包含 time 字符串（还可选含 screen、language、format 等字段）。
• 若该数组为空，则返回提示：“当前暂无排片计划”。

测试说明

• 运行 /api/search/full?q=matrix，确认响应中包含 slug、title、poster、contentRating 和 genres 字段。
• 调用 /api/show/the-matrix-41119，验证 contentRating.description、synopsis 和 posterPath 字段；注意 synopsis 可能为 null，且 posterPath 可能缺失，因此务必进行空值检查。
• 查询 /api/cinema/pathe-zaandam，检查返回的 name、citySlug 及服务元数据（该对象不含 shows 列表，故主要为静态信息）。
• 调用 /api/show/iron-lung-51335/showtimes/pathe-zaandam，确认该接口返回的是一个数组；实测该 slug 在该影院下返回空数组，表明必须妥善处理“零场次”的响应场景。
• 拉取 /api/shows?language=nl，了解批量响应结构：包含数十个条目，每个均含 slug、posterPath、contentRating、genres 和 next24ShowtimesCount 字段。

媒体交付说明

• 在通过 WhatsApp 发送海报图像（及额外剧照）前，必须先将其下载至本地。保存路径应为 /tmp 或其他临时目录，确保网关可读取该文件。
• 当用户通过 WhatsApp 明确请求海报时，在 message 工具的 media 字段中传入本地文件路径（例如：/tmp/bluey_poster.jpg）。WhatsApp 文档指出，出站媒体支持本地路径，此举可确保实际图像被正确投递，而非仅发送 URL。
• message 工具调用中的文本部分应具有描述性（例如：“这是您要求的《Bluey》海报”），视觉内容则由已下载的文件承载。

当用户询问影片搜索、海报、简介、影院可用性或场次时间表等相关问题时，请严格遵循上述指引，确保本技能始终输出准确的 Pathé 荷兰地区结果。