feat(schemas): provider 加可选 requiredClientVersion 字段 + 向后兼容规约 (#54)

配合 desirecore #1038 的 provider 级版本门槛:新凭据源/新能力 provider 必须
声明最低客户端版本,≥#1038 的客户端据此优雅门控为「需更新客户端」。
带 pattern 收紧格式(客户端 schema 端故意开放 string + fail-open,源头把关
放这里)。CLAUDE.md 补充「enum 扩值 vs 新增可选字段」的风险区别与推送时序规约。
This commit is contained in:
2026-07-09 18:25:16 +08:00
committed by GitHub
parent 0349473fd4
commit 6d7a3a70c3
2 changed files with 20 additions and 0 deletions

View File

@@ -181,6 +181,11 @@
"type": "array",
"description": "预置显式删除的模型 modelName 白名单",
"items": { "type": "string" }
},
"requiredClientVersion": {
"type": "string",
"pattern": "^\\d+\\.\\d+\\.\\d+$",
"description": "使用此 provider 所需的最低客户端版本semver x.y.z。对已铺开韧性#848/#1021的客户端是可安全推送的未知字段非毒丸——毒丸只源自已知字段的 enum 值扩展);≥ 支持版本(含 desirecore #1038的客户端据此把 provider 优雅门控为「需更新客户端」并从模型选择器排除。规约:新凭据源/新能力 provider 必须声明本字段;降低/解除要求请改为更小版本号而非删除字段(预设合并不回传字段删除)"
}
},
"additionalProperties": false,