From 9b36374bfc4d9eaa921fd2dfe9a267dc4a3537fa Mon Sep 17 00:00:00 2001 From: Jidekin Date: Thu, 19 Nov 2026 08:23:15 +0800 Subject: [PATCH] =?UTF-8?q?feat(models):=20=E5=89=8D=E7=AB=AF=E5=B1=95?= =?UTF-8?q?=E7=A4=BA=20OpenCode=20Go=20=E7=9A=84=E6=9C=88=E5=BA=A6?= =?UTF-8?q?=E9=A2=9D=E5=BA=A6=E4=B8=8E=E8=AE=AD=E7=BB=83=E7=AD=96=E7=95=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 老板要求:模型清单里能直接看到「这个模型每月能调多少」「是否拿你的代码训练」。 数据源:官方 models 接口(与 1.0.6 的同步修复同源,无需鉴权) go.monthly_usage = {go, go-plus, go-teams} # 官方口径:只用这一个模型时各套餐每月额度 go.training = false # 是否用你的请求训练 go.zdr = true # 零数据保留 为什么不写进 gateway.yaml:这是上游随时会变的市场信息,不属于网关静态配置, 也不该让每日同步脚本再背一层 plan/落盘逻辑。改为后端按需拉取 + 6 小时缓存: - app/gomodels.py(新增):拉取 + 缓存 + 失败保留旧值(5 分钟后重试), 任何异常都不影响 /v1/models(最坏就是前端不显示这一列)。 - app/main.py:_models_payload() 拆成 base + 合并层。 base 仍按配置 mtime 缓存;合并层再按 (base 对象, go 缓存时间戳) 缓存, 两个都没变时返回同一个对象(保持原有缓存身份语义),任一变化自动重拼。 别名条目不重复挂 go(额度/训练口径就是目标模型的,前端按 alias_of 取)。 - 前端 Models.vue:新增「Go 额度」列 —— 默认档额度(如 $100)+ 训练徽章 (不训练=绿 / 会训练=红),悬浮显示三档明细与零数据保留说明; 非 OpenCode 供应商显示「—」。 - locales:中英文各补 8 个键(check:i18n 通过)。 验证:直接调 _models_payload() —— 83 个模型里 28 个带 go 字段、其余为 None; 前端 vite build 通过;api-gateway 重启后 /healthz 200。 --- app/gomodels.py | 98 +++++++++++++++++++++++++++++++++++ app/main.py | 38 +++++++++++++- frontend/src/locales/en.ts | 9 ++++ frontend/src/locales/zh.ts | 9 ++++ frontend/src/views/Models.vue | 63 ++++++++++++++++++++++ 5 files changed, 216 insertions(+), 1 deletion(-) create mode 100644 app/gomodels.py diff --git a/app/gomodels.py b/app/gomodels.py new file mode 100644 index 0000000..9a68019 --- /dev/null +++ b/app/gomodels.py @@ -0,0 +1,98 @@ +"""OpenCode Go 模型的套餐元数据(月度额度 / 是否用请求训练 / 零数据保留)。 + +**只用于展示,不参与路由与计费。** 数据来自官方 models 接口(实测无需鉴权): + + GET https://opencode.ai/inference/go/v1/models + +其中每个模型带 `go` 字段: + + go: { + monthly_usage: {"go": 100, "go-plus": 200, "go-teams": 105}, + training: false, # 是否用你的请求训练模型 + zdr: true, # 零数据保留(不保留任何内容) + limited_regions: false, + } + +官方口径(docs/console/go):`monthly_usage` 是「**只用这一个模型时,各套餐每月额度 +能覆盖多少用量**」(文档举例用的是美元)。所以前端展示成「$100/月」这类形式。 + +设计取舍: + · 自带 6 小时缓存,失败后 5 分钟重试; + · 拉取失败一律返回**已有缓存或空 dict** —— `/v1/models` 绝不因此报错或变慢太多 + (首次拉取加 6 秒上限;之后走内存)。 + · 不写进 gateway.yaml:这是上游随时会变的市场信息,不属于网关的静态配置, + 也不该让模型同步脚本再背一层。 +""" + +from __future__ import annotations + +import json +import threading +import time +import urllib.request + +_URL = "https://opencode.ai/inference/go/v1/models" +_TTL = 6 * 3600 +_RETRY_AFTER_FAIL = 300 +_TIMEOUT = 6 + +_lock = threading.Lock() +_cache: dict[str, dict] = {} +_at = 0.0 + + +def _fetch() -> dict[str, dict]: + req = urllib.request.Request( + _URL, + headers={"Accept": "application/json", "User-Agent": "api-gateway/gomodels"}, + ) + with urllib.request.urlopen(req, timeout=_TIMEOUT) as resp: # noqa: S310 + payload = json.loads(resp.read().decode("utf-8", "replace")) + + out: dict[str, dict] = {} + for m in payload.get("data") or []: + mid = m.get("id") + g = m.get("go") or {} + usage = g.get("monthly_usage") or {} + if not mid or (not usage and g.get("training") is None): + continue + out[mid] = { + "monthly_usage": {k: int(v) for k, v in usage.items() + if isinstance(v, (int, float))}, + "training": bool(g.get("training")), + "zdr": bool(g.get("zdr")), + } + return out + + +def cache_stamp() -> float: + """上次成功刷新的时间戳(0 = 还没拿到过)。调用方可据此判断展示数据是否需要重拼。""" + return _at + + +def get_go_meta(force: bool = False) -> dict[str, dict]: + """{model_id: {"monthly_usage": {...}, "training": bool, "zdr": bool}}。 + + 过期才刷新;刷新失败保留旧数据,并推迟 `_RETRY_AFTER_FAIL` 秒再试。 + """ + global _at + now = time.time() + if not force and _cache and now - _at < _TTL: + return _cache + if not _lock.acquire(blocking=False): + return _cache # 别的线程正在刷新,先用旧的 + try: + if force or not _cache or time.time() - _at >= _TTL: + try: + fresh = _fetch() + except Exception: # noqa: BLE001 —— 展示数据,失败不重要 + fresh = None + if fresh: + _cache.clear() + _cache.update(fresh) + _at = time.time() + else: + _at = time.time() - _TTL + _RETRY_AFTER_FAIL + finally: + _lock.release() + return _cache diff --git a/app/main.py b/app/main.py index 7babda3..487d233 100644 --- a/app/main.py +++ b/app/main.py @@ -56,6 +56,8 @@ from app.sessions import SessionStore from app.users import UsersStore, UserError, key_limit_for_role from app.history import HistoryStore, HistoryError, MAX_ITEMS as HISTORY_CAP from app.feedback import FeedbackStore, FeedbackError, MAX_ENTRIES as FEEDBACK_CAP +# 2026-11-19: OpenCode Go 套餐元数据(月度额度 / 是否训练 / 零保留),只用于前端展示 +from app.gomodels import get_go_meta, cache_stamp as gomodels_cache_stamp from app.video_owners import VideoOwnerStore from app import settings as gw_settings from app.agents import AgentStore, AgentsError @@ -1494,7 +1496,7 @@ def _attach_cost(resp: dict, model: str, usage: dict, cfg) -> None: # ───────────────────────────────────── # GET /models + GET /v1/models(P1-7 / P0-3) # ───────────────────────────────────── -def _models_payload(): +def _models_payload_base(): cfg = _cfg() # 优化: 目录按配置 mtime 缓存(热重载改配置才重建;静默期每次请求直接命中,省掉 # all_models() 的重复遍历与对象构建)。cfg 引用同一 config 对象, @@ -1571,6 +1573,40 @@ def _models_payload(): return payload +def _models_payload(): + """在按 mtime 缓存的目录上,现拼 OpenCode Go 的套餐元数据。 + + 2026-11-19(老板要求):前端要显示「这个模型每月能调多少」「是否拿你的代码训练」。 + 这两个字段来自官方 models 接口(有自己的 6 小时缓存,见 app/gomodels.py), + 所以**不烤进** `_models_cache`(否则配置不变就永远停在第一次的快照)。 + + 拼好后按 (配置 mtime, go 缓存时间戳) 再缓存一层 —— 两个都没变时返回**同一个对象** + (`test_models_payload_cached_and_invalidated_by_mtime` 依赖这个身份语义); + 任一变化就重拼。拿不到 go 数据时直接原样返回 base。 + """ + base = _models_payload_base() + go = get_go_meta() + if not go: + return base + # 缓存键带上 base 的对象 id(并**持有 base 的强引用**,保证 id 不会被复用)—— + # 这样只要 base 被重建(配置热重载,或测试直接把 _models_cache 置 None 换 config), + # 合并层就跟着失效;go 数据刷新(时间戳变化)也会失效。 + key = (id(base), gomodels_cache_stamp()) + cached = _state.get("_models_cache_go") + if cached is not None and cached[0] == key and cached[2] is base: + return cached[1] + data = [] + for item in base.get("data") or []: + mid = item.get("id") + # 别名(alias_of)不重复挂:它的额度/训练口径就是目标模型的,前端按目标取 + if mid in go and "alias_of" not in item: + item = {**item, "go": go[mid]} + data.append(item) + payload = {**base, "data": data} + _state["_models_cache_go"] = (key, payload, base) + return payload + + @app.get("/models") async def list_models(request: Request, _auth=Depends(require_auth)): return _models_payload() diff --git a/frontend/src/locales/en.ts b/frontend/src/locales/en.ts index a8a1be7..ded20ef 100644 --- a/frontend/src/locales/en.ts +++ b/frontend/src/locales/en.ts @@ -616,6 +616,15 @@ export default { providers: 'Providers', loadErr: 'Failed to load models', capability: 'Capability', + // 2026-11-19: OpenCode Go plan quota + training policy (from the official models API's go field) + goQuota: 'Go quota', + goQuotaHint: 'Monthly allowance each plan covers when you use only this model (official go.monthly_usage)', + goQuotaValues: 'Go ${go}/mo · Go Plus ${plus}/mo · Go Teams ${teams}/mo', + goQuotaFree: 'Free', + goTrainingNo: 'No training', + goTrainingYes: 'Trains', + goTrainingHint: 'Official go.training flag: whether this model trains on your requests', + goZdrHint: 'Zero data retention: upstream keeps none of your content', visionTag: 'Vision', freeTag: 'Free', freeHint: 'Officially free model: no usage-based billing (quota is set by the vendor; both the Agnes and OpenCode Go free tiers are labelled)', diff --git a/frontend/src/locales/zh.ts b/frontend/src/locales/zh.ts index 7643b2f..b343918 100644 --- a/frontend/src/locales/zh.ts +++ b/frontend/src/locales/zh.ts @@ -621,6 +621,15 @@ export default { providers: '供应商', loadErr: '加载模型失败', capability: '能力', + // 2026-11-19:OpenCode Go 的套餐额度与训练策略(数据来自官方 models 接口的 go 字段) + goQuota: 'Go 额度', + goQuotaHint: '只用这一个模型时,各套餐每月额度能覆盖多少用量(官方 models 接口的 go.monthly_usage)', + goQuotaValues: 'Go ${go}/月 · Go Plus ${plus}/月 · Go Teams ${teams}/月', + goQuotaFree: '免费', + goTrainingNo: '不训练', + goTrainingYes: '会训练', + goTrainingHint: '官方 go.training:该模型是否用你的请求内容做训练', + goZdrHint: '零数据保留:上游不保留请求内容', visionTag: '视觉', freeTag: '免费', freeHint: '官方免费模型:不按用量计费(额度以官方为准;Agnes 与 OpenCode Go 的免费档都会标出来)', diff --git a/frontend/src/views/Models.vue b/frontend/src/views/Models.vue index e05824f..809a630 100644 --- a/frontend/src/views/Models.vue +++ b/frontend/src/views/Models.vue @@ -134,6 +134,26 @@ — + + + + +