llm-simple-router 0.4.2 → 0.5.0

package/README.md

@@ -60,56 +60,105 @@ npx llm-simple-router
 
 ### 3. 配置模型映射
 
-管理后台 > 模型映射页面。示例配置：
+管理后台 > 模型映射页面。
+
+**核心概念：** 客户端请求携带模型名 A，Router 根据映射规则将其替换为后端 Provider 支持的模型名 B，然后转发请求：
+
+```
+Claude Code (模型 A) → Router (A → B) → Provider API (模型 B)
+```
+
+只需在映射表中配置「客户端模型 = A，后端模型 = B，选择供应商」即可。
+
+#### Claude Code 默认模型名
+
+Claude Code 未设置环境变量时，默认使用以下模型名：`opus`、`sonnet`、`haiku`。如果后端是智谱 Coding Plan，映射配置如下：
 
 | 客户端模型 | 后端模型 | 供应商 | 时间窗口 |
 |-----------|---------|--------|---------|
-| sonnet | glm-5.1 | 智谱 | 全天 |
-| sonnet | kimi-for-coding | Moonshot | 14:00-18:00 |
+| opus | glm-5.1 | 智谱 Coding Plan | 全天 |
+| sonnet | glm-5.1 | 智谱 Coding Plan | 全天 |
+| haiku | glm-5-turbo | 智谱 Coding Plan | 全天 |
 
-客户端模型是指 Claude Code 实际请求的模型名（由 `ANTHROPIC_MODEL` 等环境变量决定）。
+也可以利用分时段功能实现高峰期自动切换：
+
+| 客户端模型 | 后端模型 | 供应商 | 时间窗口 |
+|-----------|---------|--------|---------|
+| sonnet | glm-5.1 | 智谱 Coding Plan | 00:00-14:00 |
+| sonnet | kimi-for-coding | Moonshot | 14:00-18:00 |
+| sonnet | glm-5.1 | 智谱 Coding Plan | 18:00-24:00 |
 
 ### 4. 配置 Claude Code
 
-在管理后台创建 Router API 密钥，然后选择一种方式配置：
+在管理后台创建 Router API 密钥，然后选择一种方式配置。**两种方式只需选其一。**
 
 **方式一：shell alias（推荐）**
 
+最小配置，Claude Code 使用默认模型名（opus / sonnet / haiku），Router 通过映射表转换为后端模型：
+
 ```bash
 alias clode='\
 export ANTHROPIC_AUTH_TOKEN="<your-router-key>" && \
 export ANTHROPIC_BASE_URL="http://127.0.0.1:9981" && \
-export ANTHROPIC_MODEL="<your-default-model>" && \
-export ANTHROPIC_DEFAULT_OPUS_MODEL="<your-opus-model>" && \
-export ANTHROPIC_DEFAULT_SONNET_MODEL="<your-sonnet-model>" && \
-export ANTHROPIC_DEFAULT_HAIKU_MODEL="<your-haiku-model>" && \
-export ANTHROPIC_SMALL_FAST_MODEL="<your-fast-model>" && \
 claude'
 ```
 
+也可以通过环境变量直接指定模型名，绕过 Router 映射：
+
+```bash
+alias clode='\
+export ANTHROPIC_AUTH_TOKEN="sk-router-xxxxxxxx" && \
+export ANTHROPIC_BASE_URL="http://192.168.1.111:9981" && \
+export ANTHROPIC_MODEL="glm-5" && \
+export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.1" && \
+export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5" && \
+export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5-turbo" && \
+export ANTHROPIC_SMALL_FAST_MODEL="glm-5-turbo" && \
+claude'
+```
+
+> 调试时可加参数：`claude --dangerously-skip-permissions --verbose --debug`，或设置 `export DEBUG=claude:*` 查看详细日志。
+
 **方式二：~/.claude/settings.json**
 
+在 `~/.claude/settings.json` 的 `env` 字段中配置，效果与 export 环境变量相同：
+
+最小配置：
+
 ```json
 {
   "env": {
     "ANTHROPIC_AUTH_TOKEN": "<your-router-key>",
-    "ANTHROPIC_BASE_URL": "http://127.0.0.1:9981",
-    "ANTHROPIC_MODEL": "<your-default-model>",
-    "ANTHROPIC_DEFAULT_OPUS_MODEL": "<your-opus-model>",
-    "ANTHROPIC_DEFAULT_SONNET_MODEL": "<your-sonnet-model>",
-    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<your-haiku-model>",
-    "ANTHROPIC_SMALL_FAST_MODEL": "<your-fast-model>"
+    "ANTHROPIC_BASE_URL": "http://127.0.0.1:9981"
   }
 }
 ```
 
+覆盖模型名：
+
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "sk-router-xxxxxxxx",
+    "ANTHROPIC_BASE_URL": "http://192.168.1.111:9981",
+    "ANTHROPIC_MODEL": "glm-5",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5-turbo",
+    "ANTHROPIC_SMALL_FAST_MODEL": "glm-5-turbo"
+  }
+}
+```
+
+> settings.json 中的环境变量对所有项目生效。如果只想对当前项目生效，可放在 `.claude/settings.json`（项目根目录下）。
+
 ### 5. 使用
 
 ```bash
-# 方式一用户直接用 alias
+# 方式一（shell alias）
 clode
 
-# 方式二用户正常启动 claude
+# 方式二（settings.json）
 claude
 ```
 

package/dist/admin/monitor.js

@@ -1,3 +1,4 @@
+import { HTTP_NOT_FOUND } from "./constants.js";
 const HTTP_OK = 200;
 export const adminMonitorRoutes = (app, options, done) => {
     const { tracker } = options;
@@ -21,5 +22,12 @@ export const adminMonitorRoutes = (app, options, done) => {
             tracker.removeClient(reply.raw);
         });
     });
+    app.get("/admin/api/monitor/request/:id", async (request, reply) => {
+        const { id } = request.params;
+        const req = tracker.getRequestById(id);
+        if (!req)
+            return reply.status(HTTP_NOT_FOUND).send({ error: "Not found" });
+        return req;
+    });
     done();
 };

package/dist/admin/routes.js

@@ -13,6 +13,7 @@ import { adminMonitorRoutes } from "./monitor.js";
 import { adminSettingsRoutes } from "./settings.js";
 import { adminRecommendedRoutes } from "./recommended.js";
 import { adminUsageRoutes } from "./usage.js";
+import { adminImportExportRoutes } from "./settings-import-export.js";
 export const adminRoutes = (app, options, done) => {
     // Setup 路由不需要 auth
     app.register(adminSetupRoutes, { db: options.db });
@@ -29,6 +30,7 @@ export const adminRoutes = (app, options, done) => {
     app.register(adminProxyEnhancementRoutes, { db: options.db });
     app.register(adminMonitorRoutes, { tracker: options.tracker });
     app.register(adminSettingsRoutes, { db: options.db });
+    app.register(adminImportExportRoutes, { db: options.db, matcher: options.matcher, semaphoreManager: options.semaphoreManager });
     app.register(adminRecommendedRoutes, { db: options.db });
     app.register(adminUsageRoutes, { db: options.db });
     done();

package/dist/admin/settings-import-export.d.ts

@@ -0,0 +1,11 @@
+import { FastifyPluginCallback } from "fastify";
+import Database from "better-sqlite3";
+import { RetryRuleMatcher } from "../proxy/retry-rules.js";
+import { ProviderSemaphoreManager } from "../proxy/semaphore.js";
+interface ImportExportOptions {
+    db: Database.Database;
+    matcher: RetryRuleMatcher | null;
+    semaphoreManager?: ProviderSemaphoreManager;
+}
+export declare const adminImportExportRoutes: FastifyPluginCallback<ImportExportOptions>;
+export {};

package/dist/admin/settings-import-export.js

@@ -0,0 +1,144 @@
+import { createHash } from "crypto";
+import { getAllProviders, PROVIDER_CONCURRENCY_DEFAULTS } from "../db/index.js";
+import { encrypt, decrypt } from "../utils/crypto.js";
+import { getSetting } from "../db/settings.js";
+import { modelState } from "../proxy/model-state.js";
+const CONFIG_TABLES = [
+    "providers",
+    "mapping_groups",
+    "retry_rules",
+    "router_keys",
+    "settings",
+    "session_model_states",
+];
+// settings 表按 key 列的值过滤，不覆盖本地安全敏感配置
+const PROTECTED_SETTING_KEYS = new Set(["admin_password_hash", "jwt_secret", "encryption_key"]);
+const EXPORT_VERSION = 1;
+const ISO_DATE_LENGTH = 10;
+const BAD_REQUEST = 400;
+const KEY_PREFIX_LENGTH = 8;
+export const adminImportExportRoutes = (app, options, done) => {
+    const { db, matcher, semaphoreManager } = options;
+    app.get("/admin/api/settings/export", async (_request, reply) => {
+        const encryptionKey = getSetting(db, "encryption_key");
+        const data = {};
+        for (const table of CONFIG_TABLES) {
+            data[table] = db.prepare(`SELECT * FROM ${table}`).all();
+        }
+        // 导出时解密敏感字段，确保跨实例可移植
+        if (encryptionKey) {
+            for (const row of (data.providers || [])) {
+                if (typeof row.api_key === "string" && row.api_key) {
+                    try {
+                        row.api_key = decrypt(row.api_key, encryptionKey);
+                    }
+                    catch { /* eslint-disable-line taste/no-silent-catch -- 无法解密则保留原值 */ }
+                }
+            }
+            for (const row of (data.router_keys || [])) {
+                if (typeof row.key_encrypted === "string") {
+                    try {
+                        row.key = decrypt(row.key_encrypted, encryptionKey);
+                        delete row.key_encrypted;
+                        delete row.key_hash;
+                        delete row.key_prefix;
+                    }
+                    catch { /* eslint-disable-line taste/no-silent-catch -- 无法解密则保留加密数据 */ }
+                }
+            }
+        }
+        const date = new Date().toISOString().slice(0, ISO_DATE_LENGTH);
+        reply.header("Content-Disposition", `attachment; filename="router-config-${date}.json"`);
+        return reply.send({
+            version: EXPORT_VERSION,
+            exportedAt: new Date().toISOString(),
+            data,
+        });
+    });
+    app.post("/admin/api/settings/import", async (request, reply) => {
+        const body = request.body;
+        if (typeof body.version !== "number" || body.version !== EXPORT_VERSION) {
+            return reply.code(BAD_REQUEST).send({ error: { message: `Unsupported version. Expected ${EXPORT_VERSION}.` } });
+        }
+        if (!body.data || typeof body.data !== "object") {
+            return reply.code(BAD_REQUEST).send({ error: { message: "Missing or invalid data field" } });
+        }
+        const counts = {};
+        const importData = body.data;
+        const encryptionKey = getSetting(db, "encryption_key");
+        // 导入时用本地密钥重新加密敏感字段
+        if (encryptionKey) {
+            for (const row of (importData.providers || [])) {
+                if (typeof row.api_key === "string" && row.api_key) {
+                    row.api_key = encrypt(row.api_key, encryptionKey);
+                }
+            }
+            for (const row of (importData.router_keys || [])) {
+                if (typeof row.key === "string") {
+                    row.key_hash = createHash("sha256").update(row.key).digest("hex");
+                    row.key_prefix = row.key.slice(0, KEY_PREFIX_LENGTH);
+                    row.key_encrypted = encrypt(row.key, encryptionKey);
+                    delete row.key;
+                }
+            }
+        }
+        db.transaction(() => {
+            // 临时关闭外键检查，避免删除顺序导致约束冲突
+            const prevFk = db.pragma("foreign_keys", { simple: true });
+            db.pragma("foreign_keys = OFF");
+            // 导入前先备份受保护配置，导入后恢复
+            const protectedRows = db
+                .prepare(`SELECT * FROM settings WHERE key IN (${[...PROTECTED_SETTING_KEYS].map(() => "?").join(", ")})`)
+                .all(...PROTECTED_SETTING_KEYS);
+            for (const table of CONFIG_TABLES) {
+                const rows = importData[table];
+                if (!Array.isArray(rows))
+                    continue;
+                db.exec(`DELETE FROM ${table}`);
+                // 用 PRAGMA table_info 获取合法列名，防止用户 JSON 注入非法列
+                const validCols = new Set(db.prepare(`PRAGMA table_info(${table})`).all().map((c) => c.name));
+                for (const row of rows) {
+                    const entries = Object.entries(row).filter(([k]) => validCols.has(k));
+                    if (entries.length === 0)
+                        continue;
+                    if (table === "settings") {
+                        const keyValue = entries.find(([k]) => k === "key")?.[1];
+                        if (keyValue && PROTECTED_SETTING_KEYS.has(keyValue)) {
+                            continue;
+                        }
+                    }
+                    const cols = entries.map(([k]) => k).join(", ");
+                    const vals = entries.map(() => "?").join(", ");
+                    db.prepare(`INSERT INTO ${table} (${cols}) VALUES (${vals})`).run(...entries.map(([, v]) => v));
+                }
+                counts[table] = rows.length;
+            }
+            // 恢复受保护配置
+            const upsertStmt = db.prepare("INSERT OR REPLACE INTO settings (key, value) VALUES (?, ?)");
+            for (const row of protectedRows) {
+                upsertStmt.run(row.key, row.value);
+            }
+            // 恢复外键设置
+            db.pragma(`foreign_keys = ${prevFk}`);
+        })();
+        // 导入成功后刷新内存缓存
+        if (matcher)
+            matcher.load(db);
+        if (semaphoreManager) {
+            // 清除旧的 semaphore 配置，按导入后的 providers 表重建
+            semaphoreManager.removeAll();
+            const providers = getAllProviders(db);
+            for (const p of providers) {
+                semaphoreManager.updateConfig(p.id, {
+                    maxConcurrency: p.max_concurrency ?? PROVIDER_CONCURRENCY_DEFAULTS.max_concurrency,
+                    queueTimeoutMs: p.queue_timeout_ms ?? PROVIDER_CONCURRENCY_DEFAULTS.queue_timeout_ms,
+                    maxQueueSize: p.max_queue_size ?? PROVIDER_CONCURRENCY_DEFAULTS.max_queue_size,
+                });
+            }
+        }
+        // session_model_states 已通过 DB 导入，内存缓存会在读取时自然回填
+        modelState.clearAll();
+        return reply.send(counts);
+    });
+    done();
+};

package/dist/admin/settings.js

@@ -1,4 +1,4 @@
-import { getLogRetentionDays, setLogRetentionDays } from "../db/settings.js";
+import { getLogRetentionDays, setLogRetentionDays, getDbMaxSizeMb, setDbMaxSizeMb, getLogTableMaxSizeMb, setLogTableMaxSizeMb, getSetting, } from "../db/settings.js";
 export const adminSettingsRoutes = (app, options, done) => {
     const { db } = options;
     app.get("/admin/api/settings/log-retention", async () => {
@@ -6,11 +6,49 @@ export const adminSettingsRoutes = (app, options, done) => {
     });
     app.put("/admin/api/settings/log-retention", async (request) => {
         const { days } = request.body;
-        if (!Number.isInteger(days) || days < 0 || days > 90) {
+        const MAX_LOG_RETENTION_DAYS = 90;
+        if (!Number.isInteger(days) || days < 0 || days > MAX_LOG_RETENTION_DAYS) {
             throw { statusCode: 400, message: "days must be integer 0-90" };
         }
         setLogRetentionDays(db, days);
         return { days };
     });
+    app.get("/admin/api/settings/db-size", async () => {
+        const DEFAULT_SIZE_INFO = { totalBytes: 0, logTableBytes: 0, logCount: 0, lastChecked: null };
+        const raw = getSetting(db, "db_size_info");
+        let sizeInfo = DEFAULT_SIZE_INFO;
+        if (raw) {
+            try {
+                sizeInfo = JSON.parse(raw);
+            }
+            catch { /* eslint-disable-line taste/no-silent-catch -- 损坏的缓存值，回退默认 */ }
+        }
+        return {
+            ...sizeInfo,
+            thresholds: {
+                dbMaxSizeMb: getDbMaxSizeMb(db),
+                logTableMaxSizeMb: getLogTableMaxSizeMb(db),
+            },
+        };
+    });
+    app.put("/admin/api/settings/db-size-thresholds", async (request) => {
+        const body = request.body;
+        if (body.dbMaxSizeMb !== undefined) {
+            if (!Number.isFinite(body.dbMaxSizeMb) || body.dbMaxSizeMb < 1) {
+                throw { statusCode: 400, message: "dbMaxSizeMb must be a positive number" };
+            }
+            setDbMaxSizeMb(db, Math.round(body.dbMaxSizeMb));
+        }
+        if (body.logTableMaxSizeMb !== undefined) {
+            if (!Number.isFinite(body.logTableMaxSizeMb) || body.logTableMaxSizeMb < 1) {
+                throw { statusCode: 400, message: "logTableMaxSizeMb must be a positive number" };
+            }
+            setLogTableMaxSizeMb(db, Math.round(body.logTableMaxSizeMb));
+        }
+        return {
+            dbMaxSizeMb: getDbMaxSizeMb(db),
+            logTableMaxSizeMb: getLogTableMaxSizeMb(db),
+        };
+    });
     done();
 };

package/dist/db/db-size-monitor.d.ts

@@ -0,0 +1,22 @@
+import Database from "better-sqlite3";
+export interface DbSizeInfo {
+    totalBytes: number;
+    logTableBytes: number;
+    logCount: number;
+    lastChecked: string;
+}
+export interface SizeThresholds {
+    dbMaxSizeMb: number;
+    logTableMaxSizeMb: number;
+}
+export declare function collectDbSizeInfo(db: Database.Database, dbPath: string): DbSizeInfo;
+export declare function runSizeBasedCleanup(db: Database.Database, dbPath: string, thresholds: SizeThresholds): number;
+export interface DbSizeMonitorHandle {
+    stop: () => void;
+}
+export declare function scheduleDbSizeMonitor(db: Database.Database, dbPath: string, options: {
+    intervalMs?: number;
+    log: {
+        info: (msg: string) => void;
+    };
+}): DbSizeMonitorHandle;

package/dist/db/db-size-monitor.js

@@ -0,0 +1,81 @@
+import { statSync } from "fs";
+import { setSetting, getDbMaxSizeMb, getLogTableMaxSizeMb } from "./settings.js";
+import { estimateLogTableSize, deleteOldestLogs, getLogCount } from "./logs.js";
+const BYTES_PER_MB = 1_048_576;
+const DEFAULT_INTERVAL_MS = 1_800_000; // 30 分钟
+const CLEANUP_TARGET_RATIO = 0.8;
+const DEFAULT_ROW_BYTES = 500;
+export function collectDbSizeInfo(db, dbPath) {
+    let totalBytes = 0;
+    if (dbPath !== ":memory:") {
+        try {
+            totalBytes = statSync(dbPath).size;
+        }
+        catch { // eslint-disable-line taste/no-silent-catch -- DB 文件可能尚未创建（CI 内存测试、首次启动等）
+        }
+    }
+    const logTableBytes = estimateLogTableSize(db);
+    const logCount = getLogCount(db);
+    const info = {
+        totalBytes,
+        logTableBytes,
+        logCount,
+        lastChecked: new Date().toISOString(),
+    };
+    setSetting(db, "db_size_info", JSON.stringify(info));
+    return info;
+}
+export function runSizeBasedCleanup(db, dbPath, thresholds) {
+    const info = collectDbSizeInfo(db, dbPath);
+    const logOverThreshold = info.logTableBytes > thresholds.logTableMaxSizeMb * BYTES_PER_MB;
+    const dbOverThreshold = info.totalBytes > thresholds.dbMaxSizeMb * BYTES_PER_MB;
+    if (!logOverThreshold && !dbOverThreshold)
+        return 0;
+    const targetBytes = thresholds.logTableMaxSizeMb * BYTES_PER_MB * CLEANUP_TARGET_RATIO;
+    const avgRowBytes = info.logCount > 0 ? info.logTableBytes / info.logCount : DEFAULT_ROW_BYTES;
+    const keepCount = Math.max(0, Math.floor(targetBytes / avgRowBytes));
+    return deleteOldestLogs(db, keepCount);
+}
+export function scheduleDbSizeMonitor(db, dbPath, options) {
+    const intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+    let running = false;
+    let initialTimer = null;
+    let intervalTimer = null;
+    const doCheck = () => {
+        if (running)
+            return;
+        running = true;
+        try {
+            // 每次检查时从 DB 读取最新阈值，而非使用启动时的缓存值
+            const thresholds = {
+                dbMaxSizeMb: getDbMaxSizeMb(db),
+                logTableMaxSizeMb: getLogTableMaxSizeMb(db),
+            };
+            const deleted = runSizeBasedCleanup(db, dbPath, thresholds);
+            if (deleted > 0)
+                options.log.info(`Size-based cleanup: deleted ${deleted} log records`);
+        }
+        catch (e) {
+            // DB 可能已关闭（测试清理、进程关闭等）
+            options.log.info(`Size monitor check skipped: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        finally {
+            running = false;
+        }
+    };
+    // 推迟到下一个事件循环 tick，避免阻塞服务器启动（与 log-cleaner 保持一致）
+    initialTimer = setTimeout(doCheck, 0);
+    intervalTimer = setInterval(doCheck, intervalMs);
+    return {
+        stop: () => {
+            if (initialTimer) {
+                clearTimeout(initialTimer);
+                initialTimer = null;
+            }
+            if (intervalTimer) {
+                clearInterval(intervalTimer);
+                intervalTimer = null;
+            }
+        },
+    };
+}

package/dist/db/index.d.ts

@@ -6,7 +6,7 @@ export { getModelMapping, getAllModelMappings, createModelMapping, updateModelMa
 export type { ModelMapping, MappingGroup, ProviderModelEntry } from "./mappings.js";
 export { getActiveRetryRules, getAllRetryRules, createRetryRule, updateRetryRule, deleteRetryRule, } from "./retry-rules.js";
 export type { RetryRule } from "./retry-rules.js";
-export { insertRequestLog, getRequestLogs, getRequestLogById, deleteLogsBefore, getRequestLogChildren, getRequestLogsGrouped, updateLogMetrics, updateLogStreamContent, backfillMetricsFromRequestMetrics, } from "./logs.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";
 export { getRouterKeyByHash, getAllRouterKeys, getRouterKeyById, createRouterKey, updateRouterKey, deleteRouterKey, getAvailableModels, } from "./router-keys.js";
 export type { RouterKey } from "./router-keys.js";
@@ -15,7 +15,10 @@ export type { MetricsSummaryRow, MetricsTimeseriesRow, MetricsPeriod, MetricsMet
 export { getStats } from "./stats.js";
 export type { Stats, StatsPeriod } 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";
 export type { SessionModelState, SessionModelHistory, UpsertSessionStateInput, InsertSessionHistoryInput } from "./session-states.js";
 export { insertWindow, getLatestWindow, getWindowsInRange, getWindowUsage, } from "./usage-windows.js";
 export type { UsageWindow, WindowUsage } from "./usage-windows.js";
+export { collectDbSizeInfo, runSizeBasedCleanup, scheduleDbSizeMonitor, } from "./db-size-monitor.js";
+export type { DbSizeInfo, SizeThresholds, DbSizeMonitorHandle } from "./db-size-monitor.js";

package/dist/db/index.js

@@ -15,6 +15,7 @@ export function initDatabase(dbPath) {
     }
     const db = new Database(dbPath);
     db.pragma("journal_mode = WAL");
+    db.pragma("auto_vacuum = INCREMENTAL");
     db.pragma("foreign_keys = ON");
     db.exec(`
     CREATE TABLE IF NOT EXISTS migrations (
@@ -55,10 +56,12 @@ export function initDatabase(dbPath) {
 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, } from "./retry-rules.js";
-export { insertRequestLog, getRequestLogs, getRequestLogById, deleteLogsBefore, getRequestLogChildren, getRequestLogsGrouped, updateLogMetrics, updateLogStreamContent, backfillMetricsFromRequestMetrics, } from "./logs.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";
 export { getStats } 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";
 export { insertWindow, getLatestWindow, getWindowsInRange, getWindowUsage, } from "./usage-windows.js";
+export { collectDbSizeInfo, runSizeBasedCleanup, scheduleDbSizeMonitor, } from "./db-size-monitor.js";

package/dist/db/log-cleaner.js

@@ -13,7 +13,8 @@ export function runLogCleanup(db) {
 /** 启动定时清理，返回 handle 用于停止 */
 export function scheduleLogCleanup(db, log) {
     let cleaning = false;
-    let timer = null;
+    let initialTimer = null;
+    let intervalTimer = null;
     const doCleanup = () => {
         if (cleaning)
             return;
@@ -23,19 +24,27 @@ export function scheduleLogCleanup(db, log) {
             if (deleted > 0)
                 log.info(`Log cleanup: deleted ${deleted} records`);
         }
+        catch (e) {
+            // DB 可能已关闭（测试清理、进程关闭等）
+            log.info(`Log cleanup skipped: ${e instanceof Error ? e.message : String(e)}`);
+        }
         finally {
             cleaning = false;
         }
     };
-    // 启动时立即执行一次
-    doCleanup();
+    // 推迟到下一个事件循环 tick，避免阻塞服务器启动
+    initialTimer = setTimeout(doCleanup, 0);
     // 定时执行
-    timer = setInterval(doCleanup, CLEANUP_INTERVAL_MS);
+    intervalTimer = setInterval(doCleanup, CLEANUP_INTERVAL_MS);
     return {
         stop: () => {
-            if (timer) {
-                clearInterval(timer);
-                timer = null;
+            if (initialTimer) {
+                clearTimeout(initialTimer);
+                initialTimer = null;
+            }
+            if (intervalTimer) {
+                clearInterval(intervalTimer);
+                intervalTimer = null;
             }
         },
     };

package/dist/db/logs.d.ts

@@ -25,6 +25,7 @@ export interface RequestLog {
     backend_model: string | null;
     metrics_complete: number;
     stream_text_content: string | null;
+    session_id: string | null;
 }
 /** 列表查询扩展字段：JOIN providers 获得 provider_name */
 export interface RequestLogListRow extends RequestLog {
@@ -49,6 +50,7 @@ export interface RequestLogInsert {
     original_request_id?: string | null;
     router_key_id?: string | null;
     original_model?: string | null;
+    session_id?: string | null;
 }
 export declare function insertRequestLog(db: Database.Database, log: RequestLogInsert): void;
 export declare function getRequestLogs(db: Database.Database, options: {
@@ -64,7 +66,7 @@ export declare function getRequestLogs(db: Database.Database, options: {
     data: RequestLogListRow[];
     total: number;
 };
-export declare function getRequestLogById(db: Database.Database, id: string): RequestLog | undefined;
+export declare function getRequestLogById(db: Database.Database, id: string): RequestLogListRow | undefined;
 type MetricsUpdate = {
     input_tokens?: number | null;
     output_tokens?: number | null;
@@ -81,6 +83,12 @@ export declare function updateLogStreamContent(db: Database.Database, logId: str
 /** 启动时回填：从 request_metrics 补齐 metrics_complete = 0 但实际有指标的行 */
 export declare function backfillMetricsFromRequestMetrics(db: Database.Database): number;
 export declare function deleteLogsBefore(db: Database.Database, beforeDate: string): number;
+/** 估算 request_logs 表占用字节数 */
+export declare function estimateLogTableSize(db: Database.Database): number;
+/** 删除最旧的日志，保留 keepCount 条，返回实际删除条数。分批删除避免长时间锁表 */
+export declare function deleteOldestLogs(db: Database.Database, keepCount: number): number;
+/** 获取 request_logs 总行数 */
+export declare function getLogCount(db: Database.Database): number;
 /** 查询某条日志的子请求（retry/failover 关联），上限 100 条 */
 export declare function getRequestLogChildren(db: Database.Database, parentId: string): RequestLogListRow[];
 export interface RequestLogGroupedRow extends RequestLogListRow {