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