运行时层 (内存缓存)
├── 系统设置缓存 (60s TTL)
├── 熔断器状态
└── 动态日志级别

数据库层 (PostgreSQL)
├── system_settings (全局配置)
├── providers (供应商设置)
└── users/keys (配额与限制)

环境层 (process.env)
├── 数据库连接
├── Redis 配置
└── 安全策略

const booleanTransform = (s: string) => s !== "false" && s !== "0";

let _envConfig: EnvConfig | null = null;

export function getEnvConfig(): EnvConfig {
  if (!_envConfig) {
    _envConfig = EnvSchema.parse(process.env);
  }
  return _envConfig;
}

DSN: z.preprocess((val) => {
  if (!val || typeof val !== "string") return undefined;
  if (val.includes("user:password@host:port")) return undefined;
  return val;
}, z.string().url().optional())

ADMIN_TOKEN: z.preprocess((val) => {
  if (!val || typeof val !== "string") return undefined;
  if (val === "change-me") return undefined;
  return val;
}, z.string().min(1).optional())

MAX_RETRY_ATTEMPTS_DEFAULT: z.coerce.number().min(1).max(10).default(2)

{
  fixTruncatedJson: true,    // 修复不完整的 JSON 响应
  fixSseFormat: true,        // 修复 Server-Sent Events 格式问题
  fixEncoding: true,         // 纠正字符编码问题
  maxJsonDepth: 200,         // 最大 JSON 解析深度
  maxFixSize: 1024 * 1024    // 处理的最大响应大小 (1MB)
}

const DEFAULT_SETTINGS = {
  enableHttp2: false,
  interceptAnthropicWarmupRequests: false,
  enableThinkingSignatureRectifier: true,
  enableCodexSessionIdCompletion: true,
  enableResponseFixer: true,
  responseFixerConfig: {
    fixTruncatedJson: true,
    fixSseFormat: true,
    fixEncoding: true,
    maxJsonDepth: 200,
    maxFixSize: 1024 * 1024,
  },
};

export const UpdateSystemSettingsSchema = z.object({
  siteTitle: z.string().min(1).max(128).optional(),
  allowGlobalUsageView: z.boolean().optional(),
  currencyDisplay: z.enum(Object.keys(CURRENCY_CONFIG)).optional(),
  billingModelSource: z.enum(["original", "redirected"]).optional(),
  timezone: z.string().refine(isValidIANATimezone).optional(),
  // ... 其他字段
});

export function isValidIANATimezone(timezone: string): boolean {
  try {
    Intl.DateTimeFormat(undefined, { timeZone: timezone });
    return true;
  } catch {
    return false;
  }
}

export const CreateProviderSchema = z.object({
  name: z.string().min(1).max(64),
  url: z.string().url().max(255),
  key: z.string().min(1).max(1024),
  weight: z.number().int().min(1).max(100).default(1),
  priority: z.number().int().min(0).max(2147483647).default(0),
  cost_multiplier: z.number().min(0).default(1.0),
  circuit_breaker_failure_threshold: z.number().int().min(0).optional(),
  circuit_breaker_open_duration: z.number().int().min(1000).max(86400000).optional(),
  circuit_breaker_half_open_success_threshold: z.number().int().min(1).max(10).optional(),
  proxy_url: z.string().max(512).nullable().optional(),
  proxy_fallback_to_direct: z.boolean().default(false),
});

export const PROVIDER_LIMITS = {
  WEIGHT: { MIN: 1, MAX: 100 },
  MAX_RETRY_ATTEMPTS: { MIN: 1, MAX: 10 },
  LIMIT_5H_USD: { MIN: 0.1, MAX: 1000, STEP: 1 },
  LIMIT_WEEKLY_USD: { MIN: 1, MAX: 5000, STEP: 1 },
  LIMIT_MONTHLY_USD: { MIN: 10, MAX: 30000, STEP: 1 },
  CONCURRENT_SESSIONS: { MIN: 1, MAX: 150 },
} as const;

export async function saveSystemSettings(formData: {...}) {
  const validated = UpdateSystemSettingsSchema.parse(formData);
  const updated = await updateSystemSettings(validated);

  invalidateSystemSettingsCache();

  for (const locale of locales) {
    revalidatePath(`/${locale}/settings/config`);
    revalidatePath(`/${locale}/dashboard`);
  }

  return { ok: true, data: updated };
}

export async function POST(req: Request) {
  const { level } = await req.json();
  setLogLevel(level as LogLevel);
  return Response.json({ success: true, level });
}

数据库时区 -> 环境 TZ -> UTC

# 安全性 (务必更改默认值！)
ADMIN_TOKEN=your-secure-random-token

# 数据库连接
DSN=postgresql://user:password@postgres:5432/db_name

# 用于缓存和限流的 Redis
REDIS_URL=redis://redis:6379

# 您所在地区的时区
TZ=Asia/Shanghai

# 初始设置后禁用自动迁移
AUTO_MIGRATE=false

# 增加连接池（根据数据库 max_connections 进行调整）
DB_POOL_MAX=50

# 启用异步写入以减轻数据库负载
MESSAGE_REQUEST_WRITE_MODE=async
MESSAGE_REQUEST_ASYNC_BATCH_SIZE=500

# 启用供应商缓存
ENABLE_PROVIDER_CACHE=true

# 增加连接超时
FETCH_CONNECT_TIMEOUT=60000

# 在网络错误时不启用熔断器
ENABLE_CIRCUIT_BREAKER_ON_NETWORK_ERRORS=false

# 增加重试次数
MAX_RETRY_ATTEMPTS_DEFAULT=3

# 生产环境日志级别
LOG_LEVEL=info

# 启用详细的供应商错误以便调试（通过 UI 设置）
# verboseProviderError: true

# 启用自动日志清理（通过 UI 设置）
# enableAutoCleanup: true
# cleanupRetentionDays: 7