要实现“神秘电影五条代码解析”，关键不是凭标题猜测五条代码的含义，而是先建立稳定的输入格式，再按明确规则完成清洗、校验、匹配和返回。当前没有提供影片原始代码、官方字段说明或现成服务接口，因此不能直接虚构五条真实内容。下面给出一套可落地的自建接口契约，既能接收五条代码，也能在缺少词典时明确返回“未映射”，避免把推测结果当成电影设定。
先定义五条代码的输入契约
如果业务规则明确要求解析五条内容，接口应把五条代码作为数组传入，并强制检查数量、编号和原始文本。原始文本必须保留，规范化文本则用于后续匹配。这样既能追溯用户提交的内容，也能避免清洗操作改变实际线索。
| 字段 | 类型 | 要求 | 用途 |
|---|---|---|---|
| schemaVersion | 字符串 | 必填 | 标识当前请求契约版本 |
| filmKey | 字符串 | 必填 | 标识影片或内容来源，避免只用片名造成歧义 |
| codes | 数组 | 必须包含五项 | 承载待解析的五条代码 |
| codes[].id | 整数 | 取值为1至5且不能重复 | 保持线索顺序 |
| codes[].raw | 字符串 | 不能为空 | 保存用户或数据源提供的原文 |
请求示例中的内容只是接口测试占位值，不代表影片《神秘电影五条代码》的实际设定：
接口如何完成解析
如果这是一个自建 HTTP 服务，可以设计为 POST /api/mystery-film/parse。该路径是实现示例，不表示存在官方接口。请求头使用 Content-Type: application/json，服务端先验证结构，再执行文本解析，最后返回每条代码的状态。
- 解析请求体。检查 JSON 是否有效，并确认 schemaVersion、filmKey 和 codes 存在。请求体无法读取时直接返回400，不进入业务解析。
- 校验五条数量。当 codes 不是数组、数量不等于5、编号重复或编号超出1至5时，返回422，并在 errors 中指出具体位置。
- 保留原文并规范化。去除首尾空格，统一全角冒号、破折号和连续空白，但不覆盖 raw 字段。normalized 字段只用于匹配。
- 执行规则匹配。根据影片对应的代码词典、正则表达式或字段映射表提取类别、关键词和关系。没有词典时只能返回结构化文本，不能自行补出剧情含义。
- 生成结果。每一项都返回 id、raw、normalized、status 和 warnings，使调用方能够区分已匹配、格式正确但未映射、以及格式错误。
这套流程的重点是把“文本被成功接收”和“文本已经被解释”分开。前者属于接口校验，后者属于业务词典或解析规则。即使五条代码格式正确，如果服务端没有对应的映射配置，也应返回 unmapped，而不是生成一个看似完整但无法验证的电影解读。
建议的返回结构
成功处理不等于五条代码全部有明确含义，因此响应中应同时提供 valid、items 和 warnings。下面是一个完整的结构示例，内容仅用于说明字段关系：
错误状态要保持稳定
| 状态码 | 触发条件 | 调用方处理方式 |
|---|---|---|
| 200 | 请求结构有效，解析流程完成 | 读取 items，并根据 status 展示结果 |
| 400 | JSON 无法解析或请求体为空 | 修正请求格式后重试 |
| 422 | 字段缺失、数量不是五条或编号不合法 | 根据 errors 修正字段 |
| 404 | filmKey 存在，但没有对应解析配置 | 补充影片词典或使用正确标识 |
不建议把所有情况都返回200并写入一段提示文字。对于开发者而言，HTTP状态码负责说明请求是否可处理，items.status 负责说明单条代码是否被识别，warnings 则说明结果为何不完整。三层信息分开后，前端、批处理程序和日志系统都能稳定消费。
实现解析器时不要把推测当成结果
实际项目通常需要一个按 filmKey 读取的代码词典。词典可以包含 codePattern、type、meaning 和 relationRule 等字段。解析器先用 codePattern 判断文本是否符合格式，再读取固定的 type 与 meaning；如果没有命中规则，就保留原文并标记 unmapped。只有来源材料明确给出“五条代码”及其对应关系时，才可以把 meaning 写入返回值。
上面的实现只表达接口边界：validateFiveItems 负责数量与编号，normalizeText 负责可重复的文本清洗，dictionary.match 负责可审计的业务匹配。它不会自动声称某个符号对应人物、时间或结局，也不会在没有原始资料时生成影片剧情。
接入真实影片资料时的最小准备
要把这套接口用于真实的“神秘电影五条代码解析”，还需要补齐三类数据：第一，五条代码的原始文本及其顺序；第二，每条代码的字段定义，例如它是符号、对白、道具还是时间线索；第三，代码之间是否存在依赖关系。若这些资料只存在于自然语言文章中，应先人工确认并录入词典，再让接口返回结构化结果。
因此，稳定的实现路径是：以 filmKey 定位作品，提交五条 raw 文本，经过数量和格式校验后生成 normalized 字段，再用明确词典完成匹配；没有可靠映射时返回未解析状态。这样得到的解析结果可复现、可测试，也不会把尚未证实的电影线索误当成接口事实。
