Agnes 免费/限时免费标注 + 免费标签间距对齐(老板 2026-09-24)

老板两件事:
1) Agnes 的模型也要标免费或限时免费 —— 之前只有 OpenCode 的 space-bunny-free 有标注;
2) 免费标签跟模型名的间隔不一样,优化。

免费标注:
- 口径(照官方措辞,按 bullet 切块判定,不关键词泛扫):
  · OpenCode 价格表 Input/Output = Free(原逻辑)
  · Agnes 定价页「### 当前优惠」:当前(均)免费 → 免费;当前限时免费 → 限时免费
  坑:Agnes 视频 agnes-video-2.5 那条 bullet 写着「输入图片前 5 张免费」——
  那是计费公式的免费额度、不是模型免费,所以只认严格措辞「当前免费 / 当前均免费 /
  均免费 / 限时免费」,且只认反引号里的完整 id(agnes-video-2.5 是
  agnes-video-2.5-flash 的子串,字符串包含会串味)。
- 配置:free: true(免费)+ 新增 free_limited: true(限时免费)。
  落盘 7 条:3.0-flash / 2.5-flash / image-2.0-flash / image-2.1-flash /
  image-2.5-flash / video-v2.0 = 免费;video-2.5-flash = 限时免费。
- scripts/sync_models.py:新增 _agnes_free_map() / _set_agnes_free(),免费标注纳入
  漂移比对 + --apply 落盘(官方改口径 → 整行撤掉标注),回读校验新增 Agnes 免费位检查;
  新增模型块也会带上标注。
- 后端:ModelInfo.free_limited + /v1/models 带出 free_limited(别名随目标继承)。
- 前端:标签文案 免费 / 限时免费(中英各 +2 键,i18n 755/755 对称),提示语同步更新
  (原文案只提 OpenCode Go 计划,已不准确)。

间距:
- 根因:.st-row 是 flex(gap:8px),.name-free 又加 margin-left:6px → 标签左侧 8+6=14px、
  右侧 8px,与其它行「模型名 → 供应商名」的 8px 节奏不一致。
- 修法:.st-row .name-free { margin-left: 0 }(表格单元格是行内排布、无 flex gap,
  那边保留 6px)。同源最小页实测:修前 14/8,修后 8/8。

测试:新增 test_agnes_free_map_rules、test_agnes_free_apply_and_revoke_round_trip
(含 撤标注/限时→免费/幂等/相邻手写注释不被碰);195 passed / 0 failed。
This commit is contained in:
api-gateway committed 2026-09-24 13:49:48 +08:00
1 parent adea820d2c
commit b0f088b82c
10 files changed
+312 -12

No files matched your search

+26
View File
@@ -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 也写盘」
**老板需求**:网关的模型清单要和上游官方文档**同步**——文档新增的加进去、下线的删掉、
+9 -1
View File
@@ -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 受保护),
+10
View File
@@ -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(
+3
View File
@@ -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})
+8
View File
@@ -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"
+3 -1
View File
@@ -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',
+3 -1
View File
@@ -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: '全部文本模型',
+23 -4
View File
@@ -34,8 +34,9 @@
挂锁标注 + 悬浮说明,省掉「为什么我传的参数不生效」这类困惑。 -->
<Icon v-if="m.paramNote" name="lock" :size="12" class="plock" :title="m.paramNote" />
<span class="code">{{ m.id }}</span>
<!-- 2026-09-21(老板要求):免费标志直接跟在模型名后面 -->
<span v-if="m.free" class="pill free name-free" :title="t('models.freeHint')">{{ t('models.freeTag') }}</span>
<!-- 2026-09-21(老板要求):免费标志直接跟在模型名后面
2026-09-24:区分「免费」与「限时免费」(Agnes 视频 2.5 Flash 是限时档) -->
<span v-if="m.free" class="pill free name-free" :title="freeHint(m)">{{ freeText(m) }}</span>
<!-- 支持的格式不在这里铺标签:这行还要放供应商/延迟/测速按钮,窄卡放不下第三颗
(悬停整行可见格式 + 本次测速走的线,见 rowTitle)。权威展示在下方表格的
「支持的格式」列。 -->
@@ -136,8 +137,9 @@
<el-table-column :label="t('models.id')" min-width="215">
<template #default="{ row }">
<span class="code">{{ row.id }}</span>
<!-- 2026-09-21(老板要求):免费标志直接跟在模型名后面 -->
<span v-if="row.free" class="pill free name-free" :title="t('models.freeHint')">{{ t('models.freeTag') }}</span>
<!-- 2026-09-21(老板要求):免费标志直接跟在模型名后面
2026-09-24:区分「免费」与「限时免费」 -->
<span v-if="row.free" class="pill free name-free" :title="freeHint(row)">{{ freeText(row) }}</span>
</template>
</el-table-column>
<el-table-column :label="t('models.type')" width="90">
@@ -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 {
+135 -5
View File
@@ -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(一行跨多行计费项)、有的单行自带,
所以按 `<tr>` 块解析,**第一格是模型 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 {})
+92
View File
@@ -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__":