llm-simple-router 0.5.1 → 0.5.2

package/dist/admin/setup.js

@@ -3,6 +3,7 @@ import jwt from "jsonwebtoken";
 import { getSetting, setSetting, isInitialized } from "../db/settings.js";
 import { hashPassword } from "../utils/password.js";
 import { HTTP_BAD_REQUEST, HTTP_CONFLICT } from "./constants.js";
+import { API_CODE, apiError } from "./api-response.js";
 const CRYPTO_BYTES_LENGTH = 32;
 const MIN_PASSWORD_LENGTH = 6;
 export const adminSetupRoutes = (app, options, done) => {
@@ -13,7 +14,7 @@ export const adminSetupRoutes = (app, options, done) => {
     app.post("/admin/api/setup/initialize", async (request, reply) => {
         const { password } = request.body;
         if (!password || password.length < MIN_PASSWORD_LENGTH) {
-            return reply.code(HTTP_BAD_REQUEST).send({ error: { message: `Password must be at least ${MIN_PASSWORD_LENGTH} characters` } });
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.VALIDATION_FAILED, `Password must be at least ${MIN_PASSWORD_LENGTH} characters`));
         }
         // 事务中原子检查防竞态
         const alreadyInitialized = db.transaction(() => {
@@ -28,7 +29,7 @@ export const adminSetupRoutes = (app, options, done) => {
             return false;
         })();
         if (alreadyInitialized) {
-            return reply.code(HTTP_CONFLICT).send({ error: { message: "Already initialized" } });
+            return reply.code(HTTP_CONFLICT).send(apiError(API_CODE.ALREADY_INITIALIZED, "Already initialized"));
         }
         // 自动登录：签发 JWT
         const TOKEN_EXPIRY_SECONDS = 172800; // 48 hours，与 admin-auth 保持一致

package/dist/admin/stats.js

@@ -1,14 +1,31 @@
 import { Type } from "@sinclair/typebox";
 import { getStats } from "../db/index.js";
+import { resolveTimeRange } from "../utils/time-range.js";
 const StatsQuerySchema = Type.Object({
-    period: Type.Optional(Type.String()),
+    period: Type.Optional(Type.Union([
+        Type.Literal("window"),
+        Type.Literal("weekly"),
+        Type.Literal("monthly"),
+    ])),
+    start_time: Type.Optional(Type.String()),
+    end_time: Type.Optional(Type.String()),
     router_key_id: Type.Optional(Type.String()),
 });
 export const adminStatsRoutes = (app, options, done) => {
     app.get("/admin/api/stats", { schema: { querystring: StatsQuerySchema } }, async (request, reply) => {
         const query = request.query;
-        const period = (query.period || "24h");
-        const stats = getStats(options.db, period, query.router_key_id);
+        let startTime;
+        let endTime;
+        if (query.start_time && query.end_time) {
+            startTime = query.start_time;
+            endTime = query.end_time;
+        }
+        else {
+            const range = resolveTimeRange((query.period ?? "weekly"), options.db, query.router_key_id);
+            startTime = range.startTime;
+            endTime = range.endTime;
+        }
+        const stats = getStats(options.db, startTime, endTime, query.router_key_id);
         return reply.send(stats);
     });
     done();

package/dist/admin/upgrade.js

@@ -6,6 +6,7 @@ import { execSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
 import { HTTP_BAD_REQUEST, HTTP_INTERNAL_ERROR } from '../constants.js';
+import { API_CODE, apiError } from './api-response.js';
 const GITHUB_CONFIG_BASE = 'https://raw.githubusercontent.com/zhushanwen321/llm-simple-router/main/config';
 const GITEE_CONFIG_BASE = 'https://gitee.com/zzzzswszzzz/llm-simple-router/raw/main/config';
 const CHECK_INTERVAL_MS = 60 * 60 * 1000; // eslint-disable-line no-magic-numbers
@@ -48,7 +49,7 @@ export const adminUpgradeRoutes = (app, options, done) => {
     app.put('/admin/api/upgrade/sync-source', async (req, reply) => {
         const { source } = req.body;
         if (source !== 'github' && source !== 'gitee') {
-            return reply.code(HTTP_BAD_REQUEST).send({ error: { message: 'source must be github or gitee' } });
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.BAD_REQUEST, 'source must be github or gitee'));
         }
         setConfigSyncSource(db, source);
         return reply.send({ ok: true });
@@ -56,14 +57,14 @@ export const adminUpgradeRoutes = (app, options, done) => {
     app.post('/admin/api/upgrade/execute', async (req, reply) => {
         const deployment = detectDeployment();
         if (deployment !== 'npm') {
-            return reply.code(HTTP_BAD_REQUEST).send({ error: { message: '仅支持 npm 全局安装模式下自动升级' } });
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.BAD_REQUEST, '仅支持 npm 全局安装模式下自动升级'));
         }
         const { version } = req.body;
         if (!version) {
-            return reply.code(HTTP_BAD_REQUEST).send({ error: { message: 'version is required' } });
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.BAD_REQUEST, 'version is required'));
         }
         if (!/^\d+\.\d+\.\d+$/.test(version)) {
-            return reply.code(HTTP_BAD_REQUEST).send({ error: { message: '无效版本号格式' } });
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.BAD_REQUEST, '无效版本号格式'));
         }
         try {
             execSync(`npm install -g llm-simple-router@${version}`, {
@@ -74,13 +75,13 @@ export const adminUpgradeRoutes = (app, options, done) => {
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
-            return reply.code(HTTP_INTERNAL_ERROR).send({ error: { message: `升级失败: ${msg}` } });
+            return reply.code(HTTP_INTERNAL_ERROR).send(apiError(API_CODE.INTERNAL_ERROR, `升级失败: ${msg}`));
         }
     });
     app.post('/admin/api/upgrade/sync-config', async (req, reply) => {
         const { source } = req.body;
         if (source !== 'github' && source !== 'gitee') {
-            return reply.code(HTTP_BAD_REQUEST).send({ error: { message: 'source must be github or gitee' } });
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.BAD_REQUEST, 'source must be github or gitee'));
         }
         const base = getConfigBaseUrl(source);
         const configDir = path.resolve(process.cwd(), 'config');
@@ -106,7 +107,7 @@ export const adminUpgradeRoutes = (app, options, done) => {
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
-            return reply.code(HTTP_INTERNAL_ERROR).send({ error: { message: `同步失败: ${msg}` } });
+            return reply.code(HTTP_INTERNAL_ERROR).send(apiError(API_CODE.INTERNAL_ERROR, `同步失败: ${msg}`));
         }
     });
     done();

package/dist/admin/usage.js

@@ -1,24 +1,16 @@
 import { Type } from "@sinclair/typebox";
 import { getWindowsInRange, getWindowUsage } from "../db/usage-windows.js";
-import { toSqliteDatetime } from "../utils/datetime.js";
+import { resolveTimeRange } from "../utils/time-range.js";
 const UsageQuerySchema = Type.Object({
     router_key_id: Type.Optional(Type.String()),
 });
-function getMonday(date) {
-    const d = new Date(date);
-    const day = d.getDay();
-    // 周日 getDay()=0，需要回退到上周一；其余日期减到周一
-    const diff = d.getDate() - day + (day === 0 ? -6 : 1); // eslint-disable-line no-magic-numbers
-    d.setDate(diff);
-    return d;
-}
-function getDailyUsage(db, start, end, routerKeyId) {
+function getDailyUsage(db, startTime, endTime, routerKeyId) {
     const routerKeyFilter = routerKeyId
         ? " AND rl.router_key_id = ?"
         : "";
     const params = routerKeyId
-        ? [toSqliteDatetime(start), toSqliteDatetime(end), routerKeyId]
-        : [toSqliteDatetime(start), toSqliteDatetime(end)];
+        ? [startTime, endTime, routerKeyId]
+        : [startTime, endTime];
     return db.prepare(`
     SELECT
       date(rm.created_at) AS date,
@@ -39,11 +31,10 @@ export const adminUsageRoutes = (app, options, done) => {
     const { db } = options;
     app.get("/admin/api/usage/windows", { schema: { querystring: UsageQuerySchema } }, async (request) => {
         const query = request.query;
-        const today = new Date();
-        today.setHours(0, 0, 0, 0);
-        const tomorrow = new Date(today);
-        tomorrow.setDate(tomorrow.getDate() + 1);
-        const windows = getWindowsInRange(db, toSqliteDatetime(today), toSqliteDatetime(tomorrow), query.router_key_id);
+        const range = resolveTimeRange("window", db, query.router_key_id);
+        const windows = getWindowsInRange(db, range.startTime, range.endTime, query.router_key_id);
+        if (windows.length === 0)
+            return [];
         return windows.map(w => ({
             window: w,
             usage: getWindowUsage(db, w.start_time, w.end_time, query.router_key_id),
@@ -51,16 +42,13 @@ export const adminUsageRoutes = (app, options, done) => {
     });
     app.get("/admin/api/usage/weekly", { schema: { querystring: UsageQuerySchema } }, async (request) => {
         const query = request.query;
-        const now = new Date();
-        const monday = getMonday(now);
-        monday.setHours(0, 0, 0, 0);
-        return getDailyUsage(db, monday, now, query.router_key_id);
+        const range = resolveTimeRange("weekly", db, query.router_key_id);
+        return getDailyUsage(db, range.startTime, range.endTime, query.router_key_id);
     });
     app.get("/admin/api/usage/monthly", { schema: { querystring: UsageQuerySchema } }, async (request) => {
         const query = request.query;
-        const now = new Date();
-        const firstOfMonth = new Date(now.getFullYear(), now.getMonth(), 1);
-        return getDailyUsage(db, firstOfMonth, now, query.router_key_id);
+        const range = resolveTimeRange("monthly", db, query.router_key_id);
+        return getDailyUsage(db, range.startTime, range.endTime, query.router_key_id);
     });
     done();
 };

package/dist/config.d.ts

@@ -4,9 +4,9 @@ export interface Config {
     LOG_LEVEL: string;
     TZ: string;
     STREAM_TIMEOUT_MS: number;
-    RETRY_MAX_ATTEMPTS: number;
     RETRY_BASE_DELAY_MS: number;
 }
 export declare function resetConfig(): void;
 export declare function getBaseConfig(): Config;
+/** @deprecated Use getBaseConfig directly */
 export declare function getConfig(): Config;

package/dist/config.js

@@ -18,11 +18,11 @@ export function getBaseConfig() {
         LOG_LEVEL: process.env.LOG_LEVEL || "info",
         TZ: process.env.TZ || "Asia/Shanghai",
         STREAM_TIMEOUT_MS: parseInt(process.env.STREAM_TIMEOUT_MS || "3000000", 10),
-        RETRY_MAX_ATTEMPTS: parseInt(process.env.RETRY_MAX_ATTEMPTS || "3", 10),
         RETRY_BASE_DELAY_MS: parseInt(process.env.RETRY_BASE_DELAY_MS || "1000", 10),
     };
     return cachedConfig;
 }
+/** @deprecated Use getBaseConfig directly */
 export function getConfig() {
     return getBaseConfig();
 }

package/dist/constants.d.ts

@@ -6,3 +6,6 @@ export declare const HTTP_CONFLICT = 409;
 export declare const HTTP_INTERNAL_ERROR = 500;
 export declare const HTTP_BAD_GATEWAY = 502;
 export declare const HTTP_SERVICE_UNAVAILABLE = 503;
+export declare const PROXY_API_TYPES: Record<string, string>;
+export declare function getProxyApiType(url: string): string | null;
+export declare const MS_PER_SECOND = 1000;

package/dist/constants.js

@@ -7,3 +7,14 @@ export const HTTP_CONFLICT = 409;
 export const HTTP_INTERNAL_ERROR = 500;
 export const HTTP_BAD_GATEWAY = 502;
 export const HTTP_SERVICE_UNAVAILABLE = 503;
+// api_type 路由映射：proxy path → api type，用于全局 hook/errorHandler 中识别代理请求
+export const PROXY_API_TYPES = {
+    "/v1/chat/completions": "openai",
+    "/v1/models": "openai",
+    "/v1/messages": "anthropic",
+};
+export function getProxyApiType(url) {
+    const path = url.split("?")[0];
+    return PROXY_API_TYPES[path] ?? null;
+}
+export const MS_PER_SECOND = 1000;

package/dist/db/index.d.ts

@@ -1,10 +1,10 @@
 import Database from "better-sqlite3";
 export declare function initDatabase(dbPath: string): Database.Database;
-export { getActiveProviders, getAllProviders, getProviderById, createProvider, updateProvider, deleteProvider, PROVIDER_CONCURRENCY_DEFAULTS, } from "./providers.js";
+export { getActiveProviders, getAllProviders, getProviderById, getActiveProviderByName, getActiveProvidersWithModels, createProvider, updateProvider, deleteProvider, PROVIDER_CONCURRENCY_DEFAULTS, } from "./providers.js";
 export type { Provider } from "./providers.js";
 export { getModelMapping, getAllModelMappings, createModelMapping, updateModelMapping, deleteModelMapping, getMappingGroup, getMappingGroupById, getAllMappingGroups, createMappingGroup, updateMappingGroup, deleteMappingGroup, getActiveProviderModels, resolveByProviderModel, } from "./mappings.js";
 export type { ModelMapping, MappingGroup, ProviderModelEntry } from "./mappings.js";
-export { getActiveRetryRules, getAllRetryRules, createRetryRule, updateRetryRule, deleteRetryRule, } from "./retry-rules.js";
+export { getActiveRetryRules, getAllRetryRules, getRetryRuleById, createRetryRule, updateRetryRule, deleteRetryRule, } from "./retry-rules.js";
 export type { RetryRule } from "./retry-rules.js";
 export { insertRequestLog, getRequestLogs, getRequestLogById, deleteLogsBefore, getRequestLogChildren, getRequestLogsGrouped, updateLogMetrics, updateLogStreamContent, backfillMetricsFromRequestMetrics, estimateLogTableSize, deleteOldestLogs, getLogCount, } from "./logs.js";
 export type { RequestLog, RequestLogGroupedRow, RequestLogListRow } from "./logs.js";
@@ -13,7 +13,7 @@ export type { RouterKey } from "./router-keys.js";
 export { getMetricsSummary, getMetricsTimeseries, insertMetrics } from "./metrics.js";
 export type { MetricsSummaryRow, MetricsTimeseriesRow, MetricsPeriod, MetricsMetric, MetricsRow, MetricsInsert } from "./metrics.js";
 export { getStats } from "./stats.js";
-export type { Stats, StatsPeriod } from "./stats.js";
+export type { Stats } from "./stats.js";
 export { getSetting, setSetting, isInitialized } from "./settings.js";
 export { getDbMaxSizeMb, setDbMaxSizeMb, getLogTableMaxSizeMb, setLogTableMaxSizeMb, } from "./settings.js";
 export { getSessionStates, getSessionState, getSessionHistory, upsertSessionState, insertSessionHistory, deleteSessionState, } from "./session-states.js";

package/dist/db/index.js

@@ -53,9 +53,9 @@ export function initDatabase(dbPath) {
     return db;
 }
 // --- Re-export from per-table modules ---
-export { getActiveProviders, getAllProviders, getProviderById, createProvider, updateProvider, deleteProvider, PROVIDER_CONCURRENCY_DEFAULTS, } from "./providers.js";
+export { getActiveProviders, getAllProviders, getProviderById, getActiveProviderByName, getActiveProvidersWithModels, createProvider, updateProvider, deleteProvider, PROVIDER_CONCURRENCY_DEFAULTS, } from "./providers.js";
 export { getModelMapping, getAllModelMappings, createModelMapping, updateModelMapping, deleteModelMapping, getMappingGroup, getMappingGroupById, getAllMappingGroups, createMappingGroup, updateMappingGroup, deleteMappingGroup, getActiveProviderModels, resolveByProviderModel, } from "./mappings.js";
-export { getActiveRetryRules, getAllRetryRules, createRetryRule, updateRetryRule, deleteRetryRule, } from "./retry-rules.js";
+export { getActiveRetryRules, getAllRetryRules, getRetryRuleById, createRetryRule, updateRetryRule, deleteRetryRule, } from "./retry-rules.js";
 export { insertRequestLog, getRequestLogs, getRequestLogById, deleteLogsBefore, getRequestLogChildren, getRequestLogsGrouped, updateLogMetrics, updateLogStreamContent, backfillMetricsFromRequestMetrics, estimateLogTableSize, deleteOldestLogs, getLogCount, } from "./logs.js";
 export { getRouterKeyByHash, getAllRouterKeys, getRouterKeyById, createRouterKey, updateRouterKey, deleteRouterKey, getAvailableModels, } from "./router-keys.js";
 export { getMetricsSummary, getMetricsTimeseries, insertMetrics } from "./metrics.js";

package/dist/db/mappings.js

@@ -1,4 +1,5 @@
 import { randomUUID } from "crypto";
+import { isTarget } from "../proxy/strategy/targets-rule.js";
 import { buildUpdateQuery, deleteById } from "./helpers.js";
 const MAPPING_FIELDS = new Set(["client_model", "backend_model", "provider_id", "is_active"]);
 const GROUP_FIELDS = new Set(["client_model", "strategy", "rule"]);
@@ -70,24 +71,20 @@ export function getActiveProviderModels(db) {
     }
     return results;
 }
-function isTargetLike(obj) {
-    return typeof obj === "object" && obj !== null &&
-        typeof obj.backend_model === "string" &&
-        typeof obj.provider_id === "string";
-}
+// --- 从 mapping_groups rule JSON 中提取 target 条目 ---
 function extractTargets(rule) {
     const results = [];
-    if (isTargetLike(rule.default))
+    if (isTarget(rule.default))
         results.push(rule.default);
     if (Array.isArray(rule.targets)) {
         for (const t of rule.targets) {
-            if (isTargetLike(t))
+            if (isTarget(t))
                 results.push(t);
         }
     }
     if (Array.isArray(rule.windows)) {
         for (const w of rule.windows) {
-            if (w && typeof w === "object" && isTargetLike(w.target)) {
+            if (w && typeof w === "object" && isTarget(w.target)) {
                 results.push(w.target);
             }
         }

package/dist/db/metrics.js

@@ -1,4 +1,5 @@
 import { randomUUID } from "crypto";
+import { MS_PER_SECOND } from "../constants.js";
 export function insertMetrics(db, m) {
     const id = randomUUID();
     db.prepare(`INSERT INTO request_metrics (id, request_log_id, provider_id, backend_model, api_type, input_tokens, output_tokens, cache_creation_tokens, cache_read_tokens, ttft_ms, total_duration_ms, tokens_per_second, stop_reason, is_complete)
@@ -21,8 +22,6 @@ const BUCKET_SECONDS = {
     "7d": 3600,
     "30d": 14400,
 };
-// unix epoch 秒转毫秒的乘数
-const MS_PER_SEC = 1000;
 // 时间跨度（秒）→ 桶大小（秒）的阶梯映射，与 BUCKET_SECONDS 保持对齐
 const BUCKET_THRESHOLDS = [
     { maxSec: 3600, bucketSec: 60 }, // ≤1h: 1min
@@ -33,7 +32,7 @@ const BUCKET_THRESHOLDS = [
 const FALLBACK_BUCKET_SEC = 14400; // >7d: 4h
 function calculateBucketSeconds(startTime, endTime) {
     const ms = new Date(endTime).getTime() - new Date(startTime).getTime();
-    const sec = ms / MS_PER_SEC;
+    const sec = ms / MS_PER_SECOND;
     const match = BUCKET_THRESHOLDS.find((t) => sec <= t.maxSec);
     return match ? match.bucketSec : FALLBACK_BUCKET_SEC;
 }
@@ -127,7 +126,7 @@ export function getMetricsTimeseries(db, period, metric, providerId, backendMode
     ORDER BY bucket_key ASC
   `).all(bucketSec, bucketSec, ...params);
     return rows.map((r) => ({
-        time_bucket: new Date(r.bucket_key * MS_PER_SEC).toISOString(),
+        time_bucket: new Date(r.bucket_key * MS_PER_SECOND).toISOString(),
         avg_value: r.avg_value,
         count: r.count,
     }));

package/dist/db/providers.d.ts

@@ -36,3 +36,11 @@ export declare function createProvider(db: Database.Database, provider: {
 }): string;
 export declare function updateProvider(db: Database.Database, id: string, fields: Partial<Pick<Provider, "name" | "api_type" | "base_url" | "api_key" | "api_key_preview" | "models" | "is_active" | "max_concurrency" | "queue_timeout_ms" | "max_queue_size">>): void;
 export declare function deleteProvider(db: Database.Database, id: string): void;
+export declare function getActiveProviderByName(db: Database.Database, name: string): {
+    id: string;
+    models: string;
+} | undefined;
+export declare function getActiveProvidersWithModels(db: Database.Database): {
+    id: string;
+    models: string;
+}[];

package/dist/db/providers.js

@@ -32,3 +32,9 @@ export function updateProvider(db, id, fields) {
 export function deleteProvider(db, id) {
     deleteById(db, "providers", id);
 }
+export function getActiveProviderByName(db, name) {
+    return db.prepare("SELECT id, models FROM providers WHERE name = ? AND is_active = 1").get(name);
+}
+export function getActiveProvidersWithModels(db) {
+    return db.prepare("SELECT id, models FROM providers WHERE is_active = 1").all();
+}

package/dist/db/retry-rules.d.ts

@@ -25,3 +25,4 @@ export declare function createRetryRule(db: Database.Database, rule: {
 }): string;
 export declare function updateRetryRule(db: Database.Database, id: string, fields: Partial<Pick<RetryRule, "name" | "status_code" | "body_pattern" | "is_active" | "retry_strategy" | "retry_delay_ms" | "max_retries" | "max_delay_ms">>): void;
 export declare function deleteRetryRule(db: Database.Database, id: string): void;
+export declare function getRetryRuleById(db: Database.Database, id: string): RetryRule | undefined;

package/dist/db/retry-rules.js

@@ -27,3 +27,6 @@ export function updateRetryRule(db, id, fields) {
 export function deleteRetryRule(db, id) {
     deleteById(db, "retry_rules", id);
 }
+export function getRetryRuleById(db, id) {
+    return db.prepare("SELECT * FROM retry_rules WHERE id = ?").get(id);
+}

package/dist/db/stats.d.ts

@@ -1,9 +1,8 @@
 import Database from "better-sqlite3";
-export type StatsPeriod = "1h" | "6h" | "24h" | "7d" | "30d";
 export interface Stats {
     totalRequests: number;
     successRate: number;
     avgTps: number;
     totalTokens: number;
 }
-export declare function getStats(db: Database.Database, period: StatsPeriod, routerKeyId?: string): Stats;
+export declare function getStats(db: Database.Database, startTime: string, endTime: string, routerKeyId?: string): Stats;

package/dist/db/stats.js

@@ -1,14 +1,10 @@
-const PERIOD_OFFSET = {
-    "1h": "-1 hours",
-    "6h": "-6 hours",
-    "24h": "-1 day",
-    "7d": "-7 days",
-    "30d": "-30 days",
-};
-export function getStats(db, period, routerKeyId) {
-    const offset = PERIOD_OFFSET[period];
-    const conditions = ["rm.is_complete = 1", "rm.created_at >= datetime('now', ?)"];
-    const params = [offset];
+export function getStats(db, startTime, endTime, routerKeyId) {
+    const conditions = [
+        "rm.is_complete = 1",
+        "rm.created_at >= datetime(?)",
+        "rm.created_at < datetime(?)",
+    ];
+    const params = [startTime, endTime];
     if (routerKeyId) {
         conditions.push("rl.router_key_id = ?");
         params.push(routerKeyId);

package/dist/index.js

@@ -5,19 +5,10 @@ import { existsSync } from "node:fs";
 import { randomUUID } from "crypto";
 import Fastify from "fastify";
 import { insertRequestLog } from "./db/logs.js";
-import { HTTP_NOT_FOUND, HTTP_INTERNAL_ERROR, HTTP_BAD_REQUEST } from "./constants.js";
+import { HTTP_NOT_FOUND, HTTP_INTERNAL_ERROR, getProxyApiType } from "./constants.js";
+import { API_CODE, apiError, isAdminApiResponse, statusToApiCode } from "./admin/api-response.js";
 const PROVIDER_DEFAULT_QUEUE_TIMEOUT_MS = 5000;
 const PROVIDER_DEFAULT_MAX_QUEUE_SIZE = 100;
-// 代理路由路径 → api_type，用于在全局 hook/errorHandler 中识别代理请求
-const PROXY_API_TYPES = {
-    "/v1/chat/completions": "openai",
-    "/v1/messages": "anthropic",
-    "/v1/models": "openai",
-};
-function getProxyApiType(url) {
-    const path = url.split("?")[0];
-    return PROXY_API_TYPES[path] ?? null;
-}
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 import { getConfig } from "./config.js";
@@ -80,32 +71,59 @@ export async function buildApp(options) {
             .join("; ");
         return new Error(message);
     });
-    // 统一 schema validation 错误响应格式，代理路由的错误也记录到 request_logs
+    // 统一错误处理：代理路由保持 {error:{message}}，Admin API 使用信封格式
     app.setErrorHandler((error, request, reply) => {
         const fastifyError = error;
         const status = fastifyError.statusCode ?? HTTP_INTERNAL_ERROR;
-        const proxyApiType = getProxyApiType(request.url);
-        if (proxyApiType) {
-            request.log.error({ statusCode: status, err: error }, `Proxy request error: ${fastifyError.message}`);
-            const body = request.body;
-            insertRequestLog(db, {
-                id: randomUUID(),
-                api_type: proxyApiType,
-                model: body?.model || null,
-                provider_id: null,
-                status_code: status,
-                latency_ms: 0,
-                is_stream: 0,
-                error_message: fastifyError.message,
-                created_at: new Date().toISOString(),
-                client_request: JSON.stringify({ headers: request.headers }),
-                router_key_id: request.routerKey?.id ?? null,
-            });
+        // 代理路由保持原有格式，并记录到 request_logs
+        if (!isAdminApiResponse(request.url)) {
+            const proxyApiType = getProxyApiType(request.url);
+            if (proxyApiType) {
+                request.log.error({ statusCode: status, err: error }, `Proxy request error: ${fastifyError.message}`);
+                const body = request.body;
+                insertRequestLog(db, {
+                    id: randomUUID(),
+                    api_type: proxyApiType,
+                    model: body?.model || null,
+                    provider_id: null,
+                    status_code: status,
+                    latency_ms: 0,
+                    is_stream: 0,
+                    error_message: fastifyError.message,
+                    created_at: new Date().toISOString(),
+                    client_request: JSON.stringify({ headers: request.headers }),
+                    router_key_id: request.routerKey?.id ?? null,
+                });
+            }
+            return reply.code(status).send({ error: { message: fastifyError.message } });
         }
-        if (status === HTTP_BAD_REQUEST && fastifyError.validation) {
-            return reply.code(HTTP_BAD_REQUEST).send({ error: { message: fastifyError.message } });
+        // Admin API — 统一信封错误格式
+        const code = statusToApiCode(status);
+        return reply.code(status).send(apiError(code, fastifyError.message));
+    });
+    // onSend hook：自动包装 Admin API 成功响应为信封格式
+    app.addHook('onSend', async (request, reply, payload) => {
+        if (!isAdminApiResponse(request.url, reply.getHeader('content-type'))) {
+            return payload;
         }
-        return reply.code(status).send({ error: { message: fastifyError.message } });
+        // 已是错误信封（errorHandler 已包装）或已是信封格式 — 跳过
+        if (typeof payload === 'string') {
+            try {
+                const parsed = JSON.parse(payload);
+                if ('code' in parsed)
+                    return payload; // errorHandler 或路由已手动包装
+            }
+            catch {
+                return payload;
+            }
+        }
+        // 包装成功响应
+        const wrapped = {
+            code: API_CODE.SUCCESS,
+            message: 'ok',
+            data: typeof payload === 'string' ? JSON.parse(payload) : payload,
+        };
+        return JSON.stringify(wrapped);
     });
     loadRecommendedConfig();
     startUpgradeChecker(options?.upgradeCheckerOptions);
@@ -147,20 +165,20 @@ export async function buildApp(options) {
     app.register(openaiProxy, {
         db,
         streamTimeoutMs: config.STREAM_TIMEOUT_MS,
-        retryMaxAttempts: config.RETRY_MAX_ATTEMPTS,
         retryBaseDelayMs: config.RETRY_BASE_DELAY_MS,
         matcher,
         semaphoreManager,
         tracker,
+        usageWindowTracker,
     });
     app.register(anthropicProxy, {
         db,
         streamTimeoutMs: config.STREAM_TIMEOUT_MS,
-        retryMaxAttempts: config.RETRY_MAX_ATTEMPTS,
         retryBaseDelayMs: config.RETRY_BASE_DELAY_MS,
         matcher,
         semaphoreManager,
         tracker,
+        usageWindowTracker,
     });
     app.register(adminRoutes, { db, matcher, tracker, semaphoreManager });
     // 前端静态文件服务（生产环境）

package/dist/metrics/metrics-extractor.js

@@ -1,4 +1,4 @@
-const MS_PER_SECOND = 1000;
+import { MS_PER_SECOND } from "../constants.js";
 export class MetricsExtractor {
     apiType;
     requestStartTime;

package/dist/metrics/sse-parser.js

@@ -5,6 +5,8 @@ export class SSEParser {
         if (this.isDone)
             return [];
         this.buffer += chunk;
+        // SSE 规范允许 \r\n 行尾，统一为 \n
+        this.buffer = this.buffer.replace(/\r\n/g, "\n");
         return this.drainEvents();
     }
     flush() {

package/dist/middleware/admin-auth.js

@@ -3,6 +3,7 @@ import cookie from "@fastify/cookie";
 import jwt from "jsonwebtoken";
 import { isInitialized, getSetting } from "../db/settings.js";
 import { verifyPassword } from "../utils/password.js";
+import { API_CODE, apiError } from "../admin/api-response.js";
 const HTTP_UNAUTHORIZED = 401;
 const adminAuthRaw = (app, options, done) => {
     app.register(cookie);
@@ -19,11 +20,11 @@ const adminAuthRaw = (app, options, done) => {
             return;
         // 未初始化时返回 needsSetup
         if (!isInitialized(options.db)) {
-            return reply.code(HTTP_UNAUTHORIZED).send({ error: { message: "Not initialized", needsSetup: true } });
+            return reply.code(HTTP_UNAUTHORIZED).send(apiError(API_CODE.NOT_INITIALIZED, "Not initialized"));
         }
         const token = request.cookies["admin_token"];
         if (!token) {
-            reply.code(HTTP_UNAUTHORIZED).send({ error: { message: "Not authenticated" } });
+            reply.code(HTTP_UNAUTHORIZED).send(apiError(API_CODE.TOKEN_INVALID, "Not authenticated"));
             return reply;
         }
         const secret = getSetting(options.db, "jwt_secret");
@@ -32,7 +33,7 @@ const adminAuthRaw = (app, options, done) => {
         }
         catch (err) {
             request.log.debug({ err }, "invalid JWT token");
-            reply.code(HTTP_UNAUTHORIZED).send({ error: { message: "Invalid or expired token" } });
+            reply.code(HTTP_UNAUTHORIZED).send(apiError(API_CODE.TOKEN_INVALID, "Invalid or expired token"));
             return reply;
         }
     });
@@ -44,12 +45,12 @@ export const adminLoginRoutes = (app, options, done) => {
     app.post("/admin/api/login", async (request, reply) => {
         const { password } = request.body;
         if (!password) {
-            return reply.code(HTTP_UNAUTHORIZED).send({ error: { message: "Invalid password" } });
+            return reply.code(HTTP_UNAUTHORIZED).send(apiError(API_CODE.WRONG_PASSWORD, "Invalid password"));
         }
         // DB 模式：scrypt hash 验证
         const hash = getSetting(options.db, "admin_password_hash");
         if (!hash || !verifyPassword(password, hash)) {
-            return reply.code(HTTP_UNAUTHORIZED).send({ error: { message: "Invalid password" } });
+            return reply.code(HTTP_UNAUTHORIZED).send(apiError(API_CODE.WRONG_PASSWORD, "Invalid password"));
         }
         const secret = getSetting(options.db, "jwt_secret");
         const token = jwt.sign({ role: "admin" }, secret, { expiresIn: TOKEN_EXPIRY_SECONDS });

package/dist/middleware/auth.js

@@ -2,6 +2,7 @@ import { createHash, randomUUID } from "crypto";
 import fp from "fastify-plugin";
 import { isInitialized } from "../db/settings.js";
 import { insertRequestLog } from "../db/logs.js";
+import { getProxyApiType } from "../constants.js";
 const SKIP_PATHS = ["/health", "/admin"];
 const HTTP_UNAUTHORIZED = 401;
 const HTTP_SERVICE_UNAVAILABLE = 503;
@@ -19,16 +20,6 @@ function unauthorizedReply(reply) {
         },
     });
 }
-// 代理路由路径 → api_type 映射，用于记录被认证拒绝的请求
-const PROXY_API_TYPES = {
-    "/v1/chat/completions": "openai",
-    "/v1/messages": "anthropic",
-    "/v1/models": "openai",
-};
-function getProxyApiType(url) {
-    const path = url.split("?")[0];
-    return PROXY_API_TYPES[path] ?? null;
-}
 function logRejectedAuth(db, apiType, statusCode, errorMessage, request) {
     insertRequestLog(db, {
         id: randomUUID(),