-
Zentrola 1.2.1 已发布。Zentrola 是面向研发团队的开源 AI Coding 能力治理平台:开发者继续使用 Codex、Claude Code 等熟悉的客户端,管理员集中管理模型、服务商、凭据、权限、配额和用量成本。本次更新重点完善模型目录同步和 Claude Code 订阅接入,并修复缓存计费、流式用量及网关故障处理中的问题。
模型目录同步覆盖更多凭据
Anthropic 官方模型目录现在可以通过 API Key 读取 /v1/models;没有可用 API Key 时,可使用 Claude Code 订阅 Token。同步会跳过已弃用模型,并记录图片输入能力。OpenAI 侧在没有可用 API Key 时,也可以用 Codex 订阅凭据同步 ChatGPT Codex 模型目录,跳过隐藏模型。同步已有模型时,不再覆盖管理员维护的显示名称和发布方。
Claude 订阅额度和连接测试更可靠
Claude Code 订阅连接测试改为对选定模型发送一次最小请求,从响应中的 5 小时和 7 天统一限额更新额度状态;凭据列表也新增手动刷新额度。网关转发订阅请求时会同步额度,额度耗尽后在重置前暂停路由到该凭据。手动刷新会消耗极少量订阅额度,也可能开启新的 5 小时窗口。
此前 Claude 订阅连接测试及网关请求可能遇到 HTTP 429,本版修正了 Claude Code 请求所需的标识与系统提示处理。Claude 订阅 OAuth Token 仅发送到 api.anthropic.com。新增可选配置 CLAUDE_CODE_VERSION,用于统一声明 Claude 订阅请求的客户端版本。
用量和成本核算更准确
Anthropic 输入 Token 现在包含缓存写入和缓存读取,月度 Token 配额因此会计入缓存提示。API Key 模型价格可单独设置缓存写入单价;未设置时按输入单价核算。此前使用提示缓存的 Anthropic 调用可能被误判为用量不完整,本版已修复。OpenAI Chat 流式请求会向上游索取用量;若流结束仍没有用量,会明确记录为失败。订阅价格与已出账账期的重叠检查、当月费用分摊和计费任务扫描效率也得到改进。
网关和管理端改进
-
新增可选配置 GATEWAY_STREAM_IDLE_TIMEOUT,默认 300 秒:上游响应(包括 SSE)持续无数据超过该时间时,按 UPSTREAM_TIMEOUT 中断并记录。并发故障转移、订阅凭据刷新、Redis 超时和客户端断开等场景的处理更加稳健。管理端操作日志支持按关键词、类型和结果在服务端筛选,也修复了筛选切换时显示旧结果等问题。
升级提示
升级需执行数据库迁移 00055 至 00058。启用 MIGRATIONS_AUTO_APPLY 时由 Backend 启动自动执行,否则应先运行 zentrola migrate。00058 会并发建立用量核算索引,数据量大时可能耗时较长。现有配置无需修改;但升级后 Anthropic 输入 Token 和月度配额用量可能因缓存提示计入而增加。不支持 stream_options 的 OpenAI 兼容上游,可能无法处理流式 Chat 请求。
完整变更与下载:Zentrola 1.2.1 Release;项目仓库:GitHub。