# ADR-0002：分离百炼协议适配器

- Status: accepted
- Date: 2026-07-11

## Context

百炼 Chat/Embedding 使用 `/compatible-mode/v1`，而 `qwen3-rerank` 使用独立的 `/compatible-api/v1/reranks`。把它们封装成一个通用 OpenAI 客户端容易误拼路径，并掩盖不同错误和限流语义。

## Decision

后端建立独立的 `EmbeddingProvider`、`Reranker`、`Generator` 接口。OpenAI 兼容客户端承担 Chat 与基础 Embedding；独立 HTTP 客户端承担 Rerank。实验需要 `text_type=query/document` 时，由原生 Embedding 适配器承担。

## Consequences

- 三类端点和错误处理可以独立做契约测试。
- Anthropic 兼容地址不进入本项目运行配置。
- 模型凭证仍只在服务端配置层读取，任何适配器都不得记录鉴权请求头。