“神秘影戏五条代码”现在不可仅凭这几个字确定是正式影戏名称、影片中的五条旗号，，，，照旧用户对五组线索的简称。。。浚浚 ？？⑹弊钗韧椎淖龇，，，，不是直接编出五条代码或虚构影片资料，，，，而是把原始短语作为待剖析输入，，，，先判断词义，，，，再凭证已有片库或用户增补内容返回效果。。。
若是没有可核验的影戏数据库，，，，接口至少应返回标准化词组、候选寄义、识别状态和缺氨赡信息；；；；若是接入了真实片库，，，，则可以进一步返回影戏信息、线索列表或剧情诠释。。。下面给出一套可以自行实现和测试的接口左券示例。。。接口名称、字段和路径均为开发示例，，，，不代表保存一个名为“神秘影戏五条代码”的官方接口。。。
先要解决的问题：它事实是影戏名、旗号，，，，照旧五条线索？？？ ？？
这句话保存三个容易混淆的部分。。。“神秘影戏”可能是作品名称，，，，也可能只是对悬疑影戏的形貌；；；；“五条”通常体现数目，，，，但也可能属于片名的一部分；；；；“代码”既可以指程序编码，，，，也可以指影片里的密码、旗号或解谜线索。。。
因此，，，，剖析器不可把空格或汉字机械拆成五个代码，，，，也不可由于泛起“影戏”二字就断言保存同名作品。。。应先保存完整原词，，，，再天生有限的候选诠释：
- 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 不得写成官方资料。。。
- 统一请求重复提交时，，，，标准化效果和状态应坚持一致，，，，便于缓存与回归测试。。。
这样实现后，，，，“神秘影戏五条代码”不再被当成一个无法验证的牢靠谜底，，，，而会成为一条有明确输入、判断界线和返回状态的剖析请求。。。浚浚 ？？⒅氐闶乔钟跋访啤⒕缜槠旌藕臀逄跸咚，，，，并让每个结论都能追溯到用户输入或现实数据源。。。
