From f1979bd1a7f4a26e4fb3c7faf3f8b369d20ddf8a Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 16 Nov 2026 10:19:04 +0800 Subject: [PATCH] docs: record the provider key pool (BUG-1922) Co-Authored-By: Claude Fable 5.2 Claude-Session: https://claude.ai/code/session_01DbBXp2Vp62Ur3C7yRWQdSq --- docs/BUG_HISTORY.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/BUG_HISTORY.md b/docs/BUG_HISTORY.md index 29a126862..5d4f722c3 100644 --- a/docs/BUG_HISTORY.md +++ b/docs/BUG_HISTORY.md @@ -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 实测。