feat: sync deployed v1.0.0-rc.38-custom.42

Sync production source including routing, billing, Astra detection and public uptime. Update custom build instructions and license packaging.

CUSTOMIZATION.md

@@ -1,20 +1,32 @@
 # 自定义版本说明
 
-当前生产版本基于官方 `v1.0.0-rc.36`（`ea7cb0ba4e0f82e2bfa5e55752eb68bdf902f71b`），版本号为 `v1.0.0-rc.36-custom.2`。
+当前版本为 v1.0.0-rc.38-custom.42-20260926，基于官方 v1.0.0-rc.38，对应 2026-09-26 已部署的自定义源码。
 
-包含以下生产定制：
+## 主要定制
 
-- 仅展示存在可用渠道的分组；禁用、无渠道和不可用分组不进入用户筛选。
-- 固定令牌分组可配置一个备用分组；主分组无路由或发生可重试上游错误时按顺序切换，实际命中的分组用于计费和日志。
-- 固定令牌配置了备用分组时，备用分组切换优先于会话亲和规则的“失败后不重试”；上游返回可重试错误（如 503）时不再停在主分组渠道。不可重试错误、显式指定渠道和 auto 分组行为保持不变。
-- 分组状态页展示请求成功率、首字延迟、平均延迟、TPS、请求缓存和令牌缓存指标。
-- 支持按分组配置动态计费表达式，并在价格页按所选分组展示。
-- 用户侧隐藏上游错误细节，完整错误仅保留在 root 日志范围；客户端断开不计为上游失败。
+- 固定令牌支持有序分组池、备用分组、可重试错误切换及分组可用性判断；按实际命中的分组计费和记录日志。
+- 支持分组动态计费表达式、请求明细、路由过程及逐次请求结算。
+- 用户侧隐藏上游错误细节；客户端断开与真实上游故障分别处理。
+- Astra 模型指纹抽检、响应模型守卫、鹈鹕检测及检测费用结算。
+- 独立公开 uptime 页，使用 shadcn/ui，支持分组别名、隐藏分组和管理员重置当前分组检测记录。
+- 主站 /group-status 使用真实分组名并展示全部分组，检测请求使用真实分组标识；独立 uptime 页应用公开展示配置。
+- 渠道每 15 分钟探活，展示最近 18 次记录；正常用户请求可恢复分组正常状态。
+- 支持 Astra 的分组排在前面，其他分组使用紧凑布局；鹈鹕样例按时间倒序横向滚动，最新在左，点击缩略图预览。
+- 鹈鹕检测通过 manxue.ai 访客接口请求公开作品，保存可跳转的作品链接；连接失败时本地生成并标记为不确定。
+- 作品脚本在隔离 iframe 中运行，以保留腿部、踏板等动画绘制；缩略图按容器宽度等比缩放。
 
-生产镜像通过以下命令构建：
+## 从源码构建
 
-```sh
-docker build --pull=false -f Dockerfile.request-status -t local/new-api:v1.0.0-rc.36-custom.2-20260911 .
-```
+    docker build -f Dockerfile.local-release -t local/new-api:v1.0.0-rc.38-custom.42-20260926 .
 
-`Dockerfile.request-status` 会执行前端类型检查、相关 Vitest 与 oxlint 检查、Go 回归测试和生产构建。
+此入口从 Bun、Go 和 Debian 基础镜像构建前端与服务，不要求预先存在旧版 local/new-api 镜像。VERSION 用于编译版本号；Compose 如果设置了 VERSION 环境变量，也应同步更新。
+
+其他 Dockerfile.* 和 build-fingerprint-backend.sh 保留为历史构建参考。部分增量构建文件依赖服务器上的旧版镜像或已编译二进制，新环境请使用 Dockerfile.local-release。
+
+## 运行与升级
+
+使用现有外部 PostgreSQL 和 Valkey，连接信息通过部署环境提供。仓库不包含生产凭据、数据库内容或线上 Compose 配置。
+
+升级前备份数据库及 Compose 配置，部署后检查容器健康、版本号、主站分组状态和公开 uptime 页面。Uptime Kuma 的停用与域名反向代理属于部署配置，不会仅因替换应用镜像自动完成。
+
+公开作品链接受 manxue.ai 的保留期限约束；没有公开链接的历史作品继续使用本站预览。