""" DeepSeek2API Neo Visualization — 基于 FastAPI 的 API 代理 + Material Design 3 仪表盘 统计:每日 token 消耗、请求次数、按模型分类、按账号分类 数据:SQLite (./data.db),仪表盘:./web/ 启动: python app_visualization.py """ import asyncio import json import logging import os import sqlite3 import threading import time from datetime import datetime, timedelta from pathlib import Path from fastapi import FastAPI, Request from fastapi.responses import HTMLResponse, JSONResponse, Response from fastapi.staticfiles import StaticFiles # --------------------------------------------------------------------------- # 导入原始 app — 包含所有 API 端点 # --------------------------------------------------------------------------- from app.main import app # noqa: E402 logging.basicConfig( level=logging.INFO, format="%(asctime)s [%(levelname)s] %(name)s: %(message)s", ) logger = logging.getLogger("app_visualization") logger.setLevel(logging.INFO) # --------------------------------------------------------------------------- # 路径常量 # --------------------------------------------------------------------------- DB_PATH = Path(os.getenv("DATA_DB_PATH", str(Path(__file__).parent / "data.db"))) WEB_DIR = Path(__file__).parent / "web" APP_HOST = os.getenv("HOST", "0.0.0.0") APP_PORT = int(os.getenv("PORT", os.getenv("APP_PORT", "5001"))) MODEL_DISPLAY_MAP = { "deepseek-v4-flash": "DeepSeek-V4-Flash", "deepseek-chat": "DeepSeek-V4-Flash", "deepseek-reasoner": "DeepSeek-V4-Flash", "deepseek-v4-pro": "DeepSeek-V4-Pro", "claude-sonnet-4-6": "DeepSeek-V4-Flash", "claude-opus-4-6": "DeepSeek-V4-Flash", "claude-haiku-4-5": "DeepSeek-V4-Flash", } TRACKED_ENDPOINTS = { "/v1/chat/completions", "/v1/messages", } # 活动连接计数(线程安全) _active_connections = 0 _active_lock = threading.Lock() def _inc_active(): global _active_connections with _active_lock: _active_connections += 1 def _dec_active(): global _active_connections with _active_lock: _active_connections -= 1 if _active_connections < 0: _active_connections = 0 # ============================================================================= # 数据库层 # ============================================================================= def get_db(): conn = sqlite3.connect(str(DB_PATH)) conn.row_factory = sqlite3.Row conn.execute("PRAGMA journal_mode=WAL") conn.execute("PRAGMA busy_timeout=3000") return conn def init_db(): conn = get_db() try: conn.executescript(""" CREATE TABLE IF NOT EXISTS usage_logs ( id INTEGER PRIMARY KEY AUTOINCREMENT, timestamp REAL NOT NULL, date TEXT NOT NULL, endpoint TEXT NOT NULL DEFAULT '', model TEXT NOT NULL DEFAULT 'unknown', model_display TEXT NOT NULL DEFAULT 'unknown', account_id TEXT NOT NULL DEFAULT '', api_key TEXT NOT NULL DEFAULT '', stream INTEGER NOT NULL DEFAULT 0, thinking_enabled INTEGER NOT NULL DEFAULT 0, request_count INTEGER NOT NULL DEFAULT 1, prompt_tokens INTEGER NOT NULL DEFAULT 0, completion_tokens INTEGER NOT NULL DEFAULT 0, total_tokens INTEGER NOT NULL DEFAULT 0 ); CREATE TABLE IF NOT EXISTS daily_summary ( date TEXT NOT NULL, model_display TEXT NOT NULL, request_count INTEGER NOT NULL DEFAULT 0, prompt_tokens INTEGER NOT NULL DEFAULT 0, completion_tokens INTEGER NOT NULL DEFAULT 0, total_tokens INTEGER NOT NULL DEFAULT 0, PRIMARY KEY (date, model_display) ); CREATE TABLE IF NOT EXISTS account_summary ( account_id TEXT NOT NULL, date TEXT NOT NULL, model_display TEXT NOT NULL, request_count INTEGER NOT NULL DEFAULT 0, prompt_tokens INTEGER NOT NULL DEFAULT 0, completion_tokens INTEGER NOT NULL DEFAULT 0, total_tokens INTEGER NOT NULL DEFAULT 0, PRIMARY KEY (account_id, date, model_display) ); CREATE INDEX IF NOT EXISTS idx_logs_date ON usage_logs(date); CREATE INDEX IF NOT EXISTS idx_logs_model ON usage_logs(model_display); CREATE INDEX IF NOT EXISTS idx_logs_account ON usage_logs(account_id); CREATE INDEX IF NOT EXISTS idx_daily_date ON daily_summary(date); CREATE INDEX IF NOT EXISTS idx_acct_date ON account_summary(date); """) # Migrate account_summary if old schema (missing prompt/completion cols) try: conn.execute("ALTER TABLE account_summary ADD COLUMN prompt_tokens INTEGER NOT NULL DEFAULT 0") except Exception: pass try: conn.execute("ALTER TABLE account_summary ADD COLUMN completion_tokens INTEGER NOT NULL DEFAULT 0") except Exception: pass conn.commit() logger.info("[init_db] SQLite 数据库初始化完成") finally: conn.close() def get_display_model(model_name: str) -> str: base = model_name.lower().strip() if base.endswith("-search"): base = base[:-7] return MODEL_DISPLAY_MAP.get(base, model_name or "unknown") def record_usage(ts, date, endpoint, model, account_id, api_key, stream, thinking, prompt, completion, total): display = get_display_model(model) conn = get_db() try: conn.execute( """INSERT INTO usage_logs (timestamp, date, endpoint, model, model_display, account_id, api_key, stream, thinking_enabled, request_count, prompt_tokens, completion_tokens, total_tokens) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?)""", (ts, date, endpoint, model, display, account_id, api_key, 1 if stream else 0, 1 if thinking else 0, prompt, completion, total), ) conn.execute( """INSERT INTO daily_summary (date, model_display, request_count, prompt_tokens, completion_tokens, total_tokens) VALUES (?, ?, 1, ?, ?, ?) ON CONFLICT(date, model_display) DO UPDATE SET request_count = request_count + 1, prompt_tokens = prompt_tokens + excluded.prompt_tokens, completion_tokens = completion_tokens + excluded.completion_tokens, total_tokens = total_tokens + excluded.total_tokens""", (date, display, prompt, completion, total), ) if account_id: conn.execute( """INSERT INTO account_summary (account_id, date, model_display, request_count, prompt_tokens, completion_tokens, total_tokens) VALUES (?, ?, ?, 1, ?, ?, ?) ON CONFLICT(account_id, date, model_display) DO UPDATE SET request_count = request_count + 1, prompt_tokens = prompt_tokens + excluded.prompt_tokens, completion_tokens = completion_tokens + excluded.completion_tokens, total_tokens = total_tokens + excluded.total_tokens""", (account_id, date, display, prompt, completion, total), ) conn.commit() except Exception as e: logger.error(f"[record_usage] 写入失败: {e}") finally: conn.close() # ============================================================================= # 统计中间件(纯 ASGI,避免 BaseHTTPMiddleware 与流式响应的冲突) # ============================================================================= class StatsASGIMiddleware: """在 ASGI 层面捕获请求/响应信息,记录统计到 SQLite""" def __init__(self, app): self.app = app async def __call__(self, scope, receive, send): if scope["type"] != "http" or scope["path"] not in TRACKED_ENDPOINTS: await self.app(scope, receive, send) return _inc_active() try: # 1) 从 ASGI receive 完整读取请求体 body_chunks = [] more_body = True while more_body: msg = await receive() body = msg.get("body", b"") if body: body_chunks.append(body) more_body = msg.get("more_body", False) body_bytes = b"".join(body_chunks) # 2) 解析请求参数 start_ts = time.time() date_str = datetime.now().strftime("%Y-%m-%d") model = "unknown" stream = False thinking = True prompt_est = 0 if body_bytes: try: data = json.loads(body_bytes) model = data.get("model", "unknown") stream = bool(data.get("stream", False)) t_obj = data.get("thinking") if isinstance(t_obj, dict): thinking = t_obj.get("type") == "enabled" elif isinstance(t_obj, bool): thinking = t_obj else: thinking = data.get("thinking_enabled", True) msgs = data.get("messages", []) sys_ = data.get("system", "") prompt_est = len(sys_ + json.dumps(msgs, ensure_ascii=False)) // 4 except Exception: pass # 3) 构造 wrapped_receive:首次返回缓存 body,后续透传(断连检测) body_consumed = False async def wrapped_receive(): nonlocal body_consumed if not body_consumed: body_consumed = True return {"type": "http.request", "body": body_bytes, "more_body": False} return await receive() # 4) 始终拦截 response body 以提取 token(流式 SSE 也包含最后一条 usage 信息) response_body = bytearray() async def wrapped_send(message): if message["type"] == "http.response.body": response_body.extend(message.get("body", b"")) await send(message) # 5) 执行下游(始终使用 wrapped_send 捕获所有 body) await self.app(scope, wrapped_receive, wrapped_send) # 6) 提取账号(由 determine_mode_and_token 注入到 request.state,通过 scope["state"]) account_id = "" try: state = scope.get("state", {}) acc = state.get("account") if acc and isinstance(acc, dict): account_id = acc.get("email") or acc.get("mobile") or "" except Exception: pass # 7) 从响应体中解析 token 用量 completion = 0 total = prompt_est if response_body: body_text = bytes(response_body).decode("utf-8", errors="replace") if stream: # SSE 流式:逐行查找包含 "usage" 的 data: 行 for line in body_text.split("\n"): line = line.strip() if line.startswith("data:") and '"usage"' in line: try: data_str = line[5:].strip() if data_str == "[DONE]": continue chunk = json.loads(data_str) usage = chunk.get("usage", {}) if usage: prompt_est = usage.get("prompt_tokens", prompt_est) completion = usage.get("completion_tokens", 0) total = usage.get("total_tokens", prompt_est + completion) except Exception: pass else: # 非流式:直接解析 JSON try: resp_data = json.loads(body_text) usage = resp_data.get("usage", {}) if usage: prompt_est = usage.get("prompt_tokens", prompt_est) completion = usage.get("completion_tokens", 0) total = usage.get("total_tokens", prompt_est + completion) except Exception: pass # 8) 写入统计 try: record_usage(start_ts, date_str, scope["path"], model, account_id, "", stream, thinking, prompt_est, completion, total) except Exception as e: logger.error(f"[StatsASGIMiddleware] record_usage 异常: {e}") finally: _dec_active() # 将 ASGI 中间件添加到原始 app app.add_middleware(StatsASGIMiddleware) # 静态文件服务(仪表盘 CSS/JS) if WEB_DIR.is_dir(): app.mount("/dashboard-assets", StaticFiles(directory=str(WEB_DIR)), name="dashboard_assets") # ============================================================================= # 仪表盘页面 # ============================================================================= @app.get("/dashboard") async def dashboard_page(): html_path = WEB_DIR / "index.html" if html_path.exists(): return HTMLResponse(html_path.read_text(encoding="utf-8")) return HTMLResponse("

仪表盘未找到

", status_code=404) # ============================================================================= # 统计 API # ============================================================================= def _query(conn, sql, params=()): return [dict(r) for r in conn.execute(sql, params).fetchall()] @app.get("/api/stats/overview") async def stats_overview(days: int = 0): conn = get_db() try: if days <= 0: today = datetime.now().strftime("%Y-%m-%d") row = conn.execute( "SELECT COALESCE(SUM(request_count),0) AS total_requests, " "COALESCE(SUM(total_tokens),0) AS total_tokens " "FROM daily_summary WHERE date = ?", (today,) ).fetchone() else: start = (datetime.now() - timedelta(days=days - 1)).strftime("%Y-%m-%d") row = conn.execute( "SELECT COALESCE(SUM(request_count),0) AS total_requests, " "COALESCE(SUM(total_tokens),0) AS total_tokens " "FROM daily_summary WHERE date >= ?", (start,) ).fetchone() return JSONResponse(dict(row)) finally: conn.close() @app.get("/api/stats/models") async def stats_models(days: int = 0): conn = get_db() try: if days <= 0: today = datetime.now().strftime("%Y-%m-%d") rows = _query(conn, "SELECT model_display, SUM(request_count) AS request_count, " "SUM(total_tokens) AS total_tokens, SUM(prompt_tokens) AS prompt_tokens, " "SUM(completion_tokens) AS completion_tokens " "FROM daily_summary WHERE date = ? GROUP BY model_display", (today,)) else: start = (datetime.now() - timedelta(days=days - 1)).strftime("%Y-%m-%d") rows = _query(conn, "SELECT model_display, SUM(request_count) AS request_count, " "SUM(total_tokens) AS total_tokens, SUM(prompt_tokens) AS prompt_tokens, " "SUM(completion_tokens) AS completion_tokens " "FROM daily_summary WHERE date >= ? GROUP BY model_display", (start,)) return JSONResponse(rows) finally: conn.close() @app.get("/api/stats/daily") async def stats_daily(days: int = 30): conn = get_db() try: start = (datetime.now() - timedelta(days=days - 1)).strftime("%Y-%m-%d") rows = _query(conn, "SELECT date, model_display, SUM(request_count) AS request_count, " "SUM(total_tokens) AS total_tokens, " "SUM(prompt_tokens) AS prompt_tokens, " "SUM(completion_tokens) AS completion_tokens " "FROM daily_summary WHERE date >= ? " "GROUP BY date, model_display ORDER BY date ASC", (start,)) return JSONResponse(rows) finally: conn.close() @app.get("/api/stats/accounts") async def stats_accounts(days: int = 0): conn = get_db() try: if days <= 0: today = datetime.now().strftime("%Y-%m-%d") rows = _query(conn, "SELECT account_id, model_display, SUM(request_count) AS request_count, " "SUM(prompt_tokens) AS prompt_tokens, " "SUM(completion_tokens) AS completion_tokens, " "SUM(total_tokens) AS total_tokens " "FROM account_summary WHERE date = ? " "GROUP BY account_id, model_display ORDER BY account_id, model_display", (today,)) else: start = (datetime.now() - timedelta(days=days - 1)).strftime("%Y-%m-%d") rows = _query(conn, "SELECT account_id, model_display, SUM(request_count) AS request_count, " "SUM(prompt_tokens) AS prompt_tokens, " "SUM(completion_tokens) AS completion_tokens, " "SUM(total_tokens) AS total_tokens " "FROM account_summary WHERE date >= ? " "GROUP BY account_id, model_display ORDER BY account_id, model_display", (start,)) return JSONResponse(rows) finally: conn.close() @app.get("/api/stats/accounts/aggregate") async def stats_accounts_aggregate(days: int = 0): conn = get_db() try: if days <= 0: today = datetime.now().strftime("%Y-%m-%d") rows = _query(conn, "SELECT account_id, SUM(request_count) AS request_count, " "SUM(prompt_tokens) AS prompt_tokens, " "SUM(completion_tokens) AS completion_tokens, " "SUM(total_tokens) AS total_tokens " "FROM account_summary WHERE date = ? " "GROUP BY account_id ORDER BY total_tokens DESC", (today,)) else: start = (datetime.now() - timedelta(days=days - 1)).strftime("%Y-%m-%d") rows = _query(conn, "SELECT account_id, SUM(request_count) AS request_count, " "SUM(prompt_tokens) AS prompt_tokens, " "SUM(completion_tokens) AS completion_tokens, " "SUM(total_tokens) AS total_tokens " "FROM account_summary WHERE date >= ? " "GROUP BY account_id ORDER BY total_tokens DESC", (start,)) return JSONResponse(rows) finally: conn.close() @app.get("/api/stats/recent") async def stats_recent(limit: int = 20): conn = get_db() try: rows = _query(conn, "SELECT timestamp, date, endpoint, model_display, account_id, " "stream, thinking_enabled, prompt_tokens, completion_tokens, total_tokens " "FROM usage_logs ORDER BY id DESC LIMIT ?", (limit,)) return JSONResponse(rows) finally: conn.close() @app.get("/api/stats/active") async def stats_active(): return JSONResponse({"active_connections": _active_connections}) # ============================================================================= # 启动 # ============================================================================= @app.on_event("startup") async def on_startup(): init_db() logger.info("仪表盘就绪 → http://%s:%s/dashboard", APP_HOST, APP_PORT) if __name__ == "__main__": import uvicorn uvicorn.run(app, host=APP_HOST, port=APP_PORT)