feat(providers): 按老板要求整个删除「火山方舟 Coding Plan」供应商(版本 2.6.1 → 2.7.0)

火山方舟 Coding Plan 已停止(后续不可用),涉及的全部清除:

- data/gateway.yaml:删 providers.volc_engine 整块、pricing 里的
  ark-code-latest、头部/协议线/下载白名单相关注释
- .env / data/.env / .env.example:删 VOLC_API_KEY(顺带清 .env 里
  遗留的 B_AI_API_KEY 空变量)
- app/main.py:FastAPI description、注释去火山(版本 2.6.1 → 2.7.0)
- app/config.py / settings.py / adapters/{__init__,openai_compat}.py:注释去火山
- frontend/src/views/Settings.vue:对话默认模型下拉删 ark-code-latest
- README.md / docs/frontend-design.md:供应商表、价格表、活体检查等去火山
- design/v1/board.html、design/v3/agents.py:设计稿演示数据换掉火山
- tests/test_gateway.py:改写配置用例的样本改用 agnes/opencode;
  保留「已删模型不该残留」的回归护栏

删除(老板确认不保留):
- /root/api-gateway/ 旧副本(非运行目录)
- data/*.bak 7 个历史配置备份
- design/design/v2/ 过时设计稿(含 b.ai/智谱/火山演示数据)

验证:单测 225 passed / 0 failed;ci_check.sh 六道门禁全绿;
已重启上线(pid 1704259),/v1/models 供应商仅 agnes/opencode/dots、无 ark-code。
CHANGELOG 历史条目(真实变更记录)保留。
This commit is contained in:
api-gateway committed 2026-09-30 15:13:50 +08:00
1 parent fe9a9fb786
commit 1af4e67a2b
11 files changed
+72 -53

No files matched your search

+1 -1
View File
@@ -11,7 +11,7 @@
# 补上后来实装但一直漏在模板外的 OPENCODE_API_KEY。
AGNES_API_KEY=
VOLC_API_KEY=
OPENCODE_API_KEY=
# 运行参数(可选,覆盖 yaml)
+4 -6
View File
@@ -1,6 +1,6 @@
# API Gateway
统一多供应商 LLM 接入网关,纯后端 FastAPI,配置驱动。支持 **Agnes AI**、**火山方舟 Coding Plan**、**OpenCode Go** 三个供应商,全部走 OpenAI 兼容协议。v2.4 已集成熔断、限流、图像/视频、指标、成本估算、热加载、测试等完整能力。
统一多供应商 LLM 接入网关,纯后端 FastAPI,配置驱动。支持 **Agnes AI**、**OpenCode Go**、**Dots AI(小红书)** 三个供应商,全部走 OpenAI 兼容协议。v2.4 已集成熔断、限流、图像/视频、指标、成本估算、热加载、测试等完整能力。
## 特性
@@ -45,7 +45,6 @@ api-gateway/
| 供应商 | Base URL | 认证 | 模型 |
|---|---|---|---|
| Agnes AI | `https://api.agnes-ai.cn/v1` | Bearer | 10 个模型:4 text(`agnes-3.0-flash` 旗舰、`agnes-2.5-flash` 支持图像输入)、3 image、3 video;其中 **6 个免费 + 1 个限时免费**(`agnes-video-2.5-flash`,见「模型清单同步」) |
| 火山方舟 Coding | `https://ark.cn-beijing.volces.com/api/coding/v3` | Bearer | `ark-code-latest`(text) |
| OpenCode Go | `https://opencode.ai/zen/go/v1` | Bearer + `x-opencode-session` | 35 个模型,含 **1 个免费**(`space-bunny-free`,见下方小节) |
| **Dots AI(小红书)** | `https://note3-prev-api.askdiandian.com/v1` | **自定义头 `api-key`** | `dots3-note-prev`(text + 视觉,**512K**,**免费体验**) |
@@ -239,7 +238,7 @@ providers:
| `responses` | `POST /v1/responses` | `Authorization: Bearer` |
模型支持哪几条线写在各供应商的 `models[].protocols`;**不声明 = 只认 `chat/completions`**
(Agnes / 火山方舟即如此,行为与改造前完全一致)。OpenCode Go 的 **35 个模型**按**实测**逐一
(Agnes 即如此,行为与改造前完全一致)。OpenCode Go 的 **35 个模型**按**实测**逐一
标线(`deepseek-v4.1-flash` / `deepseek-v4-pro` / `deepseek-v4-flash` / `deepseek-v4-flash-vision-exp` /
`deepseek-flash` 三线全通)。`GET /v1/models` 会回 `protocols`,前端据此标格式。
@@ -481,7 +480,6 @@ observability:
pricing: # 人民币/百万 token,用于估算成本
per_model:
agnes-3.0-flash: { input: 0.35, output: 1.00 }
ark-code-latest: { input: 0.50, output: 2.00 }
# 未配置的模型不返回 estimated_cost_cny
```
@@ -501,7 +499,7 @@ python run.py # 默认读 data/gateway.yaml,端口 8808
```bash
cp .env.example .env
# 编辑 .env 填入 AGNES_API_KEY / VOLC_API_KEY / OPENCODE_API_KEY
# 编辑 .env 填入 AGNES_API_KEY / OPENCODE_API_KEY / DOTS_API_KEY
python run.py # 启动时自动读取 .env
```
@@ -1414,7 +1412,7 @@ pytest tests/ -q
# 冒烟:健康 / 模型列表 / chat / batch / 错误格式(网关未起或无 key 时优雅 SKIP)
python smoke_test.py --url http://127.0.0.1:8808
# 活体检查:真实上游(Agnes / 火山方舟 / OpenCode Go)端到端行为校验,含三线直传与跨线 400、
# 活体检查:真实上游(Agnes / OpenCode Go / Dots AI)端到端行为校验,含三线直传与跨线 400、
# 流式 SSE、413、CORS 预检、图像生成等
python live_check.py --url http://127.0.0.1:8808
```
+1 -1
View File
@@ -12,7 +12,7 @@ def create_adapter(
) -> BaseAdapter:
"""根据供应商配置创建对应适配器。
当前四个供应商(Agnes / 火山方舟 / OpenCode Go)均为 OpenAI 兼容协议,
当前供应商(Agnes / OpenCode Go / Dots AI)均为 OpenAI 兼容协议,
统一使用 OpenAICompatAdapter,通过 base_url 和 extra_headers 区分。
图像/视频端点通过 media 配置覆盖(Agnes 走 /videos + /agnesapi)。
OpenCode Go 由 requires_session_header 触发每请求动态注入 x-opencode-session。
+1 -1
View File
@@ -1,6 +1,6 @@
"""OpenAI 兼容协议适配器。
Agnes / 火山方舟 两家均使用 OpenAI 兼容 API
Agnes / OpenCode Go / Dots AI 均使用 OpenAI 兼容 API
(POST {base_url}/chat/completions),本适配器统一处理。
图像/视频端点可通过 media 配置覆盖:
+3 -3
View File
@@ -52,7 +52,7 @@ PROTOCOL_MESSAGES = "messages"
PROTOCOL_RESPONSES = "responses"
PROTOCOLS: tuple[str, ...] = (PROTOCOL_CHAT, PROTOCOL_MESSAGES, PROTOCOL_RESPONSES)
# 模型没写 protocols 时的默认值:只认 chat/completions。
# 为什么要默认而不是"全支持":老配置(Agnes / 火山)从未声明过协议,
# 为什么要默认而不是"全支持":老配置(Agnes)从未声明过协议,
# 默认全支持等于把「没实测过的线」当成可用,用户打过去只会收到上游 500。
DEFAULT_PROTOCOLS: tuple[str, ...] = (PROTOCOL_CHAT,)
@@ -128,7 +128,7 @@ class ModelInfo:
type: str = "text" # text | image | video
# 第十三轮: 是否支持「图像输入」(多模态 / 视觉)。
# Agnes 3.0 Flash 文档明确「输入模态:文本、图像 URL」,实测 data:image/png;base64 也能识别;
# 其余文本模型(ark-code 等)文档未声明图像输入 → 默认 False。
# 其余文本模型文档未声明图像输入 → 默认 False。
# 用途:① /v1/models 暴露给前端标注/告警;② 前端据此提示「换个支持视觉的模型」力的模型排到前面。
vision: bool = False
# 2026-09-21: 是否**免费模型**(官方价格表标 Free、不按 token 计费)。
@@ -223,7 +223,7 @@ class ProviderConfig:
rate_limit_rps: float | None = None # 该供应商全局 QPS 上限(可选)
requires_session_header: bool = False # OpenCode Go 等要求每请求动态会话头(x-opencode-session)
# 第二十七轮(三线直传): 该供应商**每条协议线**的出站地址与鉴权头。
# 未配置时用 _default_endpoints()(三条标准线 + 标准鉴权)—— 所以 Agnes / 火山这类
# 未配置时用 _default_endpoints()(三条标准线 + 标准鉴权)—— 所以 Agnes 这类
# 只走 chat/completions 的供应商一个字段都不用加,行为与以前完全一致。
endpoints: dict[str, EndpointSpec] = field(default_factory=_default_endpoints)
+5 -4
View File
@@ -336,13 +336,14 @@ _docs_on = config.server.docs_enabled # 安全默认关(report: /docs、/ope
# 本轮修复: 版本号收敛到单一常量。此前 "2.4.0" 硬编码在 FastAPI / / 导航 / /auth/login
# 三处,/health 干脆没返回版本 —— 前端「网关版本」一直显示 v-。
# 2026-09-29: 2.4.0 → 2.4.1(前端间距规范统一);2.4.1 → 2.5.0(新增「智能体」功能模块);2.5.0 → 2.5.1(智能体支持图片附件);2.5.1 → 2.5.2(智能体页间距与对齐优化);2.5.2 → 2.5.3(修 KPI 与下方块之间 0 间距)。
# 2026-09-29: 2.4.0 → 2.4.1(前端间距规范统一);2.4.1 → 2.5.0(新增「智能体」功能模块);2.5.0 → 2.5.1(智能体支持图片附件);2.5.1 → 2.5.2(智能体页间距与对齐优化);2.5.2 → 2.5.3(修 KPI 与下方块之间 0 间距);2.6.0 → 2.6.1(模型切换挪到对话框左下角)。
# 2026-09-30: 2.6.1 → 2.7.0(按老板要求整个删除「火山方舟 Coding Plan」供应商:配置/模型/代码/文档/前端下拉/环境变量全清)。
# ★ 版本号纪律:每次改动都要往上加,小改动加小版本号、大改动加大版本号(README 有专章)。
VERSION = "2.6.1"
VERSION = "2.7.0"
app = FastAPI(
title="API Gateway",
description="统一多供应商 LLM 接入网关(Agnes / 火山方舟 / OpenCode Go)",
description="统一多供应商 LLM 接入网关(Agnes / OpenCode Go / Dots AI)",
version=VERSION,
lifespan=lifespan,
default_response_class=UTF8JSONResponse,
@@ -1144,7 +1145,7 @@ def _resolve_media_model(cfg, model: str, media_type: str):
def _resp_text(res: dict) -> str:
"""从已完成的上游结果里提取回复正文(用于访问日志展示流式/非流式的输出内容)。
本轮补充: 推理型模型(火山方舟 / Kimi thinking 等)在小 max_tokens 下正文可能为空、
本轮补充: 推理型模型(Kimi thinking 等)在小 max_tokens 下正文可能为空、
内容全在 reasoning_content,日志里就会显示成空白 —— 这时回落到推理段并标注,
保证「有输出就能在日志里看到」。
"""
+1 -1
View File
@@ -575,7 +575,7 @@ _SECTION_COMMENTS = {
# 也不生效 —— 所以由网关代拉一次并加 Content-Disposition: attachment。
# 安全:这是全网关唯一一个服务端主动出网的接口,只有这里列出的域名(含子域)允许被代下载,
# 且解析出的 IP 必须是公网地址;allowed_hosts 为空 = 该功能整体关闭。
# 换了供应商/CDN 域名时,往这里加一条即可(如 volc 的 tos-*.volces.com)。
# 换了供应商/CDN 域名时,往这里加一条即可。
""",
}
+3 -16
View File
@@ -1,5 +1,5 @@
# AI 网关配置文件(data/ 目录)
# 供应商:Agnes / 火山方舟 Coding / OpenCode Go(订阅编程模型)
# 供应商:Agnes / OpenCode Go(订阅编程模型)/ Dots AI
# 密钥统一走 token_env 指向的环境变量(本机见 data/.env),不再在 yaml 存明文
# 端口默认 8808
#
@@ -75,18 +75,6 @@ providers:
type: "video"
# 2026-09-24 自动同步:官方文档新增(scripts/sync_models.py)
volc_engine:
name: "火山方舟 Coding Plan"
base_url: "https://ark.cn-beijing.volces.com/api/coding/v3"
auth:
token_env: "VOLC_API_KEY"
extra_headers: {}
media: {}
models:
- id: "ark-code-latest"
display_name: "火山方舟 ark-code-latest"
type: "text"
opencode:
name: "OpenCode Go"
base_url: "https://opencode.ai/zen/go/v1"
@@ -109,7 +97,7 @@ providers:
# 缺少 anthropic-version 时 /messages 也会被拒 → 作为该线固定头带上。
# 语义:**这里没写的线 = 该供应商没有这条线**(模型就算声明了也调用不了,
# validate_config 会直接报错拦住)。老板决策:先只做 OpenCode 一家,
# 其余供应商(Agnes / 火山)暂不声明 → 走默认值 = 只认 chat/completions,
# 其余供应商(Agnes)暂不声明 → 走默认值 = 只认 chat/completions,
# 行为与改造前完全一致。
endpoints:
chat/completions:
@@ -452,7 +440,6 @@ pricing:
per_model:
agnes-3.0-flash: { input: 0, output: 0 } # 同步 2026-09-24(原 0.35/1;文档现价 ¥0/M 输入、¥0/M 输出)
agnes-2.5-flash: { input: 0, output: 0 } # 文档现价暂免(输入/输出/缓存命中均 ¥0/百万)
ark-code-latest: { input: 0.50, output: 2.00 }
agnes-2.5-pro: { input: 3, output: 6 } # 2026-09-24 自动同步(文档现价)
# ── 媒体下载代理白名单(第十七轮)────────────────────────
@@ -461,7 +448,7 @@ pricing:
# Content-Disposition: attachment,前端「下载」按钮才真的能存文件。
# 安全:这是网关唯一一个服务端主动出网的接口 —— 只有这里列出的域名(含其子域)
# 允许被代下载,且解析出来的 IP 必须是公网地址;列表为空 = 该功能整体关闭。
# 换了供应商/换了 CDN 域名时,往这里加一条即可(如 volc 的 tos-*.volces.com)。
# 换了供应商/换了 CDN 域名时,往这里加一条即可。
download:
# 维护提醒(第三十轮):这张表是**下载代理的出网白名单** —— /v1/media/download 只肯代抓这里列出的域名。
# 供应商换 CDN、或同一供应商多套存储(普通版 / 水印版)时,**漏加就会让「下载」按钮 400**
+1 -1
View File
@@ -11,7 +11,7 @@
## 1. 背景与目标
网关是一个 OpenAI 兼容的多供应商 LLM 统一接入层(Agnes / 火山方舟),已具备完整 REST 能力(对话/图像/视频/批量/模型/指标/日志/健康)。当前**只能通过 curl / 二次开发调用,没有可视化界面**。
网关是一个 OpenAI 兼容的多供应商 LLM 统一接入层(Agnes / OpenCode Go / Dots AI),已具备完整 REST 能力(对话/图像/视频/批量/模型/指标/日志/健康)。当前**只能通过 curl / 二次开发调用,没有可视化界面**。
本前端目标是给这台网关做一个**单页管理台(SPA)**:
1. 「用」—— 对话、图像、视频、批量,测试各种模型与降级行为;
+1 -1
View File
@@ -226,7 +226,7 @@ const { theme, followSystem, setTheme, setFollowSystem } = useTheme()
// 对话默认模型下拉(覆盖全部文本模型;第二十七轮: wjd 路由别名已删除,不再有"别名"选项)
const TEXT_MODELS = [
'agnes-3.0-flash', 'agnes-2.5-flash', 'ark-code-latest',
'agnes-3.0-flash', 'agnes-2.5-flash',
// OpenCode Go(订阅编程模型,17 个文本模型)
'glm-5.3-flash', 'glm-5.3', 'glm-5.2', 'glm-5.1',
'kimi-k3', 'kimi-k2.7-code', 'kimi-k2.6', 'longcat-2.0',
+51 -18
View File
@@ -92,8 +92,8 @@ def _login_admin_session(client=None):
# ── 配置加载 ──
def test_load_config_providers():
cfg = load_config(CONFIG)
# 四家供应商:Agnes / 火山方舟 / OpenCode Go / Dots AI(第三十六轮新增)
assert set(cfg.providers.keys()) == {"agnes", "volc_engine", "opencode", "dots"}
# 三家供应商:Agnes / OpenCode Go / Dots AI(火山方舟已于第四十一轮按老板要求删除)
assert set(cfg.providers.keys()) == {"agnes", "opencode", "dots"}
assert cfg.providers["agnes"].models[0].id == "agnes-3.0-flash"
@@ -114,16 +114,47 @@ def test_load_config_routes():
def test_pricing_estimate():
"""pricing.estimate() 的算术。
**为什么不再绑某个真实模型的价目**(第四十一轮改):本用例原来拿
`ark-code-latest` 当样本,理由写的是"它在每日同步脚本范围外、价格稳定"。
火山方舟供应商已按老板要求删除 → 该样本没了;而**剩下带价目的模型全是 Agnes**,
而 Agnes 的价目恰恰**会**被 `scripts/sync_models.py` 每日按官方文档改写
(`build_plan` 里 `price_set` 只对 agnes_doc 生效)—— 再拿它写死数字,
就是当初注释里警告过的"文档改价那天变假红灯"。
另外 opencode / dots 的文档报价是 **USD**,而网关 `pricing` 是 **¥/M**,
项目规矩是「不自动换算(要汇率、不能猜)」→ 也不能凭空造一条 ¥ 价目出来。
所以改成:**自造一份定价表**验证算术本身,与任何线上配置解耦。
真实配置的"有没有这条价目"由 `test_load_config_pricing_section_shape` 承担。
"""
from app.config import Pricing
pc = Pricing(per_model={
"demo-model": {"input": 0.50, "output": 2.00},
"free-model": {"input": 0, "output": 0},
})
# 1M in + 1M out = ¥0.50 + ¥2.00
cost = pc.estimate("demo-model", 1_000_000, 1_000_000)
assert cost is not None and abs(cost - 2.50) < 1e-6
# 只算输入
assert abs(pc.estimate("demo-model", 1_000_000, 0) - 0.50) < 1e-6
# 免费模型 → 0 而不是 None
assert pc.estimate("free-model", 1_000_000, 1_000_000) == 0
# 没配价目的模型 → None(表示"没数据",不是 0)
assert pc.estimate("unknown-model", 10, 10) is None
def test_load_config_pricing_section_shape():
"""真实配置的 pricing 段仍可用:每条都有 input/output 且都是数字。"""
cfg = load_config(CONFIG)
# 用火山方舟的价目:它不在每日同步脚本(scripts/sync_models.py)的范围内,价格稳定。
# (Agnes 的价目会随官方文档改价被自动更新 —— 拿 agnes-3.0-flash 写死 0.35/1.00
# 会在文档改价那天变成假红灯。)
mid = "ark-code-latest"
price = cfg.pricing.per_model[mid]
assert abs(price["input"] - 0.50) < 1e-9 and abs(price["output"] - 2.00) < 1e-9
cost = cfg.pricing.estimate(mid, 1_000_000, 1_000_000)
assert cost is not None and abs(cost - (0.50 + 2.00)) < 1e-6
assert cfg.pricing.estimate("unknown-model", 10, 10) is None
per_model = cfg.pricing.per_model
assert per_model, "pricing.per_model 不该是空的"
for mid, price in per_model.items():
for k in ("input", "output"):
assert k in price, f"{mid} 缺 {k}"
assert isinstance(price[k], (int, float)), f"{mid}.{k} 不是数字"
# 已删的火山方舟模型不该还在价目表里
assert "ark-code-latest" not in per_model, "火山方舟已删,价目不该残留"
# ── 路由解析 ──
@@ -2498,7 +2529,9 @@ def test_models_expose_vision_capability():
byid = {d["id"]: d for d in data}
assert byid["agnes-3.0-flash"]["vision"] is True, "Agnes 3.0 Flash 文档写了图像输入"
assert byid["agnes-image-2.5-flash"]["vision"] is False
assert byid["ark-code-latest"]["vision"] is False
# 第四十一轮: 火山方舟已删 → 其模型不该再出现在 /v1/models
assert "ark-code-latest" not in byid, "火山方舟已删,模型不该还在"
assert byid["deepseek-v4.1-flash"]["vision"] is True, "OpenCode 的 v4.1-flash 实测能看图"
# 第二十七轮: 路由别名已撤(/v1/models 里没有 type=route 的条目),
# 改为断言每个模型的**协议线**标签(调用方据此决定发到哪条线)。
# 第三十一轮: wjd 这个名字合法回来了,但只作为**别名条目**(alias_of 指向真实目标,
@@ -3486,9 +3519,9 @@ def test_config_save_applies_without_restart():
view["observability"]["access_log_maxlen"] = 777
_hy3 = next(x for x in view["providers"]["opencode"]["models"] if x["id"] == "hy3")
_hy3["protocols"] = ["chat/completions", "messages"]
view["providers"]["volc_engine"]["models"].append(
{"id": "ark-code-mini", "display_name": "迷你", "type": "text", "vision": False})
view["pricing"]["per_model"]["ark-code-mini"] = {"input": 0.1, "output": 0.2}
view["providers"]["agnes"]["models"].append(
{"id": "agnes-demo-mini", "display_name": "迷你", "type": "text", "vision": False})
view["pricing"]["per_model"]["agnes-demo-mini"] = {"input": 0.1, "output": 0.2}
r = client.put("/config", headers=ah, json={"config": view})
assert r.status_code == 200, r.text
@@ -3502,7 +3535,7 @@ def test_config_save_applies_without_restart():
assert next(x for x in m.config.providers["opencode"].models
if x.id == "hy3").protocols == ["chat/completions", "messages"], \
"协议线改动应就地生效(无需重启)"
assert m.config.find_provider_for_model("ark-code-mini")[0] == "volc_engine"
assert m.config.find_provider_for_model("agnes-demo-mini")[0] == "agnes"
assert m._access._max == 777, "访问日志容量应就地调整"
# 盘上也变了,且旧文件有备份
on_disk = _yaml.safe_load(cfg_path.read_text(encoding="utf-8"))
@@ -3717,7 +3750,7 @@ def test_opencode_session_header_from_conversation_id():
h1 = ad._req_headers()["x-opencode-session"]
h2 = ad._req_headers()["x-opencode-session"]
assert len(h1) == 32 and h1 != h2
# 非会话供应商(agnes / 火山)根本不该带这个头
# 非会话供应商(agnes / dots)根本不该带这个头
ag = create_adapter(cfg.providers["agnes"], "dummy-token")
assert "x-opencode-session" not in ag._req_headers("conv-abc")
@@ -4905,7 +4938,7 @@ def test_alias_panel_round_trip_and_save_validation():
# 「面板往返不丢 / 保存即生效 / 非法目标 400 不写盘」,不假设起始状态为空。
assert "aliases" in view, view.keys()
# 换一个和生产默认不同的目标,才能证明写入真的生效了
target = "ark-code-latest"
target = "agnes-2.5-pro"
payload = {"wjd": {"enabled": True, "target": target, "note": "客户入口"}}
# 面板真实载荷:模型页「保存映射」只提交 aliases 一段(Models.vue saveAlias),
# 不是整份视图 —— 服务端按段合并,其余段沿用文件原文(连行尾注释都不动)。