“神秘影戏五条代码”现在不可仅凭这几个字确定是正式影戏名称、影片中的五条旗号，照旧用户对五组线索的简称？⑹弊钗韧椎淖龇，不是直接编出五条代码或虚构影片资料，而是把原始短语作为待剖析输入，先判断词义，再凭证已有片库或用户增补内容返回效果。
若是没有可核验的影戏数据库，接口至少应返回标准化词组、候选寄义、识别状态和缺氨赡信息 ；若是接入了真实片库，则可以进一步返回影戏信息、线索列表或剧情诠释。下面给出一套可以自行实现和测试的接口左券示例。接口名称、字段和路径均为开发示例，不代表保存一个名为“神秘影戏五条代码”的官方接口。
先要解决的问题：它事实是影戏名、旗号，照旧五条线索？
这句话保存三个容易混淆的部分。“神秘影戏”可能是作品名称，也可能只是对悬疑影戏的形貌 ；“五条”通常体现数目，但也可能属于片名的一部分 ；“代码”既可以指程序编码，也可以指影片里的密码、旗号或解谜线索。
因此，剖析器不可把空格或汉字机械拆成五个代码，也不可由于泛起“影戏”二字就断言保存同名作品。应先保存完整原词，再天生有限的候选诠释：
- movie_title：用户可能在查一部名为“神秘影戏五条代码”的作品。
- code_phrase：用户可能在查一部神秘影戏中的代码或旗号。
- clue_collection：用户可能需要整理五条剧情线索。
- unknown：现有上下文缺乏，暂时不可可靠判断。
候选诠释不即是事实结论。只有当片库中保存完全匹配或足够明确的资料时，接谈锋应把某个候选标记为已确认 ；不然返回 ambiguous，并要求挪用方增补影戏年份、导演、演员、代码原文或剧情上下文。
确定了词义后，接口应该怎样界说，才不会把五条代码编出来？
可以设计一个只认真剖析和检索的接口，例如 POST /v1/mystery-film/parse。这是内部效劳的示例路径，重点在于输入和输出的界线清晰，而不是路径自己。
| 字段 | 类型 | 要求 | 作用 |
|---|---|---|---|
| query | 字符串 | 必填，长度限制在合理规模内 | 吸收“神秘影戏五条代码”等原始词组 |
| context | 字符串 | 可选 | 增补“查下场”“找五条旗号”等用户意图 |
| filmId | 字符串 | 可选 | 已有片库中的唯一作品编号 |
| codes | 数组 | 可选 | 用户已经提供的代码或线索列表 |
| locale | 字符串 | 可选 | 控制语言和外地化输出 |
最小请求可以只有一个 query 字段：
若是用户已经给出五项内容，则应把它们放进 codes，而不是让效劳凭证问题自行推测：
返回效果要包括什么，才华区分已确认和待核验内容？
返回结构应把原始输入、标准化效果、识别状态和证据泉源脱离。不要只返回一段看似确定的剧情文字，不然前端无法判断哪些内容来自数据库，哪些内容只是模子或规则推测。
| 字段 | 说明 |
|---|---|
| status | matched、ambiguous、unmatched 或 invalid |
| normalizedQuery | 去除多余空格、统一标点后的原始词组 |
| interpretations | 候选寄义及其依据 |
| film | 已匹配片库时返回作品信息，没有匹配时返回 null |
| items | 已确认的代码或线索列表，没有资料时返回空数组 |
| expectedCount | 从“五条”识别出的期望数目，可返回 5 |
| actualCount | 目今现实获得的条目数目 |
| evidence | 说明效果来自片库、用户输入照旧规则剖析 |
| nextAction | 提醒挪用方需要增补什么信息 |
关于只有原始词组、没有片库掷中的请求，合理响应应类似下面的结构：
这里的 expectedCount 只体现词组中泛起了“五条”这一数目信号，不代表系统已经找到了五条真实内容。只有当片库或用户输入提供了条目，actualCount 才华增添。
怎样把这条输入做成可测试的处置惩罚链？
- 规范化文本。对 query 举行去首尾空格、统一全角半角标点、合并一连空格处置惩罚，但不删除“神秘”“影戏”“五条”“代码”等可能影响判断的词。
- 识别数目表达。将“五条”映射为 expectedCount=5，同时保存原词。若输入中明确给出数字“5”，也可以归一化为统一数目值。
- 判断候选类型。凭证片库完全匹配、上下文要害词和用户提供的 codes 天生候选。没有证据时只能返回候选，不可升级为 confirmed。
- 盘问可信数据源。若 filmId 保存，优先按唯一编号盘问 ；若只有文本，则先做准确匹配，再做经由审核的又名匹配。模糊匹配应标记为候选。
- 校验条目数目。当接口声称已找到五条代码时，必需检查 items 的长度和每条内容的泉源。长度缺乏时返回 incomplete 或 ambiguous，不必占位文字补齐。
- 天生下一步行动。缺少年份时提醒年份，缺少代码原文时提醒原文，不可用泛化的剧情形貌取代缺失字段。
在规则实现上，可以把判断优先级写成明确的分支，而不是让一个模糊的文本天生函数直接产出结论：
若是暂时没有影戏资料库，接口还能返回什么？
可以返回“剖析效果”，但不可返回未经证实的影戏事实。没有片库时，效劳仍然能够完成文本规范化、数目识别、候选意图分类和参数校验。例如，输入“神秘影戏五条代码，帮我找下场”可以识别出用户可能关注剧情内容，但这并不即是效劳知道影片下场。
此时最有用的返回是缺口信息：是否需要片名、年份、导演、代码原文、截图转写或剧情片断。前端可以据此展示增补表单 ；后端也可以在资料补齐后重新挪用统一接口，而不必改变响应结构。
若是接入片库，建议给每条线索生涯 sourceId、sourceType、content、order 和 verified 字段。sourceType 可以区分官方资料、编辑录入、用户提交和自动抽取。自动抽取的内容纵然结构完整，也不应默认标记为 verified。
怎样验收“神秘影戏五条代码”的实现是否准确？
- 输入只有要害词时，返回 ambiguous 或 unmatched，不返回虚构影戏名称。
- 输入带有明确 filmId 时，只盘问对应作品，不因文内情似而切换到其他影片。
- 输入五个 codes 时，actualCount 返回 5，并保存原始顺序。
- 输入三个 codes 时，返回 actualCount=3，同时保存 expectedCount=5，不可自动补成五项。
- 输入空字符串、超长文本或过失类型时，返回 invalid，并说明字段问题。
- 片库没有匹配纪录时，film 为 null，evidence 不得写成官方资料。
- 统一请求重复提交时，标准化效果和状态应坚持一致，便于缓存与回归测试。
这样实现后，“神秘影戏五条代码”不再被当成一个无法验证的牢靠谜底，而会成为一条有明确输入、判断界线和返回状态的剖析请求？⒅氐闶乔钟跋访啤⒕缜槠旌藕臀逄跸咚，并让每个结论都能追溯到用户输入或现实数据源。
