mirror of
https://github.com/fawney19/Aether.git
synced 2026-09-12 22:20:19 +08:00
fix(providers): restore legacy endpoint health defaults
This commit is contained in:
@@ -7,31 +7,47 @@
|
||||
|
||||
## 统计规则
|
||||
|
||||
沿用 `v0.7.13`(`535ee098c`)的默认健康规则:已启用密钥缺少该格式的健康记录时,
|
||||
按 `1.0` 参与统计,而不是要求先有一次请求或探测才能显示健康。
|
||||
|
||||
- 仅统计启用端点下、支持该端点 API 格式的启用密钥。
|
||||
- 每个密钥读取其 `health_by_format[api_format].health_score`,不跨格式借用分数。
|
||||
- 只对已有的有效健康分数求算术平均;没有健康数据的密钥不按满分计入。
|
||||
- 对上述启用密钥求算术平均;缺少有效分数的密钥沿用旧版默认值 `1.0`。
|
||||
- 分数范围为 `0` 到 `1`,沿用调度器的分数读取与范围约束。
|
||||
- 停用端点、没有启用密钥或没有有效健康分数时,端点的 `health_score` 返回 `null`。
|
||||
- `avg_health_score` 仅平均有有效健康数据的启用端点;没有此类端点时返回 `null`。
|
||||
- 停用端点或没有启用密钥时,端点的 `health_score` 返回 `null`。
|
||||
- `avg_health_score` 仅平均有启用密钥的启用端点,包含按默认值计算的端点;没有此类端点时返回 `null`。
|
||||
- `unhealthy_endpoints` 仅统计上述端点中健康度低于 `0.5` 的数量,不把未知状态算作故障。
|
||||
|
||||
`total_keys` 和 `active_keys` 仍反映密钥配置数量,不因缺少健康数据而减少。
|
||||
|
||||
Codex、Kiro、Gemini CLI、Antigravity 等固定提供商的账号按照各提供商的认证规则,
|
||||
继承其启用端点的 API 格式;账号的 `api_formats` 为 `null` 或空数组,不代表没有配置账号。
|
||||
继承格式决定账号归属;缺少对应格式的分数时同样使用默认值 `1.0`,不借用其他格式的异常分数。
|
||||
|
||||
## 数据读取
|
||||
|
||||
摘要从密钥的轻量投影读取 API 格式、启用状态和 `health_by_format`。
|
||||
PostgreSQL 投影中的凭据字段使用 `summary` / `{}` 等脱敏占位值,并非真实密文,
|
||||
因此摘要读取不执行凭据解密、认证或迁移。完整密钥读取仍保留原有的凭据安全校验。
|
||||
|
||||
若将这些占位值送入凭据校验,读取会失败,并被摘要聚合当作空密钥列表,
|
||||
导致已配置密钥的端点也被错误显示为灰色;不能通过给缺失分数默认填 `100%` 来修复。
|
||||
若将这些占位值送入凭据校验,读取会失败,旧的摘要聚合还会将其当作空密钥列表,
|
||||
导致已配置密钥的端点也被错误显示为灰色。默认健康分数只能用于成功读取的启用密钥,
|
||||
不能用于掩盖查询或凭据投影错误。
|
||||
|
||||
提供商、端点或密钥摘要查询失败时,接口返回 `503`,不能将失败当作空列表并返回零账号。
|
||||
单个提供商确实不存在时仍返回 `404`。页面刷新失败保留已有列表,并显示加载错误。
|
||||
|
||||
## 页面展示
|
||||
|
||||
桌面表格和手机卡片使用相同规则:
|
||||
桌面表格、网格卡片和手机卡片使用相同规则:
|
||||
|
||||
- 有健康数据时显示百分比;有效的零分显示 `0%`。
|
||||
- 无健康数据时显示灰色占位条和 `-`,提示“暂无健康数据”,不显示 `100%` 或 `0%`。
|
||||
- 有启用密钥、但这些密钥尚无该格式的健康记录时,显示绿色 `100%`,与 `v0.7.13` 一致。
|
||||
- 端点停用、未配置密钥或没有启用密钥时显示灰色占位条和对应状态提示。
|
||||
|
||||
此分数是密钥当前健康状态的聚合,不是某个时间窗口内的请求成功率,也不是主动探测结果。
|
||||
账号详情保留原有默认 `100%` 的规则。已有观测仍取各格式最低分;端点分数则只聚合对应格式,
|
||||
两者统计范围不同,不要求百分比完全相等。调度器原有的缺省健康策略不变。
|
||||
|
||||
此分数是密钥当前健康状态的聚合,包含默认健康值,不是某个时间窗口内的请求成功率,
|
||||
也不表示已经执行过主动探测。相比 `v0.7.13`,仍保留停用账号/端点不参与健康聚合、
|
||||
凭据脱敏与查询失败显式报错等修复,不整体回退旧版代码。
|
||||
|
||||
Reference in New Issue
Block a user