Files
xiaoyin-gateway/CHANGELOG.md
T
api-gateway 6bdf2ef357 config: deepseek-v4.1-flash 标注 vision(实测确认为多模态)
- 实测:带图请求(data:image/png;base64)红/蓝/绿三色全部识别正确;
  同请求打到纯文本模型 deepseek-v4-flash 被上游 400 拒(对照组成立)
- 过网关复测:直连 + 路由别名 wjd(带图排视觉模型)均正确
- gateway.yaml 加 vision: true(附实测注释);README 模型清单标「(视觉)」
- 纯配置 → hot_reload 生效,未重启后端;/v1/models 中 vision 已由 false → true
- 判定坑:推理模型 max_tokens 太小会被 reasoning_content 吃空 content,需 ≥300
2026-09-18 12:21:36 +08:00

51 KiB
Raw Blame History

CHANGELOG

按轮次记录 api-gateway 的修复与优化(README 侧重能力/配置说明,这里侧重每轮的改动、排查、验证与上线)。


2026-09-18 · deepseek-v4.1-flash 视觉能力实测确认(纯配置,hot_reload 生效)

背景:老板提示 deepseek-v4.1-flash(OpenCode Go)是多模态。上游 /models 不提供能力字段(返回只有 id/object/created/owned_by),只能靠真实调用判定,不能凭文档或模型名猜。

实测方法与结果(真实 key)

  • 对照组设计:同一条带图请求(content=[{type:"text"},{type:"image_url",image_url:{url:"data:image/png;base64,…"}}]) 分别打给目标模型和已确认纯文本的 deepseek-v4-flash —— 后者 HTTP 400,前者 HTTP 200,区分成立 (否则"200"可能只是上游忽略图片块,无法证明它真的看了图)。
  • 颜色判别(64×64 纯色 PNG,红 220,30,30 / 蓝 30,60,220 / 绿 30,200,80):deepseek-v4.1-flash 红/蓝/绿三色全部答对,与已标视觉的 deepseek-v4-flash-vision-exp 表现完全一致。
  • 过网关复测(公网 https://api.wangjinding.com):直连 deepseek-v4.1-flash 三色全对;路由别名 wjd 带图请求被排到视觉模型、答对「红色」。
  • 踩坑(判定方法的坑):它是推理模型,max_tokens 给小了(首次探针用 40)时 token 全被 reasoning_content 吃光、content 返回空串——看起来像"只收图不回答"。复测放大到 300+ 才拿到答案。 以后判定视觉能力别用 40 这种量级。

改动

  • data/gateway.yaml:deepseek-v4.1-flash 增加 vision: true(附实测注释)。
  • README.md:OpenCode Go 模型清单里该模型标注「(视觉)」,并补进「视觉能力位」说明段。
  • 纯配置改动 → hot_reload 15s 自动生效,未重启后端、未踢网页会话。/v1/models 中该模型 vision 由 false → true(实测确认);带图请求现在也会在 wjd 路线上把该模型视为视觉候选。

2026-09-18 · 第二十五轮:模型参数硬约束 + 测速超时/错误文案(一轮全修)

背景(两条线一起收):上一轮排查出两个"看起来都坏了"的模型,其实是两回事:

  1. kimi-k2.7-code 每次必挂 —— 上游只接受 temperature=1,而一键测速探针固定发 temperature: 0,于是每次都 400 invalid temperature: only 1 is allowed for this model。更严重的是:这不只影响测速 —— 前端对话页的温度滑块默认 0.7,用户把这个模型拖到任何非 1 的值都会 400。
  2. mimo-v2.5 不是坏,是慢 —— 直连 2.23s、过网关 2.98.4s,偶发冲破探针 15s 超时。但旧文案只回 str(e),两者在前端都显示成含糊的「调用失败」,无从区分。

改动

  • app/config.py
    • ModelInfo 新增 params: dict(模型级强制参数):发往上游前覆盖客户端传值。
    • 新增 MODEL_PARAM_KEYS 白名单(temperature/top_p/top_k/max_tokens/min_tokens/presence_penalty/frequency_penalty/repetition_penalty/seed/logit_bias/n)。结构性键(model/messages/stream/tools)刻意不放行 —— 放行等于把路由与协议语义交给配置文件,重开一条越权面。
    • 新增 _parse_model_params():非映射、空参数名、白名单外的键、非法值类型一律 ConfigError(写错立刻报错,绝不静默失效)。
    • all_models() 暴露 params,供 /v1/models 与前端标注。
  • app/adapters/openai_compat.py
    • 新增 model_params 入参、_forced_params(model)(配置 > 运行期自学习)。
    • _build_payload() 末尾应用强制参数:在 strip_protected(extra, CHAT_CORE_KEYS) 之后覆盖,客户端连同 extra 逃生舱都改不动。
    • 新增 _learn_from_upstream_error():上游 400 报文里出现 invalid <参数>: only <X> is allowed / <参数> must be greater than <N> 时,按上游要求修正并重发一次。这不是"重试"——报文照原样重发只会再吃一次 400。学到的值缓存进实例(后续请求直接按修正值组装,不再多一轮往返);学不到新东西就返回 None,绝不与同一约束来回打转;管理员已在配置里写死的参数不被偷偷改(值冲突时只打日志说明)。
    • chat / chat_stream 拆出 _post_chat / _stream_once,各自在"开局就被 400 顶回"时走一次修正重发;流式若已开始吐内容则不重发(避免重复输出/串话)。
  • app/adapters/__init__.py:create_adapter 把各模型 params 带进适配器 —— 对话 / 流式 / 批量 / 一键测速所有入口自动一致,不会出现"主链路修了、测速还漏着"的偏差。配置变更时 main._apply_config 丢弃适配器缓存,约束不会滞留旧值。
  • app/main.py
    • _models_payload() 在 /v1/models 暴露 params(该端点自己构造 data 项,不是直接用 all_models() 的结果)。
    • 测速探针超时 15s → 30s(≈实测最慢值的 3 倍)。该 timeout 只作用于探针自己创建的 adapter(适配器缓存 key 含 timeout),不影响真实对话链路的 server.timeout。
    • 新增 _speedtest_error_text():超时 → 上游超时(>30s 未响应);上游 4xx/5xx → 透出上游原文(如 invalid temperature: only 1 is allowed for this model)。
  • app/settings.py
    • view_to_raw() 的模型项改为「以文件原文为底」再覆盖面板管的 4 个键 —— 面板的模型编辑器不认 params,照它重建会静默清掉手写约束(管理员只是在页面上改了别的东西,上游硬约束就没了)。
    • config_to_view() 回传 params,roundtrip 不丢。
  • data/gateway.yaml:kimi-k2.7-code 写死 params: {temperature: 1}。
  • 前端
    • Models.vue:模型行前缀挂锁图标(title 说明),模型清单「能力」列新增「参数固定」标签(列宽 120 → 190)。
    • Chat.vue:温度 chip 加挂锁;参数抽屉顶部新增说明条「该模型参数由网关固定:… (你在这里调的值会被网关覆盖后再发送)」;模型下拉选项同步挂锁。
    • Icon.vue 新增 lock;中英文案 paramTag / paramLocked 对称(726/726)。

验证

  • 上游全量扫描:20 个文本模型逐个以 temperature=0 探测,只有 kimi-k2.7-code 被拒(400 invalid temperature: only 1 is allowed for this model),改 temperature=1 复测 200。→ 约束只此一处,未凭猜测给别的模型加参数。
  • 配置层:非法 params(结构性键 / 非法值类型 / 非映射)全部被 ConfigError 拦下;真配置解析出 opencode/kimi-k2.7-code → {'temperature': 1};/v1/models 暴露一致。
  • 适配器层(MockTransport,7 个场景):① 配置强制覆盖客户端传值且只发 1 次;② 未配时 400 → 按上游要求修正重发(0 → 1);③ 学到后后续请求直接带修正值(1 次);④ 上游一直 400 → 只发 2 次就抛错;⑤ 配置值与上游要求冲突 → 尊重配置、不发第二枪;⑥ 非参数类 400(额度)→ 原样抛错,不误改参数;⑦ 流式开局 400 → 修正后重发成功。
  • 隔离实例真机(/tmp/gw25-verify/project,8899,生产 8808 全程未动):真 key 实测 kimi-k2.7-code 测速 1668ms 成功、mimo-v2.5 4691ms 成功;主链路显式 temperature=0 → 200 + 正常内容(finish_reason=stop),流式同样 200。
  • 真浏览器(同一隔离实例):Models 页 kimi-k2.7-code 行出现橙色挂锁、「参数固定」标签、单行测速 1566 ms;Chat 页选中该模型后温度 chip 带挂锁、抽屉顶部出现固定说明条。
  • 单测:168 passed / 0 failed(+10:参数解析/白名单拦截/真配置锁定/强制覆盖/自动修正重发/不无限重试/配置冲突/流式修正/测速文案/面板保留 params);前端 vue-tsc --noEmit 通过、check:i18n 726/726 对称、check:svg 通过、npm run build 成功(在副本内构建,未覆盖生产 dist)。

上线(待老板批准)

  • 含 Python 代码改动(config / adapters / main / settings)→ 需 supervisorctl restart api-gateway:api-gateway_00 才生效(会踢网页会话)。
  • 前端需 npm run build 覆盖 frontend/dist(挂锁/提示条才会出现在线上)。
  • CNB 推送新增提交。

一句话:给模型加「强制参数」机制并给上游硬约束的 kimi-k2.7-code 写死 temperature: 1(同时兜一道"上游报什么就改成什么"的自学习重发),把探针超时从 15s 放宽到 30s 并让失败文案说清是超时还是上游拒绝 —— 于是"必挂的模型"变 1.5s 成功、"慢的模型"不再被误判成坏。


2026-09-18 · OpenCode Go 会话 id 升级为「对话级稳定」(方案 A)

背景:上一轮 x-opencode-session 是每请求随机 UUID —— 能过上游 400 强校验,但每次 id 都变,吃不到文档所述的提示词缓存。本轮按老板要求实现稳定会话:同一段对话共用同一个 session id。

改动

  • app/models.py:ChatRequest 显式声明 conversation_id: str | None(网关内部字段,不进 model_extra → 不透传上游)。
  • app/adapters/openai_compat.py:_req_headers(session_id)、chat/chat_stream 新增 session_id 参数——传入则原样用作 x-opencode-session,缺省回退随机 UUID。
  • app/main.py:非流式与流式主链路把 req.conversation_id 作为 session_id 传入适配器。
  • frontend/src/views/Chat.vue:对话页新增 convId(crypto.randomUUID,带老浏览器回退),buildPayload 注入 conversation_id,随对话状态持久化(sessionStorage + 服务端历史);applyChat 沿用历史里的 id、否则新建;clearConversation 生成新 id(新对话不共享旧缓存)。
  • tests/test_gateway.py:新增 test_chat_conversation_id_is_internal_not_upstream、test_opencode_session_header_from_conversation_id。

验证

  • 单测 157 passed / 0 failed(+2);前端 vue-tsc --noEmit 通过。
  • 真实 key 冒烟:同一 conversation_id 两次调用均 200,x-opencode-session 稳定一致;缺省回退 32 位随机、两次不同;非会话供应商不带该头。
  • 说明:缓存命中是上游机会性优化,网关侧保证的是「同一对话稳定 session」。

上线(待老板批准)

  • 含后端代码改动 → 需 supervisorctl restart;前端 Settings.vue/Chat.vue 改动需 npm run build 覆盖 dist;CNB 推送待确认。

一句话:给网关接入 OpenCode Go(https://opencode.ai/zen/go/v1)的 OpenAI 兼容 /chat/completions 线 17 个文本模型;按老板「wjd = 全部文本模型」规则全部并入 routes.wjd。

背景(文档要点)

  • OpenCode Go 是每月订阅制编程模型入口;每个请求必须带 x-opencode-session 头(实测缺它接口 400 MissingSessionID),建议专属 User-Agent(实测 UA 不敏感,session 头才是硬性要求)。
  • 模型分三条契约线:/chat/completions(OpenAI,本网关可直连)、/messages(Anthropic MiniMax/Qwen 等)、/responses(Grok/GPT/Muse)。仅接入 OpenAI 兼容线;其余两条不在本次范围。

改动

  • data/.env:新增 OPENCODE_API_KEY(600、gitignored)。
  • data/gateway.yaml:
    • 新增 providers.opencode:base_url https://opencode.ai/zen/go/v1、token_env OPENCODE_API_KEY、requires_session_header: true、extra_headers.User-Agent: api-gateway/2.4.0 (jakon opencode-go),收录 17 个文本模型(glm-5.3-flash/5.3/5.2/5.1、kimi-k3/k2.7-code/k2.6、longcat-2.0、deepseek-v4-pro/v4-flash/flash/v4.1-flash/v4-flash-vision-exp(视觉)、mimo-v2.5/v2.5-pro、hy4-preview/hy3)。
    • routes.wjd 追加这 17 个(wjd 链 = 20 个文本模型)。
    • 未收录:glm-5、kimi-k2.5、hy3-preview(上游实测 400 Model is unavailable);/messages、/responses 线模型未接入(适配器不含该契约)。
  • app/config.py:ProviderConfig 加 requires_session_header 字段并解析。
  • app/adapters/openai_compat.py:OpenAICompatAdapter 加 requires_session_header,在每次请求动态注入 x-opencode-session: <uuid>(不能放静态 headers——_get_adapter 缓存会冻结)。
  • app/adapters/__init__.py:create_adapter 透传开关。
  • app/settings.py:面板视图与写回均增补 requires_session_header(否则 roundtrip 后该字段被重置为 False)。
  • frontend/src/views/Settings.vue:默认模型下拉 TEXT_MODELS 追加 17 个 go 模型(老板「全部文本模型」)、保留 wjd 在最前。
  • tests/test_gateway.py:
    • test_load_config_providers 断言 {"agnes","volc_engine","opencode"};test_load_config_routes wjd 长度 3→20。
    • 修复既有污染:test_effective_rps_priority 直接用共享 m._cfg() 把 agnes.rate_limit_rps 改成 9 且未还原,新增 go 模型后触发限流桶被填满、令 chat_unknown / batch / streaming fallback 三个测试在全套运行时假红——已加 finally 还原(这本质是测试手尾泄漏,非业务 bug)。

验证

  • 文档端点实测:GET /zen/go/v1/models 通,返回 38 个模型(原生 id、无前缀)。
  • 契约实测:17 个 chat/completions 模型真实 key 全部 200;glm-5 / kimi-k2.5 / hy3-preview 400 未收录。
  • 头敏感性实测:带 x-opencode-session 必 200,缺它必 400(UA 无关)。
  • 适配器端到端(真实 key):非流式 glm-5.3-flash 与流式 deepseek-v4-flash 均正常返回(证明会话头注入生效)。
  • 单测:155 passed / 0 failed;前端 vue-tsc --noEmit 通过。

上线(待老板批准)

  • 含 Python 代码改动(config / adapters / settings)→ 需 supervisorctl restart api-gateway:api-gateway_00 才生效(会踢网页会话);纯 yaml 的 hot_reload 只重载供应商/模型定义,requires_session_header 字段与注入逻辑要重启后代码才认。
  • 前端 build 覆盖 dist(纯前端上线动作)与 CNB 推送待老板确认。

一句话:老板拍板——现有 + 以后新增的每一个文本模型都必须加入 routes.wjd 兜底链。本次把 agnes-2.5-flash 补进 wjd,并把这句作为长期规则写入 MEMORY / README / CHANGELOG,供后续新增模型照做。

改动

  • data/gateway.yaml:routes.wjd.models 补第 3 位 agnes-2.5-flash,链改为 ark-code-latest → agnes-3.0-flash → agnes-2.5-flash;加上注释「wjd 链路 = 全部文本模型(新增/现有都必须加入)」。
  • README.md:wjd yaml 示例链同步为 3 模型 + 同一句注释。
  • tests/test_gateway.py:test_load_config_routes 断言 len(wjd.models) == 2 → 3。
  • MEMORY.md / memory/2026-09-18/wjd-route-rule.md:记录决策为长期约束(新增文本模型必须同时进 routes.wjd.models)。

验证

  • 静态校验:data/gateway.yaml 中全部 type: text 模型 = agnes-2.5-flash / agnes-3.0-flash / ark-code-latest,与 routes.wjd.models 完全一致(无缺失、wjd 无多出的非文本模型)。
  • 单测:python3 tests/test_gateway.py → 155 passed, 0 failed。
  • 运行时排序不受影响:wjd 仍按「可用性 + 速度」实时重排,配置序只是冷启动初始序;timeout:60 / retry:1 不变。

上线

  • 纯配置改动,hot_reload ≤15s 自动生效,无需重启、不踢会话;是否推 CNB 等老板确认。

一句话:给 Agnes 供应商注册新模型 agnes-2.5-flash(2.0 升级版,OpenAI 兼容 Chat Completions,支持图像 URL 输入)。

改动

  • data/gateway.yaml:providers.agnes.models 新增:
    • agnes-2.5-flash(text,vision: true,注释注明:2.0 升级版、OpenAI 兼容 /v1/chat/completions、支持图像 URL 输入与工具调用、上下文 512K / 输出 65.5K、现价暂免)。
    • pricing.per_model 新增 agnes-2.5-flash: { input: 0, output: 0 }(文档现价输入/输出/缓存命中均 ¥0/百万)。
  • frontend/src/views/Settings.vue:TEXT_MODELS(对话默认模型下拉)插入 agnes-2.5-flash(['wjd','agnes-3.0-flash','agnes-2.5-flash','ark-code-latest'])。
  • README.md:供应商表 Agnes 行补 agnes-2.5-flash(text,支持图像输入)。

实测(连真实 AGNES_API_KEY,经生产适配器直调)

  • 文本 agnes-2.5-flash → 200 "正常" ✅
  • 视觉(200×200 红图 data:URI)→ 200 "红色" ✅(vision 标记确认正确)

上线

  • 纯配置(gateway.yaml)hot_reload ≤15s 自动生效、免重启;前端 npm run build 覆盖 dist(新入口 index-BcM3V8if.js),/web/ 静态服务自动服务新产物。
  • 单测 155 passed / 0 failed(新增模型未破坏现有断言,models[0] 仍为 agnes-3.0-flash)。

说明

  • 未加入 routes.wjd 兜底链(boss 未要求)——如需让它在 wjd 路由里兜底,加进 routes.wjd.models 即可。
  • agnes-3.0-flash 仍是 TOKEN_MODELS 里第 2 顺位(紧随 wjd)。

2026-09-17 · 移除智谱 GLM(bigmodel)供应商

一句话:老板要求删除智谱供应商,代码/配置/文档/测试/前端全清——覆盖上上轮新增的 6 个 GLM 文本模型(含 3 视觉)、CogView-3-Flash 文生图、CogVideoX-Flash 文生视频及配套的媒体契约代码。

改动清单(除 CHANGELOG 历史条目外全部清零)

  • data/gateway.yaml:删 providers.bigmodel 整块(GLM-4.7-Flash/GLM-4-Flash-250414/GLM-Z1-Flash/GLM-4.6V-Flash/GLM-4V-Flash/GLM-4.1V-Thinking-Flash 6 文本 + cogview-3-flash 图像 + cogvideox-flash 视频 + 整套 media 配置);download.allowed_hosts 删智谱 CDN 项(maas-watermark-prod-new.cn-wlcb.ufileos.com);头注释供应商列表 → Agnes / 火山方舟 Coding。routes.wjd、pricing 本就不含智谱,无需动。
  • data/.env:删 ZHIPU_API_KEY。
  • app/config.py:MediaConfig 删 video_style / video_default_size 两个字段及其解析(智谱视频契约专用)。
  • app/main.py:_ZHIPU_VIDEO_SIZES 常量删;_validate_video_request 删 zhipu 分支、恢复单参数 (req)、docstring 去"接入其它视频供应商";videos_create 恢复"先入站校验后解析"原顺序(去掉按供应商媒体契约分流);_video_status 改通用描述(去智谱词,状态优先级 status/state/task_status);description → (Agnes / 火山方舟)。
  • app/settings.py:面板 MEDIA_KEYS 删 video_style / video_default_size。
  • app/adapters/{__init__,openai_compat}.py:docstring「三家」→「两家」;create_video / poll_video 删 zhipu 分支(恢复纯 Agnes 风格);删 urllib.parse.quote 导入。
  • 前端:Settings.vue TEXT_MODELS 去 6 个 GLM;Videos.vue 删智谱视频专用表单/状态/watch/create 分支,恢复 Agnes 表单;Images.vue 删 cogview 像素档/isZhipu/参考图与 ratio 的 v-if;locales/{zh,en}.ts 删 videos.z*(7 键/语言);media.ts findVideoUrl 优先键去 video_result。
  • README.md / docs/frontend-design.md:供应商改两家,删智谱供应商表行、.env 说明去 ZHIPU_API_KEY。
  • tests/test_gateway.py:test_load_config_providers 账号集合→{agnes,volc_engine}、删智谱媒体断言;速度排序测试用 [ark-code-latest,agnes-3.0-flash] 两模型演示(删 GLM);test_vision_first 用 agnes-3.0-flash(vision)当视觉样例;媒体路由别名测试/配置写回测试/视频轮询测试改用真实模型或恢复原样。

验证 / 上线

  • 单测 155 passed / 0 failed;全项目 grep 智谱|bigmodel|GLM|cogview|cogvideox|ufileos|ZHIPU|zhipu|video_style|_ZHIPU 除 CHANGELOG 历史外全部清零。
  • 前端 npm run build 过(typecheck + i18n 对称),新入口 index-BynIw5Ue.js。
  • 配置校验:providers [agnes,volc_engine]、模型 agnes[3] + volc[1]、routes.wjd 2 项、下载白名单仅 Agnes。
  • supervisorctl restart api-gateway:api-gateway_00 上线(description/适配器/校验等属代码改动,需重启)。

2026-09-17 · 移除 b.ai 供应商

一句话:老板要求删除 b.ai 供应商及其两个模型(qwen3.8-flash、hy3),代码、配置、文档、测试全清。

改动清单

  • data/gateway.yaml:删 providers.b_ai 整块(含 qwen3.8-flash、hy3 两个模型);routes.wjd 兜底链由 4 项(ark-code/agnes/qwen3.8/hy3)精简为 2 项(ark-code-latest → agnes-3.0-flash);pricing.per_model 删 qwen3.8-flash/hy3 两条;头部供应商注释 Agnes / b.ai / 火山方舟 / 智谱 GLM → Agnes / 火山方舟 / 智谱 GLM。
  • data/.env:删 B_AI_API_KEY=sk-nf...(纯删除,密钥不再使用)。
  • app/main.py:description 字符串去 b.ai;测速探针注释去掉 b.ai(qwen3.8-flash/hy3) 引用。
  • app/config.py:ModelInfo.vision 注释去掉 b.ai 系。
  • app/adapters/{__init__,openai_compat}.py:docstring「四家」→「三家」,供应商列表去 b.ai。
  • README.md:头部「四个供应商」→「三个」;供应商表删 b.ai 行;路由示例去 qwen3.8-flash/hy3 并去其重编号;pricing 示例去 b.ai 两条;# 编辑 .env 填入 行去 B_AI_API_KEY。
  • frontend/src/views/Settings.vue:TEXT_MODELS 去 qwen3.8-flash。
  • docs/frontend-design.md:供应商列表去 b.ai。
  • tests/test_gateway.py:test_load_config_providers 集合去 b_ai;test_load_config_routes wjd 长度 4→2;test_wjd_route_orders_by_availability_and_speed 用 GLM-4.7-Flash 替代 qwen3.8-flash 做速度排序演示,env var 清单改 ZHIPU_API_KEY;test_vision_first_reorders_only_when_vision_exists 改用非视觉模型 GLM-Z1-Flash(原 hy3);test_config_endpoints_permission_matrix 及路由写回测试中的 hy3 改 GLM-4.1V-Thinking-Flash;媒体路由测试的 qwen3.8-flash 改 GLM-4.1V-Thinking-Flash。

验证

  • 单测 155 passed / 0 failed(修正 6 处断言后全绿)。
  • 全项目 grep b_ai|api.b.ai|B_AI_API_KEY|qwen3.8-flash|hy3 命中仅为 CHANGELOG 历史条目(保留)—— 其余全部清零。
  • 纯配置+文档改动,hot_reload 自动生效;若重启,/v1/models 由 14 → 12(agnes 3 + volc_engine 1 + bigmodel 8),routes.wjd 由 4 → 2。

2026-09-16 · 集成智谱 CogView-3-Flash(文生图)+ CogVideoX-Flash(文生视频)

一句话:给上一轮的智谱供应商补上媒体生成——图像页用 cogview-3-flash、视频页用 cogvideox-flash,前后端按「选到的供应商」自动切到智谱契约(不动 Agnes)。

契约(官网 + 真 Key 实测确认)

  • 图像 cogview-3-flash:POST {base}/images/generations,{model, prompt, size}(size 为像素档:1024x1024/768x1344/864x1152/1344x768/1152x864/1440x720/720x1440)→ 返回 data[].url;无 ratio、不支持图生图。
  • 视频 cogvideox-flash:POST {base}/videos/generations(异步){model, prompt, quality, with_audio, size, fps:30/60} → 返回 task_status:PROCESSING;再 GET /async-result/{id} 轮询到 SUCCESS 取 video_result[].url。仅文生视频。

后端

  • data/gateway.yaml bigmodel 加 media(图像端点+像素档、视频 /videos/generations+/async-result/{id},新增 video_style:"zhipu"),并注册 cogview-3-flash(image)、cogvideox-flash(video)(顺带修复本轮早前编辑误吞的 server: 顶层键)。
  • config.py:MediaConfig 新增 video_style / video_default_size。
  • 适配器 create_video / poll_video:按 video_style=="zhipu" 走智谱异步契约(fps/quality/with_audio + 路径参数轮询);Agnes 分支不变(__init__.py docstring 改四家)。
  • main.py:新增 _video_status(兼容 task_status,智谱才识得 SUCCESS/FAIL 终态)与 _video_terminal,替换 3 处视频状态判定;_validate_video_request 按供应商分流(智谱仅 text 文生视频,size/quality/fps 合规校验,非法回干净 400 不进熔断);videos_create 改为先 _resolve_media_model 再按供应商校验。
  • settings.py:面板 MEDIA_KEYS 补 video_style/video_default_size(否则「网关配置」面板往返会丢这两个字段)。
  • 顺带修正 DELETE /feedback 过时 docstring(admin 可真删 admin_delete)。

前端(按所选模型 provider==='bigmodel' 自动切)

  • Videos.vue:选智谱视频模型显示专用表单(分辨率/质量 speed·quality/帧率 30·60/配音 switch,固定文生视频),body 用 extra:{quality,fps,with_audio};选 Agnes 原表单不变;切智谱模型时强制 mode='text'。
  • Images.vue:选 cogview 时 size 换成像素档、隐藏 ratio 与参考图(cogview 无图生图)。
  • media.ts:findVideoUrl 优先键补 video_result。
  • i18n:新增 videos.zSize/zQuality/zSpeed/zQualityHigh/zFps/zAudio/zTip 7 键,中英对称。

验证

  • 单测:新增/修正 bigmodel 媒体契约断言、视频轮询必经 ?model=(现两家视频供应商)、配置往返含新 media 键 → 155 passed / 0 failed;前端 npm run build 过(typecheck + i18n 对称),新入口 index-CxdHy_Sw.js。
  • 真机隔离(uvicorn:8899 临时 users/history,连真实智谱):/v1/models 列出 8 个智谱模型;图像 → 200 data[].url;视频创建 → video_id+task_status:PROCESSING;轮询 → status:processing;非法参数(mode=keyframe)→ 400 干净拒绝。
  • 上线:supervisorctl restart api-gateway:api-gateway_00(代码改动需重启),前端 dist 已 build 覆盖。
  • 补「下载白名单」:上线后老板实测智谱图/视频下载报「不在白名单:maas-watermark-prod-new.cn-wlcb.ufileos.com」。已确认智谱图+视频产物同一 CDN 域名(实测视频 SUCCESS 结果 url 同域),在 download.allowed_hosts 补 maas-watermark-prod-new.cn-wlcb.ufileos.com(精确项 + 子域匹配,不泛放整个 ufileos.com;evilufileos.com、后缀撞车域名仍拒绝)。纯配置改动,hot_reload ≤15s 自动生效免重启。已用隔离服务器实测:智谱图经 /v1/media/download 拉回 200 + 有效 JPEG 97KB。

2026-09-16 · 新增智谱 GLM(open.bigmodel.cn)供应商

一句话:接入智谱开放平台作为新的 OpenAI 兼容供应商,收录 6 个 Flash 模型(3 文本 + 3 视觉),密钥走 data/.env 的 ZHIPU_API_KEY,真图实测确认 3 个 V 型号支持图像输入。

供应商接入

  • data/gateway.yaml 新增 providers.bigmodel:
    • base_url: https://open.bigmodel.cn/api/paas/v4(适配器自动拼 /chat/completions)
    • auth.token_env: ZHIPU_API_KEY(明文 key 不进 yaml,统一放 data/.env,chmod 600)
    • 媒体端点 media: {}(智谱无图像/视频生成端点)
    • 模型 6 个:GLM-4.7-Flash、GLM-4-Flash-250414、GLM-Z1-Flash、GLM-4.6V-Flash、GLM-4V-Flash、GLM-4.1V-Thinking-Flash,其中 3 个 V 型号标 vision: true
  • data/.env 追加 ZHIPU_API_KEY=<智谱 Key>(49 位,未入版本库)。
  • 前端 Settings.vue 的「对话默认模型」静态清单 TEXT_MODELS 追加这 6 个模型;Models 页 / /v1/models 本身是动态的,重启后自动出现。

排查与实测(重点)

  • 首把 Key cdfb6b5e... 直接裸调 6 模型一度全 401「令牌已过期」 → 误判 Key 无效。后用官方示例格式 + glm-5.3 重打是 429「余额不足」(说明 Key 认证是通的)→ 回到 6 模型官方格式再打:5 个 200,GLM-4.7-Flash 偶发 429「访问量过大」(1305,瞬时过载,模型存在)。结论:Key 有效,之前 401 是上游瞬时过载造成的误报。
  • 视觉探针(1×1 红图)被智谱拒 400 code 1210「图片输入格式/解析错误」 —— 是图太小的问题,非格式问题。换 200×200 标准红图后 data-URI 与外链 URL 均识别:GLM-4V-Flash、GLM-4.1V-Thinking-Flash 认「红色」✅;GLM-4.6V-Flash 全程遇上游过载(1305)未取到视觉结果,型号带 V 故仍标 vision: true(如后续实测不一致可再改)。
  • 端到端:用生产同一适配器 OpenAICompatAdapter(真实 base_url + Bearer 解析 token)直连智谱——文本 GLM-4-Flash-250414 ✅、推理 GLM-Z1-Flash ✅(返回含 thinking)、视觉 GLM-4V-Flash(data-URI 图)✅ 全部 HTTP 200。

上线

  • 配置层 hot_reload 会自动热更 gateway.yaml;但 ZHIPU_API_KEY 是新增环境变量,需重启进程才加载 → 待老板批准后重启,/v1/models 由 6 → 12 个文本模型、Models 页自动多出智谱 6 个。
  • 单测:修正 test_load_config_providers(供应商集合加入 bigmodel + 智谱 6 模型/V 标记断言);一并修掉此前遗留的 test_feedback_withdraw_only_when_pending(其旧断言「管理员 DELETE 反馈→403」没跟上「admin 收件箱可真删 admin_delete」的功能演进,已改为:普通用户撤别人→403、管理员真删→200 且图片文件一并清;并同步修正 DELETE 端点过时的 docstring)。最终 155 passed / 0 failed。

2026-09-15 · 新增 OpenCode Zen(免费档)供应商

一句话:把 OpenCode Zen 作为第 4 个供应商接入,只收录文档定价页列出的免费模型。打通后发现免费档比较刁钻:既被 Cloudflare 拦默认 UA,又强制要求每个请求带独立会话头——两条都已在适配器层解决,实测全部 200。

背景 / 需求

老板要求查看 OpenCode Zen 文档,接入该供应商,模型只要文档里免费的模型,并提供一把 API Key。

上游真相(重点!)

文档定价页的"免费模型"共有 6 个。直接以"Bearer key + 标准请求"裸调全部失败,逐一实测定位(带浏览器 UA 后才能看到模型层错误):

免费模型 id 裸调结果 根因 处理
big-pickle 401 Model is disabled 隐身模型,未对本工作区/Key 开放 ❌ 排除
mimo-v2.5-free 400 MissingSessionID 免费档要求每个请求带会话 id ✅ 收录
ling-3.0-flash-fin-free 400 MissingSessionID 同上 ✅ 收录
nemotron-3-ultra-free 400 MissingSessionID 同上 ✅ 收录
nemotron-3.5-lightning-free 400 MissingSessionID 同上 ✅ 收录
muse-spark-1.3-contributor-free 400 MissingSessionID 且走 /responses 端点(本适配器是 chat/completions 调不了)+ contributor 档会用你的提示词/补全训练 Meta 模型 ❌ 排除

根因一(Cloudflare):裸调用默认 urllib UA 报 403 error code: 1010(基于客户端签名的访问被禁)。改成浏览器 UA 后请求才抵达模型层。网关默认 python-httpx UA 大概率同样被拦 → 必须在请求头带浏览器 User-Agent。

根因二(会话标识):通过 DeepSeek Harness 生产集成讨论帖 确认——所有打到 opencode.ai 的请求都要带 x-opencode-session 请求头(会话 id,UUID 即可;同一次多轮保持稳定会走路由亲和性)。不带 → 400 MissingSessionID。带上后 4 个免费模型全部可用。

Key 与计费:该 Key 有效(能通过鉴权、能识别到 workspace),但账号未绑定支付方式 → 付费模型返回 CreditsError: No payment method。因此当前这套 Key 下能用的只有免费档(且经会话头 + 浏览器 UA 后确实能用)。

改动明细

  • app/adapters/openai_compat.py(后端代码改动,需重启生效)
    • 新增常量 OPENCODE_SESSION_SENTINEL = "@per-request-uuid@"。
    • 新增 _call_headers():若 extra_headers 里 x-opencode-session 为哨兵值,则每次 chat / chat_stream 调用现生成一个新 UUID 再发请求;否则原样返回静态头(其它供应商零行为变化)。
    • 目的:所有用户/会话共用一个固定 session 会互相踩 OpenCode 的限流与路由亲和,必须按请求/会话隔离。
    • chat() 与 chat_stream() 的请求头由 self._headers 改为 self._call_headers()。
  • data/gateway.yaml
    • 新增 opencode 供应商:name: OpenCode Zen、base_url: https://opencode.ai/zen/v1、token_env: OPENCODE_API_KEY。
    • extra_headers:User-Agent(浏览器 UA,过 Cloudflare)+ x-opencode-session: "@per-request-uuid@"(哨兵)。
    • media: {}(仅文本,无图像/视频)。
    • models:4 个免费模型(mimo-v2.5-free / ling-3.0-flash-fin-free / nemotron-3-ultra-free / nemotron-3.5-lightning-free)。
    • pricing.per_model:新增这 4 个,input: 0, output: 0(免费)。
    • 顶部注释供应商清单补 OpenCode Zen(免费档)。
  • data/.env:新增 OPENCODE_API_KEY=<sk-...>,权限 0600(保留原行、仅追加)。key 明文不进 yaml、不入版本库。
  • tests/test_gateway.py:test_load_config_providers 断言更新为 4 家,并新增守卫断言(opencode.base_url / 浏览器 UA / 哨兵头 / 4 个模型集),防以后误改。
  • README.md:顶部供应商清单、供应商表格、openai_compat.py 架构注释、OpenCode 两条硬性要求说明。

验证(非编造,实录)

  • 上游直打 https://opencode.ai/zen/v1/chat/completions(浏览器 UA + 每请求新 UUID 会话头):
    • 4 个免费模型非流式全部 200,nemotron-3.5-lightning-free 出真实中文回复 + usage.reasoning_tokens(推理模型先吐推理再吐内容)。
    • 流式全部 200:content-type: text/event-stream,nemotron-3.5-lightning-free 收了 123 个 chunk 并正常收到 [DONE]。
    • big-pickle 反复 401 Model is disabled → 确认本 Key 未开放,排除。
  • 适配器哨兵逻辑单测:哨兵值 → 每次新 UUID(36 位);普通静态值 → 原样保留。
  • 全量单测 python tests/test_gateway.py:153 passed, 2 failed。
    • 涉及的 provider 相关用例通过;余下 2 个失败为历史遗留、与本次无关:
      • test_load_config_routes:断言 wjd.models == 6,但 GLM-5.3-Flash 移除后 wjd 链是 5 个(旧断言未同步)。
      • test_feedback_withdraw_only_when_pending:feedback 撤回逻辑,非本次改动范围。

部署

  • supervisorctl restart api-gateway:api-gateway_00。
  • 重启前验证文件已就位:yaml safe_load 通过、providers = [agnes, b_ai, volc_engine, opencode]、opencode 4 个模型。
  • 上线后校验:新 pid 61457、healthz {"status":"ok"}、/v1/models 200 且含 opencode 4 个免费模型、无凭证/错 key 仍 401、真实 chat 调用 provider=opencode 返回 200。

待办 / 已知

  • big-pickle 与付费模型都因账号条件(Model disabled / 未绑支付方式)不可用,等以后条件变化再按需补录。
  • 免费档是否偶尔有速率/额度上限:OpenCode 注明"目前免费提供,团队在收集反馈",可能随时变化;若某模型开始报错,在 Models 页一键测速即可发现。
  • 本次未把 OpenCode 加进 wjd 兜底路由,先在 Models 页 + 直连模型 id 可用;要进 wjd 需老板另行确认。

视觉支持实测(2026-09-15,真图判定)

发一张「青色背景 + 品红五角星」的答案唯一测试图,走 OpenAI 多模态 image_url 格式(带浏览器 UA + x-opencode-session)实测:

  • ling-3.0-flash-fin-free → ❌ 无视觉:上游 400 ... [404] No endpoints found that support image input。
  • nemotron-3-ultra-free → ❌ 无视觉:同上。
  • nemotron-3.5-lightning-free → ❌ 无视觉:同上。
  • mimo-v2.5-free → ⚠️ 未判定:连纯文本都持续 429 FreeUsageLimitError(免费额度是小时/天级窗口,等 7 分钟未回血),够不到读图那步。强先验:MiMo-V2.5 家族在 b.ai 早前实测即 Vision is disabled,故基本可断定无视觉。
  • 结论:4 个 OpenCode 免费模型均无视觉(3 个实测坐实、1 个受限于限流未坐实但先验一致)。gateway.yaml 里这 4 个都只标 type: text、未加 vision:true,与实测一致,无需改动;Models 页也不会给它们显示 👁 图标。

2026-09-15 · 一键测速报错展示优化(Models 页)

问题:Models 页「一键测速」某个模型失败时,错误内容被塞进硬编码的窄 pill(.st-lat)里,长错误(无空格 JSON / 上游错误串)不换行、到卡片边缘就被切掉 → 报错显示不全。

改动(frontend/src/views/Models.vue,纯前端,不重启后端):

  • 模板:每个测速行 st-row 外包一层 st-item;当某模型测速失败时,在行下方新增一整行 st-err(ban 图标 + 完整错误文本)全宽展示。
  • 逻辑:新增 latErr(id) 返回完整错误串(用于 st-err 行);latText(id) 失败时只返回短的「失败」标记(长错误不再塞窄 pill)。
  • 样式:.st-err 用 --err 文字 + --err-soft 底、圆角块;overflow-wrap: anywhere + word-break: break-word 让长 JSON/无空格错误串自动换行不溢出;.st-item + .st-item 虚线分隔。

验证:npm run check:svg && npm run check:i18n && vite build 通过;vue-tsc --noEmit 无错;新产物 index-C_e1f2ok.js / Models-C-QAxhv1.js 线上 200、旧 hash 404。后端挂载 frontend/dist,build 即可见,pid 未动、会话不掉。

附带修复:后端空错误兜底

真实实测中发现 nemotron-3-ultra-free / mimo-v2.5-free 偶尔 429 限流,部分时候上游只返回空 body 导致 error = "{}"(str({})),既丑又无信息。app/main.py 的 _upstream_detail 修复:当 j 无 message/error/detail 且 str(j) in ("{}","","null","None") 时返回空串,前端 row.error 兜底显示「调用失败」而不是 {}。重启后生效(pid 121772)。

截图留档

  • docs/st-err-speedtest-error-display.png:真实浏览器实拍,两个 OpenCode 免费模型同时报错,st-err 红块完整展示 429 限流错误信息(含上游文档链接)——验证"显示不全"已修复。

2026-09-15 · 一键测速改为「逐个测、测一个显示一个」

需求:一键测速原来是并发/一次性返回全部结果、最后一起显示;改成串行逐个测,每测完一个立刻显示那一行,再测下一个。

改动

  • app/main.py /v1/models/speedtest:新增可选 body.model。传了就只测该模型、返回单条(不排序);乱传/非文本模型返回一条兜底错误行「模型不存在或非文本模型」。不传仍是一次性全测(保留兼容)。
  • frontend/src/views/Models.vue:runSpeedtest() 改为按列表顺序 for 循环,逐个 POST {model:id},每测完一个 latByModel.value = {...latByModel.value, [id]: row} 响应式即时刷新该行;单个模型异常不中断整轮(catch 后标失败继续下一个)。新增 latDone/latTotal,按钮测速中显示「测速中 n/total」进度。latText() 改为:已测行显示 ms/失败、测速中未轮到的显示 …、空闲显示 —。
    • 注:textModelRows 本就按供应商分组顺序、不随延迟重排,所以逐个测时行不会跳动,无需额外锁序。
  • i18n:models.testingProgress 中英各加一条(测速中 {n}/{total} / Testing {n}/{total}),保持对称。

为什么串行更好:并发一次性测会把 OpenCode 免费档瞬间打满触发 429;串行逐个测天然错峰。

验证:后端单测 153 passed(2 个历史遗留不变);前端 build + vue-tsc 通过;新产物 index-D81T1xmr.js / Models-DpOHvPHF.js 线上 200、旧 hash 404;supervisorctl restart → pid 187860、healthz ok。接口实测 {model:"hy3"} 只返回 1 条、乱传 model 有兜底错误行。浏览器实拍:点测速后按钮「测速中 1/9」、第一行已出 748 ms、其余 8 行 … 排队,33s 全部完成——逐个填充生效。

  • 截图留档:docs/speedtest-sequential-progress.png

追加:按钮去数字 + 当前行加载图标

老板反馈测速按钮不要出现 n/total 数字,改成「轮到哪个模型、就在那一行显示加载图标」。

  • 按钮:runSpeedtest 期间文案改 t('models.testingShort')(「测速中…」),去掉 latDone/latTotal 数字;el-button :loading 自带转圈。
  • 当前行:新增 latCurrentId,循环里每测一个置为该 id、整轮结束清空;模板延迟格里 v-if="m.id===latCurrentId" 显示 CSS spinner(.st-spin 圆环旋转,prefers-reduced-motion 降速),否则显 latText。latText 未轮到/空闲统一 —(去掉原 …)。
  • i18n:删 testingProgress、加 testingShort(中英)。
  • 纯前端,build 覆盖 dist 即生效、未重启后端。新产物 index-CZxVI3oL.js / Models-C-o3SZgZ.js,线上 200、旧 hash 404。
  • 浏览器实拍:按钮「测速中…」无数字、agnes 已出 929 ms、qwen3.8-flash 行内转圈、其余 —。截图 docs/speedtest-current-row-spinner.png。

追加:失败行「重新测速」按钮

老板要失败的模型旁边可点击单独重测。

  • Models.vue 新增 retestOne(id):只测这一个模型(POST {model:id}),复用当前行加载图标;latTesting || latCurrentId 时禁用/忽略,避免与整轮或另一单测打架;单模型异常也不抛、写回失败行。
  • 模板:st-err 错误块右侧加 .st-retry 胶囊按钮(refresh 图标 + 「重新测速」),v-if="latErr(m.id)" 只在失败行出现;错误文本用 .st-err-txt{flex:1} 占满、按钮靠右。
  • i18n:models.retry(重新测速 / Retry)中英。
  • 纯前端,build 覆盖 dist 即生效、未重启后端。新产物 index-nCRwIFRg.js / Models-CGpanPte.js,线上 200、旧 hash 404。
  • 浏览器实拍:整轮后 4 个失败行各带「重新测速」;点其中一个 → 仅该行转圈(.st-spin=1)、按钮未变「测速中…」(未误触发整轮)、15s 后该行结果刷新。截图 docs/speedtest-per-row-retry.png。

追加:每行常驻「单独测速」按钮(取代仅失败行重试)

老板要常态下(没跑整轮时)每个模型行右侧都有测速按钮,可单独测任意一个模型。

  • 把上一版只在 st-err 里的「重新测速」按钮改为每个 st-row 右侧常驻一个 ⚡ 图标按钮 .st-one(bolt 图标,title/aria-label=单独测速),点击调 retestOne(id) 只测该模型;latTesting || latCurrentId 时禁用(一次只允许一个测速动作,防与整轮/另一单测打架)。
  • st-err 移除旧 .st-retry 按钮,只留错误文本;删除 .st-retry 样式,新增 .st-one 图标按钮样式(hover 用 --primary/--primary-soft)。
  • i18n:删 models.retry、加 models.testOne(单独测速 / Test this model)中英。
  • 纯前端,未重启后端。新产物 index-BYzyfwi3.js / Models-CJ5mchi4.js,线上 200、旧 hash 404。
  • 浏览器实拍:9 个文本模型行 = 9 个 .st-one 按钮、无 .st-retry 残留;点第一行 agnes-3.0-flash 只它出 754 ms、其余仍 —、未误触发整轮。截图 docs/speedtest-per-row-test-button.png。

2026-09-15 · 移除 OpenCode 的 mimo-v2.5-free 模型

需求:老板要求把 mimo-v2.5-free 从 OpenCode 供应商去掉,相关配置与文档一并清理。

改动

  • data/gateway.yaml:删 providers.opencode.models 里的 mimo-v2.5-free 条目、删 pricing.per_model 的 mimo-v2.5-free;opencode 注释「这 4 个」改「这 3 个」,并在排除/已移除清单加一行说明(此前实测可 200,但免费档常 429 限流,按要求移除)。opencode 现 3 个免费模型:ling-3.0-flash-fin-free / nemotron-3-ultra-free / nemotron-3.5-lightning-free。
  • README.md:供应商表格 OpenCode 行的模型清单去掉 mimo-v2.5-free。
  • tests/test_gateway.py:test_load_config_providers 里 opencode 模型集断言去掉 mimo-v2.5-free。
  • 注意:只删 OpenCode 的 mimo-v2.5-free,b.ai 的 mimo-v2.5 保留不动。

验证:yaml.safe_load 后 opencode models=3、pricing 无该项;全量单测 153 passed(2 个历史遗留不变)。纯配置改动,hot_reload 自动生效、未重启——线上 /v1/models 由 12 → 11、mimo-v2.5-free 已消失、mimo-v2.5(b.ai) 仍在。CHANGELOG 保留此前收录/实测该模型的历史条目(真实记录),此处仅追加移除说明。


2026-09-15 · 排查「opencode 模型大概率失败」+ 测速探针加 429/5xx 重试

排查结论(非网关 bug):翻网关日志 opencode.ai/zen/v1/chat/completions 上游响应 = 30×200 / 14×429 / 3×503,且有明显「首个 429 → 隔 1~2s → 200」模式。根因是 OpenCode 免费档对共享 key 的激进限流(429) + 偶发 503。真实 chat 直连有 retry:3 兜底(退避 0.3/0.6s)多能扛过;但一键测速是单次探针、不重试,正好撞高频首个 429 → Models 页显示一片"失败"。反复点测速又消耗同一把免费 key 的额度 → 越点越限流。

修复(老板选定的方案 1):让测速探针也重试。

  • app/main.py 新增 _speedtest_retryable(e):仅上游 429 / 5xx 判为可重试;4xx(模型不存在/鉴权/参数)与超时不重试(前者无意义、后者拖慢整轮)。
  • /v1/models/speedtest 探针由单次改为 for attempt in range(1,4) 最多 3 次、退避 0.3*attempt(与真实链路一致),成功即 break;latency_ms 记整个重试过程总耗时(用户真实等待)。

验证:_speedtest_retryable 判定单测全对(429/503/500→重试、400/401/404/超时→不重试);全量单测 153 passed;supervisorctl restart → pid 249194、healthz ok。日志实测到重试生效:ling-3.0-flash-fin-free 一次 503→503→200(attempt 1/3、2/3)被救回。

遗留发现(待老板定):nemotron-3-ultra-free 仍测速失败,但已不是 429——直连实测它响应要 88.4 秒("Ultra" 大推理模型 + 免费档,极慢),远超探针 15s 超时;nemotron-3.5-lightning(2.4s)、ling(1.1s) 正常。可选:①调大探针超时(但 88s 会让整轮测速极慢、意义不大);②像 mimo-v2.5-free 一样把 nemotron-3-ultra-free 移除(88s 不实用);③保留(测速如实显示它太慢,真实 chat 靠 120s server timeout 仍可用但要等 ~88s)。


2026-09-15 · 整体移除 OpenCode Zen 供应商

需求:老板决定把 OpenCode Zen 供应商整个去掉,相关配置、代码、文档一并清理。

移除(opencode 专属)

  • data/gateway.yaml:删 providers.opencode 整块(base_url / token_env: OPENCODE_API_KEY / UA+哨兵 extra_headers / 3 个免费模型)+ pricing.per_model 里 3 条 opencode 免费模型 + 顶部注释供应商清单去 OpenCode。
  • app/adapters/openai_compat.py:删 OPENCODE_SESSION_SENTINEL 常量、_call_headers() 方法、import uuid;chat()/chat_stream() 请求头由 self._call_headers() 回滚为 self._headers(适配器回到"纯静态头")。
  • data/.env:删 OPENCODE_API_KEY 行(保留 AGNES/B_AI/VOLC 三把,权限 0600)。
  • README.md:顶部"四个供应商"→"三个"、架构注释"四家通用+opencode 会话头"→"三家通用+媒体端点"、供应商表格 OpenCode 行删除、OpenCode 两条硬性要求 blockquote 删除。
  • tests/test_gateway.py:test_load_config_providers 回退到 3 家、删 opencode 相关断言。

保留(通用改进,非 opencode 专属):测速探针 429/5xx 重试(_speedtest_retryable + 重试循环)与 _upstream_detail 空 body→「调用失败」兜底 —— 对 b.ai/agnes 等偶发限流同样受益,仅把注释里的 "OpenCode" 字样改通用。前端 Models 页动态读 /v1/models,opencode 行自动消失,无需改前端。

验证:yaml.safe_load 后 providers=[agnes,b_ai,volc_engine]、文本模型回到 5 个;openai_compat 已无 _call_headers/OPENCODE_SESSION_SENTINEL;import app.main OK;源码/配置/README/测试 grep opencode 清零(CHANGELOG 历史条目保留);全量单测 153 passed。代码有改动 → supervisorctl restart → pid 254282、healthz ok、线上 /v1/models = 8(无 opencode)。CHANGELOG 此前收录/排查 opencode 的历史条目全部保留(真实记录)。


2026-09-15 · 移除 b.ai 的 mimo-v2.5 模型

需求:老板要求把 b.ai 供应商下的 mimo-v2.5 也去掉,相关配置、代码、文档一并清理。(注:与上一轮已删的 OpenCode mimo-v2.5-free 是两个不同模型。)

改动

  • data/gateway.yaml:删 providers.b_ai.models 里的 mimo-v2.5 条目、删 pricing.per_model 的 mimo-v2.5、并从 routes.wjd 兜底链移除第 4 项 mimo-v2.5(hy3 由「5)」改「4)」重编号)。wjd 链现 [ark-code-latest, agnes-3.0-flash, qwen3.8-flash, hy3]。
  • app/main.py:测速探针注释里 b.ai(qwen3.8-flash/mimo-v2.5/hy3) 去掉 mimo-v2.5(max_tokens>2 约束对 qwen3.8-flash/hy3 仍成立,逻辑不变)。
  • README.md:供应商表格 b.ai 行模型清单去掉 mimo-v2.5;路由链示例同步去掉并重编号。
  • tests/test_gateway.py:test_load_config_routes 断言 wjd.models 数量由历史遗留的 == 6 修正为实际 == 4(该用例此前一直 FAIL,本次顺带修好)。

验证:yaml.safe_load 后 b_ai models=[qwen3.8-flash,hy3]、wjd 链 4 项、pricing 无 mimo-v2.5;源码/配置/README/测试 grep mimo-v2.5 清零(CHANGELOG 历史保留);全量单测 154 passed / 1 failed(routes 用例转绿,仅剩 feedback 无关遗留)。纯配置改动,hot_reload 自动生效、未重启——线上 /v1/models 由 8 → 7、mimo-v2.5 已消失。


2026-09-15 · 初始化 Git 仓库并推送到 CNB(cnb.cool)

  • 项目此前不是 git 仓库:git init 建库、设提交身份、首次提交(91 个源码文件)。
  • .gitignore 补充忽略 node_modules/、frontend/node_modules/、frontend/dist/、dist/、*.egg-info/、.DS_Store —— 否则 git add -A 会把 15342 个 node_modules 文件塞进仓库。
  • 推送前安全审计:确认 .env、data/users.json、data/history.json、data/feedback.json、data/feedback_media/ 全部被忽略、无任何密钥/隐私入库(仅无密钥的 .env.example 模板随库)。
  • 远程:CNB https://cnb.cool/Jidekin/api-gateway,分支 master,首推成功(远端 HEAD=6cc65ff 与本地一致)。origin 配为不含 token 的干净地址,令牌不写入 .git/config;后续推送用 git push https://cnb:<token>@cnb.cool/Jidekin/api-gateway.git master。