42 lines
3.1 KiB
Markdown
42 lines
3.1 KiB
Markdown
# 自定义版本说明
|
||
|
||
当前版本为 v1.0.0-rc.45-custom.97，基于官方 v1.0.0-rc.45。
|
||
|
||
## 主要定制
|
||
|
||
- 固定令牌支持有序分组池、备用分组、可重试错误切换及分组可用性判断；按实际命中的分组计费和记录日志。
|
||
- 支持分组动态计费表达式、请求明细、路由过程及逐次请求结算。
|
||
- 用户侧隐藏上游错误细节；客户端断开与真实上游故障分别处理。
|
||
- Astra 模型指纹抽检、响应模型守卫、鹈鹕检测及检测费用结算。
|
||
- 独立公开 uptime 页，使用 shadcn/ui，支持分组别名、隐藏分组和管理员重置当前分组检测记录。
|
||
- 主站 /group-status 使用真实分组名并展示全部分组，检测请求使用真实分组标识；独立 uptime 页应用公开展示配置。
|
||
- 渠道每 15 分钟探活，展示最近 18 次记录；正常用户请求可恢复分组正常状态。
|
||
- 两页共用分组行布局，正常与性能下降分组共同优先，同类状态中支持 Astra 的分组排在前面，其他分组使用紧凑布局；鹈鹕样例按时间倒序横向滚动，最新在左，点击缩略图预览。
|
||
- 作品脚本在隔离 iframe 中运行，以保留腿部、踏板等动画绘制；缩略图按容器宽度等比缩放。
|
||
|
||
## custom.97
|
||
|
||
- 视觉检测区分能力残缺、疑似降智和运行失败，保留各项检测的独立有效结论。
|
||
- 按分组与模型展示吞吐量、首字时间：各自优先使用最近 30 次有效调用，缺少调用时使用测试数据。
|
||
- 自动分组新增高吞吐优先策略；网站图标可通过构建变量配置。
|
||
- Astra 优先分组预设从当前分组池选择，不绑定特定供应商。
|
||
|
||
## 从源码构建
|
||
|
||
docker build -f Dockerfile.local-release -t local/new-api:v1.0.0-rc.45-custom.97 .
|
||
|
||
此入口从 Bun、Go 和 Debian 基础镜像构建前端与服务，不要求预先存在旧版 local/new-api 镜像。VERSION 用于编译版本号；Compose 如果设置了 VERSION 环境变量，也应同步更新。
|
||
|
||
构建需要 Bun 和 Go 1.26；Dockerfile.local-release 包含完整的前端与后端构建过程。
|
||
|
||
## 运行与升级
|
||
|
||
使用现有外部 PostgreSQL 和 Valkey，连接信息通过部署环境提供。仓库不包含生产凭据、数据库内容或线上 Compose 配置。
|
||
|
||
升级前备份数据库及 Compose 配置，部署后检查容器健康、版本号、主站分组状态和公开 uptime 页面。Uptime Kuma 的停用与域名反向代理属于部署配置，不会仅因替换应用镜像自动完成。
|
||
|
||
|
||
## custom.44 current availability
|
||
|
||
最近 15 分钟内，以最新完成的真实用户请求结果决定分组状态：成功为正常，上游服务失败为异常；抽检不覆盖这段时间的真实使用结果。客户端取消、参数错误和本地额度不足不改变分组健康状态。没有近期真实请求时使用最近一次独立探活，超过 30 分钟未探活显示未知。禁用分组保持不可用。指纹、鹈鹕和小时请求成功率保留为历史统计，不直接决定当前状态。正常与性能下降分组一起优先排列，同类中 Astra 优先。
|