# 项目约定与设计决策

本文档记录容易被误解的设计决策，确保开发一致性。

---

## AI 服务配置

**重要：系统使用 AI 中转服务商，不直连 AI 厂商！**

- 使用 OneAPI / OneInAll / OpenRouter 等中转服务商
- 中转服务商统一了不同 AI 厂商（豆包、通义、DeepSeek 等）的接口
- 只需配置中转服务商的 API Key 和 Base URL
- 具体使用哪个底层模型，由中转服务商的模型名称决定

```python
# 正确 ✓
AI_PROVIDER = "oneapi"
AI_API_BASE_URL = "https://api.oneinall.ai/v1"

# 错误 ✗ - 不直接配置 AI 厂商
AI_PROVIDER = "doubao"
```

---

## 其他约定

（后续添加）