llm-simple-router 0.3.7 → 0.4.1

package/dist/db/index.js

@@ -38,10 +38,11 @@ export function initDatabase(dbPath) {
 // --- Re-export from per-table modules ---
 export { getActiveProviders, getAllProviders, getProviderById, 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, seedDefaultRules, } from "./retry-rules.js";
-export { insertRequestLog, getRequestLogs, getRequestLogById, deleteLogsBefore, insertMetrics, } from "./logs.js";
+export { getActiveRetryRules, getAllRetryRules, createRetryRule, updateRetryRule, deleteRetryRule, } from "./retry-rules.js";
+export { insertRequestLog, getRequestLogs, getRequestLogById, deleteLogsBefore, getRequestLogChildren, getRequestLogsGrouped, } from "./logs.js";
 export { getRouterKeyByHash, getAllRouterKeys, getRouterKeyById, createRouterKey, updateRouterKey, deleteRouterKey, getAvailableModels, } from "./router-keys.js";
-export { getMetricsSummary, getMetricsTimeseries } from "./metrics.js";
+export { getMetricsSummary, getMetricsTimeseries, insertMetrics } from "./metrics.js";
 export { getStats } from "./stats.js";
 export { getSetting, setSetting, isInitialized } from "./settings.js";
 export { getSessionStates, getSessionState, getSessionHistory, upsertSessionState, insertSessionHistory, deleteSessionState, } from "./session-states.js";
+export { insertWindow, getLatestWindow, getWindowsInRange, getWindowUsage, } from "./usage-windows.js";

package/dist/db/logs.d.ts

@@ -16,6 +16,7 @@ export interface RequestLog {
     upstream_response: string | null;
     client_response: string | null;
     is_retry: number;
+    is_failover: number;
     original_request_id: string | null;
     original_model: string | null;
 }
@@ -24,38 +25,6 @@ export interface RequestLogListRow extends RequestLog {
     backend_model: string | null;
     provider_name: string | null;
 }
-export interface MetricsRow {
-    id: string;
-    request_log_id: string;
-    provider_id: string;
-    backend_model: string;
-    api_type: string;
-    input_tokens: number | null;
-    output_tokens: number | null;
-    cache_creation_tokens: number | null;
-    cache_read_tokens: number | null;
-    ttft_ms: number | null;
-    total_duration_ms: number | null;
-    tokens_per_second: number | null;
-    stop_reason: string | null;
-    is_complete: number;
-    created_at: string;
-}
-export type MetricsInsert = {
-    request_log_id: string;
-    provider_id: string;
-    backend_model: string;
-    api_type: string;
-    input_tokens?: number | null;
-    output_tokens?: number | null;
-    cache_creation_tokens?: number | null;
-    cache_read_tokens?: number | null;
-    ttft_ms?: number | null;
-    total_duration_ms?: number | null;
-    tokens_per_second?: number | null;
-    stop_reason?: string | null;
-    is_complete?: number;
-};
 export interface RequestLogInsert {
     id: string;
     api_type: string;
@@ -73,6 +42,7 @@ export interface RequestLogInsert {
     upstream_response?: string | null;
     client_response?: string | null;
     is_retry?: number;
+    is_failover?: number;
     original_request_id?: string | null;
     router_key_id?: string | null;
     original_model?: string | null;
@@ -84,10 +54,31 @@ export declare function getRequestLogs(db: Database.Database, options: {
     api_type?: string;
     model?: string;
     router_key_id?: string;
+    provider_id?: string;
+    start_time?: string;
+    end_time?: string;
 }): {
     data: RequestLogListRow[];
     total: number;
 };
 export declare function getRequestLogById(db: Database.Database, id: string): RequestLog | undefined;
 export declare function deleteLogsBefore(db: Database.Database, beforeDate: string): number;
-export declare function insertMetrics(db: Database.Database, m: MetricsInsert): string;
+/** 查询某条日志的子请求（retry/failover 关联），上限 100 条 */
+export declare function getRequestLogChildren(db: Database.Database, parentId: string): RequestLogListRow[];
+export interface RequestLogGroupedRow extends RequestLogListRow {
+    child_count: number;
+}
+/** 只返回根请求（original_request_id IS NULL），附带子请求数量 */
+export declare function getRequestLogsGrouped(db: Database.Database, options: {
+    page: number;
+    limit: number;
+    api_type?: string;
+    model?: string;
+    router_key_id?: string;
+    provider_id?: string;
+    start_time?: string;
+    end_time?: string;
+}): {
+    data: RequestLogGroupedRow[];
+    total: number;
+};

package/dist/db/logs.js

@@ -1,10 +1,17 @@
-import { randomUUID } from "crypto";
+// --- request_logs ---
+/** 三处日志列表查询共享的 SELECT 列 + JOIN 子句 */
+const LOG_LIST_SELECT = `rl.id, rl.api_type, rl.model, rl.provider_id, rl.status_code, rl.latency_ms,
+            rl.is_stream, rl.error_message, rl.created_at, rl.is_retry, rl.is_failover, rl.original_request_id, rl.original_model,
+            CASE WHEN rl.provider_id = 'router' THEN rl.upstream_request ELSE NULL END AS upstream_request,
+            rm.backend_model, COALESCE(p.name, rl.provider_id) AS provider_name`;
+const LOG_LIST_JOIN = `LEFT JOIN request_metrics rm ON rm.request_log_id = rl.id
+     LEFT JOIN providers p ON p.id = rl.provider_id`;
 export function insertRequestLog(db, log) {
-    db.prepare(`INSERT INTO request_logs (id, api_type, model, provider_id, status_code, latency_ms, is_stream, error_message, created_at, request_body, response_body, client_request, upstream_request, upstream_response, client_response, is_retry, original_request_id, router_key_id, original_model)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(log.id, log.api_type, log.model, log.provider_id, log.status_code, log.latency_ms, log.is_stream, log.error_message, log.created_at, log.request_body ?? null, log.response_body ?? null, log.client_request ?? null, log.upstream_request ?? null, log.upstream_response ?? null, log.client_response ?? null, log.is_retry ?? 0, log.original_request_id ?? null, log.router_key_id ?? null, log.original_model ?? null);
+    db.prepare(`INSERT INTO request_logs (id, api_type, model, provider_id, status_code, latency_ms, is_stream, error_message, created_at, request_body, response_body, client_request, upstream_request, upstream_response, client_response, is_retry, is_failover, original_request_id, router_key_id, original_model)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(log.id, log.api_type, log.model, log.provider_id, log.status_code, log.latency_ms, log.is_stream, log.error_message, log.created_at, log.request_body ?? null, log.response_body ?? null, log.client_request ?? null, log.upstream_request ?? null, log.upstream_response ?? null, log.client_response ?? null, log.is_retry ?? 0, log.is_failover ?? 0, log.original_request_id ?? null, log.router_key_id ?? null, log.original_model ?? null);
 }
-export function getRequestLogs(db, options) {
-    let where = "1=1";
+function buildLogWhereClause(options, baseCondition) {
+    let where = baseCondition;
     const params = [];
     if (options.api_type) {
         where += " AND rl.api_type = ?";
@@ -18,16 +25,28 @@ export function getRequestLogs(db, options) {
         where += " AND rl.router_key_id = ?";
         params.push(options.router_key_id);
     }
+    if (options.provider_id) {
+        where += " AND rl.provider_id = ?";
+        params.push(options.provider_id);
+    }
+    if (options.start_time) {
+        where += " AND rl.created_at >= ?";
+        params.push(options.start_time);
+    }
+    if (options.end_time) {
+        where += " AND rl.created_at <= ?";
+        params.push(options.end_time);
+    }
+    return { where, params };
+}
+export function getRequestLogs(db, options) {
+    const { where, params } = buildLogWhereClause(options, "1=1");
     const total = db.prepare(`SELECT COUNT(*) as count FROM request_logs rl WHERE ${where}`).get(...params).count;
     const offset = (options.page - 1) * options.limit;
     const data = db
-        .prepare(`SELECT rl.id, rl.api_type, rl.model, rl.provider_id, rl.status_code, rl.latency_ms,
-              rl.is_stream, rl.error_message, rl.created_at, rl.is_retry, rl.original_request_id, rl.original_model,
-              CASE WHEN rl.provider_id = 'router' THEN rl.upstream_request ELSE NULL END AS upstream_request,
-              rm.backend_model, COALESCE(p.name, rl.provider_id) AS provider_name
+        .prepare(`SELECT ${LOG_LIST_SELECT}
        FROM request_logs rl
-       LEFT JOIN request_metrics rm ON rm.request_log_id = rl.id
-       LEFT JOIN providers p ON p.id = rl.provider_id
+       ${LOG_LIST_JOIN}
        WHERE ${where} ORDER BY rl.created_at DESC LIMIT ? OFFSET ?`)
         .all(...params, options.limit, offset);
     return { data, total };
@@ -38,10 +57,26 @@ export function getRequestLogById(db, id) {
 export function deleteLogsBefore(db, beforeDate) {
     return db.prepare("DELETE FROM request_logs WHERE created_at < ?").run(beforeDate).changes;
 }
-// --- request_metrics ---
-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)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, m.request_log_id, m.provider_id, m.backend_model, m.api_type, m.input_tokens ?? null, m.output_tokens ?? null, m.cache_creation_tokens ?? null, m.cache_read_tokens ?? null, m.ttft_ms ?? null, m.total_duration_ms ?? null, m.tokens_per_second ?? null, m.stop_reason ?? null, m.is_complete ?? 1);
-    return id;
+/** 查询某条日志的子请求（retry/failover 关联），上限 100 条 */
+export function getRequestLogChildren(db, parentId) {
+    return db.prepare(`SELECT ${LOG_LIST_SELECT}
+     FROM request_logs rl
+     ${LOG_LIST_JOIN}
+     WHERE rl.original_request_id = ?
+     ORDER BY rl.created_at ASC
+     LIMIT 100`).all(parentId);
+}
+/** 只返回根请求（original_request_id IS NULL），附带子请求数量 */
+export function getRequestLogsGrouped(db, options) {
+    const { where, params } = buildLogWhereClause(options, "rl.original_request_id IS NULL");
+    const total = db.prepare(`SELECT COUNT(*) as count FROM request_logs rl WHERE ${where}`).get(...params).count;
+    const offset = (options.page - 1) * options.limit;
+    const data = db
+        .prepare(`SELECT ${LOG_LIST_SELECT},
+              (SELECT COUNT(*) FROM request_logs c WHERE c.original_request_id = rl.id) AS child_count
+       FROM request_logs rl
+       ${LOG_LIST_JOIN}
+       WHERE ${where} ORDER BY rl.created_at DESC LIMIT ? OFFSET ?`)
+        .all(...params, options.limit, offset);
+    return { data, total };
 }

package/dist/db/metrics.d.ts

@@ -1,6 +1,39 @@
 import Database from "better-sqlite3";
-export type MetricsPeriod = "1h" | "6h" | "24h" | "7d" | "30d";
+export type MetricsPeriod = "1h" | "5h" | "6h" | "24h" | "7d" | "30d";
 export type MetricsMetric = "ttft" | "tps" | "tokens" | "cache_rate" | "request_count" | "input_tokens" | "output_tokens" | "cache_hit_tokens";
+export interface MetricsRow {
+    id: string;
+    request_log_id: string;
+    provider_id: string;
+    backend_model: string;
+    api_type: string;
+    input_tokens: number | null;
+    output_tokens: number | null;
+    cache_creation_tokens: number | null;
+    cache_read_tokens: number | null;
+    ttft_ms: number | null;
+    total_duration_ms: number | null;
+    tokens_per_second: number | null;
+    stop_reason: string | null;
+    is_complete: number;
+    created_at: string;
+}
+export type MetricsInsert = {
+    request_log_id: string;
+    provider_id: string;
+    backend_model: string;
+    api_type: string;
+    input_tokens?: number | null;
+    output_tokens?: number | null;
+    cache_creation_tokens?: number | null;
+    cache_read_tokens?: number | null;
+    ttft_ms?: number | null;
+    total_duration_ms?: number | null;
+    tokens_per_second?: number | null;
+    stop_reason?: string | null;
+    is_complete?: number;
+};
+export declare function insertMetrics(db: Database.Database, m: MetricsInsert): string;
 export interface MetricsSummaryRow {
     provider_id: string;
     provider_name: string;
@@ -15,10 +48,10 @@ export interface MetricsSummaryRow {
     total_cache_hit_tokens: number;
     cache_hit_rate: number | null;
 }
-export declare function getMetricsSummary(db: Database.Database, period: MetricsPeriod, providerId?: string, backendModel?: string, routerKeyId?: string): MetricsSummaryRow[];
+export declare function getMetricsSummary(db: Database.Database, period: MetricsPeriod, providerId?: string, backendModel?: string, routerKeyId?: string, startTime?: string, endTime?: string): MetricsSummaryRow[];
 export interface MetricsTimeseriesRow {
     time_bucket: string;
     avg_value: number | null;
     count: number;
 }
-export declare function getMetricsTimeseries(db: Database.Database, period: MetricsPeriod, metric: MetricsMetric, providerId?: string, backendModel?: string, routerKeyId?: string): MetricsTimeseriesRow[];
+export declare function getMetricsTimeseries(db: Database.Database, period: MetricsPeriod, metric: MetricsMetric, providerId?: string, backendModel?: string, routerKeyId?: string, startTime?: string, endTime?: string): MetricsTimeseriesRow[];

package/dist/db/metrics.js

@@ -1,5 +1,13 @@
+import { randomUUID } from "crypto";
+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)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, m.request_log_id, m.provider_id, m.backend_model, m.api_type, m.input_tokens ?? null, m.output_tokens ?? null, m.cache_creation_tokens ?? null, m.cache_read_tokens ?? null, m.ttft_ms ?? null, m.total_duration_ms ?? null, m.tokens_per_second ?? null, m.stop_reason ?? null, m.is_complete ?? 1);
+    return id;
+}
 const PERIOD_OFFSET = {
     "1h": "-1 hours",
+    "5h": "-5 hours",
     "6h": "-6 hours",
     "24h": "-1 day",
     "7d": "-7 days",
@@ -7,6 +15,7 @@ const PERIOD_OFFSET = {
 };
 const BUCKET_SECONDS = {
     "1h": 60,
+    "5h": 300,
     "6h": 300,
     "24h": 900,
     "7d": 3600,
@@ -14,10 +23,39 @@ const BUCKET_SECONDS = {
 };
 // unix epoch 秒转毫秒的乘数
 const MS_PER_SEC = 1000;
-export function getMetricsSummary(db, period, providerId, backendModel, routerKeyId) {
-    const offset = PERIOD_OFFSET[period];
-    const conditions = ["rm.is_complete = 1", "rm.created_at >= datetime('now', ?)"];
-    const params = [offset];
+// 时间跨度（秒）→ 桶大小（秒）的阶梯映射，与 BUCKET_SECONDS 保持对齐
+const BUCKET_THRESHOLDS = [
+    { maxSec: 3600, bucketSec: 60 }, // ≤1h: 1min
+    { maxSec: 21600, bucketSec: 300 }, // ≤6h: 5min
+    { maxSec: 86400, bucketSec: 900 }, // ≤1d: 15min
+    { maxSec: 604800, bucketSec: 3600 }, // ≤7d: 1h
+];
+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 match = BUCKET_THRESHOLDS.find((t) => sec <= t.maxSec);
+    return match ? match.bucketSec : FALLBACK_BUCKET_SEC;
+}
+function buildTimeCondition(period, startTime, endTime) {
+    if (startTime && endTime) {
+        // request_metrics.created_at 用 datetime('now') 格式 (YYYY-MM-DD HH:MM:SS)，
+        // 前端传入 ISO 8601，需要转换格式以匹配字符串比较
+        return {
+            timeWhere: "rm.created_at >= datetime(?) AND rm.created_at < datetime(?)",
+            timeParams: [startTime, endTime],
+        };
+    }
+    return {
+        timeWhere: "rm.created_at >= datetime('now', ?)",
+        timeParams: [PERIOD_OFFSET[period]],
+    };
+}
+export function getMetricsSummary(db, period, providerId, backendModel, routerKeyId, startTime, endTime) {
+    const { timeWhere, timeParams } = buildTimeCondition(period, startTime, endTime);
+    const conditions = ["rm.is_complete = 1", timeWhere];
+    const params = [...timeParams];
+    const joins = ["LEFT JOIN providers p ON p.id = rm.provider_id"];
     if (providerId) {
         conditions.push("rm.provider_id = ?");
         params.push(providerId);
@@ -26,48 +64,23 @@ export function getMetricsSummary(db, period, providerId, backendModel, routerKe
         conditions.push("rm.backend_model = ?");
         params.push(backendModel);
     }
-    const joins = "LEFT JOIN providers p ON p.id = rm.provider_id";
     if (routerKeyId) {
+        joins.push("LEFT JOIN request_logs rl ON rl.id = rm.request_log_id");
         conditions.push("rl.router_key_id = ?");
         params.push(routerKeyId);
-        return db.prepare(`
-      SELECT
-        rm.provider_id, COALESCE(p.name, rm.provider_id) AS provider_name, rm.backend_model,
-        COUNT(*) AS request_count, AVG(rm.ttft_ms) AS avg_ttft_ms, NULL AS p50_ttft_ms, NULL AS p95_ttft_ms,
-        AVG(rm.tokens_per_second) AS avg_tps,
-        COALESCE(SUM(rm.input_tokens), 0) AS total_input_tokens, COALESCE(SUM(rm.output_tokens), 0) AS total_output_tokens,
-        COALESCE(SUM(rm.cache_read_tokens), 0) AS total_cache_hit_tokens,
-        CASE WHEN SUM(rm.input_tokens) > 0 THEN SUM(rm.cache_read_tokens) * 1.0 / SUM(rm.input_tokens) ELSE NULL END AS cache_hit_rate
-      FROM request_metrics rm
-      LEFT JOIN providers p ON p.id = rm.provider_id
-      LEFT JOIN request_logs rl ON rl.id = rm.request_log_id
-      WHERE ${conditions.join(" AND ")}
-      GROUP BY rm.provider_id, rm.backend_model ORDER BY request_count DESC
-    `).all(...params);
     }
-    const where = conditions.join(" AND ");
     return db.prepare(`
     SELECT
-      rm.provider_id,
-      COALESCE(p.name, rm.provider_id) AS provider_name,
-      rm.backend_model,
-      COUNT(*) AS request_count,
-      AVG(rm.ttft_ms) AS avg_ttft_ms,
-      NULL AS p50_ttft_ms,
-      NULL AS p95_ttft_ms,
+      rm.provider_id, COALESCE(p.name, rm.provider_id) AS provider_name, rm.backend_model,
+      COUNT(*) AS request_count, AVG(rm.ttft_ms) AS avg_ttft_ms, NULL AS p50_ttft_ms, NULL AS p95_ttft_ms,
       AVG(rm.tokens_per_second) AS avg_tps,
-      COALESCE(SUM(rm.input_tokens), 0) AS total_input_tokens,
-      COALESCE(SUM(rm.output_tokens), 0) AS total_output_tokens,
+      COALESCE(SUM(rm.input_tokens), 0) AS total_input_tokens, COALESCE(SUM(rm.output_tokens), 0) AS total_output_tokens,
       COALESCE(SUM(rm.cache_read_tokens), 0) AS total_cache_hit_tokens,
-      CASE WHEN SUM(rm.input_tokens) > 0
-        THEN SUM(rm.cache_read_tokens) * 1.0 / SUM(rm.input_tokens)
-        ELSE NULL
-      END AS cache_hit_rate
+      CASE WHEN SUM(rm.input_tokens) > 0 THEN SUM(rm.cache_read_tokens) * 1.0 / SUM(rm.input_tokens) ELSE NULL END AS cache_hit_rate
     FROM request_metrics rm
-    ${joins}
-    WHERE ${where}
-    GROUP BY rm.provider_id, rm.backend_model
-    ORDER BY request_count DESC
+    ${joins.join(" ")}
+    WHERE ${conditions.join(" AND ")}
+    GROUP BY rm.provider_id, rm.backend_model ORDER BY request_count DESC
   `).all(...params);
 }
 const METRIC_EXPR = {
@@ -80,11 +93,13 @@ const METRIC_EXPR = {
     output_tokens: "SUM(rm.output_tokens)",
     cache_hit_tokens: "SUM(rm.cache_read_tokens)",
 };
-export function getMetricsTimeseries(db, period, metric, providerId, backendModel, routerKeyId) {
-    const offset = PERIOD_OFFSET[period];
-    const bucketSec = BUCKET_SECONDS[period];
-    const conditions = ["rm.is_complete = 1", "rm.created_at >= datetime('now', ?)"];
-    const params = [offset];
+export function getMetricsTimeseries(db, period, metric, providerId, backendModel, routerKeyId, startTime, endTime) {
+    const bucketSec = (startTime && endTime)
+        ? calculateBucketSeconds(startTime, endTime)
+        : BUCKET_SECONDS[period];
+    const { timeWhere, timeParams } = buildTimeCondition(period, startTime, endTime);
+    const conditions = ["rm.is_complete = 1", timeWhere];
+    const params = [...timeParams];
     if (providerId) {
         conditions.push("rm.provider_id = ?");
         params.push(providerId);

package/dist/db/migrations/018_add_failover_field.sql

@@ -0,0 +1,2 @@
+ALTER TABLE request_logs ADD COLUMN is_failover INTEGER NOT NULL DEFAULT 0;
+CREATE INDEX IF NOT EXISTS idx_request_logs_original_request_id ON request_logs(original_request_id);

package/dist/db/migrations/019_create_usage_windows.sql

@@ -0,0 +1,11 @@
+CREATE TABLE IF NOT EXISTS usage_windows (
+  id TEXT PRIMARY KEY,
+  router_key_id TEXT,
+  start_time TEXT NOT NULL,
+  end_time TEXT NOT NULL,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_usage_windows_start ON usage_windows(start_time);
+CREATE INDEX IF NOT EXISTS idx_usage_windows_router_key ON usage_windows(router_key_id);
+CREATE INDEX IF NOT EXISTS idx_usage_windows_end_time ON usage_windows(end_time);

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

@@ -25,8 +25,3 @@ 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;
-/**
- * 首次启动时（表为空）插入默认重试规则。
- * 429/503 为通用 HTTP 重试；其余为 ZAI middleware 特定 400 响应。
- */
-export declare function seedDefaultRules(db: Database.Database): void;

package/dist/db/retry-rules.js

@@ -27,26 +27,3 @@ export function updateRetryRule(db, id, fields) {
 export function deleteRetryRule(db, id) {
     deleteById(db, "retry_rules", id);
 }
-// ---------- Default seed rules ----------
-const DEFAULT_RULES = [
-    { name: "429 Too Many Requests", status_code: 429, body_pattern: ".*", is_active: 1, retry_strategy: "exponential", retry_delay_ms: 5000, max_retries: 10, max_delay_ms: 60000 },
-    { name: "503 Service Unavailable", status_code: 503, body_pattern: ".*", is_active: 1, retry_strategy: "exponential", retry_delay_ms: 5000, max_retries: 10, max_delay_ms: 60000 },
-    { name: 'ZAI 网络错误 (code 1234)', status_code: 400, body_pattern: '"type"\\s*:\\s*"error".*"code"\\s*:\\s*"1234"', is_active: 1, retry_strategy: "exponential", retry_delay_ms: 5000, max_retries: 10, max_delay_ms: 60000 },
-    { name: 'ZAI 临时不可用', status_code: 400, body_pattern: '"type"\\s*:\\s*"error".*请稍后重试', is_active: 1, retry_strategy: "exponential", retry_delay_ms: 5000, max_retries: 10, max_delay_ms: 60000 },
-    { name: 'ZAI 操作失败 (code 500)', status_code: 400, body_pattern: '"type"\\s*:\\s*"error".*"code"\\s*:\\s*"500"', is_active: 1, retry_strategy: "exponential", retry_delay_ms: 5000, max_retries: 10, max_delay_ms: 60000 },
-];
-/**
- * 首次启动时（表为空）插入默认重试规则。
- * 429/503 为通用 HTTP 重试；其余为 ZAI middleware 特定 400 响应。
- */
-export function seedDefaultRules(db) {
-    const count = db.prepare("SELECT COUNT(*) as c FROM retry_rules").get().c;
-    if (count > 0)
-        return;
-    const now = new Date().toISOString();
-    const insert = db.prepare(`INSERT INTO retry_rules (id, name, status_code, body_pattern, is_active, created_at, retry_strategy, retry_delay_ms, max_retries, max_delay_ms)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
-    for (const rule of DEFAULT_RULES) {
-        insert.run(randomUUID(), rule.name, rule.status_code, rule.body_pattern, rule.is_active, now, rule.retry_strategy, rule.retry_delay_ms, rule.max_retries, rule.max_delay_ms);
-    }
-}

package/dist/db/usage-windows.d.ts

@@ -0,0 +1,19 @@
+import Database from "better-sqlite3";
+export interface UsageWindow {
+    id: string;
+    router_key_id: string | null;
+    start_time: string;
+    end_time: string;
+    created_at: string;
+}
+export interface WindowUsage {
+    request_count: number;
+    total_input_tokens: number;
+    total_output_tokens: number;
+}
+export declare function insertWindow(db: Database.Database, w: Omit<UsageWindow, "created_at">): string;
+export declare function getLatestWindow(db: Database.Database, routerKeyId?: string): UsageWindow | null;
+/** 返回与 [start, end) 区间有重叠的窗口 */
+export declare function getWindowsInRange(db: Database.Database, start: string, end: string, routerKeyId?: string): UsageWindow[];
+/** 聚合指定时间窗口内的请求计数和 token 用量 */
+export declare function getWindowUsage(db: Database.Database, startTime: string, endTime: string, routerKeyId?: string): WindowUsage;

package/dist/db/usage-windows.js

@@ -0,0 +1,37 @@
+import { randomUUID } from "crypto";
+export function insertWindow(db, w) {
+    const id = w.id || randomUUID();
+    db.prepare("INSERT INTO usage_windows (id, router_key_id, start_time, end_time) VALUES (?, ?, ?, ?)").run(id, w.router_key_id ?? null, w.start_time, w.end_time);
+    return id;
+}
+export function getLatestWindow(db, routerKeyId) {
+    const sql = routerKeyId
+        ? "SELECT * FROM usage_windows WHERE router_key_id = ? ORDER BY start_time DESC LIMIT 1"
+        : "SELECT * FROM usage_windows ORDER BY start_time DESC LIMIT 1";
+    const params = routerKeyId ? [routerKeyId] : [];
+    return db.prepare(sql).get(...params) ?? null;
+}
+/** 返回与 [start, end) 区间有重叠的窗口 */
+export function getWindowsInRange(db, start, end, routerKeyId) {
+    if (routerKeyId) {
+        return db.prepare("SELECT * FROM usage_windows WHERE start_time < ? AND end_time > ? AND router_key_id = ? ORDER BY start_time ASC").all(end, start, routerKeyId);
+    }
+    return db.prepare("SELECT * FROM usage_windows WHERE start_time < ? AND end_time > ? ORDER BY start_time ASC").all(end, start);
+}
+/** 聚合指定时间窗口内的请求计数和 token 用量 */
+export function getWindowUsage(db, startTime, endTime, routerKeyId) {
+    const baseSql = `
+    SELECT
+      COUNT(*) AS request_count,
+      COALESCE(SUM(rm.input_tokens), 0) AS total_input_tokens,
+      COALESCE(SUM(rm.output_tokens), 0) AS total_output_tokens
+    FROM request_metrics rm
+    JOIN request_logs rl ON rl.id = rm.request_log_id
+    WHERE rm.is_complete = 1
+      AND rm.created_at >= datetime(?)
+      AND rm.created_at < datetime(?)`;
+    if (routerKeyId) {
+        return db.prepare(`${baseSql} AND rl.router_key_id = ?`).get(startTime, endTime, routerKeyId);
+    }
+    return db.prepare(baseSql).get(startTime, endTime);
+}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { FastifyInstance } from "fastify";
 import { Config } from "./config.js";
+import { UsageWindowTracker } from "./proxy/usage-window-tracker.js";
 import Database from "better-sqlite3";
 export interface AppOptions {
     config?: Config;
@@ -9,6 +10,7 @@ export interface AppOptions {
 export declare function buildApp(options?: AppOptions): Promise<{
     app: FastifyInstance;
     db: Database.Database;
+    usageWindowTracker: UsageWindowTracker;
     close: () => Promise<void>;
 }>;
 export declare function main(): Promise<void>;

package/dist/index.js

@@ -5,9 +5,7 @@ import { existsSync } from "node:fs";
 import { randomUUID } from "crypto";
 import Fastify from "fastify";
 import { insertRequestLog } from "./db/logs.js";
-const HTTP_NOT_FOUND = 404;
-const HTTP_INTERNAL_ERROR = 500;
-const HTTP_BAD_REQUEST = 400;
+import { HTTP_NOT_FOUND, HTTP_INTERNAL_ERROR, HTTP_BAD_REQUEST } from "./constants.js";
 const PROVIDER_DEFAULT_QUEUE_TIMEOUT_MS = 5000;
 const PROVIDER_DEFAULT_MAX_QUEUE_SIZE = 100;
 // 代理路由路径 → api_type，用于在全局 hook/errorHandler 中识别代理请求
@@ -23,7 +21,8 @@ function getProxyApiType(url) {
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 import { getConfig } from "./config.js";
-import { initDatabase, seedDefaultRules, getAllProviders } from "./db/index.js";
+import { initDatabase, getAllProviders } from "./db/index.js";
+import { loadRecommendedConfig } from "./config/recommended.js";
 import { authMiddleware } from "./middleware/auth.js";
 import { openaiProxy } from "./proxy/openai.js";
 import { anthropicProxy } from "./proxy/anthropic.js";
@@ -32,6 +31,7 @@ import { RetryRuleMatcher } from "./proxy/retry-rules.js";
 import { ProviderSemaphoreManager } from "./proxy/semaphore.js";
 import { RequestTracker } from "./monitor/request-tracker.js";
 import { modelState } from "./proxy/model-state.js";
+import { UsageWindowTracker } from "./proxy/usage-window-tracker.js";
 import fastifyStatic from "@fastify/static";
 export async function buildApp(options) {
     const config = options?.config ?? getBaseConfig();
@@ -102,15 +102,17 @@ export async function buildApp(options) {
         }
         return reply.code(status).send({ error: { message: fastifyError.message } });
     });
-    // 首次启动时插入默认重试规则（表为空时）
-    seedDefaultRules(db);
+    loadRecommendedConfig();
     // 注入 DB 到 modelState 单例，启用会话级持久化
     modelState.init(db);
     const matcher = new RetryRuleMatcher();
     matcher.load(db);
     const semaphoreManager = new ProviderSemaphoreManager();
-    const tracker = new RequestTracker({ semaphoreManager });
+    const tracker = new RequestTracker({ semaphoreManager, logger: app.log });
     tracker.startPushInterval();
+    // 5h 用量窗口追踪器，启动时自动补齐缺失窗口
+    const usageWindowTracker = new UsageWindowTracker(db);
+    usageWindowTracker.reconcileOnStartup();
     // 从 DB 读取已有 provider 的并发配置，初始化信号量管理器和 tracker
     const allProviders = getAllProviders(db);
     for (const p of allProviders) {
@@ -162,7 +164,7 @@ export async function buildApp(options) {
                 !request.url.startsWith("/admin/api")) {
                 return reply.sendFile("index.html");
             }
-            reply.code(HTTP_NOT_FOUND).send({ error: "Not Found" });
+            reply.code(HTTP_NOT_FOUND).send({ error: { message: "Not Found" } });
         });
     }
     else {
@@ -174,6 +176,7 @@ export async function buildApp(options) {
     return {
         app,
         db,
+        usageWindowTracker,
         close: async () => {
             tracker.stopPushInterval();
             await app.close();

package/dist/monitor/request-tracker.d.ts

@@ -3,10 +3,15 @@ import { StatsAggregator } from "./stats-aggregator.js";
 import { RuntimeCollector } from "./runtime-collector.js";
 import type { ProviderSemaphoreManager } from "../proxy/semaphore.js";
 import type { ActiveRequest, ProviderConcurrencySnapshot, RuntimeMetrics, StatsSnapshot } from "./types.js";
+export interface TrackerLogger {
+    debug(obj: Record<string, unknown>, msg: string): void;
+    warn(obj: Record<string, unknown>, msg: string): void;
+}
 export declare class RequestTracker {
     private activeMap;
     private recentCompleted;
     private clients;
+    private logger?;
     private providerConfigCache;
     private pushTimer;
     private tickCount;
@@ -17,6 +22,7 @@ export declare class RequestTracker {
     constructor(deps?: {
         semaphoreManager?: ProviderSemaphoreManager;
         runtimeCollector?: RuntimeCollector;
+        logger?: TrackerLogger;
     });
     start(req: ActiveRequest): void;
     update(id: string, patch: Partial<ActiveRequest>): void;