diff --git a/CHANGELOG.md b/CHANGELOG.md index 5765ee2..f52529c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,31 @@ # CHANGELOG +## 2026-09-24 · Agnes 免费 / 限时免费标注 + 免费标签间距对齐 + +**老板需求**:① Agnes 的模型也要标「免费」或「限时免费」;② 标注和模型名的间隔不一样,优化一下。 + +### 交付 +| 部分 | 内容 | +| --- | --- | +| 判定口径 | Agnes 定价页「### 当前优惠」小节:`当前(均)免费` → 免费;`当前限时免费` → 限时免费。按 bullet 切块 + 严格措辞,**只认反引号里的完整 id**(`agnes-video-2.5` 是 `agnes-video-2.5-flash` 的子串),`输入图片前 5 张免费` 这类计费额度不算模型免费 | +| 配置 | `free: true`(免费)+ 新增 `free_limited: true`(限时免费)。落盘 7 条:`3.0-flash` / `2.5-flash` / 3 个 `image-*-flash` / `video-v2.0` = 免费,`video-2.5-flash` = 限时免费;只 +8 行,手写注释一行未动 | +| 每日同步 | `scripts/sync_models.py` 新增 `_agnes_free_map()` / `_set_agnes_free()`:免费标注纳入漂移比对与 `--apply` 落盘(`free` + `free_limited`),官方改口径时**整行撤掉**标注;回读校验新增 Agnes 免费位检查 | +| 后端 | `ModelInfo.free_limited` 字段 + `/v1/models` 带出 `free_limited`(别名随目标继承) | +| 前端 | 标签文案 `免费` / `限时免费`(中英各 2 个新键,i18n 755/755 对称);间距修正:`.st-row .name-free { margin-left: 0 }` | +| 测试 | 新增 `test_agnes_free_map_rules`、`test_agnes_free_apply_and_revoke_round_trip`(加标注 / 限时 / 撤标注 / 幂等 / 相邻注释不被碰);**195 passed / 0 failed** | + +### 间距问题的实测根因 +`.st-row` 是 flex(`gap: 8px`),而 `.name-free` 又给了 `margin-left: 6px` —— 标签左侧 8+6=**14px**、 +右侧只有 **8px**,跟其它行「模型名 → 供应商名」的 8px 节奏对不上。用同源最小页实测: +修前 `14 / 8`,修后 `8 / 8`(且与无标签行的 8px 一致)。表格单元格是行内排布、没有 flex gap, +所以那边保留 `margin-left: 6px`,只对测速行归零。 + +### 上线 +- 配置:`--apply` 落盘(备份 `data/gateway.yaml.bak`,权限 600,回读校验通过),`hot_reload` 自动生效。 +- 后端:`supervisorctl restart api-gateway:api-gateway_00`(pid 3465113,health 200)。 +- 前端:`npm run build` 覆盖 `frontend/dist`,线上 `/web` 已换 `index-CkVhRx-u.js` / `Models-RN5bN2Hd.js`(旧 chunk 404),入口包里能查到「限时免费」。 +- 实测 `/v1/models` 载荷:Agnes 6 个免费 + `agnes-video-2.5-flash` 限时免费 + 3 个付费档无标注;`space-bunny-free` 免费标注不受影响。 + ## 2026-09-24 · 模型清单每日同步(全量落盘)+ 视频默认模型口径 + 修「空 plan 也写盘」 **老板需求**:网关的模型清单要和上游官方文档**同步**——文档新增的加进去、下线的删掉、 diff --git a/README.md b/README.md index 8e551bd..d629136 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ api-gateway/ | 供应商 | Base URL | 认证 | 模型 | |---|---|---|---| -| Agnes AI | `https://api.agnes-ai.cn/v1` | Bearer | `agnes-3.0-flash`、`agnes-2.5-flash`(text,支持图像输入)、`agnes-image-2.5-flash`(image)、`agnes-video-2.5-flash`(video) | +| 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`,见下方小节) | @@ -1354,6 +1354,14 @@ python scripts/sync_models.py --apply --log logs/model-sync.log - 边界:协议线**只加不砍**(文档给的新线补上,逐条实测出来的线不动);`PROTECTED` 名单与被别名 / `media` 引用的模型 id **永不自动删**(官方文档表收录有滞后,实测 `deepseek-flash` / `omen-alpha` 上游在服务、文档表还没补),只在报告里点名。 +- **免费标注**(2026-09-24 老板要求:Agnes 也要标):配置里 `free: true` → 「免费」标签, + 再加 `free_limited: true` → 「限时免费」标签;`/v1/models` 带出这两个字段,前端「模型与供应商」 + 页把标签放在模型名后面(左右间距统一交给行内 flex `gap`,别再加 margin,否则 14px vs 8px 不齐)。 + 判定源是官方措辞:OpenCode 价格表 `Input/Output = Free`;Agnes 定价页「### 当前优惠」小节里 + 的「当前(均)免费」→ 免费、「限时免费」→ 限时。**注意** Agnes 视频 `agnes-video-2.5` 那条 + bullet 里的「输入图片前 5 张免费」是计费公式的免费额度、**不算**模型免费,所以判定按 bullet + 切块 + 只认严格措辞,且只认反引号里的完整 id(`agnes-video-2.5` 是 `agnes-video-2.5-flash` 的 + 子串,字符串包含会串味)。优惠到期 / 官方改口径时,同步会自动把标注**整行撤掉**。 - 视频默认模型 `agnes.media.video_model_name` **不自动换**:文档对视频模型没有「哪个最新 / 最好」的 机器可读标记(`agnes-video-v2.0` 当前免费、`agnes-video-2.5` 按输出分辨率计费、`agnes-video-2.5-flash` 限时免费),自动切会直接改变线上视频行为。脚本只做两件事:保证它不被自动删(`media` 引用的 id 受保护), diff --git a/app/config.py b/app/config.py index 53b314a..c299c04 100644 --- a/app/config.py +++ b/app/config.py @@ -132,6 +132,12 @@ class ModelInfo: # 不参与路由/限流/熔断,也不影响成本估算(额度由上游控制,网关无法感知)。 # 配置写法:`models[]` 里加 `free: true`(OpenCode Go 当前只有 space-bunny-free)。 free: bool = False + # 2026-09-24(老板要求:Agnes 也要标免费 / 限时免费): 免费是否**带期限**。 + # 语义:`free: true` + `free_limited: false` → 免费;`free_limited: true` → 限时免费。 + # 来源是 Agnes 定价页「### 当前优惠」小节的措辞(「当前免费」vs「当前限时免费」), + # 由 scripts/sync_models.py 按文档自动维护(撤标注时整行删掉)。 + # 同样只是标注:/v1/models 带出、前端标签文案据此切换,不参与路由/限流/计费。 + free_limited: bool = False # 第二十五轮(模型参数硬约束): 该模型**必须用**的上游参数,发送前强制覆盖客户端传值。 # 背景:OpenCode Go 的 kimi-k2.7-code 只接受 temperature=1,客户端传 0(含一键测速的 # 探针,它固定发 temperature=0)会被上游 400: @@ -392,6 +398,9 @@ class GatewayConfig: # 2026-09-21: 免费模型标注(官方标 Free)。前端「能力」列打「免费」标签, # /v1/models 也带出该字段;不参与路由/限流/计费。 "free": bool(m.free), + # 2026-09-24: 「免费」还是「限时免费」—— 前端标签文案据此切换 + # (免费 / 限时免费),也带进 /v1/models 让接口调用方知道优惠可能到期。 + "free_limited": bool(m.free_limited), "provider": pkey, "provider_name": pconfig.name, # 第二十五轮: 暴露模型级强制参数(如 {"temperature": 1})。 @@ -783,6 +792,7 @@ def parse_config(raw: dict[str, Any]) -> GatewayConfig: ModelInfo(id=m.get("id", ""), display_name=m.get("display_name", ""), type=m.get("type", "text"), vision=_opt_bool(m.get("vision"), "providers.*.models.*.vision", False), free=_opt_bool(m.get("free"), "providers.*.models.*.free", False), + free_limited=_opt_bool(m.get("free_limited"), "providers.*.models.*.free_limited", False), params=_parse_model_params( m.get("params"), f"providers.{pkey}.models[{idx}].params"), protocols=_parse_protocols( diff --git a/app/main.py b/app/main.py index 804fb9b..eaa1b23 100644 --- a/app/main.py +++ b/app/main.py @@ -1227,6 +1227,8 @@ def _models_payload(): # 2026-09-21: 免费模型标注(官方标 Free)—— 前端「能力」列据此打「免费」标签, # 接口调用方也能提前知道这个模型不计费。 "free": bool(m.get("free")), + # 2026-09-24: 免费是否带期限(限时免费)—— 前端标签文案据此切换 + "free_limited": bool(m.get("free_limited")), # 第二十五轮: 暴露模型级强制参数(如 {"temperature": 1})。前端据此标挂锁, # API 调用方也能提前知道自己传的采样参数会被上游要求覆盖。 "params": dict(m.get("params") or {}), @@ -1256,6 +1258,7 @@ def _models_payload(): "vision": bool(aminfo.vision), # 2026-09-21: 免费位随目标继承(与 vision / params 同一份事实来源) "free": bool(aminfo.free), + "free_limited": bool(aminfo.free_limited), "params": dict(aminfo.params or {}), "protocols": list(ALIAS_PROTOCOLS), "alias_of": aminfo.id, "alias_note": spec.note}) diff --git a/data/gateway.yaml b/data/gateway.yaml index 8b6df4d..7de8105 100644 --- a/data/gateway.yaml +++ b/data/gateway.yaml @@ -27,21 +27,26 @@ providers: - id: "agnes-3.0-flash" display_name: "Agnes 3.0 Flash" type: "text" + free: true # 2026-09-24 自动同步:文档「当前优惠」写当前免费(scripts/sync_models.py) # 第十三轮: Agnes 3.0 Flash 文档「输入模态:文本、图像 URL」→ 支持视觉(对话带图)。 # 实测 data:image/png;base64,... 也能识别。 vision: true - id: "agnes-2.5-flash" display_name: "Agnes 2.5 Flash" type: "text" + free: true # 2026-09-24 自动同步:文档「当前优惠」写当前免费(scripts/sync_models.py) # Agnes 2.5 Flash(2.0 升级版):OpenAI 兼容 /v1/chat/completions,支持图像 URL 输入与工具调用, # 上下文 512K / 最大输出 65.5K;当前定价暂免(¥0/百万)。参见官方文档 agnes-25-flash。 vision: true - id: "agnes-image-2.5-flash" display_name: "Agnes Image 2.5 Flash" type: "image" + free: true # 2026-09-24 自动同步:文档「当前优惠」写当前免费(scripts/sync_models.py) - id: "agnes-video-2.5-flash" display_name: "Agnes Video 2.5 Flash" type: "video" + free: true # 2026-09-24 自动同步:文档「当前优惠」写当前限时免费(scripts/sync_models.py) + free_limited: true # 限时免费;文档改口径后同步会自动撤掉这行 # 2026-09-24 自动同步:官方文档新增(scripts/sync_models.py) - id: "agnes-2.5-pro" display_name: "Agnes 2.5 Pro" @@ -56,10 +61,12 @@ providers: - id: "agnes-image-2.0-flash" display_name: "Agnes Image 2.0 Flash" type: "image" + free: true # 2026-09-24 自动同步:文档「当前优惠」写当前免费(scripts/sync_models.py) # 2026-09-24 自动同步:官方文档新增(scripts/sync_models.py) - id: "agnes-image-2.1-flash" display_name: "Agnes Image 2.1 Flash" type: "image" + free: true # 2026-09-24 自动同步:文档「当前优惠」写当前免费(scripts/sync_models.py) # 2026-09-24 自动同步:官方文档新增(scripts/sync_models.py) - id: "agnes-video-2.5" display_name: "Agnes Video 2.5" @@ -68,6 +75,7 @@ providers: - id: "agnes-video-v2.0" display_name: "Agnes Video V2.0" type: "video" + free: true # 2026-09-24 自动同步:文档「当前优惠」写当前免费(scripts/sync_models.py) volc_engine: name: "火山方舟 Coding Plan" diff --git a/frontend/src/locales/en.ts b/frontend/src/locales/en.ts index 4234736..57a9496 100644 --- a/frontend/src/locales/en.ts +++ b/frontend/src/locales/en.ts @@ -382,7 +382,9 @@ export default { capability: 'Capability', visionTag: 'Vision', freeTag: 'Free', - freeHint: 'Officially free model: no token billing (quota is set by the vendor; only Space Bunny Free in the current OpenCode Go plan)', + freeHint: 'Officially free model: no usage-based billing (quota is set by the vendor; both the Agnes and OpenCode Go free tiers are labelled)', + freeLimitedTag: 'Limited-time free', + freeLimitedHint: 'Officially "limited-time free": the offer has an expiry — the daily sync updates this label when the vendor changes it', paramTag: 'Params locked', paramLocked: 'Parameters pinned by the gateway: {p} (upstream hard limit; values from clients and the speed test are overridden)', allTextModels: 'All text models', diff --git a/frontend/src/locales/zh.ts b/frontend/src/locales/zh.ts index 006adb3..ba70979 100644 --- a/frontend/src/locales/zh.ts +++ b/frontend/src/locales/zh.ts @@ -382,7 +382,9 @@ export default { capability: '能力', visionTag: '视觉', freeTag: '免费', - freeHint: '官方免费模型:不按 token 计费(额度以官方为准;当前 OpenCode Go 计划里只有 Space Bunny Free)', + freeHint: '官方免费模型:不按用量计费(额度以官方为准;Agnes 与 OpenCode Go 的免费档都会标出来)', + freeLimitedTag: '限时免费', + freeLimitedHint: '官方「限时免费」:优惠有期限,官方改口径后每日同步会自动更新这个标注', paramTag: '参数固定', paramLocked: '该模型参数由网关固定:{p}(上游硬约束,客户端与测速探针传的值都会被覆盖)', allTextModels: '全部文本模型', diff --git a/frontend/src/views/Models.vue b/frontend/src/views/Models.vue index 10fc2ab..de03374 100644 --- a/frontend/src/views/Models.vue +++ b/frontend/src/views/Models.vue @@ -34,8 +34,9 @@ 挂锁标注 + 悬浮说明,省掉「为什么我传的参数不生效」这类困惑。 --> {{ m.id }} - - {{ t('models.freeTag') }} + + {{ freeText(m) }} @@ -136,8 +137,9 @@ @@ -383,6 +385,8 @@ const textModelRows = computed(() => vision: !!m.vision, // 免费模型(2026-09-21):与表格「能力」列同一份数据 free: !!m.free, + // 免费是否带期限(2026-09-24):Agnes 的限时免费档,标签文案换成「限时免费」 + free_limited: !!m.free_limited, // 模型级强制参数(第二十五轮):被上游固定住的采样参数,用挂锁标注出来。 paramNote: paramKeys(m).length ? paramNote(m) : '', // 支持的格式(第二十七轮):悬浮这一行就能看到「能用哪几条线 + 本次测速走的哪条」 @@ -400,6 +404,16 @@ function rowTitle(m: any): string { : t('models.protocolHintRow', { lines }) } +// ── 免费标注(2026-09-24 老板:Agnes 也要标免费 / 限时免费)── +// 后端 /v1/models 给 free(是否免费)+ free_limited(免费是否带期限,来自官方 +// 「当前限时免费」措辞)。限时档文案单独一个,别让人以为它会一直免费。 +function freeText(m: any): string { + return m && m.free_limited ? t('models.freeLimitedTag') : t('models.freeTag') +} +function freeHint(m: any): string { + return m && m.free_limited ? t('models.freeLimitedHint') : t('models.freeHint') +} + // ── 模型级强制参数(第二十五轮)── // 后端 /v1/models 在 params 里给出「该模型发往上游前会被强制覆盖的参数」 // (例:kimi-k2.7-code 只接受 temperature=1)。这里只做展示,不提供编辑入口。 @@ -465,7 +479,12 @@ onMounted(load) .plock { color: var(--warn); } /* 免费模型:绿色系,跟「视觉」(主题色) / 「参数固定」(橙) 区分开;跟在模型名后面 */ .pill.free { background: rgba(16, 185, 129, 0.14); color: #059669; } +/* 免费标注的间距(2026-09-24 老板:间隔不一样)—— + 表格单元格里是行内排布、没有 flex gap,靠这个 margin 与模型名分开; + 测速行是 flex(.st-row gap: 8px),必须把 margin 归零:否则标签左侧 8+6=14px、 + 右侧只有 8px,跟其它行「模型名 → 供应商名」的节奏对不上。左右统一由 gap 决定。 */ .name-free { margin-left: 6px; vertical-align: middle; } +.st-row .name-free { margin-left: 0; } /* 支持的格式:三条线是并列关系(没有谁更优),统一用主题色弱底, 不用 ok/warn/err —— 否则「messages」看起来像警告、「responses」像被禁用。 */ .proto { diff --git a/scripts/sync_models.py b/scripts/sync_models.py index 70eef9a..91c1ce0 100755 --- a/scripts/sync_models.py +++ b/scripts/sync_models.py @@ -116,11 +116,61 @@ def _price_of(cell: str) -> float | None: return float(m.group(1)) if m else None +# 免费状态判定用的严格措辞(2026-09-24 老板要求 Agnes 也标免费 / 限时免费) +_AGNES_LIMITED_RE = re.compile(r"限时免费") +_AGNES_FREE_RE = re.compile(r"(当前免费|当前均免费|均免费)") +_AGNES_BULLET_RE = re.compile(r"^\s*[*\-]\s+") +_AGNES_TICKED_RE = re.compile(r"`([a-z][a-z0-9.\-]*)`") + + +def _agnes_free_map(md: str, known: set[str]) -> dict[str, object]: + """从 Agnes 文档的「### 当前优惠」小节判定每个模型的免费状态。 + + 返回 `{model_id: True | "limited"}`,**只收录文档明说免费的**;没提的模型不在结果里 + (= 按收费处理,前端不打标)。 + + 判定口径(按 bullet / 段落**切块**,块内用**严格措辞**): + ① 块里出现「限时免费」 → "limited"(限时免费) + ② 块里出现「当前免费 / 当前均免费 / 均免费」 → True(免费) + ③ 其它(含「按…计费」「刊例价」等) → 不算免费 + + 为什么不能全文扫「免费」:视频 `agnes-video-2.5` 那条 bullet 写着「输入图片前 5 张免费」—— + 那是计费公式里的免费额度说明,不是模型免费。所以必须按块 + 严格措辞,不能关键词泛扫。 + 另外块内提 id 必须取**反引号里的完整 id**:`agnes-video-2.5` 是 `agnes-video-2.5-flash` + 的子串,用字符串包含会把两者搞混。 + """ + out: dict[str, object] = {} + # 逐个「### 当前优惠」小节(正文到下一个标题为止) + for m in re.finditer(r"^#{3,4}\s*当前优惠\s*$", md, flags=re.M): + body = md[m.end():] + nxt = re.search(r"^#{2,4}\s+\S", body, flags=re.M) + if nxt: + body = body[:nxt.start()] + chunk: list[str] = [] + for ln in body.splitlines() + [""]: + if _AGNES_BULLET_RE.match(ln) or not ln.strip(): + if chunk: # 块结束 → 判定 + text = " ".join(chunk) + state: object = ("limited" if _AGNES_LIMITED_RE.search(text) + else True if _AGNES_FREE_RE.search(text) else None) + if state is not None: + for mid in _AGNES_TICKED_RE.findall(text): + if mid in known: + out[mid] = state + chunk = [] + if _AGNES_BULLET_RE.match(ln): + chunk = [ln] + else: + chunk.append(ln) + return out + + def fetch_agnes() -> dict[str, dict]: - """返回 {model_id: {section, type, input, output}}(input/output = 现价,¥/M,仅文本模型有)。 + """返回 {model_id: {section, type, input, output, free}}(input/output = 现价,¥/M,仅文本模型有)。 页面是 JSX 风格的 HTML 表:模型列有的带 rowSpan(一行跨多行计费项)、有的单行自带, 所以按 `` 块解析,**第一格是模型 id 就认模型行,否则归到上一个模型**。 + `free`(免费标注)另从「### 当前优惠」小节判定,见 `_agnes_free_map`。 """ md = _get(AGNES_PRICING_URL) out: dict[str, dict] = {} @@ -140,7 +190,7 @@ def fetch_agnes() -> dict[str, dict]: if _MODEL_ID_RE.fullmatch(first): cur = first out.setdefault(cur, {"section": title, "type": AGNES_SECTION_TYPE[title], - "input": None, "output": None}) + "input": None, "output": None, "free": None}) continue if not cur: continue @@ -153,6 +203,8 @@ def fetch_agnes() -> dict[str, dict]: out[cur]["output"] = price if not out: raise RuntimeError("Agnes 定价页没解析出模型(页面可能改版)") + for mid, state in _agnes_free_map(md, set(out)).items(): + out[mid]["free"] = state return out @@ -171,6 +223,13 @@ def _references(cfg: dict) -> dict[str, str]: return refs +def _cfg_free_state(m: dict) -> object: + """配置里一个模型的免费状态:True(免费)/ "limited"(限时免费)/ None(没标)。""" + if m.get("free_limited"): + return "limited" + return True if m.get("free") else None + + def _split_removed(prov: str, cur: dict, doc: dict, refs: dict) -> tuple[list[str], dict[str, str]]: """「网关有、文档没收录」的模型 → (该删的, 该保的 {id: 原因})。 @@ -243,7 +302,13 @@ def diff(cfg: dict, oc_doc: dict, agnes_doc: dict) -> dict: # 不自动换。文档对三个视频模型没有任何「哪个最新 / 最好」的机器可读标记 # (v2.0 当前免费、2.5 按输出分辨率计费、2.5-flash 限时免费),自动挑一个切上去 # 会直接改变线上视频行为。换默认由老板点模型名,改一行配置。 + # 免费标注漂移(2026-09-24 老板要求:Agnes 也要标免费 / 限时免费)—— + # 口径见 _agnes_free_map;这里只比「文档明说免费」的那批,文档没提的不打标。 + ag_free_drift = [{"id": mid, "cfg": _cfg_free_state(ag_cur[mid]), "doc": meta["free"]} + for mid, meta in sorted(agnes_doc.items()) + if mid in ag_cur and _cfg_free_state(ag_cur[mid]) != meta["free"]] vid_cfg = ((providers.get("agnes") or {}).get("media") or {}).get("video_model_name") + report["agnes"]["free_drift"] = ag_free_drift report["agnes"]["video_default"] = { "cfg": vid_cfg, "in_doc": bool(vid_cfg) and vid_cfg in agnes_doc, @@ -297,6 +362,11 @@ def render(report: dict) -> str: lines.append(" 定价漂移(网关 pricing.per_model vs 文档现价,¥/M)→ 落盘更新:") for d in real_drift: lines.append(f" ~ {d['id']} 网关={d['cfg']} 文档={d['doc']}") + if ag.get("free_drift"): + lines.append(" 免费标注漂移(文档「当前优惠」vs 网关 free / free_limited)→ 落盘更新:") + label = {True: "免费", "limited": "限时免费", None: "(无标注)"} + lines += [f" ~ {d['id']} 网关={label.get(d['cfg'], d['cfg'])}" + f" 文档={label.get(d['doc'], d['doc'])}" for d in ag["free_drift"]] vd = ag.get("video_default") or {} if vd.get("cfg"): mark = ("✓ 文档里还在" if vd.get("in_doc") @@ -304,7 +374,7 @@ def render(report: dict) -> str: lines.append(f" 视频默认模型 media.video_model_name:{vd['cfg']} —— {mark}") lines.append(f" 文档视频清单:{', '.join(vd.get('doc_videos') or []) or '(无)'}" " ← 换默认由老板点模型名,改一行配置(不自动挑)") - if not any(ag[k] for k in ("added", "removed", "price_drift")): + if not (any(ag[k] for k in ("added", "removed", "free_drift")) or real_drift): lines.append(" 无漂移 ✓") return "\n".join(lines) @@ -421,6 +491,12 @@ def _render_model_block(provider: str, mid: str, meta: dict, date: str) -> list[ out.append(" free: true # 官方价格表标 Free\n") elif meta.get("input") is not None: out.append(f" # 文档现价 ¥{meta['input']:g}/M 输入、¥{meta['output']:g}/M 输出\n") + if provider == "agnes" and meta.get("free"): + limited = meta["free"] == "limited" + out.append(f" free: true # {date} 自动同步:文档「当前优惠」写当前" + f"{'限时' if limited else ''}免费\n") + if limited: + out.append(" free_limited: true # 限时免费;文档改口径后同步会自动撤掉这行\n") return out @@ -455,17 +531,49 @@ def _set_free(seg: list[str], want: bool, date: str) -> list[str]: return seg +# Agnes 的免费标注行(撤标注时要整行删掉,注释是行内的,跟着走) +_AGNES_FREE_LINE_RE = re.compile(r"^\s*(free|free_limited):\s*") + + +def _set_agnes_free(seg: list[str], want: object, date: str) -> list[str]: + """按文档写 Agnes 模型的免费标注(2026-09-24 老板要求 Agnes 也要标)。 + + want = `True`(免费)/ `"limited"`(限时免费)/ `None`(文档没说免费 → 撤掉标注)。 + 写法:`free: true`,限时再加一行 `free_limited: true`(前端据此显示「限时免费」)。 + 撤标注时**整行删掉**(不留 `free: false` 垃圾行 —— Agnes 十个模型里大多数不免费, + 留 false 会把配置撑起来);原行内的手写注释也随行删除,报告里会说明这次撤了哪些。 + """ + out = [ln for ln in seg if not _AGNES_FREE_LINE_RE.match(ln)] + if want is None: + return out + limited = want == "limited" + note = (f"{date} 自动同步:文档「当前优惠」写当前{'限时' if limited else ''}免费" + "(scripts/sync_models.py)") + extra = [f" free: true # {note}\n"] + if limited: + extra.append(" free_limited: true # 限时免费;文档改口径后同步会自动撤掉这行\n") + for i, ln in enumerate(out): + if re.match(r"^\s*type:\s*", ln): + return out[:i + 1] + extra + out[i + 1:] + for i, ln in enumerate(out): + if re.match(r"^\s*-\s*id:\s*", ln): + return out[:i + 1] + extra + out[i + 1:] + return out + + def build_plan(report: dict, cfg: dict, oc_doc: dict, agnes_doc: dict) -> dict: """把报告翻成可执行动作(纯计算,不碰磁盘)。""" docs = {"opencode": oc_doc, "agnes": agnes_doc} pricing = (cfg.get("pricing") or {}).get("per_model") or {} plan: dict = {"add": {}, "remove": {}, "price_set": {}, "price_add": {}, - "proto_add": {}, "free_set": {}} + "proto_add": {}, "free_set": {}, "agnes_free": {}} for prov in SYNC_PROVIDERS: plan["add"][prov] = {m["id"]: m for m in report[prov]["added"]} plan["remove"][prov] = list(report[prov]["removed"]) plan["proto_add"] = {d["id"]: d["doc"] for d in report["opencode"]["protocol_drift"]} plan["free_set"] = {d["id"]: d["doc_free"] for d in report["opencode"]["free_drift"]} + # Agnes 的免费标注(True / "limited" / None)单独一条 plan,走 _set_agnes_free + plan["agnes_free"] = {d["id"]: d["doc"] for d in report["agnes"]["free_drift"]} for mid, meta in sorted(agnes_doc.items()): if meta["input"] is None: # 图片/视频模型文档没给单价 continue @@ -489,7 +597,8 @@ def plan_is_empty(plan: dict) -> bool: for prov in SYNC_PROVIDERS: if plan["add"].get(prov) or plan["remove"].get(prov): return False - return not any(plan.get(k) for k in ("price_set", "price_add", "proto_add", "free_set")) + return not any(plan.get(k) for k in + ("price_set", "price_add", "proto_add", "free_set", "agnes_free")) def render_plan(plan: dict, date: str) -> str: @@ -503,6 +612,9 @@ def render_plan(plan: dict, date: str) -> str: lines.append(f" 补协议线 opencode/{mid} += {proto}") for mid, want in sorted(plan["free_set"].items()): lines.append(f" 免费标记 opencode/{mid} → {want}") + _flabel = {True: "免费", "limited": "限时免费", None: "撤掉标注"} + for mid, want in sorted(plan.get("agnes_free", {}).items()): + lines.append(f" 免费标注 agnes/{mid} → {_flabel.get(want, want)}") for mid, spec in sorted(plan["price_set"].items()): lines.append(f" 改价 {mid} {spec['old']} → {spec['new']}") for mid, want in sorted(plan["price_add"].items()): @@ -559,6 +671,16 @@ def apply_plan(text: str, plan: dict, date: str) -> str: seg = _set_free(seg, plan["free_set"][mid], date) lines[s:e] = seg + # 3b) Agnes 的免费标注(免费 / 限时免费 / 撤标注)——同一套倒序处理, + # 字段插在块的 type: 之后,撤标注整行删。放在 3) 之后重取块表,避免下标串位。 + if plan.get("agnes_free"): + blocks = _find_model_blocks(lines, "agnes") + for mid in sorted(plan["agnes_free"], key=lambda m: blocks.get(m, (0, 0))[0], reverse=True): + if mid not in blocks: + continue + s, e = blocks[mid] + lines[s:e] = _set_agnes_free(lines[s:e], plan["agnes_free"][mid], date) + # 4) 定价:改价 / 补价 / 删掉被删模型的价 gone = {m for prov in SYNC_PROVIDERS for m in plan["remove"].get(prov) or []} span = _pricing_span(lines) @@ -632,6 +754,14 @@ def verify(new_text: str, cfg_before: dict, plan: dict) -> list[str]: for mid, want in plan["free_set"].items(): if bool(oc2.get(mid, {}).get("free")) != bool(want): problems.append(f"免费标记 {mid} 没改成 {want}") + # Agnes 的免费标注:True(免费)/ "limited"(限时免费)/ None(该没有标注) + ag2 = {m["id"]: m for m in (cfg2.get("providers", {}).get("agnes") or {}).get("models", [])} + for mid, want in plan.get("agnes_free", {}).items(): + got = _cfg_free_state(ag2.get(mid, {})) + if got != want: + problems.append( + f"免费标注 {mid} 没写成 {{True: '免费', 'limited': '限时免费', None: '无标注'}}" + f"[{want!r}](现 {got!r})") # 定价 pr2 = ((cfg2.get("pricing") or {}).get("per_model") or {}) diff --git a/tests/test_gateway.py b/tests/test_gateway.py index 9e2e076..723faac 100644 --- a/tests/test_gateway.py +++ b/tests/test_gateway.py @@ -5101,6 +5101,98 @@ def test_sync_plan_is_empty_drills_into_provider_buckets(): assert sm.plan_is_empty({**empty, "free_set": {"m": True}}) is False +def test_agnes_free_map_rules(): + """Agnes 免费标注解析(2026-09-24 老板要求 Agnes 也标免费 / 限时免费)。 + + 只用文档里的**严格措辞**判定,且必须按 bullet/段落切块 + 只认反引号里的完整 id: + · 「当前均免费」「当前免费」→ 免费;「限时免费」→ 限时免费 + · 「输入图片前 5 张免费」这种计费公式附注 **不算** 模型免费(视频 2.5 就是这样) + · `agnes-video-2.5` 是 `agnes-video-2.5-flash` 的子串,不能互相串味 + """ + sys.path.insert(0, str(_ROOT / "scripts")) + import sync_models as sm + + ids = {"agnes-3.0-flash", "agnes-2.5-flash", "agnes-video-2.5", "agnes-video-2.5-flash", + "agnes-video-v2.0", "agnes-2.5-pro"} + + real = ("## 视频模型\n### 当前优惠\n" + "* `agnes-video-v2.0` 当前免费。\n" + "* `agnes-video-2.5` 按输出视频分辨率和总计费时长计费;输入图片前 5 张免费,第 6 张起计费。\n" + "* `agnes-video-2.5-flash` 采用相同计费公式,当前限时免费。\n" + "### 计费规则\n输入图片前 5 张免费。\n") + got = sm._agnes_free_map(real, ids) + assert got == {"agnes-video-v2.0": True, "agnes-video-2.5-flash": "limited"}, got + + # 改口径 → 不再免费(否则同步会一直把「免费」标签留在配置里) + changed = ("### 当前优惠\n* `agnes-3.0-flash` 当前按刊例价计费,暂无折扣。\n" + "* `agnes-2.5-flash` 当前均免费。\n") + assert sm._agnes_free_map(changed, ids) == {"agnes-2.5-flash": True} + + # 下一小节里的「免费」不能串进本轮判定 + boundary = "### 当前优惠\n* `agnes-video-v2.0` 当前免费。\n### 计费规则\n输入图片前 5 张免费。\n" + assert sm._agnes_free_map(boundary, ids) == {"agnes-video-v2.0": True} + + +def test_agnes_free_apply_and_revoke_round_trip(): + """agnes 免费标注落盘:加标注 / 限时 / 撤标注都要能改对,且不碰相邻手写注释。""" + import yaml as _yaml + sys.path.insert(0, str(_ROOT / "scripts")) + import sync_models as sm + + text = ( + "providers:\n" + " agnes:\n" + ' name: "Agnes"\n' + " models:\n" + ' - id: "agnes-3.0-flash"\n' + ' display_name: "Agnes 3.0 Flash"\n' + ' type: "text"\n' + " # 手写注释:别动我\n" + ' - id: "agnes-video-2.5-flash"\n' + ' display_name: "Agnes Video 2.5 Flash"\n' + ' type: "video"\n' + ' - id: "agnes-video-v2.0"\n' + ' display_name: "Agnes Video V2.0"\n' + ' type: "video"\n' + " free: true # 旧标注\n" + ) + date = "2026-09-24" + + def run(src, free_map): + plan = {"add": {"opencode": {}, "agnes": {}}, "remove": {"opencode": [], "agnes": []}, + "price_set": {}, "price_add": {}, "proto_add": {}, "free_set": {}, + "agnes_free": dict(free_map)} + new = sm.apply_plan(src, plan, date) + assert sm.verify(new, _yaml.safe_load(src), plan) == [], "回读校验必须全过" + return new, _yaml.safe_load(new)["providers"]["agnes"]["models"] + + # ① 加标注:普通免费 + 限时免费 + text, models = run(text, {"agnes-3.0-flash": True, "agnes-video-2.5-flash": "limited"}) + by = {m["id"]: m for m in models} + assert sm._cfg_free_state(by["agnes-3.0-flash"]) is True + assert "free_limited" not in by["agnes-3.0-flash"] + assert sm._cfg_free_state(by["agnes-video-2.5-flash"]) == "limited" + assert "别动我" in text, "相邻手写注释必须原样保留" + assert "旧标注" in text, "没在本次动作里的模型,标注行不许动" + + # ② 撤标注(文档改口径)+ 限时 → 普通免费 + text, models = run(text, {"agnes-video-v2.0": None, "agnes-video-2.5-flash": True}) + by = {m["id"]: m for m in models} + assert sm._cfg_free_state(by["agnes-video-v2.0"]) is None + assert not [k for k in by["agnes-video-v2.0"] if k.startswith("free")], "撤标注要整行删干净" + assert "旧标注" not in text + assert sm._cfg_free_state(by["agnes-video-2.5-flash"]) is True + assert "free_limited" not in by["agnes-video-2.5-flash"], "限时行要跟着删" + assert sm._cfg_free_state(by["agnes-3.0-flash"]) is True, "不相关的模型不能被顺手改掉" + + # ③ 幂等:同一份动作重放,结果逐字节一致 + plan = {"add": {"opencode": {}, "agnes": {}}, "remove": {"opencode": [], "agnes": []}, + "price_set": {}, "price_add": {}, "proto_add": {}, "free_set": {}, + "agnes_free": {"agnes-3.0-flash": True}} + assert sm.apply_plan(sm.apply_plan(text, plan, date), plan, date) == \ + sm.apply_plan(text, plan, date) + + # 直接运行(非 pytest)—— 必须留在文件末尾,见上方 `test_image_request_goes_to_requested_model` # 之前的旁注:运行器只会收集执行到这一行时已经存在的 globals。 if __name__ == "__main__":