设计与架构
本目录收录内部实现与设计取舍。它们不影响日常使用,但能解释「为什么行为是这样」,也是排障和二次开发的参考。
文档清单
| 文档 | 说明 |
|---|---|
| 总体架构 | 目标、非目标、请求链路、Web UI 页面清单 |
| 数据模型 | 实体关系与建表 DDL |
| 路由与负载均衡 | 逻辑模型 → 目标模型 → 密钥的选择算法 |
| 熔断与恢复 | 失败分类、阶梯冷却、模型可达性、全部不可用兜底 |
| 请求生命周期与重试 | 一次请求的完整路径与失败转移 |
| 协议转换 | OpenAI ↔ Anthropic ↔ Responses ↔ Gemini 字段映射与限制 |
| 统计口径 | 记录维度、费用折算、隐私默认 |
| 门户权限与通知受众 | 通知可见性、已读受众、配额档位与去重 |
| 定时探测与自动解禁 | 自动禁用组合的后台探测与恢复(设计中) |
阅读建议
- 想知道请求怎么选模型、怎么重试:先看 路由与负载均衡 和 请求生命周期与重试
- 想理解路由页上的健康状态:看 熔断与恢复
- 想接原生协议或排查字段差异:看 协议转换
- 想理解统计和通知口径:看 统计口径 与 门户权限与通知受众
设计稿描述的是机制与取舍,具体配置项以 配置项总表 为准。