llm-simple-router 0.5.1 → 0.5.4

package/config/recommended-providers.json

@@ -0,0 +1,291 @@
+[
+  {
+    "group": "DeepSeek",
+    "presets": [
+      {
+        "plan": "Anthropic",
+        "presetName": "deepseek",
+        "apiType": "anthropic",
+        "baseUrl": "https://api.deepseek.com/anthropic",
+        "models": ["deepseek-chat", "deepseek-reasoner"]
+      },
+      {
+        "plan": "OpenAI",
+        "presetName": "deepseek-openai",
+        "apiType": "openai",
+        "baseUrl": "https://api.deepseek.com",
+        "models": ["deepseek-chat", "deepseek-reasoner"]
+      }
+    ]
+  },
+  {
+    "group": "百度千帆",
+    "presets": [
+      {
+        "plan": "API",
+        "presetName": "qianfan",
+        "apiType": "openai",
+        "baseUrl": "https://qianfan.baidubce.com/v2",
+        "models": [
+          "ernie-4.0-8k",
+          "ernie-4.0-turbo-8k",
+          "ernie-3.5-8k",
+          "ernie-speed-8k",
+          "ernie-lite-8k",
+          "ernie-x1-32k-preview",
+          "deepseek-v3",
+          "deepseek-r1"
+        ]
+      }
+    ]
+  },
+  {
+    "group": "科大讯飞",
+    "presets": [
+      {
+        "plan": "API",
+        "presetName": "iflytek-spark",
+        "apiType": "openai",
+        "baseUrl": "https://spark-api-open.xf-yun.com/v1",
+        "models": [
+          "4.0Ultra",
+          "generalv3.5",
+          "max-32k",
+          "generalv3",
+          "pro-128k",
+          "lite"
+        ]
+      }
+    ]
+  },
+  {
+    "group": "硅基流动",
+    "presets": [
+      {
+        "plan": "API",
+        "presetName": "siliconflow",
+        "apiType": "openai",
+        "baseUrl": "https://api.siliconflow.cn/v1",
+        "models": [
+          "deepseek-ai/DeepSeek-V3.2-Exp",
+          "deepseek-ai/DeepSeek-R1",
+          "Qwen/Qwen3-8B",
+          "Qwen/Qwen2.5-72B-Instruct",
+          "Qwen/Qwen2.5-Coder-32B-Instruct",
+          "moonshotai/Kimi-K2-Instruct",
+          "moonshotai/Kimi-K2.5"
+        ]
+      }
+    ]
+  },
+  {
+    "group": "智谱",
+    "presets": [
+      {
+        "plan": "Coding Plan",
+        "presetName": "zhipu-coding-plan",
+        "apiType": "anthropic",
+        "baseUrl": "https://open.bigmodel.cn/api/anthropic",
+        "models": ["glm-5.1", "glm-5", "glm-4.7", "glm-4.5-air"]
+      },
+      {
+        "plan": "API",
+        "presetName": "zhipu",
+        "apiType": "openai",
+        "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
+        "models": [
+          "glm-5.1",
+          "glm-5",
+          "glm-5-turbo",
+          "glm-4.7",
+          "glm-4.7-flash",
+          "glm-4.6"
+        ]
+      }
+    ]
+  },
+  {
+    "group": "KIMI",
+    "presets": [
+      {
+        "plan": "Coding Plan",
+        "presetName": "kimi-coding-plan",
+        "apiType": "anthropic",
+        "baseUrl": "https://api.kimi.com/coding",
+        "models": ["kimi-for-coding", "kimi-k2.5"]
+      },
+      {
+        "plan": "API",
+        "presetName": "kimi",
+        "apiType": "openai",
+        "baseUrl": "https://api.moonshot.cn",
+        "models": [
+          "kimi-k2.6",
+          "kimi-k2.5",
+          "kimi-k2-turbo-preview",
+          "kimi-k2-thinking",
+          "moonshot-v1-128k"
+        ]
+      }
+    ]
+  },
+  {
+    "group": "Minimax",
+    "presets": [
+      {
+        "plan": "Token Plan",
+        "presetName": "minimax-token-plan",
+        "apiType": "anthropic",
+        "baseUrl": "https://api.minimaxi.com/anthropic",
+        "models": ["MiniMax-M2.7"]
+      },
+      {
+        "plan": "API",
+        "presetName": "minimax",
+        "apiType": "openai",
+        "baseUrl": "https://api.minimax.chat",
+        "models": [
+          "MiniMax-M2.7",
+          "MiniMax-M2.7-highspeed",
+          "MiniMax-M2.5",
+          "MiniMax-M2.5-highspeed",
+          "MiniMax-M2.1",
+          "MiniMax-M2"
+        ]
+      }
+    ]
+  },
+  {
+    "group": "火山引擎",
+    "presets": [
+      {
+        "plan": "Coding Plan",
+        "presetName": "volcengine-coding-plan",
+        "apiType": "anthropic",
+        "baseUrl": "https://ark.cn-beijing.volces.com/api/compatible",
+        "models": [
+          "ark-code-latest",
+          "doubao-seed-2.0-code",
+          "kimi-k2.5",
+          "glm-4.7",
+          "deepseek-v3.2"
+        ]
+      },
+      {
+        "plan": "API",
+        "presetName": "volcengine",
+        "apiType": "openai",
+        "baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
+        "models": [
+          "doubao-seed-2-0-pro-260215",
+          "doubao-seed-1-8-251228",
+          "doubao-seed-code-preview-251028"
+        ]
+      }
+    ]
+  },
+  {
+    "group": "阿里云",
+    "presets": [
+      {
+        "plan": "Coding Plan",
+        "presetName": "aliyun-coding-plan",
+        "apiType": "anthropic",
+        "baseUrl": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
+        "models": [
+          "qwen3.6-plus",
+          "qwen3-coder-next",
+          "qwen3-coder-plus",
+          "kimi-k2.5",
+          "glm-5",
+          "MiniMax-M2.5"
+        ]
+      },
+      {
+        "plan": "API",
+        "presetName": "aliyun",
+        "apiType": "openai",
+        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode",
+        "models": [
+          "qwen3.6-plus",
+          "qwen3.5-plus",
+          "qwen3-max",
+          "qwen3.5-flash",
+          "qwen3-coder-plus",
+          "qwen3-coder-next"
+        ]
+      }
+    ]
+  },
+  {
+    "group": "腾讯云",
+    "presets": [
+      {
+        "plan": "Coding Plan",
+        "presetName": "tencent-coding-plan",
+        "apiType": "anthropic",
+        "baseUrl": "https://api.lkeap.cloud.tencent.com/coding/anthropic",
+        "models": [
+          "tc-code-latest",
+          "hunyuan-2.0-instruct",
+          "hunyuan-2.0-thinking",
+          "hunyuan-turbos",
+          "hunyuan-t1",
+          "glm-5",
+          "kimi-k2.5"
+        ]
+      },
+      {
+        "plan": "API",
+        "presetName": "tencent",
+        "apiType": "openai",
+        "baseUrl": "https://api.hunyuan.cloud.tencent.com",
+        "models": [
+          "hunyuan-2.0-thinking",
+          "hunyuan-2.0-instruct",
+          "hunyuan-t1-latest",
+          "hunyuan-a13b",
+          "hunyuan-turbos-latest"
+        ]
+      }
+    ]
+  },
+  {
+    "group": "OpenCode Go",
+    "presets": [
+      {
+        "plan": "Go",
+        "presetName": "opencode-go-anthropic",
+        "apiType": "anthropic",
+        "baseUrl": "https://opencode.ai/zen/go/v1/messages",
+        "models": ["deepseek-v4-pro", "deepseek-v4-flash", "minimax-m2.7", "minimax-m2.5"]
+      }
+    ]
+  },
+  {
+    "group": "阶跃星辰",
+    "presets": [
+      {
+        "plan": "Step Plan",
+        "presetName": "stepfun-step-plan",
+        "apiType": "anthropic",
+        "baseUrl": "https://api.stepfun.com/step_plan",
+        "models": ["step-3.5-flash-2603", "step-3.5-flash"]
+      },
+      {
+        "plan": "API",
+        "presetName": "stepfun",
+        "apiType": "openai",
+        "baseUrl": "https://api.stepfun.com",
+        "models": [
+          "step-3.5-flash",
+          "step-3",
+          "step-2-mini",
+          "step-2-16k",
+          "step-1-8k",
+          "step-1-32k"
+        ]
+      }
+    ]
+  }
+]

package/config/recommended-retry-rules.json

@@ -0,0 +1,10 @@
+[
+  { "name": "429 Too Many Requests", "status_code": 429, "body_pattern": ".*", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
+  { "name": "503 Service Unavailable", "status_code": 503, "body_pattern": ".*", "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\"", "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\".*请稍后重试", "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\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
+  { "name": "ZAI 速率限制 (HTTP 200, code 1302)", "status_code": 200, "body_pattern": "\"error\".*\"code\"\\s*:\\s*\"1302\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
+  { "name": "ZAI SSE 错误 (HTTP 200, code 500)", "status_code": 200, "body_pattern": "\"error\".*\"code\"\\s*:\\s*\"500\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 },
+  { "name": "ZAI SSE 错误 (HTTP 200, code 1234)", "status_code": 200, "body_pattern": "\"error\".*\"code\"\\s*:\\s*\"1234\"", "retry_strategy": "exponential", "retry_delay_ms": 5000, "max_retries": 10, "max_delay_ms": 60000 }
+]

package/dist/admin/api-response.d.ts

@@ -0,0 +1,26 @@
+/** 统一信封格式 */
+export interface ApiResponse<T> {
+    code: number;
+    message: string;
+    data: T | null;
+}
+/** 错误码常量 — XXYYZ 格式：前两位=HTTP 类别，后三位=业务序号 */
+export declare const API_CODE: {
+    readonly SUCCESS: 0;
+    readonly BAD_REQUEST: 40001;
+    readonly VALIDATION_FAILED: 40002;
+    readonly INVALID_REGEX: 40003;
+    readonly WRONG_PASSWORD: 40101;
+    readonly TOKEN_INVALID: 40102;
+    readonly NOT_INITIALIZED: 40103;
+    readonly NOT_FOUND: 40401;
+    readonly CONFLICT_NAME: 40901;
+    readonly CONFLICT_REFERENCED: 40902;
+    readonly ALREADY_INITIALIZED: 40903;
+    readonly INTERNAL_ERROR: 50001;
+};
+export declare function statusToApiCode(status: number): number;
+/** 判断是否为 Admin API 路由（需要信封包装） */
+export declare function isAdminApiResponse(url: string, contentType?: string): boolean;
+/** 构造错误响应 */
+export declare function apiError(code: number, message: string): ApiResponse<null>;

package/dist/admin/api-response.js

@@ -0,0 +1,44 @@
+// src/admin/api-response.ts
+/** 错误码常量 — XXYYZ 格式：前两位=HTTP 类别，后三位=业务序号 */
+export const API_CODE = {
+    SUCCESS: 0,
+    BAD_REQUEST: 40001,
+    VALIDATION_FAILED: 40002,
+    INVALID_REGEX: 40003,
+    WRONG_PASSWORD: 40101,
+    TOKEN_INVALID: 40102,
+    NOT_INITIALIZED: 40103,
+    NOT_FOUND: 40401,
+    CONFLICT_NAME: 40901,
+    CONFLICT_REFERENCED: 40902,
+    ALREADY_INITIALIZED: 40903,
+    INTERNAL_ERROR: 50001,
+};
+/** HTTP status → 默认 API_CODE 映射（errorHandler 兜底用） */
+const STATUS_BAD_REQUEST = 400;
+const STATUS_UNAUTHORIZED = 401;
+const STATUS_NOT_FOUND = 404;
+const STATUS_CONFLICT = 409;
+export function statusToApiCode(status) {
+    if (status === STATUS_BAD_REQUEST)
+        return API_CODE.BAD_REQUEST;
+    if (status === STATUS_UNAUTHORIZED)
+        return API_CODE.TOKEN_INVALID;
+    if (status === STATUS_NOT_FOUND)
+        return API_CODE.NOT_FOUND;
+    if (status === STATUS_CONFLICT)
+        return API_CODE.CONFLICT_NAME;
+    return API_CODE.INTERNAL_ERROR;
+}
+/** 判断是否为 Admin API 路由（需要信封包装） */
+export function isAdminApiResponse(url, contentType) {
+    if (!url.startsWith('/admin/api/'))
+        return false;
+    if (contentType?.includes('text/event-stream'))
+        return false;
+    return true;
+}
+/** 构造错误响应 */
+export function apiError(code, message) {
+    return { code, message, data: null };
+}

package/dist/admin/constants.d.ts

@@ -1,3 +1 @@
-import type { FastifyReply } from "fastify";
 export { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_FORBIDDEN, HTTP_NOT_FOUND, HTTP_CONFLICT, HTTP_INTERNAL_ERROR, HTTP_BAD_GATEWAY, HTTP_SERVICE_UNAVAILABLE, } from "../constants.js";
-export declare function sendErrorResponse(reply: FastifyReply, statusCode: number, message: string): FastifyReply<import("fastify").RouteGenericInterface, import("fastify").RawServerDefault, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, unknown, import("fastify").FastifySchema, import("fastify").FastifyTypeProviderDefault, unknown>;

package/dist/admin/constants.js

@@ -1,5 +1,2 @@
 // HTTP 状态码统一从 src/constants.ts 导入，避免重复定义
 export { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_FORBIDDEN, HTTP_NOT_FOUND, HTTP_CONFLICT, HTTP_INTERNAL_ERROR, HTTP_BAD_GATEWAY, HTTP_SERVICE_UNAVAILABLE, } from "../constants.js";
-export function sendErrorResponse(reply, statusCode, message) {
-    return reply.code(statusCode).send({ error: { message } });
-}

package/dist/admin/groups.js

@@ -1,7 +1,8 @@
 import { Type } from "@sinclair/typebox";
 import { getAllMappingGroups, createMappingGroup, updateMappingGroup, deleteMappingGroup, getProviderById, getMappingGroupById, } from "../db/index.js";
 import { STRATEGY_NAMES } from "../proxy/strategy/types.js";
-import { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_CONFLICT } from "./constants.js";
+import { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_CONFLICT, HTTP_NOT_FOUND } from "./constants.js";
+import { API_CODE, apiError } from "./api-response.js";
 const MIN_FAILOVER_TARGETS = 2;
 const CreateGroupSchema = Type.Object({
     client_model: Type.String({ minLength: 1 }),
@@ -13,6 +14,23 @@ const UpdateGroupSchema = Type.Object({
     strategy: Type.Optional(Type.String({ minLength: 1 })),
     rule: Type.Optional(Type.String()),
 });
+function validateOverflow(db, target, label) {
+    const hasOverflowProvider = !!target.overflow_provider_id;
+    const hasOverflowModel = !!target.overflow_model;
+    if (hasOverflowProvider && !hasOverflowModel) {
+        return `${label}: overflow_provider_id requires overflow_model`;
+    }
+    if (hasOverflowModel && !hasOverflowProvider) {
+        return `${label}: overflow_model requires overflow_provider_id`;
+    }
+    if (hasOverflowProvider) {
+        const p = getProviderById(db, target.overflow_provider_id);
+        if (!p) {
+            return `${label}: overflow_provider_id '${target.overflow_provider_id}' not found`;
+        }
+    }
+    return undefined;
+}
 async function validateRule(db, strategy, ruleJson) {
     const VALID_STRATEGIES = new Set(Object.values(STRATEGY_NAMES));
     if (!VALID_STRATEGIES.has(strategy)) {
@@ -34,6 +52,9 @@ async function validateRule(db, strategy, ruleJson) {
         if (!defaultProvider) {
             return `provider_id '${r.default.provider_id}' not found`;
         }
+        const overflowErr = validateOverflow(db, r.default, "rule.default");
+        if (overflowErr)
+            return overflowErr;
         if (r.windows !== undefined && !Array.isArray(r.windows)) {
             return "rule.windows must be an array";
         }
@@ -47,6 +68,9 @@ async function validateRule(db, strategy, ruleJson) {
                 if (!p) {
                     return `window[${i}] provider_id '${w.target.provider_id}' not found`;
                 }
+                const wOverflowErr = validateOverflow(db, w.target, `window[${i}]`);
+                if (wOverflowErr)
+                    return wOverflowErr;
             }
         }
     }
@@ -68,6 +92,9 @@ async function validateRule(db, strategy, ruleJson) {
             if (!p) {
                 return `targets[${i}] provider_id '${t.provider_id}' not found`;
             }
+            const overflowErr = validateOverflow(db, t, `targets[${i}]`);
+            if (overflowErr)
+                return overflowErr;
         }
     }
     return undefined;
@@ -82,7 +109,7 @@ export const adminGroupRoutes = (app, options, done) => {
         const body = request.body;
         const validationError = await validateRule(db, body.strategy, body.rule);
         if (validationError) {
-            return reply.code(HTTP_BAD_REQUEST).send({ error: { message: validationError } });
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.BAD_REQUEST, validationError));
         }
         try {
             const id = createMappingGroup(db, {
@@ -94,7 +121,7 @@ export const adminGroupRoutes = (app, options, done) => {
         }
         catch (err) {
             if (err instanceof Error && err.message.includes("UNIQUE constraint")) {
-                return reply.code(HTTP_CONFLICT).send({ error: { message: "client_model already exists" } });
+                return reply.code(HTTP_CONFLICT).send(apiError(API_CODE.CONFLICT_NAME, "client_model already exists"));
             }
             throw err;
         }
@@ -113,7 +140,7 @@ export const adminGroupRoutes = (app, options, done) => {
         const ruleJson = body.rule ?? findGroupRule(db, id);
         const validationError = await validateRule(db, strategy, ruleJson);
         if (validationError) {
-            return reply.code(HTTP_BAD_REQUEST).send({ error: { message: validationError } });
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.BAD_REQUEST, validationError));
         }
         try {
             updateMappingGroup(db, id, fields);
@@ -121,16 +148,28 @@ export const adminGroupRoutes = (app, options, done) => {
         }
         catch (err) {
             if (err instanceof Error && err.message.includes("UNIQUE constraint")) {
-                return reply.code(HTTP_CONFLICT).send({ error: { message: "client_model already exists" } });
+                return reply.code(HTTP_CONFLICT).send(apiError(API_CODE.CONFLICT_NAME, "client_model already exists"));
             }
             throw err;
         }
     });
     app.delete("/admin/api/mapping-groups/:id", async (request, reply) => {
         const { id } = request.params;
+        const existing = getMappingGroupById(db, id);
+        if (!existing)
+            return reply.code(HTTP_NOT_FOUND).send(apiError(API_CODE.NOT_FOUND, "Mapping group not found"));
         deleteMappingGroup(db, id);
         return reply.send({ success: true });
     });
+    app.post("/admin/api/mapping-groups/:id/toggle", async (request, reply) => {
+        const { id } = request.params;
+        const existing = getMappingGroupById(db, id);
+        if (!existing)
+            return reply.code(HTTP_NOT_FOUND).send(apiError(API_CODE.NOT_FOUND, "Mapping group not found"));
+        const newActive = existing.is_active ? 0 : 1;
+        updateMappingGroup(db, id, { is_active: newActive });
+        return reply.send({ success: true, is_active: newActive });
+    });
     done();
 };
 function findGroupStrategy(db, id) {

package/dist/admin/logs.js

@@ -1,6 +1,7 @@
 import { Type } from "@sinclair/typebox";
 import { getRequestLogs, getRequestLogsGrouped, getRequestLogById, getRequestLogChildren, deleteLogsBefore } from "../db/index.js";
 import { HTTP_NOT_FOUND } from "./constants.js";
+import { API_CODE, apiError } from "./api-response.js";
 const LogQuerySchema = Type.Object({
     page: Type.Optional(Type.String()),
     limit: Type.Optional(Type.String()),
@@ -42,7 +43,7 @@ export const adminLogRoutes = (app, options, done) => {
         const params = request.params;
         const log = getRequestLogById(db, params.id);
         if (!log) {
-            return reply.code(HTTP_NOT_FOUND).send({ error: { message: "Log not found" } });
+            return reply.code(HTTP_NOT_FOUND).send(apiError(API_CODE.NOT_FOUND, "Log not found"));
         }
         return reply.send(log);
     });
@@ -50,7 +51,7 @@ export const adminLogRoutes = (app, options, done) => {
         const params = request.params;
         const parent = getRequestLogById(db, params.id);
         if (!parent) {
-            return reply.code(HTTP_NOT_FOUND).send({ error: { message: "Log not found" } });
+            return reply.code(HTTP_NOT_FOUND).send(apiError(API_CODE.NOT_FOUND, "Log not found"));
         }
         const rows = getRequestLogChildren(db, params.id);
         return reply.send(rows);

package/dist/admin/mappings.js

@@ -2,6 +2,7 @@ import { Type } from "@sinclair/typebox";
 import { getAllMappingGroups, createMappingGroup, updateMappingGroup, deleteMappingGroup, getProviderById, getMappingGroupById, getMappingGroup, } from "../db/index.js";
 import { STRATEGY_NAMES } from "../proxy/strategy/types.js";
 import { HTTP_BAD_REQUEST, HTTP_CREATED, HTTP_NOT_FOUND, HTTP_CONFLICT } from "./constants.js";
+import { API_CODE, apiError } from "./api-response.js";
 const CreateMappingSchema = Type.Object({
     client_model: Type.String({ minLength: 1 }),
     backend_model: Type.String({ minLength: 1 }),
@@ -46,7 +47,7 @@ export const adminMappingRoutes = (app, options, done) => {
         const body = request.body;
         const provider = getProviderById(db, body.provider_id);
         if (!provider) {
-            return reply.code(HTTP_BAD_REQUEST).send({ error: { message: "provider_id not found" } });
+            return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.NOT_FOUND, "provider_id not found"));
         }
         try {
             const id = createMappingGroup(db, {
@@ -61,7 +62,7 @@ export const adminMappingRoutes = (app, options, done) => {
         }
         catch (err) {
             if (err instanceof Error && err.message.includes("UNIQUE constraint")) {
-                return reply.code(HTTP_CONFLICT).send({ error: { message: "client_model already exists" } });
+                return reply.code(HTTP_CONFLICT).send(apiError(API_CODE.CONFLICT_NAME, "client_model already exists"));
             }
             throw err;
         }
@@ -70,7 +71,7 @@ export const adminMappingRoutes = (app, options, done) => {
         const { id } = request.params;
         const group = findGroupByIdOrClientModel(db, id);
         if (!group) {
-            return reply.code(HTTP_NOT_FOUND).send({ error: { message: "Mapping not found" } });
+            return reply.code(HTTP_NOT_FOUND).send(apiError(API_CODE.NOT_FOUND, "Mapping not found"));
         }
         const body = request.body;
         let rule;
@@ -86,7 +87,7 @@ export const adminMappingRoutes = (app, options, done) => {
         if (body.provider_id !== undefined) {
             const provider = getProviderById(db, body.provider_id);
             if (!provider) {
-                return reply.code(HTTP_BAD_REQUEST).send({ error: { message: "provider_id not found" } });
+                return reply.code(HTTP_BAD_REQUEST).send(apiError(API_CODE.NOT_FOUND, "provider_id not found"));
             }
             defaultTarget.provider_id = body.provider_id;
         }
@@ -102,7 +103,7 @@ export const adminMappingRoutes = (app, options, done) => {
         }
         catch (err) {
             if (err instanceof Error && err.message.includes("UNIQUE constraint")) {
-                return reply.code(HTTP_CONFLICT).send({ error: { message: "client_model already exists" } });
+                return reply.code(HTTP_CONFLICT).send(apiError(API_CODE.CONFLICT_NAME, "client_model already exists"));
             }
             throw err;
         }
@@ -111,7 +112,7 @@ export const adminMappingRoutes = (app, options, done) => {
         const { id } = request.params;
         const group = findGroupByIdOrClientModel(db, id);
         if (!group) {
-            return reply.code(HTTP_NOT_FOUND).send({ error: { message: "Mapping not found" } });
+            return reply.code(HTTP_NOT_FOUND).send(apiError(API_CODE.NOT_FOUND, "Mapping not found"));
         }
         deleteMappingGroup(db, group.id);
         return reply.send({ success: true });

package/dist/admin/metrics.js

@@ -1,9 +1,14 @@
 import { Type } from "@sinclair/typebox";
 import { getMetricsSummary, getMetricsTimeseries } from "../db/index.js";
-const PeriodEnum = Type.Union([
+import { resolveTimeRange } from "../utils/time-range.js";
+const LegacyPeriodEnum = Type.Union([
     Type.Literal("1h"), Type.Literal("5h"), Type.Literal("6h"), Type.Literal("24h"),
     Type.Literal("7d"), Type.Literal("30d"),
 ]);
+const DashboardPeriodEnum = Type.Union([
+    Type.Literal("window"), Type.Literal("weekly"), Type.Literal("monthly"),
+]);
+const PeriodEnum = Type.Union([LegacyPeriodEnum, DashboardPeriodEnum]);
 const MetricEnum = Type.Union([
     Type.Literal("ttft"), Type.Literal("tps"), Type.Literal("tokens"),
     Type.Literal("cache_rate"), Type.Literal("request_count"),
@@ -27,18 +32,31 @@ const TimeseriesQuerySchema = Type.Object({
     start_time: Type.Optional(Type.String()),
     end_time: Type.Optional(Type.String()),
 });
+const DASHBOARD_PERIODS = new Set(["window", "weekly", "monthly"]);
+function resolveMetricsTime(query, db, routerKeyId) {
+    if (query.start_time && query.end_time) {
+        return { startTime: query.start_time, endTime: query.end_time, legacyPeriod: "30d" };
+    }
+    const period = query.period ?? "weekly";
+    if (DASHBOARD_PERIODS.has(period)) {
+        const range = resolveTimeRange(period, db, routerKeyId);
+        return { startTime: range.startTime, endTime: range.endTime, legacyPeriod: "5h" };
+    }
+    return { legacyPeriod: period };
+}
 export const adminMetricsRoutes = (app, options, done) => {
+    const { db } = options;
     app.get("/admin/api/metrics/summary", { schema: { querystring: SummaryQuerySchema } }, async (request, reply) => {
         const query = request.query;
-        const period = (query.period ?? "24h");
-        const summary = getMetricsSummary(options.db, period, query.provider_id, query.backend_model, query.router_key_id, query.start_time, query.end_time);
+        const { startTime, endTime, legacyPeriod } = resolveMetricsTime(query, db, query.router_key_id);
+        const summary = getMetricsSummary(db, legacyPeriod, query.provider_id, query.backend_model, query.router_key_id, startTime, endTime);
         return reply.send(summary);
     });
     app.get("/admin/api/metrics/timeseries", { schema: { querystring: TimeseriesQuerySchema } }, async (request, reply) => {
         const query = request.query;
-        const period = (query.period ?? "24h");
         const metric = query.metric;
-        const timeseries = getMetricsTimeseries(options.db, period, metric, query.provider_id, query.backend_model, query.router_key_id, query.start_time, query.end_time);
+        const { startTime, endTime, legacyPeriod } = resolveMetricsTime(query, db, query.router_key_id);
+        const timeseries = getMetricsTimeseries(db, legacyPeriod, metric, query.provider_id, query.backend_model, query.router_key_id, startTime, endTime);
         return reply.send(timeseries);
     });
     done();

package/dist/admin/monitor.js

@@ -1,4 +1,5 @@
 import { HTTP_NOT_FOUND } from "./constants.js";
+import { API_CODE, apiError } from "./api-response.js";
 const HTTP_OK = 200;
 export const adminMonitorRoutes = (app, options, done) => {
     const { tracker } = options;
@@ -12,6 +13,8 @@ export const adminMonitorRoutes = (app, options, done) => {
     app.get("/admin/api/monitor/concurrency", async () => tracker.getConcurrency());
     app.get("/admin/api/monitor/runtime", async () => tracker.getRuntime());
     app.get("/admin/api/monitor/stream", (request, reply) => {
+        // hijack() 让 Fastify 完全放弃响应管理，避免 onSend hook 向 SSE 流注入信封 JSON
+        reply.hijack();
         reply.raw.writeHead(HTTP_OK, {
             "Content-Type": "text/event-stream",
             "Cache-Control": "no-cache",
@@ -26,7 +29,7 @@ export const adminMonitorRoutes = (app, options, done) => {
         const { id } = request.params;
         const req = tracker.getRequestById(id);
         if (!req)
-            return reply.status(HTTP_NOT_FOUND).send({ error: "Not found" });
+            return reply.code(HTTP_NOT_FOUND).send(apiError(API_CODE.NOT_FOUND, "Not found"));
         return req;
     });
     done();