docs: record the provider key pool (BUG-1922)
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DbBXp2Vp62Ur3C7yRWQdSq
This commit is contained in:
@@ -25901,3 +25901,16 @@
|
||||
- 验证与防复发:本地 DeepSeek flash,同一问题 4 张公开盘改前改后各一份,另抽事业、婚恋、健康 6 份:正文里「盘分不出」「这条线」「这一侧」和括号标签改前 10 处、改后 0 处;证据卡核对无不符。没有做盲评,没有重新统计与生平不符的严重错误,判断更直接后这类错误可能回升。测试:`frontend/tests/consult-answer-shape-20261105.test.ts`、`consultation-voice-contract.test.ts`、`consult-pressure-lines-20261104.test.ts`、`consult-judgment-basis-20261116.test.tsx` 等 11 个文件改为锁新写法(每处注明原值、新值、原因);对话相关测试 798 项通过。
|
||||
- 关联记录:BUG-1603(上次可读性修改,允许起说法)、BUG-1599 / BUG-1161(压力句与范围)、BUG-1756(限制与结论相邻)、BUG-1647(规则不能整批删)。与上游 skill 本地跑同一问题的对照另见数据缺口(互换星座、A4 / A9、Raman 原文未送达),未在本次修改内。
|
||||
- 修复版本:`claude/answer-readability-1116`,待 staging 实测。
|
||||
|
||||
## BUG-1922 | 一个模型供应商只能配一个 Key,多个账号没法分流,也没有并发控制
|
||||
|
||||
- 状态:fixed-pending-verify(待 staging 实测;真实数据库测试只在 CI 跑)。
|
||||
- 首次发现 / 最近更新:2026-11-16 / 2026-11-16。
|
||||
- 触发与现象:后台的模型供应商只有一个 API Key 字段。同一家有几个账号时只能用一个,高峰时单个 Key 被限流,其余账号闲着。
|
||||
- 触发条件:任何模型调用;并发高或单 Key 被限流时最明显。
|
||||
- 根因:`public.model_providers.encrypted_api_key` 是单值,模型目录解析时直接取这一个 Key,没有按请求选 Key 的环节。
|
||||
- 修复:新增 `public.model_provider_keys`(名称、密文、启用、并发上限),迁移把原有 Key 复制成一条「默认」;原字段保留并始终等于第一条启用的 Key,旧镜像、发布与回滚检查、连接测试照常。后台「编辑供应商」里可以添加、编辑、测试、停用、删除 Key;启用中的供应商不能停用或删除最后一条启用的 Key,每个供应商最多 20 条。运行时每次调用在未冷却的 Key 里选在途请求最少的;都到上限时排队,最多等 15 秒后落到最空的一条。429 冷却 30 秒(按 Retry-After,最长 120 秒),401 / 403 冷却 10 分钟并在后台列表显示「上次调用被拒绝」;还没输出内容就遇到这三种状态时换一条 Key 重试一次。任何接口、日志、审计都不返回 Key 内容。
|
||||
- 验证与防复发:`frontend/tests/model-key-pool.test.ts`(选 Key、上限与排队、冷却、中断释放)、`pooled-language-model.test.ts`(真实 Agent 对本地兼容接口:轮流用 Key、429 不到用户、释放)、`model-provider-keys.test.ts`(迁移合同、接口不含 Key、最后一条保护、权限)、`database-model-provider-keys.test.ts`(真实数据库,本机无 Docker 未跑,待 CI)。本机用 PGlite 加最小表结构跑过迁移。未在本机验证:登录后的后台页面全流程、原生 OpenAI / Anthropic 类型走连接池。
|
||||
- 已知限制:在途计数、冷却和「上次调用被拒绝」存在 Web 进程内存里,重启清零,多容器不共享;用量账本不记录是哪一条 Key;编辑或替换第一条启用的 Key 后,下次发布要重新做连接测试。
|
||||
- 关联记录:BUG-147(admin_runtime 缺 SELECT policy)、BUG-1914(模型单价)。
|
||||
- 修复版本:`claude/provider-key-pool-1116`,待 staging 实测。
|
||||
|
||||
Reference in New Issue
Block a user