Query 处理流程与数据结构解析

Query 处理流程与数据结构解析

本文档梳理了查询处理接口的请求与响应规范，帮助开发者理解数据流转逻辑。

请求定义

请求体需携带追踪 ID 与原始查询内容，格式如下：

{
  "trace_id": "1234567890",
  "query": "q"
}

响应详解

服务端处理后返回结构化数据，涵盖处理状态、匹配结果及算法细节。

基础字段

• trace_id: 保持与请求一致，便于链路追踪。
• time_cost: 接口总耗时，单位毫秒。
• timestamp: 服务器处理时间。

结果对象 (results)

核心逻辑封装在 results 对象中，包含多个维度的匹配判定：

1. 基础规则匹配

   • result_single_char: 单字匹配标识。
   • result_whitelist: 白名单命中状态。

2. 作品与角色关联

   • result_in_works: 命中作品详情，含名称、作者及主角信息。
   • result_author: 该作者名下其他作品列表。
   • result_character: 角色所属作品及作者溯源。

3. 跨平台资源

   • result_out_works: 外部资源类型（如影视、游戏等）及来源平台 ID。

4. 算法分析层

   • result_algorithm: 记录处理耗时、查询分词 (query_processed)、子集划分 (subsets) 及意图识别 (intention)。其中 is_tips 标识是否为帖子，type 区分同音、同形等匹配方式。

接入建议

开发过程中请注意 trace_id 的全局唯一性。针对 result_algorithm 返回的子集数据，建议结合业务需求做进一步清洗，避免展示冗余信息。