llm-simple-router 1.0.8 → 1.0.11

package/dist/admin/dashboard.d.ts

@@ -0,0 +1,7 @@
+import { FastifyPluginCallback } from "fastify";
+import Database from "better-sqlite3";
+interface DashboardRoutesOptions {
+    db: Database.Database;
+}
+export declare const adminDashboardRoutes: FastifyPluginCallback<DashboardRoutesOptions>;
+export {};

package/dist/admin/dashboard.js

@@ -0,0 +1,93 @@
+import { Type } from "@sinclair/typebox";
+import { getStats, getMetricsSummary, getMetricsTimeseries, getClientTypeBreakdown } from "../db/index.js";
+const OverviewQuerySchema = Type.Object({
+    provider_id: Type.Optional(Type.String()),
+    backend_model: Type.Optional(Type.String()),
+    router_key_id: Type.Optional(Type.String()),
+    client_type: Type.Optional(Type.String()),
+    start_time: Type.String(),
+    end_time: Type.String(),
+});
+const PERCENT_MULTIPLIER = 100;
+const PCT_ROUND_DIGITS = 10;
+const PROVIDER_TOKEN_LOOKBACK_DAYS = 30;
+export const adminDashboardRoutes = (app, options, done) => {
+    const { db } = options;
+    app.get("/admin/api/dashboard/overview", { schema: { querystring: OverviewQuerySchema } }, async (request, reply) => {
+        const query = request.query;
+        const startTime = query.start_time;
+        const endTime = query.end_time;
+        const providerId = query.provider_id || undefined;
+        const backendModel = query.backend_model || undefined;
+        const routerKeyId = query.router_key_id || undefined;
+        const clientType = query.client_type || undefined;
+        // 1. Current period stats
+        const stats = getStats(db, startTime, endTime, routerKeyId, providerId, backendModel, clientType);
+        // 2. Previous period stats (same duration, immediately before current window)
+        const durationMs = new Date(endTime).getTime() - new Date(startTime).getTime();
+        const prevEnd = startTime;
+        const prevStart = new Date(new Date(startTime).getTime() - durationMs).toISOString();
+        const prevStats = durationMs > 0
+            ? getStats(db, prevStart, prevEnd, routerKeyId, providerId, backendModel, clientType)
+            : null;
+        // 3. Timeseries (tps, input_tokens, output_tokens)
+        const legacyPeriod = "30d";
+        const [tpsRes, inputRes, outputRes] = await Promise.allSettled([
+            getMetricsTimeseries(db, legacyPeriod, "total_tps", providerId, backendModel, routerKeyId, startTime, endTime, clientType),
+            getMetricsTimeseries(db, legacyPeriod, "input_tokens", providerId, backendModel, routerKeyId, startTime, endTime, clientType),
+            getMetricsTimeseries(db, legacyPeriod, "output_tokens", providerId, backendModel, routerKeyId, startTime, endTime, clientType),
+        ]);
+        const tpsRes_ = tpsRes.status === "fulfilled" ? tpsRes.value : [];
+        const inputRes_ = inputRes.status === "fulfilled" ? inputRes.value : [];
+        const outputRes_ = outputRes.status === "fulfilled" ? outputRes.value : [];
+        // 4. Cache hit rate + client type breakdown
+        const summary = getMetricsSummary(db, legacyPeriod, providerId, backendModel, routerKeyId, startTime, endTime, clientType);
+        const totalInputTokens = summary.reduce((sum, r) => sum + r.total_input_tokens, 0);
+        const totalCacheHitTokens = summary.reduce((sum, r) => sum + r.total_cache_hit_tokens, 0);
+        const cacheHitRate = totalInputTokens > 0
+            ? Math.round(totalCacheHitTokens * PERCENT_MULTIPLIER / totalInputTokens * PCT_ROUND_DIGITS) / PCT_ROUND_DIGITS
+            : 0;
+        const breakdown = getClientTypeBreakdown(db, legacyPeriod, providerId, backendModel, routerKeyId, startTime, endTime);
+        // 5. Provider token summary (for provider sorting/labels in frontend)
+        const providerTokenSummary = getProviderTokenSummary(db);
+        return reply.send({
+            stats: {
+                totalRequests: stats.totalRequests,
+                successRate: stats.successRate,
+                avgTps: stats.avgTps,
+                totalInputTokens: stats.totalInputTokens,
+                totalOutputTokens: stats.totalOutputTokens,
+                startTime,
+                endTime,
+            },
+            prev_stats: prevStats ? {
+                totalRequests: prevStats.totalRequests,
+                successRate: prevStats.successRate,
+                avgTps: prevStats.avgTps,
+                totalInputTokens: prevStats.totalInputTokens,
+                totalOutputTokens: prevStats.totalOutputTokens,
+            } : null,
+            cache_hit_rate: cacheHitRate,
+            client_type_breakdown: breakdown,
+            timeseries: {
+                tps: tpsRes_,
+                input_tokens: inputRes_,
+                output_tokens: outputRes_,
+            },
+            provider_token_summary: providerTokenSummary,
+        });
+    });
+    done();
+};
+/** Get per-provider total input tokens for last 30 days (for sorting/labels) */
+function getProviderTokenSummary(db) {
+    const rows = db.prepare(`SELECT provider_id, COALESCE(SUM(sum_input_tokens), 0) AS total_input_tokens
+     FROM metrics_10min
+     WHERE bucket_time >= datetime('now', '-' || ? || ' days')
+     GROUP BY provider_id`).all(PROVIDER_TOKEN_LOOKBACK_DAYS);
+    const result = {};
+    for (const r of rows) {
+        result[r.provider_id] = r.total_input_tokens;
+    }
+    return result;
+}

package/dist/admin/metrics.js

@@ -1,5 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import { getMetricsSummary, getMetricsTimeseries, getClientTypeBreakdown } from "../db/index.js";
+import { queryAggActivity } from "../db/metrics-10min.js";
 import { resolveTimeRange } from "../utils/time-range.js";
 const LegacyPeriodEnum = Type.Union([
     Type.Literal("1h"), Type.Literal("5h"), Type.Literal("6h"), Type.Literal("24h"),
@@ -34,6 +35,10 @@ const TimeseriesQuerySchema = Type.Object({
     start_time: Type.Optional(Type.String()),
     end_time: Type.Optional(Type.String()),
 });
+const ActivityQuerySchema = Type.Object({
+    router_key_id: Type.Optional(Type.String()),
+    provider_id: Type.Optional(Type.String()),
+});
 const DASHBOARD_PERIODS = new Set(["window", "weekly", "monthly"]);
 const PCT_FACTOR = 100;
 const PCT_ROUND_DIGITS = 10;
@@ -67,5 +72,13 @@ export const adminMetricsRoutes = (app, options, done) => {
         const timeseries = getMetricsTimeseries(db, legacyPeriod, metric, query.provider_id, query.backend_model, query.router_key_id, startTime, endTime);
         return reply.send(timeseries);
     });
+    app.get("/admin/api/metrics/activity", { schema: { querystring: ActivityQuerySchema } }, async (request, reply) => {
+        const query = request.query;
+        const buckets = queryAggActivity(db, {
+            routerKeyId: query.router_key_id,
+            providerId: query.provider_id,
+        });
+        return reply.send({ buckets });
+    });
     done();
 };

package/dist/admin/routes.js

@@ -17,6 +17,7 @@ import { adminUpgradeRoutes } from "./upgrade.js";
 import { adminQuickSetupRoutes } from "./quick-setup.js";
 import { adminImportExportRoutes } from "./settings-import-export.js";
 import { adminTransformRuleRoutes } from "./transform-rules.js";
+import { adminDashboardRoutes } from "./dashboard.js";
 import { adminScheduleRoutes } from "./schedules.js";
 import { hookRegistry } from "../proxy/pipeline/hook-registry.js";
 export const adminRoutes = (app, options, done) => {
@@ -41,6 +42,7 @@ export const adminRoutes = (app, options, done) => {
     app.register(adminUsageRoutes, { db: options.db });
     app.register(adminQuickSetupRoutes, { db: options.db, stateRegistry: options.stateRegistry, tracker: options.tracker, adaptiveController: options.adaptiveController });
     app.register(adminUpgradeRoutes, { db: options.db, closeFn: options.closeFn ?? (async () => { }) });
+    app.register(adminDashboardRoutes, { db: options.db });
     app.register(adminTransformRuleRoutes, { db: options.db, pluginRegistry: options.pluginRegistry });
     // Pipeline hooks 查询
     app.get("/admin/api/pipeline/hooks", async () => {

package/dist/admin/settings.js

@@ -1,6 +1,6 @@
 import { statSync, readdirSync } from "node:fs";
 import { join } from "node:path";
-import { getLogRetentionDays, setLogRetentionDays, getDbMaxSizeMb, setDbMaxSizeMb, getLogTableMaxSizeMb, setLogTableMaxSizeMb, getSetting, getTokenEstimationEnabled, setTokenEstimationEnabled, getClientSessionHeaders, setClientSessionHeaders, } from "../db/settings.js";
+import { getLogRetentionDays, setLogRetentionDays, getDbMaxSizeMb, setDbMaxSizeMb, getLogTableMaxSizeMb, setLogTableMaxSizeMb, getSetting, getTokenEstimationEnabled, setTokenEstimationEnabled, getClientSessionHeaders, setClientSessionHeaders, getMetricsDetailDays, setMetricsDetailDays, } from "../db/settings.js";
 import { HTTP_BAD_REQUEST } from "./constants.js";
 import { API_CODE, apiError } from "./api-response.js";
 export const adminSettingsRoutes = (app, options, done) => {
@@ -98,6 +98,22 @@ export const adminSettingsRoutes = (app, options, done) => {
         setClientSessionHeaders(db, entries);
         return { success: true };
     });
+    // --- Metrics Detail Days ---
+    app.get("/admin/api/settings/metrics-detail-days", async () => {
+        return { days: getMetricsDetailDays(db) };
+    });
+    const MAX_METRICS_DETAIL_DAYS = 30;
+    app.put("/admin/api/settings/metrics-detail-days", async (request, reply) => {
+        const { days } = request.body;
+        if (!Number.isInteger(days) || days < 1 || days > MAX_METRICS_DETAIL_DAYS) {
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.BAD_REQUEST, "days must be integer 1-30"));
+        }
+        if (days > getLogRetentionDays(db)) {
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.BAD_REQUEST, "metrics_detail_days must not exceed log_retention_days"));
+        }
+        setMetricsDetailDays(db, days);
+        return { days };
+    });
     done();
 };
 /** 递归计算目录下所有文件的总大小（字节） */

package/dist/admin/stats.js

@@ -12,6 +12,7 @@ const StatsQuerySchema = Type.Object({
     router_key_id: Type.Optional(Type.String()),
     provider_id: Type.Optional(Type.String()),
     backend_model: Type.Optional(Type.String()),
+    client_type: Type.Optional(Type.String()),
 });
 export const adminStatsRoutes = (app, options, done) => {
     app.get("/admin/api/stats", { schema: { querystring: StatsQuerySchema } }, async (request, reply) => {
@@ -27,7 +28,7 @@ export const adminStatsRoutes = (app, options, done) => {
             startTime = range.startTime;
             endTime = range.endTime;
         }
-        const stats = getStats(options.db, startTime, endTime, query.router_key_id, query.provider_id, query.backend_model);
+        const stats = getStats(options.db, startTime, endTime, query.router_key_id, query.provider_id, query.backend_model, query.client_type);
         return reply.send({ ...stats, startTime, endTime });
     });
     done();

package/dist/admin/usage.js

@@ -1,6 +1,8 @@
 import { Type } from "@sinclair/typebox";
 import { getWindowsInRange, getWindowUsage } from "../db/usage-windows.js";
 import { getProviderById } from "../db/index.js";
+import { MS_PER_SECOND } from "../core/constants.js";
+import { BUCKET_SECONDS } from "../db/metrics-10min.js";
 import { resolveTimeRange } from "../utils/time-range.js";
 const UsageQuerySchema = Type.Object({
     router_key_id: Type.Optional(Type.String()),
@@ -8,7 +10,39 @@ const UsageQuerySchema = Type.Object({
     start_time: Type.Optional(Type.String()),
     end_time: Type.Optional(Type.String()),
 });
-function getDailyUsage(db, startTime, endTime, routerKeyId, providerId) {
+// Use shared bucket boundary from metrics-10min
+// BUCKET_SECONDS imported from metrics-10min
+function computeBucketBoundary() {
+    const bucketStartSec = Math.floor(Date.now() / MS_PER_SECOND / BUCKET_SECONDS) * BUCKET_SECONDS;
+    return new Date(bucketStartSec * MS_PER_SECOND).toISOString();
+}
+function queryAggDailyUsage(db, startTime, endTime, routerKeyId, providerId) {
+    const conditions = [
+        "m.bucket_time >= datetime(?)",
+        "m.bucket_time < datetime(?)",
+    ];
+    const params = [startTime, endTime];
+    if (routerKeyId) {
+        conditions.push("m.router_key_id = ?");
+        params.push(routerKeyId);
+    }
+    if (providerId) {
+        conditions.push("m.provider_id = ?");
+        params.push(providerId);
+    }
+    return db.prepare(`
+    SELECT
+      date(m.bucket_time) AS date,
+      SUM(m.request_count) AS request_count,
+      SUM(m.sum_input_tokens) AS total_input_tokens,
+      SUM(m.sum_output_tokens) AS total_output_tokens
+    FROM metrics_10min m
+    WHERE ${conditions.join(" AND ")}
+    GROUP BY date(m.bucket_time)
+    ORDER BY date ASC
+  `).all(...params);
+}
+function queryDetailDailyUsage(db, startTime, endTime, routerKeyId, providerId) {
     const conditions = [
         "rm.created_at >= datetime(?)",
         "rm.created_at < datetime(?)",
@@ -34,6 +68,40 @@ function getDailyUsage(db, startTime, endTime, routerKeyId, providerId) {
     ORDER BY date ASC
   `).all(...params);
 }
+function mergeDailyUsageResults(a, b) {
+    if (a.length === 0)
+        return b;
+    if (b.length === 0)
+        return a;
+    const dateMap = new Map();
+    for (const row of [...a, ...b]) {
+        const existing = dateMap.get(row.date);
+        if (existing) {
+            existing.request_count += row.request_count;
+            existing.total_input_tokens += row.total_input_tokens;
+            existing.total_output_tokens += row.total_output_tokens;
+        }
+        else {
+            dateMap.set(row.date, { ...row });
+        }
+    }
+    return Array.from(dateMap.values()).sort((a, b) => a.date.localeCompare(b.date));
+}
+function getDailyUsage(db, startTime, endTime, routerKeyId, providerId) {
+    const boundary = computeBucketBoundary();
+    // Pure agg: entire range is before the current bucket
+    if (endTime <= boundary) {
+        return queryAggDailyUsage(db, startTime, endTime, routerKeyId, providerId);
+    }
+    // Pure detail: entire range is within the current bucket
+    if (startTime >= boundary) {
+        return queryDetailDailyUsage(db, startTime, endTime, routerKeyId, providerId);
+    }
+    // Cross-boundary: agg segment [start, boundary) + detail segment [boundary, end)
+    const aggResult = queryAggDailyUsage(db, startTime, boundary, routerKeyId, providerId);
+    const detailResult = queryDetailDailyUsage(db, boundary, endTime, routerKeyId, providerId);
+    return mergeDailyUsageResults(detailResult, aggResult);
+}
 function resolveProviderName(db, providerId) {
     if (!providerId)
         return null;

package/dist/core/constants.d.ts

@@ -12,6 +12,7 @@ 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;
+export declare const SECONDS_PER_DAY = 86400;
 export declare const UPSTREAM_SUCCESS = 200;
 /** 过滤掉不应转发给下游的 hop-by-hop headers */
 export declare function filterHeaders(raw: import("./types.js").RawHeaders): Record<string, string>;

package/dist/core/constants.js

@@ -24,6 +24,7 @@ export function getProxyApiType(url) {
     return PROXY_API_TYPES[path] ?? null;
 }
 export const MS_PER_SECOND = 1000;
+export const SECONDS_PER_DAY = 86_400;
 // 上游成功状态码
 export const UPSTREAM_SUCCESS = 200;
 /** 过滤掉不应转发给下游的 hop-by-hop headers */

package/dist/db/index.d.ts

@@ -10,8 +10,9 @@ export { insertRequestLog, getRequestLogs, getRequestLogById, deleteLogsBefore,
 export type { RequestLog, RequestLogGroupedRow, RequestLogListRow } from "./logs.js";
 export { getRouterKeyByHash, getAllRouterKeys, getRouterKeyById, createRouterKey, updateRouterKey, deleteRouterKey, getAvailableModels, } from "./router-keys.js";
 export type { RouterKey } from "./router-keys.js";
-export { getMetricsSummary, getMetricsTimeseries, insertMetrics, getClientTypeBreakdown } from "./metrics.js";
+export { getMetricsSummary, getMetricsTimeseries, insertMetrics, getClientTypeBreakdown, deleteMetricsBefore } from "./metrics.js";
 export type { MetricsSummaryRow, MetricsTimeseriesRow, MetricsPeriod, MetricsMetric, MetricsRow, MetricsInsert, ClientTypeBreakdown } from "./metrics.js";
+export type { Metrics10minRow } from "./metrics-10min.js";
 export { getStats, getLatestMetricTime } from "./stats.js";
 export type { Stats } from "./stats.js";
 export { getSetting, setSetting, isInitialized } from "./settings.js";

package/dist/db/index.js

@@ -186,7 +186,7 @@ export { getMappingGroup, getMappingGroupById, getAllMappingGroups, createMappin
 export { getActiveRetryRules, getAllRetryRules, getRetryRuleById, createRetryRule, updateRetryRule, deleteRetryRule, } from "./retry-rules.js";
 export { insertRequestLog, getRequestLogs, getRequestLogById, deleteLogsBefore, getRequestLogChildren, getRequestLogsGrouped, updateLogStreamContent, updateLogClientStatus, estimateLogTableSize, deleteOldestLogs, getLogCount, updateLogPipelineSnapshot, extractThinkingLevel, } from "./logs.js";
 export { getRouterKeyByHash, getAllRouterKeys, getRouterKeyById, createRouterKey, updateRouterKey, deleteRouterKey, getAvailableModels, } from "./router-keys.js";
-export { getMetricsSummary, getMetricsTimeseries, insertMetrics, getClientTypeBreakdown } from "./metrics.js";
+export { getMetricsSummary, getMetricsTimeseries, insertMetrics, getClientTypeBreakdown, deleteMetricsBefore } from "./metrics.js";
 export { getStats, getLatestMetricTime } from "./stats.js";
 export { getSetting, setSetting, isInitialized } from "./settings.js";
 export { getDbMaxSizeMb, setDbMaxSizeMb, getLogTableMaxSizeMb, setLogTableMaxSizeMb, } from "./settings.js";

package/dist/db/log-cleaner.js

@@ -1,5 +1,6 @@
 import { deleteLogsBefore } from "./logs.js";
-import { getLogRetentionDays } from "./settings.js";
+import { getLogRetentionDays, getMetricsDetailDays } from "./settings.js";
+import { deleteMetricsBefore } from "./metrics.js";
 import { deleteToolErrorLogsBefore } from "./tool-error-logs.js";
 const MS_PER_DAY = 86_400_000;
 const CLEANUP_INTERVAL_MS = 3_600_000; // 1 小时
@@ -11,7 +12,13 @@ export function runLogCleanup(db) {
     const cutoff = new Date(Date.now() - days * MS_PER_DAY).toISOString();
     const logDeleted = deleteLogsBefore(db, cutoff);
     const toolErrorDeleted = deleteToolErrorLogsBefore(db, cutoff);
-    return logDeleted + toolErrorDeleted;
+    let metricsDeleted = 0;
+    const detailDays = getMetricsDetailDays(db);
+    if (detailDays > 0) {
+        const metricsCutoff = new Date(Date.now() - detailDays * MS_PER_DAY).toISOString();
+        metricsDeleted = deleteMetricsBefore(db, metricsCutoff);
+    }
+    return logDeleted + toolErrorDeleted + metricsDeleted;
 }
 /** 启动定时清理，返回 handle 用于停止 */
 export function scheduleLogCleanup(db, log) {

package/dist/db/logs.d.ts

@@ -64,6 +64,7 @@ export interface RequestLogInsert {
     upstream_api_type?: string | null;
     upstream_base_url?: string | null;
     thinking_level?: string;
+    backend_model?: string | null;
 }
 export interface LogWriteContext {
     matcher?: RetryMatcher | null;

package/dist/db/logs.js

@@ -38,9 +38,9 @@ function rawInsertRequestLog(db, log, writeContext) {
       is_stream, error_message, created_at, client_request, upstream_request, upstream_response,
       is_retry, is_failover, original_request_id, router_key_id, original_model, session_id, pipeline_snapshot,
       transport_kind, abort_reason, error_code, headers_sent, resilience_action, resilience_reason, mapping_reason, failover_trigger,
-      upstream_api_type, upstream_base_url, thinking_level)
+      upstream_api_type, upstream_base_url, thinking_level, backend_model)
      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?,
-      ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(log.id, log.api_type, log.model, log.provider_id, log.status_code, log.client_status_code ?? null, log.latency_ms, log.is_stream, log.error_message, log.created_at, log.client_request ?? null, preserveDetail ? (log.upstream_request ?? null) : null, preserveDetail ? (log.upstream_response ?? null) : null, log.is_retry ?? 0, log.is_failover ?? 0, log.original_request_id ?? null, log.router_key_id ?? null, log.original_model ?? null, log.session_id ?? null, log.pipeline_snapshot ?? null, log.transport_kind ?? null, log.abort_reason ?? null, log.error_code ?? null, log.headers_sent ?? null, log.resilience_action ?? null, log.resilience_reason ?? null, log.mapping_reason ?? null, log.failover_trigger ?? null, log.upstream_api_type ?? null, log.upstream_base_url ?? null, log.thinking_level ?? extractThinkingLevel(log.api_type, log.client_request ?? null));
+      ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(log.id, log.api_type, log.model, log.provider_id, log.status_code, log.client_status_code ?? null, log.latency_ms, log.is_stream, log.error_message, log.created_at, log.client_request ?? null, preserveDetail ? (log.upstream_request ?? null) : null, preserveDetail ? (log.upstream_response ?? null) : null, log.is_retry ?? 0, log.is_failover ?? 0, log.original_request_id ?? null, log.router_key_id ?? null, log.original_model ?? null, log.session_id ?? null, log.pipeline_snapshot ?? null, log.transport_kind ?? null, log.abort_reason ?? null, log.error_code ?? null, log.headers_sent ?? null, log.resilience_action ?? null, log.resilience_reason ?? null, log.mapping_reason ?? null, log.failover_trigger ?? null, log.upstream_api_type ?? null, log.upstream_base_url ?? null, log.thinking_level ?? extractThinkingLevel(log.api_type, log.client_request ?? null), log.backend_model ?? null);
 }
 export function insertRequestLog(db, log, writeContext) {
     // 文件写入：始终同步调用（WriteStream 内部异步，不阻塞事件循环）
@@ -75,8 +75,8 @@ function buildLogWhereClause(options, baseCondition) {
         params.push(`%${options.client_model}%`);
     }
     if (options.backend_model) {
-        where += " AND rl.id IN (SELECT request_log_id FROM request_metrics WHERE backend_model LIKE ?)";
-        params.push(`%${options.backend_model}%`);
+        where += " AND rl.id IN (SELECT request_log_id FROM request_metrics WHERE backend_model = ?)";
+        params.push(options.backend_model);
     }
     if (options.router_key_id) {
         where += " AND rl.router_key_id = ?";

package/dist/db/metrics-10min.d.ts

@@ -0,0 +1,43 @@
+import Database from "better-sqlite3";
+import type { MetricsPeriod, MetricsMetric, MetricsSummaryRow, MetricsTimeseriesRow } from "./metrics.js";
+declare const MILLISECONDS_PER_SECOND = 1000;
+export declare const BUCKET_SECONDS = 600;
+export { MILLISECONDS_PER_SECOND };
+export interface Metrics10minRow {
+    bucket_time: string;
+    router_key_id: string;
+    provider_id: string;
+    backend_model: string;
+    client_type: string;
+    api_type: string;
+    request_count: number;
+    sum_input_tokens: number;
+    sum_output_tokens: number;
+    sum_cache_read_tokens: number;
+    sum_cache_creation_tokens: number;
+    sum_total_duration_ms: number;
+    sum_ttft_ms: number;
+    sum_thinking_tokens: number;
+    sum_text_tokens: number;
+    sum_tool_use_tokens: number;
+    sum_thinking_duration_ms: number;
+    sum_text_duration_ms: number;
+    sum_tool_use_duration_ms: number;
+}
+export declare function queryAggActivity(db: Database.Database, filters?: {
+    routerKeyId?: string;
+    providerId?: string;
+}): {
+    bucket_time: string;
+    request_count: number;
+}[];
+export declare function queryAggSummary(db: Database.Database, period: MetricsPeriod, providerId?: string, backendModel?: string, routerKeyId?: string, startTime?: string, endTime?: string, clientType?: string): MetricsSummaryRow[];
+export declare const AGG_METRIC_EXPR: Record<MetricsMetric, string>;
+export declare function queryAggTimeseries(db: Database.Database, period: MetricsPeriod, metric: MetricsMetric, providerId?: string, backendModel?: string, routerKeyId?: string, startTime?: string, endTime?: string, clientType?: string): MetricsTimeseriesRow[];
+export interface AggStats {
+    totalRequests: number;
+    avgTps: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+}
+export declare function queryAggStats(db: Database.Database, startTime: string, endTime: string, routerKeyId?: string, providerId?: string, backendModel?: string, clientType?: string): AggStats;

package/dist/db/metrics-10min.js

@@ -0,0 +1,197 @@
+import { getCachedStmt } from "./helpers.js";
+const MILLISECONDS_PER_SECOND = 1000;
+// Shared with metrics.ts — bucket boundary computation constants
+export const BUCKET_SECONDS = 600;
+export { MILLISECONDS_PER_SECOND };
+// 单条 upsert 已废弃，聚合逻辑统一由 metrics-aggregator.ts 批量 INSERT...SELECT 处理
+// --- Activity chart query ---
+export function queryAggActivity(db, filters) {
+    const conditions = ["bucket_time >= datetime('now', '-30 days')"];
+    const params = [];
+    if (filters?.routerKeyId) {
+        conditions.push("router_key_id = ?");
+        params.push(filters.routerKeyId);
+    }
+    if (filters?.providerId) {
+        conditions.push("provider_id = ?");
+        params.push(filters.providerId);
+    }
+    const where = conditions.join(" AND ");
+    return getCachedStmt(db, `SELECT bucket_time, SUM(request_count) AS request_count
+     FROM metrics_10min
+     WHERE ${where}
+     GROUP BY bucket_time
+     ORDER BY bucket_time ASC`).all(...params);
+}
+// --- Time condition builder for 10min aggregation table ---
+const AGG_PERIOD_OFFSET = {
+    "1h": "-1 hours",
+    "5h": "-5 hours",
+    "6h": "-6 hours",
+    "24h": "-1 day",
+    "7d": "-7 days",
+    "30d": "-30 days",
+};
+function buildAggTimeCondition(period, startTime, endTime) {
+    if (startTime && endTime) {
+        return {
+            timeWhere: "m.bucket_time >= datetime(?) AND m.bucket_time < datetime(?)",
+            timeParams: [startTime, endTime],
+        };
+    }
+    return {
+        timeWhere: "m.bucket_time >= datetime('now', ?)",
+        timeParams: [AGG_PERIOD_OFFSET[period]],
+    };
+}
+// --- Summary query (供 BG3 使用) ---
+export function queryAggSummary(db, period, providerId, backendModel, routerKeyId, startTime, endTime, clientType) {
+    const { timeWhere, timeParams } = buildAggTimeCondition(period, startTime, endTime);
+    const conditions = [timeWhere];
+    const params = [...timeParams];
+    if (providerId) {
+        conditions.push("m.provider_id = ?");
+        params.push(providerId);
+    }
+    if (backendModel) {
+        conditions.push("m.backend_model = ?");
+        params.push(backendModel);
+    }
+    if (routerKeyId) {
+        conditions.push("m.router_key_id = ?");
+        params.push(routerKeyId);
+    }
+    if (clientType) {
+        conditions.push("m.client_type = ?");
+        params.push(clientType);
+    }
+    const where = conditions.join(" AND ");
+    return getCachedStmt(db, `SELECT
+      m.provider_id, COALESCE(p.name, m.provider_id) AS provider_name,
+      m.backend_model, m.client_type,
+      SUM(m.request_count) AS request_count,
+      CASE WHEN SUM(m.request_count) > 0 THEN SUM(m.sum_ttft_ms) / SUM(m.request_count) ELSE NULL END AS avg_ttft_ms,
+      NULL AS p50_ttft_ms, NULL AS p95_ttft_ms,
+      CASE WHEN SUM(m.sum_total_duration_ms) > 0
+        THEN CAST(SUM(m.sum_output_tokens) AS REAL) * 1000.0 / SUM(m.sum_total_duration_ms)
+        ELSE NULL END AS avg_tps,
+      SUM(m.sum_input_tokens) AS total_input_tokens,
+      SUM(m.sum_output_tokens) AS total_output_tokens,
+      SUM(m.sum_cache_read_tokens) AS total_cache_hit_tokens,
+      CASE WHEN SUM(m.sum_input_tokens) > 0
+        THEN SUM(m.sum_cache_read_tokens) * 100.0 / SUM(m.sum_input_tokens)
+        ELSE NULL END AS cache_hit_rate
+    FROM metrics_10min m
+    LEFT JOIN providers p ON p.id = m.provider_id
+    WHERE ${where}
+    GROUP BY m.provider_id, m.backend_model, m.client_type
+    ORDER BY request_count DESC`).all(...params);
+}
+// --- Timeseries query (供 BG3 使用) ---
+export const AGG_METRIC_EXPR = {
+    ttft: "SUM(m.sum_ttft_ms) / CASE WHEN SUM(m.request_count) > 0 THEN SUM(m.request_count) ELSE 1 END",
+    tps: "CASE WHEN SUM(m.sum_total_duration_ms) > 0 THEN CAST(SUM(m.sum_output_tokens) AS REAL) * 1000.0 / SUM(m.sum_total_duration_ms) ELSE NULL END",
+    text_tps: "CASE WHEN SUM(m.sum_text_duration_ms) > 0 THEN CAST(SUM(m.sum_text_tokens) AS REAL) * 1000.0 / SUM(m.sum_text_duration_ms) ELSE NULL END",
+    thinking_tps: "CASE WHEN SUM(m.sum_thinking_duration_ms) > 0 THEN CAST(SUM(m.sum_thinking_tokens) AS REAL) * 1000.0 / SUM(m.sum_thinking_duration_ms) ELSE NULL END",
+    tool_use_tps: "CASE WHEN SUM(m.sum_tool_use_duration_ms) > 0 THEN CAST(SUM(m.sum_tool_use_tokens) AS REAL) * 1000.0 / SUM(m.sum_tool_use_duration_ms) ELSE NULL END",
+    non_thinking_tps: "CASE WHEN SUM(m.sum_text_duration_ms) + SUM(m.sum_tool_use_duration_ms) > 0 THEN CAST(SUM(m.sum_text_tokens) + SUM(m.sum_tool_use_tokens) AS REAL) * 1000.0 / (SUM(m.sum_text_duration_ms) + SUM(m.sum_tool_use_duration_ms)) ELSE NULL END",
+    total_tps: "CASE WHEN SUM(m.sum_total_duration_ms) > 0 THEN CAST(SUM(m.sum_output_tokens) AS REAL) * 1000.0 / SUM(m.sum_total_duration_ms) ELSE NULL END",
+    tokens: "SUM(m.sum_output_tokens)",
+    cache_rate: "CASE WHEN SUM(m.sum_input_tokens) > 0 THEN SUM(m.sum_cache_read_tokens) * 1.0 / SUM(m.sum_input_tokens) ELSE NULL END",
+    request_count: "SUM(m.request_count)",
+    input_tokens: "SUM(m.sum_input_tokens)",
+    output_tokens: "SUM(m.sum_output_tokens)",
+    cache_hit_tokens: "SUM(m.sum_cache_read_tokens)",
+};
+const AGG_PERIOD_TOTAL_SEC = {
+    "1h": 3600,
+    "5h": 18000,
+    "6h": 21600,
+    "24h": 86400,
+    "7d": 604800,
+    "30d": 2592000,
+};
+const MIN_BUCKET_SEC = 60;
+const DATA_POINT_COUNT = 10;
+function calcBucketSec(totalSec) {
+    return Math.max(MIN_BUCKET_SEC, Math.round(totalSec / DATA_POINT_COUNT));
+}
+export function queryAggTimeseries(db, period, metric, providerId, backendModel, routerKeyId, startTime, endTime, clientType) {
+    const totalSec = (startTime && endTime)
+        ? (new Date(endTime).getTime() - new Date(startTime).getTime()) / MILLISECONDS_PER_SECOND
+        : AGG_PERIOD_TOTAL_SEC[period];
+    const bucketSec = calcBucketSec(totalSec);
+    const { timeWhere, timeParams } = buildAggTimeCondition(period, startTime, endTime);
+    const conditions = [timeWhere];
+    const params = [...timeParams];
+    if (providerId) {
+        conditions.push("m.provider_id = ?");
+        params.push(providerId);
+    }
+    if (backendModel) {
+        conditions.push("m.backend_model = ?");
+        params.push(backendModel);
+    }
+    if (routerKeyId) {
+        conditions.push("m.router_key_id = ?");
+        params.push(routerKeyId);
+    }
+    if (clientType) {
+        conditions.push("m.client_type = ?");
+        params.push(clientType);
+    }
+    const where = conditions.join(" AND ");
+    const expr = AGG_METRIC_EXPR[metric];
+    const rows = getCachedStmt(db, `SELECT
+      (unixepoch(m.bucket_time) / CAST(? AS INTEGER)) * CAST(? AS INTEGER) AS bucket_key,
+      ${expr} AS avg_value,
+      SUM(m.request_count) AS count
+    FROM metrics_10min m
+    WHERE ${where}
+    GROUP BY bucket_key
+    ORDER BY bucket_key ASC`).all(bucketSec, bucketSec, ...params);
+    return rows.map((r) => ({
+        time_bucket: new Date(r.bucket_key * MILLISECONDS_PER_SECOND).toISOString(),
+        avg_value: r.avg_value,
+        count: r.count,
+    }));
+}
+export function queryAggStats(db, startTime, endTime, routerKeyId, providerId, backendModel, clientType) {
+    const conditions = [
+        "m.bucket_time >= datetime(?)",
+        "m.bucket_time < datetime(?)",
+    ];
+    const params = [startTime, endTime];
+    if (routerKeyId) {
+        conditions.push("m.router_key_id = ?");
+        params.push(routerKeyId);
+    }
+    if (providerId) {
+        conditions.push("m.provider_id = ?");
+        params.push(providerId);
+    }
+    if (backendModel) {
+        conditions.push("m.backend_model = ?");
+        params.push(backendModel);
+    }
+    if (clientType) {
+        conditions.push("m.client_type = ?");
+        params.push(clientType);
+    }
+    const where = conditions.join(" AND ");
+    const row = getCachedStmt(db, `SELECT
+      SUM(m.request_count) AS total_requests,
+      CASE WHEN SUM(m.sum_total_duration_ms) > 0
+        THEN CAST(SUM(m.sum_output_tokens) AS REAL) * 1000.0 / SUM(m.sum_total_duration_ms)
+        ELSE NULL END AS avg_tps,
+      COALESCE(SUM(m.sum_input_tokens), 0) AS total_input_tokens,
+      COALESCE(SUM(m.sum_output_tokens), 0) AS total_output_tokens
+    FROM metrics_10min m
+    WHERE ${where}`).get(...params);
+    return {
+        totalRequests: row?.total_requests ?? 0,
+        avgTps: row?.avg_tps ?? 0,
+        totalInputTokens: row?.total_input_tokens ?? 0,
+        totalOutputTokens: row?.total_output_tokens ?? 0,
+    };
+}

package/dist/db/metrics-aggregator.d.ts

@@ -0,0 +1,8 @@
+import Database from "better-sqlite3";
+export interface MetricsAggregatorHandle {
+    stop: () => void;
+}
+export declare function scheduleMetricsAggregator(db: Database.Database, log: {
+    warn: (msg: string) => void;
+    info: (msg: string) => void;
+}): MetricsAggregatorHandle;