从一份素材，
到一次搜索。

flowchart TD
    I01["01 提交 file_id + HTTPS URL<br/>assets.register · Sozai 可带 asset_id"] --> I02["02 核验来源身份<br/>签名断言或回源会话 · 统一用户"]
    I02 --> I03["03 校验参数和 URL<br/>暂不下载原文件"]
    I03 --> I04{"04 同来源文件是否已登记？"}
    I04 -->|本人既有任务| IDUP["复用原 upload_id + asset_id"]
    I04 -->|他人或已注销| DECLINE["拒绝：NOT_FOUND"]
    I04 -->|新素材| I05["05 PG 四表事务保存任务<br/>asset_id 短码 · queued · 指定短码被占用则 409"]
    IDUP --> I06["06 立即返回 upload_id + asset_id<br/>调用方可以轮询 uploads.get"]
    I05 --> I06
    I06 -->|queued 或中断任务| I07["07 后台领取任务<br/>PG 会话锁 · downloading"]
    I06 -.->|调用方轮询| I17["17 uploads.get 查询进度<br/>ready 时返回素材 result"]
    I07 --> I08["08 下载或复用完整原文件<br/>公网 DNS · 重定向 · 流式下载"]
    I08 -->|新下载文件| I09["09 文件头 + ffprobe + SHA-256<br/>私有文件与媒体信息"]
    I08 -->|复用已有完整原件| I10
    I09 --> I10["10 Gemini 分析完整媒体<br/>analyzing · 附上传者标题 / 标签"]
    I10 --> I11["11 PG 保存分析文字<br/>音频描述并入 description"]
    I11 --> I12["12 素材文本 embedding<br/>embedding · 1536 维 · 内容版本核对"]
    I12 --> I13["13 同一组文字计算 BM25<br/>Intl 分词 · 词频与长度修正"]
    I13 --> I14["14 写入同一 Qdrant point<br/>稀疏 + 稠密 + 权限字段"]
    I14 --> I15["15 PG 标记 ready"]
    I15 --> I16["16 登记 URL 无查询参数时删除本地副本<br/>媒体请求 302 到源地址 · 签名 URL 保留副本"]
    I16 --> I17
    I10 -.->|处理异常| I18["18 failed：所有者 uploads.retry<br/>复用任务，可替换 URL"]
    I08 -.-> I18
    I09 -.-> I18
    I12 -.-> I18
    I14 -.-> I18
    I18 -.->|重新 queued| I07
    I17 -.->|之后按 asset_id| I19["19 注销或修改元数据<br/>后台清理或重算双向量"]
    classDef focus fill:#EEF2F7,stroke:#1B365D,stroke-width:2px,color:#141413;
    classDef auxiliary fill:#EAE9E2,stroke:#6b6a64,color:#3d3d3a;
    class I06,I15 focus;
    class IDUP,DECLINE,I18,I19 auxiliary;

flowchart TD
    Q01["01 提交 query + filters + limit"] --> Q02["02 每个请求重新核验身份<br/>统一用户 + 当前团队 + 创意源"]
    Q02 --> Q03["03 校验参数 · 文本 limit 1–20<br/>文本搜索不接受 cursor"]
    Q03 --> Q04{"04 query 为空？"}
    Q04 -->|是| BROWSE["PG 浏览 ready 素材 · limit 1–100<br/>返回列表 + 无状态下一页游标"]
    BROWSE --> Q19["19 查看原图 / 视频<br/>/api/media · 本地副本或 302 到源地址"]
    Q04 -->|否| Q05["05 从原 query 启动两路<br/>单类并行 · 全部类型一次 batch"]
    Q05 --> Q06["06 原 query → Intl 分词<br/>去重 · 每词权重 1"]
    Q06 --> Q07["07 BM25 关键词召回<br/>Qdrant · 单类 20 / 每类 10 · 无下限"]
    Q05 --> Q08["08 查询 embedding<br/>默认原 query · HyDE 可选 · 1536 维"]
    Q08 --> Q09["09 语义召回 · 余弦 ≥ 0.6<br/>Qdrant Cosine · 单类 20 / 每类 10"]
    Q07 --> Q10["10 RRF 融合、去重<br/>单类 ≤40 · 全部类型 ≤30"]
    Q09 --> Q10
    Q10 --> Q11["11 PG 过滤权限 / ready / 筛选<br/>取合格候选的描述和 tags"]
    Q11 -->|有候选| Q12["12 合并同一文件的副本<br/>sha256 相同 · 优先自己的那份"]
    Q11 -->|无候选| NONE["返回空结果，不调用 Jev"]
    Q12 --> Q13["13 Jev 逐条打分精排<br/>原 query + description / tags"]
    Q13 -->|成功| Q14["14 校验完整 ID 排列<br/>不能新增、遗漏或重复"]
    Q13 -->|Jev 失败| SKIP["不重排，保留 RRF 顺序<br/>rerank_skipped: true"]
    SKIP --> Q14
    Q14 --> Q15["15 去掉 Jev 分数低于 0.15 的结果<br/>未重排时没有分数，不过滤"]
    Q15 --> Q16["16 再次回 PG 复核<br/>权限 / ready / 筛选与最新字段"]
    Q16 --> Q17["17 最后按 limit 截取<br/>默认返回 Top 5"]
    Q17 --> Q18["18 返回本次结果<br/>不保存搜索快照 · next_cursor 为 null"]
    Q18 --> Q19
    classDef focus fill:#EEF2F7,stroke:#1B365D,stroke-width:2px,color:#141413;
    classDef auxiliary fill:#EAE9E2,stroke:#6b6a64,color:#3d3d3a;
    class Q08,Q13 focus;
    class BROWSE,NONE,SKIP auxiliary;