第三十三轮:模型接口加入上下文参数(context_window / max_output_tokens)

老板 2026-09-24 要求:「文档里有写明支持上下文多少吗?有的话就修改 ai 网关,
接口加入上下文参数」+「Agnes 先加上,opencode go 看下 v2/docs/console/go/ 文档,
没有的话就看接口里有没有,这个也要加入同步脚本里」。

数据来源(逐一核查过):
- Agnes:官方**每个文本模型详情页**的「限制与价格」表写明 `上下文窗口` / `最大输出`
  (定价页没有这两项)。3.0-flash = 512K/65,536、2.5-flash = 512K/65.5K、
  2.5-pro 与 2.5-pro-beta = 1M/65,536。图片/视频页无此表 → 留 0。
- OpenCode:官方文档(Zen 页、v2/docs/console/go/)**都不写**上下文;`/zen/go/v1/models`
  实测只回 id/object/created/owned_by(单模型详情 404、include 参数被忽略)。
  唯一机器可读来源是 **models.dev**(OpenCode 团队维护),其 `opencode-go` /
  `opencode` 两供应商每条模型都带 `limit.context` / `limit.output`。
  口径(老板拍板):只用于**更新网关已有模型**,不拿它当增删依据(models.dev 收录
  比官方 Go 文档多,含 omen-alpha 等未收录的);跨源不一致时取**保守下限**
  (minimax-m3 Go 1M / Zen 512K → 512,000;qwen3.6-plus → 262,144)。

改动:
- app/config.py:ModelInfo 新增 context_window / max_output_tokens(默认 0 = 未标注),
  解析 + to_dict 序列化一并带上。
- app/main.py:GET /models 与 /v1/models 输出这两个字段;别名继承目标模型的值。
- app/settings.py:「供应商与模型」面板往返不丢字段(默认 0 → 未配置的模型不会被
  补出 `context_window: 0` 污染 YAML);提交了就以此为准,没提交则沿用文件原文。
- data/gateway.yaml:37 个模型落盘(33 OpenCode + 4 Agnes 文本),文本级插入保住
  全部手写注释(注释行 162 → 236)。
- scripts/sync_models.py:新增 fetch_models_dev()(拉失败返回 None → 只跳过上下文
  同步、不当成漂移)、fetch_agnes_context()(逐模型页解析「限制与价格」表)、
  diff() 产出 ctx_drift、build_plan/apply_plan(_set_context 块内改值,保留行尾注释、
  幂等)、verify() 回读校验、render_plan/render 显示漂移;_DRIFT_KEYS 与
  plan_is_empty 认 ctx_set。
- tests:新增 3 个(models.dev 保守下限合并 + 抓失败返回 None;_set_context 幂等与
  保注释;/models 带出字段且未标注不瞎补)→ **201 passed / 0 failed**;ci_check.sh 全绿。

上线:supervisorctl restart api-gateway:api-gateway_00(pid 3492804)后实测
/v1/models 45 个模型、38 个带 context_window(含 wjd 别名继承 = 1,000,000/384,000),
图片模型正确为 0。
This commit is contained in:
api-gateway committed 2026-09-24 15:00:26 +08:00
1 parent 1c4bc9fb1e
commit 64054ad920
6 files changed
+428 -7

No files matched your search

+20 -1
View File
@@ -111,7 +111,12 @@ def config_to_view(cfg: GatewayConfig) -> dict[str, Any]:
# 第二十七轮: 模型能走哪几条协议线。这一项**面板可编辑**
# (「供应商与模型」页给每个模型打格式标签),所以两处都要认:
# 读回给页面显示、写盘时以页面提交的为准。
"protocols": list(m.protocols)}
"protocols": list(m.protocols),
# 第三十三轮(2026-09-24): 上下文窗口 / 最大输出。面板不提供编辑入口
# (由 scripts/sync_models.py 每日同步),但必须一路带着走 ——
# 否则管理员在页面上随手保存一次,这两个值就被静默清成 0。
"context_window": int(m.context_window or 0),
"max_output_tokens": int(m.max_output_tokens or 0)}
for m in p.models
],
}
@@ -224,6 +229,11 @@ _MODEL_KEY_DEFAULTS: dict[str, Any] = {
"type": "text",
"vision": False,
"protocols": list(DEFAULT_PROTOCOLS), # 不写 = 自动走默认线(chat/completions)
# 第三十三轮(2026-09-24): 未标注的模型(图片/视频、或上游没给数的)**不写**这两个键。
# 默认 0 与 ModelInfo 一致 → _prune_defaults 会把面板补出来的 0 丢掉,
# 只有 sync_models.py 明确写入的非 0 值才留在文件里。
"context_window": 0,
"max_output_tokens": 0,
}
@@ -343,6 +353,15 @@ def view_to_raw(cfg: GatewayConfig, raw: dict[str, Any], view: dict[str, Any]) -
"type": str(m.get("type") or "text").strip(),
"vision": bool(m.get("vision", False)),
})
# 第三十三轮(2026-09-24): 上下文窗口 / 最大输出由 sync_models.py 维护,
# 面板不提供编辑入口 —— 提交了就以此为准,没提交则沿用文件原文
# (旧前端/脚本提交时不至于把这两个值清成 0)。
for _k in ("context_window", "max_output_tokens"):
if m.get(_k) is not None:
try:
item[_k] = int(m.get(_k) or 0)
except (TypeError, ValueError):
pass
# 第二十七轮: 协议线由面板管理(每个模型的格式标签),提交了就以此为准;
# 没提交则沿用文件原文里的值(避免旧前端/脚本提交时把 protocols 清空)。
if m.get("protocols"):