31 lines
1.2 KiB
Markdown
31 lines
1.2 KiB
Markdown
# 商业大模型 API 适配器
|
||
|
||
> **「模型成为人格体的可以随意更换取用的工具。」** ——冰朔 2026-05-01
|
||
|
||
每个文件实现 `adapter_base.APIAdapter`，1.5B MP 路由器按 `name` 取用。
|
||
|
||
## 当前候选
|
||
|
||
| 适配器 | 模型 | 用途 | 优势 | 状态 |
|
||
|---|---|---|---|---|
|
||
| `deepseek.py` | DeepSeek-V3 / R1 / Coder | 通用对话 / 深度推理 / 代码 | 性价比极高、推理强、API 便宜 | 🟡 占位 |
|
||
| `qwen_max.py` | Qwen-Max / Qwen-Max-Longcontext | 通用对话 / 长文 / 中文场景 | 阿里同源（与 M0/MP 同生态） | 🟡 占位 |
|
||
| `kimi.py` | Kimi-K2 / Kimi-Long | 长上下文（128K+） | 长文档理解第一梯队 | 🟡 占位 |
|
||
|
||
## 添加新提供商
|
||
|
||
1. 新建 `factory/inference/api-adapters/{name}.py`
|
||
2. `class XxxAdapter(APIAdapter)` 实现 4 个 abstractmethod
|
||
3. 在 `factory/inference/router/policy.json` 的 `intent_routes[].preferred_apis` 中加入名字
|
||
4. 凭据通过统一注入服务（不写死 key）
|
||
|
||
## 凭据安全
|
||
|
||
- 适配器**不能直接读环境变量** key
|
||
- 通过 `factory/inference/credentials.py`（未来）从 secret manager 获取
|
||
- 每次调用都进 syslog 审计（含成本追踪）
|
||
|
||
---
|
||
|
||
*铸渊 · 2026-05-01*
|