protocol-proxy 2.7.0 → 2.8.1

package/lib/proxy-server.js

@@ -8,6 +8,7 @@ const a2g = require('./converters/anthropic-to-gemini');
 const g2a = require('./converters/gemini-to-anthropic');
 const { recordUsage } = require('./stats-store');
 const logger = require('./logger');
+const requestLog = require('./request-log');
 
 function createProxyApp(proxyConfigOrGetter) {
   const getProxyConfig = typeof proxyConfigOrGetter === 'function'
@@ -343,6 +344,7 @@ function createProxyApp(proxyConfigOrGetter) {
 
   async function handleRequest(req, res) {
     const requestId = `req-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+    const requestStart = Date.now();
     const proxyConfig = getProxyConfig();
     const inboundProtocol = detectInboundProtocol(req, req.body);
     const candidates = buildCandidates(proxyConfig);
@@ -353,6 +355,8 @@ function createProxyApp(proxyConfigOrGetter) {
 
     const isStream = req.body?.stream === true;
     const proxyId = proxyConfig.id || 'default';
+    const clientIP = req.ip || req.socket?.remoteAddress || '';
+    const proxyName = proxyConfig.name || '';
     const inboundModel = req.body?.model;
     const effectiveModel = proxyConfig.target?.defaultModel || inboundModel;
     const baseRequestBody = effectiveModel ? { ...req.body, model: effectiveModel } : { ...req.body };
@@ -448,6 +452,7 @@ function createProxyApp(proxyConfigOrGetter) {
 
       const maxKeyRetries = (candidate.apiKeys || []).filter(k => typeof k === 'object' ? k.enabled !== false : true).length || 1;
       let lastKeyError = null;
+      let keyLabel = '';
 
       for (let keyAttempt = 0; keyAttempt < maxKeyRetries; keyAttempt++) {
         const currentKey = selectKey(candidate.providerId, candidate.apiKeys || []);
@@ -493,7 +498,7 @@ function createProxyApp(proxyConfigOrGetter) {
         recordSuccess(proxyId, candidate.providerId, Date.now() - startedAt);
         const keyEntry = (candidate.apiKeys || []).find(k => (typeof k === 'string' ? k : k.key) === currentKey);
         const alias = keyEntry && typeof keyEntry === 'object' ? keyEntry.alias : '';
-        const keyLabel = alias ? `${alias}(…${currentKey.slice(-4)})` : (currentKey ? `…${currentKey.slice(-4)}` : '-');
+        keyLabel = alias ? `${alias}(…${currentKey.slice(-4)})` : (currentKey ? `…${currentKey.slice(-4)}` : '-');
         logger.log(`[${requestId}] ✓ ${candidate.providerName} | model=${candidateModel || '(default)'} key=${keyLabel} (${Date.now() - startedAt}ms)`);
 
         if (isStream) {
@@ -543,6 +548,18 @@ function createProxyApp(proxyConfigOrGetter) {
 
             if (streamUsage) {
               recordUsage(proxyConfig.id, candidate.providerName, candidateModel, streamUsage, false);
+              requestLog.add({
+                id: requestId, proxyId, proxyName, method: req.method, path: req.path,
+                inboundProtocol, targetProtocol: candidate.protocol,
+                providerName: candidate.providerName, model: candidateModel || '',
+                status: 'success', upstreamStatusCode: null,
+                latencyMs: Date.now() - startedAt,
+                promptTokens: streamUsage.prompt_tokens || streamUsage.input_tokens || 0,
+                completionTokens: streamUsage.completion_tokens || streamUsage.output_tokens || 0,
+                totalTokens: (streamUsage.prompt_tokens || streamUsage.input_tokens || 0)
+                           + (streamUsage.completion_tokens || streamUsage.output_tokens || 0),
+                isEstimated: false, stream: true, keyAlias: keyLabel, errorMessage: null, clientIP,
+              });
             } else if (responseText || toolCallCount > 0) {
               const inputTokens = estimateInputTokens(req.body);
               const outputTokens = estimateTokens(responseText) + toolCallCount * 15;
@@ -550,6 +567,16 @@ function createProxyApp(proxyConfigOrGetter) {
                 prompt_tokens: inputTokens,
                 completion_tokens: outputTokens,
               }, true);
+              requestLog.add({
+                id: requestId, proxyId, proxyName, method: req.method, path: req.path,
+                inboundProtocol, targetProtocol: candidate.protocol,
+                providerName: candidate.providerName, model: candidateModel || '',
+                status: 'success', upstreamStatusCode: null,
+                latencyMs: Date.now() - startedAt,
+                promptTokens: inputTokens, completionTokens: outputTokens,
+                totalTokens: inputTokens + outputTokens,
+                isEstimated: true, stream: true, keyAlias: keyLabel, errorMessage: null, clientIP,
+              });
             }
 
             if (sseConverter) {
@@ -559,6 +586,15 @@ function createProxyApp(proxyConfigOrGetter) {
           } catch (err) {
             recordFailure(proxyId, candidate.providerId);
             logger.error(`[${requestId}] Stream error:`, err.message);
+            requestLog.add({
+              id: requestId, proxyId, proxyName, method: req.method, path: req.path,
+              inboundProtocol, targetProtocol: candidate.protocol,
+              providerName: candidate.providerName, model: candidateModel || '',
+              status: 'failure', upstreamStatusCode: null,
+              latencyMs: Date.now() - startedAt,
+              promptTokens: 0, completionTokens: 0, totalTokens: 0, isEstimated: false,
+              stream: true, keyAlias: keyLabel, errorMessage: err.message, clientIP,
+            });
             if (!res.writableEnded) {
               try {
                 res.write(`data: ${JSON.stringify({ error: { message: err.message, type: 'proxy_error' } })}\n\n`);
@@ -574,6 +610,18 @@ function createProxyApp(proxyConfigOrGetter) {
         extractReasoningFromResponse(responseBody);
         extractAnthropicThinking(responseBody);
         recordUsage(proxyConfig.id, candidate.providerName, candidateModel, responseBody.usage);
+        requestLog.add({
+          id: requestId, proxyId, proxyName, method: req.method, path: req.path,
+          inboundProtocol, targetProtocol: candidate.protocol,
+          providerName: candidate.providerName, model: candidateModel || '',
+          status: 'success', upstreamStatusCode: fetchRes.status,
+          latencyMs: Date.now() - startedAt,
+          promptTokens: responseBody.usage?.prompt_tokens || responseBody.usage?.input_tokens || 0,
+          completionTokens: responseBody.usage?.completion_tokens || responseBody.usage?.output_tokens || 0,
+          totalTokens: (responseBody.usage?.prompt_tokens || responseBody.usage?.input_tokens || 0)
+                     + (responseBody.usage?.completion_tokens || responseBody.usage?.output_tokens || 0),
+          isEstimated: false, stream: false, keyAlias: keyLabel, errorMessage: null, clientIP,
+        });
         const convertedBody = convertRes(responseBody);
         return res.json(convertedBody);
       } catch (err) {
@@ -584,6 +632,15 @@ function createProxyApp(proxyConfigOrGetter) {
         }
         recordFailure(proxyId, candidate.providerId);
         logger.error(`[${requestId}] ✗ ${candidate.providerName} | model=${candidateModel || '(default)'} - ${err.message}`);
+        requestLog.add({
+          id: requestId, proxyId, proxyName, method: req.method, path: req.path,
+          inboundProtocol, targetProtocol: candidate.protocol,
+          providerName: candidate.providerName, model: candidateModel || '',
+          status: 'failure', upstreamStatusCode: err?.status || null,
+          latencyMs: Date.now() - startedAt,
+          promptTokens: 0, completionTokens: 0, totalTokens: 0, isEstimated: false,
+          stream: isStream, keyAlias: keyLabel, errorMessage: err.message, clientIP,
+        });
         if (err?.status && !isRetryableStatus(err.status)) {
           return res.status(err.status).json({ error: err.message });
         }
@@ -596,10 +653,27 @@ function createProxyApp(proxyConfigOrGetter) {
       if (lastKeyError) {
         recordFailure(proxyId, candidate.providerId);
         logger.error(`[${requestId}] ✗ ${candidate.providerName} | all keys rate-limited (429)`);
+        requestLog.add({
+          id: requestId, proxyId, proxyName, method: req.method, path: req.path,
+          inboundProtocol, targetProtocol: candidate.protocol,
+          providerName: candidate.providerName, model: candidateModel || '',
+          status: '429', upstreamStatusCode: 429,
+          latencyMs: Date.now() - startedAt,
+          promptTokens: 0, completionTokens: 0, totalTokens: 0, isEstimated: false,
+          stream: isStream, keyAlias: keyLabel, errorMessage: 'All keys rate-limited', clientIP,
+        });
       }
     } // end candidate loop
 
     logger.error(`[${requestId}] 所有供应商均失败`);
+    requestLog.add({
+      id: requestId, proxyId, proxyName, method: req.method, path: req.path,
+      inboundProtocol, targetProtocol: '', providerName: 'N/A', model: effectiveModel || '',
+      status: 'failure', upstreamStatusCode: null,
+      latencyMs: Date.now() - requestStart,
+      promptTokens: 0, completionTokens: 0, totalTokens: 0, isEstimated: false,
+      stream: isStream, keyAlias: '', errorMessage: 'All providers failed', clientIP,
+    });
     return res.status(502).json({ error: 'All providers failed' });
   }
 

package/lib/request-log.js

@@ -0,0 +1,27 @@
+const MAX_ENTRIES = 1000;
+
+const entries = [];
+let listener = null;
+
+function add(entry) {
+  entry.timestamp = entry.timestamp || new Date().toISOString();
+  entries.unshift(entry);
+  if (entries.length > MAX_ENTRIES) entries.pop();
+  if (listener) {
+    try { listener(entry); } catch { /* ignore */ }
+  }
+}
+
+function getAll(limit) {
+  return entries.slice(0, limit || MAX_ENTRIES);
+}
+
+function getCount() {
+  return entries.length;
+}
+
+function onEntry(callback) {
+  listener = callback;
+}
+
+module.exports = { add, getAll, getCount, onEntry, MAX_ENTRIES };

package/lib/stats-store.js

@@ -29,6 +29,7 @@ function addToBuffer(period, date, statsKey, prompt, completion, estimated) {
 function flush() {
   const stats = readStats();
   if (!dirty) return stats;
+  if (!stats.hourly) stats.hourly = {};
   if (!stats.daily) stats.daily = {};
   if (!stats.monthly) stats.monthly = {};
 
@@ -92,15 +93,31 @@ function yearKey(d) {
   return String(d.getFullYear());
 }
 
+function hourKey(d) {
+  return dateKey(d) + '-' + String(d.getHours()).padStart(2, '0');
+}
+
 // ==================== 分层合并 ====================
 
 function mergeIfNeeded() {
   const stats = flush();
   let changed = false;
 
+  const todayStr = dateKey(new Date());
   const currentMonth = monthKey(new Date()); // "2026-05"
   const currentYear = String(new Date().getFullYear());
 
+  // 小时级：清理昨天及更早的数据（daily 已有汇总，hourly 仅保留当天）
+  if (stats.hourly) {
+    const todayStart = todayStr + '-00';
+    for (const hk of Object.keys(stats.hourly)) {
+      if (hk < todayStart) {
+        delete stats.hourly[hk];
+        changed = true;
+      }
+    }
+  }
+
   // 日 → 月：非当月的日级数据合并为月级
   if (stats.daily) {
     const toMerge = {};
@@ -183,6 +200,7 @@ function recordUsage(proxyId, provider, model, usage, estimated = false) {
   if (!prompt && !completion) return;
 
   const now = new Date();
+  const hk = hourKey(now);
   const dk = dateKey(now);
   const mk = monthKey(now);
 
@@ -195,6 +213,7 @@ function recordUsage(proxyId, provider, model, usage, estimated = false) {
   ];
 
   for (const key of keys) {
+    addToBuffer('hourly', hk, key, prompt, completion, estimated);
     addToBuffer('daily', dk, key, prompt, completion, estimated);
   }
 }
@@ -208,9 +227,14 @@ function getStats(opts = {}) {
   const stats = readStats();
   const src = stats[range] || {};
 
+  // hourly keys are "YYYY-MM-DD-HH", need to pad day-level dates for comparison
+  const isHourly = range === 'hourly';
+  const filterStart = startDate ? (isHourly ? startDate + '-00' : startDate) : null;
+  const filterEnd = endDate ? (isHourly ? endDate + '-99' : endDate) : null;
+
   const dates = Object.keys(src).filter(d => {
-    if (startDate && d < startDate) return false;
-    if (endDate && d > endDate) return false;
+    if (filterStart && d < filterStart) return false;
+    if (filterEnd && d > filterEnd) return false;
     return true;
   }).sort();
 

package/lib/ws-server.js

@@ -0,0 +1,46 @@
+const logger = require('./logger');
+
+let wss = null;
+let WebSocketServer = null;
+
+function init(httpServer) {
+  try {
+    const ws = require('ws');
+    WebSocketServer = ws.WebSocketServer || ws.Server;
+    wss = new WebSocketServer({ server: httpServer });
+
+    wss.on('connection', (ws) => {
+      logger.log('[WS] Client connected');
+      try { ws.send(JSON.stringify({ type: 'connected', count: getClientCount() })); } catch { /* ignore */ }
+      ws.on('close', () => { logger.log('[WS] Client disconnected'); });
+    });
+
+    logger.log('[WS] WebSocket server initialized');
+  } catch (err) {
+    logger.error('[WS] Failed to initialize WebSocket server:', err.message);
+    wss = null;
+  }
+}
+
+function broadcast(data) {
+  if (!wss) return;
+  const msg = JSON.stringify(data);
+  for (const client of wss.clients) {
+    if (client.readyState === 1 /* OPEN */) {
+      try { client.send(msg); } catch { /* ignore */ }
+    }
+  }
+}
+
+function getClientCount() {
+  return wss ? wss.clients.size : 0;
+}
+
+function close() {
+  if (wss) {
+    try { wss.close(); } catch { /* ignore */ }
+    wss = null;
+  }
+}
+
+module.exports = { init, broadcast, getClientCount, close };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "protocol-proxy",
-  "version": "2.7.0",
+  "version": "2.8.1",
   "description": "OpenAI / Anthropic 协议转换透明代理",
   "main": "server.js",
   "bin": {
@@ -27,7 +27,8 @@
   },
   "dependencies": {
     "cors": "^2.8.5",
-    "express": "^4.19.2"
+    "express": "^4.19.2",
+    "ws": "^8.20.1"
   },
   "devDependencies": {
     "pkg": "^5.8.1"
@@ -48,4 +49,4 @@
   "engines": {
     "node": ">=20.0.0"
   }
-}
+}

package/public/app.js

@@ -6,6 +6,8 @@ let importData = null;
 let statsRange = 'daily';
 let statsProxyId = '';
 let providerPoolItems = [];
+let keyHealth = {};
+let statsAutoRefreshTimer = null;
 
 // ==================== 主题切换 ====================
 
@@ -81,6 +83,30 @@ function updateStats() {
     proxies.filter(p => p.running).length;
 }
 
+async function loadKeyHealth() {
+  try {
+    const res = await fetch('/api/key-health');
+    keyHealth = await res.json();
+    refreshHealthUI();
+  } catch (err) {
+    console.error('加载 Key 健康状态失败:', err);
+  }
+}
+
+function refreshHealthUI() {
+  // 更新每个代理卡片上的健康点
+  document.querySelectorAll('.health-dot[data-provider]').forEach(dot => {
+    const h = keyHealth[dot.dataset.provider];
+    dot.className = 'health-dot';
+    if (!h || h.status === 'unknown') { dot.classList.add('health-unknown'); dot.title = '未检测'; }
+    else if (h.status === 'healthy') { dot.classList.add('health-ok'); dot.title = 'Key 正常'; }
+    else if (h.status === 'partial') { dot.classList.add('health-warn'); dot.title = '部分 Key 异常'; }
+    else { dot.classList.add('health-error'); dot.title = 'Key 全部异常'; }
+  });
+  // 更新汇总卡片
+  renderProviderHealthSummary();
+}
+
 function parseProviderPool(value) {
   const text = (value || '').trim();
   if (!text) return [];
@@ -991,9 +1017,18 @@ function initStatsRangeBtns() {
       document.querySelectorAll('.stats-range-btn').forEach(b => b.classList.remove('active'));
       btn.classList.add('active');
       statsRange = btn.dataset.range;
-      // 清空日期选择器，显示全部数据
-      document.getElementById('stats-start-date').value = '';
-      document.getElementById('stats-end-date').value = '';
+      // 清除自动刷新
+      if (statsAutoRefreshTimer) { clearInterval(statsAutoRefreshTimer); statsAutoRefreshTimer = null; }
+      if (statsRange === 'hourly') {
+        // 实时模式：设为今天 + 30 秒自动刷新
+        const today = new Date().toISOString().slice(0, 10);
+        document.getElementById('stats-start-date').value = today;
+        document.getElementById('stats-end-date').value = today;
+        statsAutoRefreshTimer = setInterval(loadStats, 30000);
+      } else {
+        document.getElementById('stats-start-date').value = '';
+        document.getElementById('stats-end-date').value = '';
+      }
       loadStats();
     });
   });
@@ -1054,7 +1089,16 @@ function initProviderPoolDropdown() {
 }
 
 async function init() {
+  // 默认统计范围：当天（HTML 内联脚本已优先设置，此处兜底）
+  const today = new Date().toISOString().slice(0, 10);
+  const sd = document.getElementById('stats-start-date');
+  const ed = document.getElementById('stats-end-date');
+  if (!sd.value) sd.value = today;
+  if (!ed.value) ed.value = today;
   await Promise.all([loadProxies(), loadProviders(), loadStats()]);
+  // 延迟加载 health（等后端启动检测完成），之后每 5 分钟刷新
+  setTimeout(() => loadKeyHealth(), 6000);
+  setInterval(() => loadKeyHealth(), 5 * 60 * 1000);
   renderProxies();
   initProviderDropdown();
   initModelDropdown();
@@ -1087,6 +1131,7 @@ async function init() {
       if (document.getElementById('confirm-modal').classList.contains('active')) return;
       if (document.getElementById('log-modal').classList.contains('active')) { closeLogViewer(); return; }
       if (document.getElementById('history-modal').classList.contains('active')) { closeHistoryViewer(); return; }
+      if (document.getElementById('request-log-modal').classList.contains('active')) { closeRequestLog(); return; }
       if (document.getElementById('test-result-modal').classList.contains('active')) { document.getElementById('test-result-modal').classList.remove('active'); return; }
       if (document.getElementById('import-modal').classList.contains('active')) { closeImportModal(); return; }
       if (document.getElementById('modal').classList.contains('active')) { closeModal(); return; }
@@ -1227,6 +1272,156 @@ async function loadLogs() {
   }
 }
 
+// ==================== 实时请求日志 ====================
+
+let requestLogWs = null;
+let requestLogEntries = [];
+let requestLogReconnectTimer = null;
+
+function openRequestLog() {
+  document.getElementById('request-log-modal').classList.add('active');
+  populateRequestLogFilters();
+  loadInitialRequestLogs();
+  connectRequestLogWs();
+}
+
+function closeRequestLog() {
+  document.getElementById('request-log-modal').classList.remove('active');
+  disconnectRequestLogWs();
+}
+
+function connectRequestLogWs() {
+  if (requestLogWs) return;
+  const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
+  const url = `${protocol}//${location.host}`;
+  requestLogWs = new WebSocket(url);
+
+  requestLogWs.onopen = () => {
+    const el = document.getElementById('request-log-ws-status');
+    el.textContent = '已连接';
+    el.style.color = '#34d399';
+    if (requestLogReconnectTimer) { clearTimeout(requestLogReconnectTimer); requestLogReconnectTimer = null; }
+  };
+
+  requestLogWs.onmessage = (event) => {
+    try {
+      const entry = JSON.parse(event.data);
+      if (entry.type === 'connected') return;
+      requestLogEntries.unshift(entry);
+      if (requestLogEntries.length > 2000) requestLogEntries.pop();
+      appendRequestLogRow(entry);
+      updateRequestLogCount();
+    } catch { /* ignore */ }
+  };
+
+  requestLogWs.onclose = () => {
+    requestLogWs = null;
+    const el = document.getElementById('request-log-ws-status');
+    el.textContent = '已断开';
+    el.style.color = '#ef4444';
+    if (document.getElementById('request-log-modal').classList.contains('active')) {
+      requestLogReconnectTimer = setTimeout(connectRequestLogWs, 3000);
+    }
+  };
+
+  requestLogWs.onerror = () => {};
+}
+
+function disconnectRequestLogWs() {
+  if (requestLogWs) { requestLogWs.close(); requestLogWs = null; }
+  if (requestLogReconnectTimer) { clearTimeout(requestLogReconnectTimer); requestLogReconnectTimer = null; }
+}
+
+async function loadInitialRequestLogs() {
+  try {
+    const res = await fetch('/api/request-logs?limit=200');
+    const data = await res.json();
+    requestLogEntries = data.entries || [];
+    renderRequestLogTable();
+    updateRequestLogCount();
+  } catch { /* ignore */ }
+}
+
+function populateRequestLogFilters() {
+  const select = document.getElementById('request-log-proxy-filter');
+  select.innerHTML = '<option value="">全部代理</option>' +
+    (proxies || []).map(p => `<option value="${escapeHtml(p.id)}">${escapeHtml(p.name)}</option>`).join('');
+}
+
+function filterRequestLogs() {
+  renderRequestLogTable();
+}
+
+function getFilteredRequestLogs() {
+  const proxyId = document.getElementById('request-log-proxy-filter').value;
+  const status = document.getElementById('request-log-status-filter').value;
+  const model = (document.getElementById('request-log-model-filter').value || '').trim().toLowerCase();
+
+  return requestLogEntries.filter(e => {
+    if (proxyId && e.proxyId !== proxyId) return false;
+    if (status && e.status !== status) return false;
+    if (model && !(e.model || '').toLowerCase().includes(model)) return false;
+    return true;
+  });
+}
+
+function updateRequestLogCount() {
+  const filtered = getFilteredRequestLogs();
+  document.getElementById('request-log-count').textContent =
+    `(显示 ${filtered.length}/${requestLogEntries.length})`;
+}
+
+function renderRequestLogTable() {
+  const tbody = document.getElementById('request-log-tbody');
+  const filtered = getFilteredRequestLogs();
+  tbody.innerHTML = filtered.map(e => entryToRowHtml(e)).join('');
+  updateRequestLogCount();
+}
+
+function appendRequestLogRow(entry) {
+  const proxyId = document.getElementById('request-log-proxy-filter').value;
+  const status = document.getElementById('request-log-status-filter').value;
+  const model = (document.getElementById('request-log-model-filter').value || '').trim().toLowerCase();
+  if (proxyId && entry.proxyId !== proxyId) return;
+  if (status && entry.status !== status) return;
+  if (model && !(entry.model || '').toLowerCase().includes(model)) return;
+
+  const tbody = document.getElementById('request-log-tbody');
+  const row = document.createElement('tr');
+  row.className = 'request-log-row request-log-' + entry.status;
+  row.innerHTML = entryToCellHtml(entry);
+  tbody.insertBefore(row, tbody.firstChild);
+}
+
+function entryToRowHtml(e) {
+  return `<tr class="request-log-row request-log-${e.status}">${entryToCellHtml(e)}</tr>`;
+}
+
+function entryToCellHtml(e) {
+  const time = new Date(e.timestamp).toLocaleTimeString('zh-CN', { hour12: false });
+  const statusLabel = e.status === 'success' ? '成功' : e.status === '429' ? '429' : '失败';
+  const tokens = e.totalTokens > 0 ? `${e.promptTokens}+${e.completionTokens}` : '-';
+  const latency = e.latencyMs != null ? `${e.latencyMs}ms` : '-';
+  const statusSuffix = e.upstreamStatusCode ? ` (${e.upstreamStatusCode})` : '';
+  return [
+    `<td>${time}</td>`,
+    `<td>${escapeHtml(e.proxyName || '-')}</td>`,
+    `<td><span class="badge" style="font-size:11px">${escapeHtml(e.inboundProtocol || '-')}</span></td>`,
+    `<td><code style="font-size:12px">${escapeHtml(e.model || '-')}</code></td>`,
+    `<td><span class="request-log-status-badge request-log-status-${e.status}">${statusLabel}${statusSuffix}</span></td>`,
+    `<td>${tokens}${e.isEstimated ? ' <span title="估算值" style="color:var(--text-dim)">~</span>' : ''}</td>`,
+    `<td>${latency}</td>`,
+    `<td>${escapeHtml(e.providerName || '-')}</td>`,
+    `<td>${escapeHtml(e.keyAlias || '-')}</td>`,
+  ].join('');
+}
+
+function clearRequestLogs() {
+  requestLogEntries = [];
+  document.getElementById('request-log-tbody').innerHTML = '';
+  document.getElementById('request-log-count').textContent = '';
+}
+
 // ==================== 版本历史 ====================
 
 async function openHistoryViewer() {
@@ -1327,9 +1522,64 @@ function filterProxies() {
   renderProxies();
 }
 
+function healthDot(providerId) {
+  const h = keyHealth[providerId];
+  const cls = !h || h.status === 'unknown' ? 'health-unknown'
+    : h.status === 'healthy' ? 'health-ok'
+    : h.status === 'partial' ? 'health-warn' : 'health-error';
+  const title = !h || h.status === 'unknown' ? '未检测'
+    : h.status === 'healthy' ? 'Key 正常'
+    : h.status === 'partial' ? '部分 Key 异常' : 'Key 全部异常';
+  return `<span class="health-dot ${cls}" data-provider="${escapeHtml(providerId)}" title="${title}"></span>`;
+}
+
+function renderProviderHealthSummary() {
+  const el = document.getElementById('provider-health-summary');
+  if (!el) return;
+  const allProviders = proxies.map(p => p.providerId).filter(Boolean);
+  const unique = [...new Set(allProviders)];
+  if (unique.length === 0) { el.style.display = 'none'; return; }
+  let healthy = 0, partial = 0, unhealthy = 0, unknown = 0;
+  for (const id of unique) {
+    const h = keyHealth[id];
+    if (!h || h.status === 'unknown') unknown++;
+    else if (h.status === 'healthy') healthy++;
+    else if (h.status === 'partial') partial++;
+    else unhealthy++;
+  }
+  el.style.display = '';
+  el.innerHTML = `
+    <div class="health-stat"><span class="health-dot health-ok"></span><span>正常 ${healthy}</span></div>
+    <div class="health-stat"><span class="health-dot health-warn"></span><span>部分异常 ${partial}</span></div>
+    <div class="health-stat"><span class="health-dot health-error"></span><span>异常 ${unhealthy}</span></div>
+    <div class="health-stat"><span class="health-dot health-unknown"></span><span>未检测 ${unknown}</span></div>
+    <button class="btn btn-sm" onclick="recheckKeys()">重新检测</button>
+  `;
+}
+
+let rechecking = false;
+async function recheckKeys() {
+  if (rechecking) return;
+  rechecking = true;
+  const btn = document.querySelector('.provider-health-summary .btn');
+  if (btn) { btn.disabled = true; btn.textContent = '检测中...'; }
+  showToast('正在检测...');
+  try {
+    await fetch('/api/key-health/check', { method: 'POST' });
+    await loadKeyHealth();
+    showToast('检测完成');
+  } catch (err) {
+    showToast('检测失败: ' + err.message, true);
+  } finally {
+    rechecking = false;
+    if (btn) { btn.disabled = false; btn.textContent = '重新检测'; }
+  }
+}
+
 function renderProxies() {
   const container = document.getElementById('proxy-list');
   const list = getFilteredProxies();
+  renderProviderHealthSummary();
   if (proxies.length === 0) {
     container.innerHTML = '<div class="empty">暂无代理配置，点击右上角创建</div>';
     return;
@@ -1374,6 +1624,7 @@ function renderProxies() {
       </div>
       <div class="proxy-meta">
         <span>端口: <strong>${p.port}</strong></span>
+        <span>供应商: ${healthDot(p.providerId)} ${escapeHtml(p.providerName || '-')}</span>
         <span>认证: ${p.requireAuth ? '已启用' : '未启用'}</span>
       </div>
       <div class="proxy-address">

package/public/index.html

@@ -7,6 +7,16 @@
   <link rel="stylesheet" href="style.css">
 </head>
 <body>
+  <script>
+    // 尽早设置统计日期默认值，避免 init() 时序问题
+    document.addEventListener('DOMContentLoaded', function() {
+      var today = new Date().toISOString().slice(0, 10);
+      var sd = document.getElementById('stats-start-date');
+      var ed = document.getElementById('stats-end-date');
+      if (sd && !sd.value) sd.value = today;
+      if (ed && !ed.value) ed.value = today;
+    });
+  </script>
   <div class="container">
     <button class="theme-toggle" id="theme-toggle" onclick="toggleTheme()" title="切换主题">
       <span id="theme-icon">&#9790;</span>
@@ -43,6 +53,7 @@
             </div>
           </div>
           <div class="stats-range-btns">
+            <button class="btn btn-sm stats-range-btn" data-range="hourly">实时</button>
             <button class="btn btn-sm stats-range-btn active" data-range="daily">每日</button>
             <button class="btn btn-sm stats-range-btn" data-range="monthly">每月</button>
             <button class="btn btn-sm stats-range-btn" data-range="yearly">每年</button>
@@ -95,8 +106,10 @@
           <button class="btn btn-sm" onclick="startAllProxies()">全部启动</button>
           <button class="btn btn-sm" onclick="stopAllProxies()">全部停止</button>
           <button class="btn btn-sm" onclick="openLogViewer()">日志</button>
+          <button class="btn btn-sm" onclick="openRequestLog()">请求日志</button>
         </div>
       </div>
+      <div class="provider-health-summary" id="provider-health-summary" style="display:none"></div>
       <div id="proxy-list" class="proxy-list">
         <div class="empty">加载中...</div>
       </div>
@@ -331,6 +344,52 @@
     </div>
   </div>
 
+  <!-- 实时请求日志弹窗 -->
+  <div class="modal" id="request-log-modal">
+    <div class="modal-content" style="max-width:1200px">
+      <div class="modal-header">
+        <h3>实时请求日志 <span id="request-log-count" style="color:#64748b;font-size:0.8rem;font-weight:400"></span></h3>
+        <button class="btn-close" onclick="closeRequestLog()">&times;</button>
+      </div>
+      <div class="request-log-toolbar">
+        <div class="request-log-filters">
+          <select id="request-log-proxy-filter" onchange="filterRequestLogs()">
+            <option value="">全部代理</option>
+          </select>
+          <select id="request-log-status-filter" onchange="filterRequestLogs()">
+            <option value="">全部状态</option>
+            <option value="success">成功</option>
+            <option value="failure">失败</option>
+            <option value="429">429 限流</option>
+          </select>
+          <input type="text" id="request-log-model-filter" placeholder="模型过滤..." oninput="filterRequestLogs()">
+        </div>
+        <div class="request-log-controls">
+          <button class="btn btn-sm" id="request-log-ws-status" style="color:var(--text-dim);cursor:default">连接中...</button>
+          <button class="btn btn-sm" onclick="clearRequestLogs()">清空</button>
+        </div>
+      </div>
+      <div class="request-log-table-wrap" id="request-log-table-wrap">
+        <table class="request-log-table">
+          <thead>
+            <tr>
+              <th>时间</th>
+              <th>代理</th>
+              <th>协议</th>
+              <th>模型</th>
+              <th>状态</th>
+              <th>Tokens</th>
+              <th>延迟</th>
+              <th>供应商</th>
+              <th>Key</th>
+            </tr>
+          </thead>
+          <tbody id="request-log-tbody"></tbody>
+        </table>
+      </div>
+    </div>
+  </div>
+
   <!-- 导入预览弹窗 -->
   <div class="modal" id="import-modal">
     <div class="modal-content" style="max-width:500px">

package/public/style.css

@@ -1871,3 +1871,126 @@ form {
   font-size: 0.78rem;
   white-space: nowrap;
 }
+
+/* Health dots */
+.health-dot {
+  display: inline-block;
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  vertical-align: middle;
+  margin-right: 4px;
+}
+
+.health-ok { background: #22c55e; box-shadow: 0 0 6px rgba(34, 197, 94, 0.4); }
+.health-warn { background: #f59e0b; box-shadow: 0 0 6px rgba(245, 158, 11, 0.4); }
+.health-error { background: #ef4444; box-shadow: 0 0 6px rgba(239, 68, 68, 0.4); }
+.health-unknown { background: #64748b; }
+
+/* Provider health summary */
+.provider-health-summary {
+  display: flex;
+  align-items: center;
+  gap: 18px;
+  padding: 12px 28px;
+  border-bottom: 1px solid var(--border-light);
+  background: var(--bg-surface-alt);
+  font-size: 0.82rem;
+  color: var(--text-muted);
+}
+
+.health-stat {
+  display: flex;
+  align-items: center;
+  gap: 5px;
+}
+
+/* ==================== 实时请求日志面板 ==================== */
+
+.request-log-toolbar {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 8px 0;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.request-log-filters {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+}
+
+.request-log-filters select,
+.request-log-filters input {
+  background: var(--bg-surface);
+  color: var(--text-primary);
+  border: 1px solid var(--border-input);
+  border-radius: 6px;
+  padding: 4px 8px;
+  font-size: 12px;
+}
+
+.request-log-controls {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+}
+
+.request-log-table-wrap {
+  max-height: 60vh;
+  overflow-y: auto;
+  border: 1px solid var(--border-light);
+  border-radius: 8px;
+}
+
+.request-log-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 12px;
+}
+
+.request-log-table thead {
+  position: sticky;
+  top: 0;
+  z-index: 1;
+  background: var(--bg-elevated);
+}
+
+.request-log-table th {
+  padding: 8px 10px;
+  text-align: left;
+  font-weight: 600;
+  color: var(--text-muted);
+  border-bottom: 1px solid var(--border-main);
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.request-log-table td {
+  padding: 6px 10px;
+  border-bottom: 1px solid var(--border-light);
+  color: var(--text-secondary);
+}
+
+.request-log-row:hover td {
+  background: var(--bg-surface-alt);
+}
+
+.request-log-success td:first-child { border-left: 3px solid #34d399; }
+.request-log-failure td:first-child { border-left: 3px solid #ef4444; }
+.request-log-429 td:first-child { border-left: 3px solid #fbbf24; }
+
+.request-log-status-badge {
+  display: inline-block;
+  padding: 2px 8px;
+  border-radius: 10px;
+  font-size: 11px;
+  font-weight: 500;
+}
+
+.request-log-status-success { background: rgba(52,211,153,0.15); color: #34d399; }
+.request-log-status-failure { background: rgba(239,68,68,0.15); color: #ef4444; }
+.request-log-status-429 { background: rgba(251,191,36,0.15); color: #fbbf24; }

package/server.js

@@ -249,6 +249,89 @@ async function init() {
     return proxyManager.startProxy(proxyConfig);
   }
 
+  // ==================== API Key 健康检查 ====================
+
+  const keyHealth = new Map(); // providerId -> { status, lastCheck, keys: [{index, ok, message}] }
+  let healthCheckRunning = false;
+
+  async function checkAllProviderKeys() {
+    if (healthCheckRunning) return;
+    healthCheckRunning = true;
+    try {
+      const providers = configStore.getProviders();
+      logger.log(`[Health] 开始检查 ${providers.length} 个供应商的 API Key...`);
+      for (const provider of providers) {
+        await checkProviderKeys(provider);
+      }
+      logger.log('[Health] API Key 健康检查完成');
+    } finally {
+      healthCheckRunning = false;
+    }
+  }
+
+  async function checkProviderKeys(provider) {
+    const keys = (provider.apiKeys || []).filter(k => k.enabled !== false);
+    if (keys.length === 0) {
+      keyHealth.set(provider.id, { status: 'unknown', lastCheck: Date.now(), keys: [] });
+      return;
+    }
+
+    const protocol = provider.protocol || 'openai';
+    const base = provider.url.replace(/\/$/, '');
+    const hasV1Suffix = base.endsWith('/v1');
+    const isAzure = protocol === 'openai' && !!provider.azureDeployment;
+
+    const results = await Promise.all(keys.map(async (k, i) => {
+      try {
+        let testUrl, fetchOpts;
+        if (protocol === 'openai') {
+          if (isAzure) {
+            const ver = provider.azureApiVersion || '2024-02-01';
+            testUrl = `${base}/openai/deployments/${provider.azureDeployment}/models?api-version=${ver}`;
+            fetchOpts = { headers: { 'api-key': k.key } };
+          } else {
+            testUrl = hasV1Suffix ? `${base}/models` : `${base}/v1/models`;
+            fetchOpts = { headers: { 'Authorization': `Bearer ${k.key}` } };
+          }
+        } else if (protocol === 'anthropic') {
+          const testModel = (provider.models && provider.models[0]) || 'claude-3-haiku-20240307';
+          testUrl = hasV1Suffix ? `${base}/messages` : `${base}/v1/messages`;
+          fetchOpts = {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'x-api-key': k.key, 'anthropic-version': '2023-06-01' },
+            body: JSON.stringify({ model: testModel, max_tokens: 1, messages: [{ role: 'user', content: 'hi' }] }),
+          };
+        } else if (protocol === 'gemini') {
+          testUrl = `${base}/v1beta/models?key=${k.key}`;
+          fetchOpts = {};
+        } else {
+          return { index: i, ok: false, message: '不支持的协议' };
+        }
+        const res = await fetch(testUrl, { ...fetchOpts, signal: AbortSignal.timeout(15000) });
+        if (!res.ok) {
+          const hint = res.status === 401 || res.status === 403 ? 'Key 无效或无权限' : `HTTP ${res.status}`;
+          return { index: i, ok: false, message: hint };
+        }
+        return { index: i, ok: true };
+      } catch (err) {
+        return { index: i, ok: false, message: err.name === 'TimeoutError' ? '连接超时' : err.message };
+      }
+    }));
+
+    const allOk = results.every(r => r.ok);
+    const anyOk = results.some(r => r.ok);
+    keyHealth.set(provider.id, {
+      status: allOk ? 'healthy' : anyOk ? 'partial' : 'unhealthy',
+      lastCheck: Date.now(),
+      keys: results,
+    });
+  }
+
+  // 启动后延迟 5 秒执行首次检查
+  setTimeout(() => checkAllProviderKeys(), 5000);
+  // 每 24 小时检查一次
+  setInterval(() => checkAllProviderKeys(), 24 * 60 * 60 * 1000);
+
   // ==================== 供应商 API ====================
 
   app.get('/api/providers', (req, res) => {
@@ -720,6 +803,21 @@ async function init() {
     });
   });
 
+  // API Key 健康状态
+  app.get('/api/key-health', (req, res) => {
+    const result = {};
+    for (const [providerId, health] of keyHealth) {
+      result[providerId] = health;
+    }
+    res.json(result);
+  });
+
+  // 手动触发健康检查
+  app.post('/api/key-health/check', async (req, res) => {
+    await checkAllProviderKeys();
+    res.json({ success: true });
+  });
+
   // 设置
   app.get('/api/settings', (req, res) => {
     res.json(configStore.getSettings());
@@ -769,6 +867,13 @@ async function init() {
     }
   });
 
+  // 实时请求日志
+  const requestLog = require('./lib/request-log');
+  app.get('/api/request-logs', (req, res) => {
+    const limit = Math.min(parseInt(req.query.limit) || 200, 2000);
+    res.json({ entries: requestLog.getAll(limit), total: requestLog.getCount() });
+  });
+
   // ==================== 配置导入/导出 ====================
 
   app.get('/api/config/export', (req, res) => {
@@ -938,11 +1043,19 @@ async function init() {
     }
   }));
 
-  app.listen(PORT, () => {
+  const http = require('http');
+  const server = app.listen(PORT, () => {
     const adminUrl = `http://localhost:${PORT}`;
     logger.log(`[Admin] Management server running on ${adminUrl}`);
     logger.log(`[Admin] ${proxies.length} proxy config(s) loaded`);
     logger.log(`[Admin] 日志文件: ${logger.LOG_FILE}`);
+
+    // 初始化 WebSocket 实时日志
+    const wsServer = require('./lib/ws-server');
+    wsServer.init(server);
+    requestLog.onEntry((entry) => wsServer.broadcast(entry));
+    logger.log(`[Admin] WebSocket 已附加 (ws://localhost:${PORT})`);
+
     openBrowser(adminUrl);
   });
 }
@@ -952,6 +1065,8 @@ process.on('SIGINT', async () => {
   logger.log('[Shutdown] Shutting down...');
   removePid();
   try {
+    const wsServer = require('./lib/ws-server');
+    wsServer.close();
     const proxyManager = require('./lib/proxy-manager');
     const statsStore = require('./lib/stats-store');
     statsStore.flush();
@@ -965,6 +1080,8 @@ process.on('SIGINT', async () => {
 process.on('SIGTERM', async () => {
   removePid();
   try {
+    const wsServer = require('./lib/ws-server');
+    wsServer.close();
     const proxyManager = require('./lib/proxy-manager');
     const statsStore = require('./lib/stats-store');
     statsStore.flush();