+
加载中...
暂无 Token，请点击右上角导入或添加。
diff --git a/_public/static/common/html/header.html b/_public/static/common/html/header.html
index 8b1ae1a2..c60969a9 100644
--- a/_public/static/common/html/header.html
+++ b/_public/static/common/html/header.html
@@ -17,6 +17,7 @@
Token管理
配置管理
缓存管理
+
日志查看
diff --git a/_public/static/i18n/locales/en.json b/_public/static/i18n/locales/en.json
index 7bcd1526..cf5249ad 100644
--- a/_public/static/i18n/locales/en.json
+++ b/_public/static/i18n/locales/en.json
@@ -66,12 +66,14 @@
"noTokenSelected": "No Token selected",
"clearCache": "Clear cache",
"failureDetails": "Failure Details",
- "retryFailed": "Retry failed items"
+ "retryFailed": "Retry failed items",
+ "raw": "Raw"
},
"nav": {
"tokenManage": "Token Mgmt",
"configManage": "Config Mgmt",
"cacheManage": "Cache Mgmt",
+ "logsView": "Logs",
"chat": "Chat",
"imagine": "Imagine Gallery",
"video": "Video Generation",
@@ -128,108 +130,385 @@
},
"fields": {
"app": {
- "api_key": {"title": "API Key", "desc": "Token for calling Grok2API services (optional, supports multiple, comma-separated or array)."},
- "app_key": {"title": "Admin Password", "desc": "Password for logging into the Grok2API admin panel (required)."},
- "function_enabled": {"title": "Enable Function Access", "desc": "Whether to enable the function access entry (disabled means function pages are inaccessible)."},
- "function_key": {"title": "Function Password", "desc": "Access password for function pages (optional)."},
- "app_url": {"title": "App URL", "desc": "External access URL for the Grok2API service, used for file link access."},
- "image_format": {"title": "Image Format", "desc": "Default image format (url or base64)."},
- "video_format": {"title": "Video Format", "desc": "Default video format (html or url, url is the processed link)."},
- "temporary": {"title": "Temporary Chat", "desc": "Whether to enable temporary chat mode by default."},
- "disable_memory": {"title": "Disable Memory", "desc": "Whether to disable Grok memory feature by default."},
- "stream": {"title": "Streaming", "desc": "Whether to enable streaming output by default."},
- "thinking": {"title": "Chain of Thought", "desc": "Whether to enable chain of thought output by default."},
- "dynamic_statsig": {"title": "Dynamic Fingerprint", "desc": "Whether to enable dynamic Statsig fingerprint generation by default."},
- "custom_instruction": {"title": "Custom Instruction", "desc": "Multi-line text passed through as Grok request parameter customPersonality."},
- "filter_tags": {"title": "Filter Tags", "desc": "Configure automatic filtering of special tags in Grok responses."}
+ "api_key": {
+ "title": "API Key",
+ "desc": "Token for calling Grok2API services (optional, supports multiple, comma-separated or array)."
+ },
+ "app_key": {
+ "title": "Admin Password",
+ "desc": "Password for logging into the Grok2API admin panel (required)."
+ },
+ "function_enabled": {
+ "title": "Enable Function Access",
+ "desc": "Whether to enable the function access entry (disabled means function pages are inaccessible)."
+ },
+ "function_key": {
+ "title": "Function Password",
+ "desc": "Access password for function pages (optional)."
+ },
+ "app_url": {
+ "title": "App URL",
+ "desc": "External access URL for the Grok2API service, used for file link access."
+ },
+ "image_format": {
+ "title": "Image Format",
+ "desc": "Default image format (url or base64)."
+ },
+ "video_format": {
+ "title": "Video Format",
+ "desc": "Default video format (html or url, url is the processed link)."
+ },
+ "temporary": {
+ "title": "Temporary Chat",
+ "desc": "Whether to enable temporary chat mode by default."
+ },
+ "disable_memory": {
+ "title": "Disable Memory",
+ "desc": "Whether to disable Grok memory feature by default."
+ },
+ "stream": {
+ "title": "Streaming",
+ "desc": "Whether to enable streaming output by default."
+ },
+ "thinking": {
+ "title": "Chain of Thought",
+ "desc": "Whether to enable chain of thought output by default."
+ },
+ "dynamic_statsig": {
+ "title": "Dynamic Fingerprint",
+ "desc": "Whether to enable dynamic Statsig fingerprint generation by default."
+ },
+ "custom_instruction": {
+ "title": "Custom Instruction",
+ "desc": "Multi-line text passed through as Grok request parameter customPersonality."
+ },
+ "filter_tags": {
+ "title": "Filter Tags",
+ "desc": "Configure automatic filtering of special tags in Grok responses."
+ }
},
"proxy": {
- "base_proxy_url": {"title": "Base Proxy URL", "desc": "Base service address for proxying requests to Grok website."},
- "asset_proxy_url": {"title": "Asset Proxy URL", "desc": "Address for proxying static resource (image/video) requests to Grok website."},
- "skip_proxy_ssl_verify": {"title": "Skip Proxy SSL Verify", "desc": "Enable when your proxy uses a self-signed certificate (only bypasses proxy certificate validation)."},
- "enabled": {"title": "Enable CF Auto-Refresh", "desc": "When enabled, automatically obtains cf_clearance through FlareSolverr."},
- "flaresolverr_url": {"title": "FlareSolverr URL", "desc": "HTTP address of FlareSolverr service (e.g. http://flaresolverr:8191)."},
- "refresh_interval": {"title": "Refresh Interval (sec)", "desc": "Time interval for auto-refreshing cf_clearance, recommended minimum 300 seconds."},
- "timeout": {"title": "Challenge Timeout (sec)", "desc": "Maximum time to wait for FlareSolverr to solve CF challenge."},
- "cf_clearance": {"title": "CF Clearance", "desc": "Cloudflare Clearance Cookie for bypassing anti-bot verification. Automatically managed when auto-refresh is enabled."},
- "browser": {"title": "Browser Fingerprint", "desc": "curl_cffi browser fingerprint identifier (e.g. chrome136). Automatically managed when auto-refresh is enabled."},
- "user_agent": {"title": "User-Agent", "desc": "HTTP request User-Agent string. Automatically managed when auto-refresh is enabled."}
+ "base_proxy_url": {
+ "title": "Base Proxy URL",
+ "desc": "Base service address for proxying requests to Grok website."
+ },
+ "asset_proxy_url": {
+ "title": "Asset Proxy URL",
+ "desc": "Address for proxying static resource (image/video) requests to Grok website."
+ },
+ "skip_proxy_ssl_verify": {
+ "title": "Skip Proxy SSL Verify",
+ "desc": "Enable when your proxy uses a self-signed certificate (only bypasses proxy certificate validation)."
+ },
+ "enabled": {
+ "title": "Enable CF Auto-Refresh",
+ "desc": "When enabled, automatically obtains cf_clearance through FlareSolverr."
+ },
+ "flaresolverr_url": {
+ "title": "FlareSolverr URL",
+ "desc": "HTTP address of FlareSolverr service (e.g. http://flaresolverr:8191)."
+ },
+ "refresh_interval": {
+ "title": "Refresh Interval (sec)",
+ "desc": "Time interval for auto-refreshing cf_clearance, recommended minimum 300 seconds."
+ },
+ "timeout": {
+ "title": "Challenge Timeout (sec)",
+ "desc": "Maximum time to wait for FlareSolverr to solve CF challenge."
+ },
+ "cf_clearance": {
+ "title": "CF Clearance",
+ "desc": "Cloudflare Clearance Cookie for bypassing anti-bot verification. Automatically managed when auto-refresh is enabled."
+ },
+ "browser": {
+ "title": "Browser Fingerprint",
+ "desc": "curl_cffi browser fingerprint identifier (e.g. chrome136). Automatically managed when auto-refresh is enabled."
+ },
+ "user_agent": {
+ "title": "User-Agent",
+ "desc": "HTTP request User-Agent string. Automatically managed when auto-refresh is enabled."
+ }
},
"retry": {
- "max_retry": {"title": "Max Retries", "desc": "Maximum number of retries when Grok service request fails."},
- "retry_status_codes": {"title": "Retry Status Codes", "desc": "HTTP status codes that trigger a retry."},
- "reset_session_status_codes": {"title": "Session Reset Status Codes", "desc": "HTTP status codes that trigger session rebuild (used for proxy rotation)."},
- "retry_backoff_base": {"title": "Backoff Base", "desc": "Base delay (seconds) for retry backoff."},
- "retry_backoff_factor": {"title": "Backoff Factor", "desc": "Exponential multiplier for retry backoff."},
- "retry_backoff_max": {"title": "Backoff Max", "desc": "Maximum delay (seconds) for a single retry wait."},
- "retry_budget": {"title": "Backoff Budget", "desc": "Maximum total retry time (seconds) for a single request."}
+ "max_retry": {
+ "title": "Max Retries",
+ "desc": "Maximum number of retries when Grok service request fails."
+ },
+ "retry_status_codes": {
+ "title": "Retry Status Codes",
+ "desc": "HTTP status codes that trigger a retry."
+ },
+ "reset_session_status_codes": {
+ "title": "Session Reset Status Codes",
+ "desc": "HTTP status codes that trigger session rebuild (used for proxy rotation)."
+ },
+ "retry_backoff_base": {
+ "title": "Backoff Base",
+ "desc": "Base delay (seconds) for retry backoff."
+ },
+ "retry_backoff_factor": {
+ "title": "Backoff Factor",
+ "desc": "Exponential multiplier for retry backoff."
+ },
+ "retry_backoff_max": {
+ "title": "Backoff Max",
+ "desc": "Maximum delay (seconds) for a single retry wait."
+ },
+ "retry_budget": {
+ "title": "Backoff Budget",
+ "desc": "Maximum total retry time (seconds) for a single request."
+ }
},
"chat": {
- "concurrent": {"title": "Concurrency Limit", "desc": "Reverse API concurrency limit."},
- "timeout": {"title": "Request Timeout", "desc": "Reverse API timeout (seconds)."},
- "stream_timeout": {"title": "Stream Idle Timeout", "desc": "Streaming idle timeout (seconds)."}
+ "concurrent": {
+ "title": "Concurrency Limit",
+ "desc": "Reverse API concurrency limit."
+ },
+ "timeout": {
+ "title": "Request Timeout",
+ "desc": "Reverse API timeout (seconds)."
+ },
+ "stream_timeout": {
+ "title": "Stream Idle Timeout",
+ "desc": "Streaming idle timeout (seconds)."
+ }
},
"video": {
- "concurrent": {"title": "Concurrency Limit", "desc": "Reverse API concurrency limit."},
- "timeout": {"title": "Request Timeout", "desc": "Reverse API timeout (seconds)."},
- "stream_timeout": {"title": "Stream Idle Timeout", "desc": "Streaming idle timeout (seconds)."}
+ "concurrent": {
+ "title": "Concurrency Limit",
+ "desc": "Reverse API concurrency limit."
+ },
+ "timeout": {
+ "title": "Request Timeout",
+ "desc": "Reverse API timeout (seconds)."
+ },
+ "stream_timeout": {
+ "title": "Stream Idle Timeout",
+ "desc": "Streaming idle timeout (seconds)."
+ }
},
"image": {
- "timeout": {"title": "Request Timeout", "desc": "WebSocket request timeout (seconds)."},
- "stream_timeout": {"title": "Stream Idle Timeout", "desc": "WebSocket streaming idle timeout (seconds)."},
- "final_timeout": {"title": "Final Image Timeout", "desc": "Timeout (seconds) to wait for final image after receiving medium image."},
- "blocked_grace_seconds": {"title": "Review Grace Seconds", "desc": "Grace seconds for suspected review/censorship after receiving medium image (default 10, configurable)."},
- "nsfw": {"title": "NSFW Mode", "desc": "Whether to enable NSFW for WebSocket requests."},
- "medium_min_bytes": {"title": "Medium Min Bytes", "desc": "Minimum byte size for medium quality image detection."},
- "final_min_bytes": {"title": "Final Min Bytes", "desc": "Minimum byte size for final image detection (typically JPG > 100KB)."},
- "blocked_parallel_enabled": {"title": "Enable Parallel Compensation", "desc": "Whether to enable parallel compensation when suspected review/blocking occurs."},
- "blocked_parallel_attempts": {"title": "Block Compensation Concurrency", "desc": "Number of parallel compensation attempts when suspected review/blocking prevents final image."}
+ "timeout": {
+ "title": "Request Timeout",
+ "desc": "WebSocket request timeout (seconds)."
+ },
+ "stream_timeout": {
+ "title": "Stream Idle Timeout",
+ "desc": "WebSocket streaming idle timeout (seconds)."
+ },
+ "final_timeout": {
+ "title": "Final Image Timeout",
+ "desc": "Timeout (seconds) to wait for final image after receiving medium image."
+ },
+ "blocked_grace_seconds": {
+ "title": "Review Grace Seconds",
+ "desc": "Grace seconds for suspected review/censorship after receiving medium image (default 10, configurable)."
+ },
+ "nsfw": {
+ "title": "NSFW Mode",
+ "desc": "Whether to enable NSFW for WebSocket requests."
+ },
+ "medium_min_bytes": {
+ "title": "Medium Min Bytes",
+ "desc": "Minimum byte size for medium quality image detection."
+ },
+ "final_min_bytes": {
+ "title": "Final Min Bytes",
+ "desc": "Minimum byte size for final image detection (typically JPG > 100KB)."
+ },
+ "blocked_parallel_enabled": {
+ "title": "Enable Parallel Compensation",
+ "desc": "Whether to enable parallel compensation when suspected review/blocking occurs."
+ },
+ "blocked_parallel_attempts": {
+ "title": "Block Compensation Concurrency",
+ "desc": "Number of parallel compensation attempts when suspected review/blocking prevents final image."
+ }
},
"imagine_fast": {
- "n": {"title": "Generation Count", "desc": "Server-side unified generation count for grok-imagine-1.0-fast only (1-10)."},
- "size": {"title": "Image Size", "desc": "Server-side unified size for grok-imagine-1.0-fast only."},
- "response_format": {"title": "Response Format", "desc": "Server-side unified response format for grok-imagine-1.0-fast only."}
+ "n": {
+ "title": "Generation Count",
+ "desc": "Server-side unified generation count for grok-imagine-1.0-fast only (1-10)."
+ },
+ "size": {
+ "title": "Image Size",
+ "desc": "Server-side unified size for grok-imagine-1.0-fast only."
+ },
+ "response_format": {
+ "title": "Response Format",
+ "desc": "Server-side unified response format for grok-imagine-1.0-fast only."
+ }
},
"asset": {
- "upload_concurrent": {"title": "Upload Concurrency", "desc": "Maximum concurrent uploads. Recommended: 30."},
- "upload_timeout": {"title": "Upload Timeout", "desc": "Upload timeout (seconds). Recommended: 60."},
- "download_concurrent": {"title": "Download Concurrency", "desc": "Maximum concurrent downloads. Recommended: 30."},
- "download_timeout": {"title": "Download Timeout", "desc": "Download timeout (seconds). Recommended: 60."},
- "list_concurrent": {"title": "Query Concurrency", "desc": "Maximum concurrent asset queries. Recommended: 10."},
- "list_timeout": {"title": "Query Timeout", "desc": "Asset query timeout (seconds). Recommended: 60."},
- "list_batch_size": {"title": "Query Batch Size", "desc": "Number of tokens per query batch. Recommended: 10."},
- "delete_concurrent": {"title": "Delete Concurrency", "desc": "Maximum concurrent asset deletions. Recommended: 10."},
- "delete_timeout": {"title": "Delete Timeout", "desc": "Asset deletion timeout (seconds). Recommended: 60."},
- "delete_batch_size": {"title": "Delete Batch Size", "desc": "Number of tokens per delete batch. Recommended: 10."}
+ "upload_concurrent": {
+ "title": "Upload Concurrency",
+ "desc": "Maximum concurrent uploads. Recommended: 30."
+ },
+ "upload_timeout": {
+ "title": "Upload Timeout",
+ "desc": "Upload timeout (seconds). Recommended: 60."
+ },
+ "download_concurrent": {
+ "title": "Download Concurrency",
+ "desc": "Maximum concurrent downloads. Recommended: 30."
+ },
+ "download_timeout": {
+ "title": "Download Timeout",
+ "desc": "Download timeout (seconds). Recommended: 60."
+ },
+ "list_concurrent": {
+ "title": "Query Concurrency",
+ "desc": "Maximum concurrent asset queries. Recommended: 10."
+ },
+ "list_timeout": {
+ "title": "Query Timeout",
+ "desc": "Asset query timeout (seconds). Recommended: 60."
+ },
+ "list_batch_size": {
+ "title": "Query Batch Size",
+ "desc": "Number of tokens per query batch. Recommended: 10."
+ },
+ "delete_concurrent": {
+ "title": "Delete Concurrency",
+ "desc": "Maximum concurrent asset deletions. Recommended: 10."
+ },
+ "delete_timeout": {
+ "title": "Delete Timeout",
+ "desc": "Asset deletion timeout (seconds). Recommended: 60."
+ },
+ "delete_batch_size": {
+ "title": "Delete Batch Size",
+ "desc": "Number of tokens per delete batch. Recommended: 10."
+ }
},
"voice": {
- "timeout": {"title": "Request Timeout", "desc": "Voice request timeout (seconds)."}
+ "timeout": {
+ "title": "Request Timeout",
+ "desc": "Voice request timeout (seconds)."
+ }
},
"token": {
- "auto_refresh": {"title": "Auto Refresh", "desc": "Whether to enable automatic Token refresh."},
- "refresh_interval_hours": {"title": "Refresh Interval", "desc": "Time interval (hours) for regular Token refresh."},
- "super_refresh_interval_hours": {"title": "Super Refresh Interval", "desc": "Time interval (hours) for Super Token refresh."},
- "fail_threshold": {"title": "Failure Threshold", "desc": "Number of consecutive failures before a Token is marked unavailable."},
- "save_delay_ms": {"title": "Save Delay", "desc": "Delay (ms) for batching Token change writes."},
- "usage_flush_interval_sec": {"title": "Usage Flush Interval", "desc": "Minimum interval (seconds) for writing usage data to database."},
- "reload_interval_sec": {"title": "Sync Interval", "desc": "Token state refresh interval (seconds) in multi-worker scenarios."}
+ "auto_refresh": {
+ "title": "Auto Refresh",
+ "desc": "Whether to enable automatic Token refresh."
+ },
+ "refresh_interval_hours": {
+ "title": "Refresh Interval",
+ "desc": "Time interval (hours) for regular Token refresh."
+ },
+ "super_refresh_interval_hours": {
+ "title": "Super Refresh Interval",
+ "desc": "Time interval (hours) for Super Token refresh."
+ },
+ "fail_threshold": {
+ "title": "Failure Threshold",
+ "desc": "Number of consecutive failures before a Token is marked unavailable."
+ },
+ "save_delay_ms": {
+ "title": "Save Delay",
+ "desc": "Delay (ms) for batching Token change writes."
+ },
+ "usage_flush_interval_sec": {
+ "title": "Usage Flush Interval",
+ "desc": "Minimum interval (seconds) for writing usage data to database."
+ },
+ "reload_interval_sec": {
+ "title": "Sync Interval",
+ "desc": "Token state refresh interval (seconds) in multi-worker scenarios."
+ }
},
"cache": {
- "enable_auto_clean": {"title": "Auto Clean", "desc": "Whether to enable automatic cache cleanup based on size limit."},
- "limit_mb": {"title": "Clean Threshold", "desc": "Cache size threshold (MB) that triggers cleanup."}
+ "enable_auto_clean": {
+ "title": "Auto Clean",
+ "desc": "Whether to enable automatic cache cleanup based on size limit."
+ },
+ "limit_mb": {
+ "title": "Clean Threshold",
+ "desc": "Cache size threshold (MB) that triggers cleanup."
+ }
},
"nsfw": {
- "concurrent": {"title": "Concurrency Limit", "desc": "Maximum concurrent requests for batch NSFW enable. Recommended: 10."},
- "batch_size": {"title": "Batch Size", "desc": "Batch processing count for NSFW enable. Recommended: 50."},
- "timeout": {"title": "Request Timeout", "desc": "Timeout for NSFW-related requests (seconds). Recommended: 60."}
+ "concurrent": {
+ "title": "Concurrency Limit",
+ "desc": "Maximum concurrent requests for batch NSFW enable. Recommended: 10."
+ },
+ "batch_size": {
+ "title": "Batch Size",
+ "desc": "Batch processing count for NSFW enable. Recommended: 50."
+ },
+ "timeout": {
+ "title": "Request Timeout",
+ "desc": "Timeout for NSFW-related requests (seconds). Recommended: 60."
+ }
},
"usage": {
- "concurrent": {"title": "Concurrency Limit", "desc": "Maximum concurrent requests for batch usage refresh. Recommended: 10."},
- "batch_size": {"title": "Batch Size", "desc": "Batch processing count for usage refresh. Recommended: 50."},
- "timeout": {"title": "Request Timeout", "desc": "Usage query timeout (seconds). Recommended: 60."}
+ "concurrent": {
+ "title": "Concurrency Limit",
+ "desc": "Maximum concurrent requests for batch usage refresh. Recommended: 10."
+ },
+ "batch_size": {
+ "title": "Batch Size",
+ "desc": "Batch processing count for usage refresh. Recommended: 50."
+ },
+ "timeout": {
+ "title": "Request Timeout",
+ "desc": "Usage query timeout (seconds). Recommended: 60."
+ }
}
}
},
+ "logs": {
+ "pageTitle": "Grok2API - Logs",
+ "title": "Log Viewer",
+ "subtitle": "Filter structured logs by file, level, and keyword with a cleaner reading experience.",
+ "filesTitle": "Log Files",
+ "rawTitle": "Raw Log",
+ "empty": "No matching log records",
+ "filters": {
+ "file": "Log File",
+ "level": "Level",
+ "limit": "Rows",
+ "keyword": "Keyword",
+ "keywordPlaceholder": "traceID / path / error keyword",
+ "apply": "Apply",
+ "reset": "Reset",
+ "excludeAdminRoutes": "Hide `/v1/admin/*` only on this page"
+ },
+ "levels": {
+ "all": "All Levels"
+ },
+ "stats": {
+ "file": "Current File",
+ "entries": "Loaded Rows",
+ "entriesHint": "Shown with current filters",
+ "errorWarn": "Warnings / Errors",
+ "errorWarnHint": "warning + error",
+ "size": "Total Size",
+ "sizeHint": "Log directory usage"
+ },
+ "loadFilesFailed": "Failed to load log files",
+ "loadFailed": "Failed to load logs",
+ "noFiles": "No log files",
+ "fileCount": "{count} log files",
+ "deleteNone": "Select log files to delete first",
+ "deleteConfirm": "Delete {count} log files?",
+ "deleteFailed": "Failed to delete logs",
+ "deleteResult": "Deleted {deleted} log files, {failed} failed",
+ "toggle": {
+ "expand": "Expand",
+ "collapse": "Collapse"
+ },
+ "autoRefresh": {
+ "buttonAria": "Auto refresh",
+ "off": "Auto refresh: Off",
+ "offShort": "Off",
+ "interval": "Auto refresh: {seconds}s",
+ "intervalLabel": "{seconds}s",
+ "changed": "Auto refresh: {label}",
+ "disabled": "Auto refresh disabled"
+ },
+ "deleteSelected": "Delete Selected"
+ },
"token": {
"pageTitle": "Grok2API - Token Mgmt",
"title": "Token List",
@@ -267,7 +546,7 @@
"prevPage": "Prev",
"nextPage": "Next",
"perPage": "{size} / page",
- "pagination": "Page {current} / {total} \u00b7 {count} items",
+ "pagination": "Page {current} / {total} · {count} items",
"batchExport": "Export",
"batchRefresh": "Refresh",
"batchDisable": "Disable",
diff --git a/_public/static/i18n/locales/zh.json b/_public/static/i18n/locales/zh.json
index 95157910..57106b02 100644
--- a/_public/static/i18n/locales/zh.json
+++ b/_public/static/i18n/locales/zh.json
@@ -66,12 +66,14 @@
"noTokenSelected": "未选择 Token",
"clearCache": "清空缓存",
"failureDetails": "失败详情",
- "retryFailed": "重试失败项"
+ "retryFailed": "重试失败项",
+ "raw": "原始"
},
"nav": {
"tokenManage": "Token管理",
"configManage": "配置管理",
"cacheManage": "缓存管理",
+ "logsView": "日志查看",
"chat": "Chat 聊天",
"imagine": "Imagine 瀑布流",
"video": "Video 视频生成",
@@ -128,108 +130,385 @@
},
"fields": {
"app": {
- "api_key": {"title": "API 密钥", "desc": "调用 Grok2API 服务的 Token（可选，支持多个，逗号分隔或数组）。"},
- "app_key": {"title": "后台密码", "desc": "登录 Grok2API 管理后台的密码（必填）。"},
- "function_enabled": {"title": "启用功能玩法", "desc": "是否启用功能玩法入口（关闭则功能玩法页面不可访问）。"},
- "function_key": {"title": "Function 密码", "desc": "功能玩法页面的访问密码（可选）。"},
- "app_url": {"title": "应用地址", "desc": "当前 Grok2API 服务的外部访问 URL，用于文件链接访问。"},
- "image_format": {"title": "图片格式", "desc": "默认生成的图片格式（url 或 base64）。"},
- "video_format": {"title": "视频格式", "desc": "默认生成的视频格式（html 或 url，url 为处理后的链接）。"},
- "temporary": {"title": "临时对话", "desc": "是否默认启用临时对话模式。"},
- "disable_memory": {"title": "禁用记忆", "desc": "是否默认禁用 Grok 记忆功能。"},
- "stream": {"title": "流式响应", "desc": "是否默认启用流式输出。"},
- "thinking": {"title": "思维链", "desc": "是否默认启用思维链输出。"},
- "dynamic_statsig": {"title": "动态指纹", "desc": "是否默认启用动态生成 Statsig 指纹。"},
- "custom_instruction": {"title": "自定义指令", "desc": "多行文本，会透传为 Grok 请求参数 customPersonality。"},
- "filter_tags": {"title": "过滤标签", "desc": "设置自动过滤 Grok 响应中的特殊标签。"}
+ "api_key": {
+ "title": "API 密钥",
+ "desc": "调用 Grok2API 服务的 Token（可选，支持多个，逗号分隔或数组）。"
+ },
+ "app_key": {
+ "title": "后台密码",
+ "desc": "登录 Grok2API 管理后台的密码（必填）。"
+ },
+ "function_enabled": {
+ "title": "启用功能玩法",
+ "desc": "是否启用功能玩法入口（关闭则功能玩法页面不可访问）。"
+ },
+ "function_key": {
+ "title": "Function 密码",
+ "desc": "功能玩法页面的访问密码（可选）。"
+ },
+ "app_url": {
+ "title": "应用地址",
+ "desc": "当前 Grok2API 服务的外部访问 URL，用于文件链接访问。"
+ },
+ "image_format": {
+ "title": "图片格式",
+ "desc": "默认生成的图片格式（url 或 base64）。"
+ },
+ "video_format": {
+ "title": "视频格式",
+ "desc": "默认生成的视频格式（html 或 url，url 为处理后的链接）。"
+ },
+ "temporary": {
+ "title": "临时对话",
+ "desc": "是否默认启用临时对话模式。"
+ },
+ "disable_memory": {
+ "title": "禁用记忆",
+ "desc": "是否默认禁用 Grok 记忆功能。"
+ },
+ "stream": {
+ "title": "流式响应",
+ "desc": "是否默认启用流式输出。"
+ },
+ "thinking": {
+ "title": "思维链",
+ "desc": "是否默认启用思维链输出。"
+ },
+ "dynamic_statsig": {
+ "title": "动态指纹",
+ "desc": "是否默认启用动态生成 Statsig 指纹。"
+ },
+ "custom_instruction": {
+ "title": "自定义指令",
+ "desc": "多行文本，会透传为 Grok 请求参数 customPersonality。"
+ },
+ "filter_tags": {
+ "title": "过滤标签",
+ "desc": "设置自动过滤 Grok 响应中的特殊标签。"
+ }
},
"proxy": {
- "base_proxy_url": {"title": "基础代理 URL", "desc": "代理请求到 Grok 官网的基础服务地址。"},
- "asset_proxy_url": {"title": "资源代理 URL", "desc": "代理请求到 Grok 官网的静态资源（图片/视频）地址。"},
- "skip_proxy_ssl_verify": {"title": "跳过代理 SSL 校验", "desc": "代理使用自签名证书时启用（仅放行代理证书校验）。"},
- "enabled": {"title": "启用 CF 自动刷新", "desc": "启用后将通过 FlareSolverr 自动获取 cf_clearance。"},
- "flaresolverr_url": {"title": "FlareSolverr 地址", "desc": "FlareSolverr 服务的 HTTP 地址（如 http://flaresolverr:8191）。"},
- "refresh_interval": {"title": "刷新间隔（秒）", "desc": "自动刷新 cf_clearance 的时间间隔，建议不低于 300 秒。"},
- "timeout": {"title": "挑战超时（秒）", "desc": "等待 FlareSolverr 解决 CF 挑战的最大时间。"},
- "cf_clearance": {"title": "CF Clearance", "desc": "Cloudflare Clearance Cookie，用于绕过反爬虫验证。启用自动刷新时由系统自动管理。"},
- "browser": {"title": "浏览器指纹", "desc": "curl_cffi 浏览器指纹标识（如 chrome136）。启用自动刷新时由系统自动管理。"},
- "user_agent": {"title": "User-Agent", "desc": "HTTP 请求的 User-Agent 字符串。启用自动刷新时由系统自动管理。"}
+ "base_proxy_url": {
+ "title": "基础代理 URL",
+ "desc": "代理请求到 Grok 官网的基础服务地址。"
+ },
+ "asset_proxy_url": {
+ "title": "资源代理 URL",
+ "desc": "代理请求到 Grok 官网的静态资源（图片/视频）地址。"
+ },
+ "skip_proxy_ssl_verify": {
+ "title": "跳过代理 SSL 校验",
+ "desc": "代理使用自签名证书时启用（仅放行代理证书校验）。"
+ },
+ "enabled": {
+ "title": "启用 CF 自动刷新",
+ "desc": "启用后将通过 FlareSolverr 自动获取 cf_clearance。"
+ },
+ "flaresolverr_url": {
+ "title": "FlareSolverr 地址",
+ "desc": "FlareSolverr 服务的 HTTP 地址（如 http://flaresolverr:8191）。"
+ },
+ "refresh_interval": {
+ "title": "刷新间隔（秒）",
+ "desc": "自动刷新 cf_clearance 的时间间隔，建议不低于 300 秒。"
+ },
+ "timeout": {
+ "title": "挑战超时（秒）",
+ "desc": "等待 FlareSolverr 解决 CF 挑战的最大时间。"
+ },
+ "cf_clearance": {
+ "title": "CF Clearance",
+ "desc": "Cloudflare Clearance Cookie，用于绕过反爬虫验证。启用自动刷新时由系统自动管理。"
+ },
+ "browser": {
+ "title": "浏览器指纹",
+ "desc": "curl_cffi 浏览器指纹标识（如 chrome136）。启用自动刷新时由系统自动管理。"
+ },
+ "user_agent": {
+ "title": "User-Agent",
+ "desc": "HTTP 请求的 User-Agent 字符串。启用自动刷新时由系统自动管理。"
+ }
},
"retry": {
- "max_retry": {"title": "最大重试次数", "desc": "请求 Grok 服务失败时的最大重试次数。"},
- "retry_status_codes": {"title": "重试状态码", "desc": "触发重试的 HTTP 状态码列表。"},
- "reset_session_status_codes": {"title": "重建状态码", "desc": "触发重建 session 的 HTTP 状态码列表（用于轮换代理）。"},
- "retry_backoff_base": {"title": "退避基数", "desc": "重试退避的基础延迟（秒）。"},
- "retry_backoff_factor": {"title": "退避倍率", "desc": "重试退避的指数放大系数。"},
- "retry_backoff_max": {"title": "退避上限", "desc": "单次重试等待的最大延迟（秒）。"},
- "retry_budget": {"title": "退避预算", "desc": "单次请求的最大重试总耗时（秒）。"}
+ "max_retry": {
+ "title": "最大重试次数",
+ "desc": "请求 Grok 服务失败时的最大重试次数。"
+ },
+ "retry_status_codes": {
+ "title": "重试状态码",
+ "desc": "触发重试的 HTTP 状态码列表。"
+ },
+ "reset_session_status_codes": {
+ "title": "重建状态码",
+ "desc": "触发重建 session 的 HTTP 状态码列表（用于轮换代理）。"
+ },
+ "retry_backoff_base": {
+ "title": "退避基数",
+ "desc": "重试退避的基础延迟（秒）。"
+ },
+ "retry_backoff_factor": {
+ "title": "退避倍率",
+ "desc": "重试退避的指数放大系数。"
+ },
+ "retry_backoff_max": {
+ "title": "退避上限",
+ "desc": "单次重试等待的最大延迟（秒）。"
+ },
+ "retry_budget": {
+ "title": "退避预算",
+ "desc": "单次请求的最大重试总耗时（秒）。"
+ }
},
"chat": {
- "concurrent": {"title": "并发上限", "desc": "Reverse 接口并发上限。"},
- "timeout": {"title": "请求超时", "desc": "Reverse 接口超时时间（秒）。"},
- "stream_timeout": {"title": "流空闲超时", "desc": "流式空闲超时时间（秒）。"}
+ "concurrent": {
+ "title": "并发上限",
+ "desc": "Reverse 接口并发上限。"
+ },
+ "timeout": {
+ "title": "请求超时",
+ "desc": "Reverse 接口超时时间（秒）。"
+ },
+ "stream_timeout": {
+ "title": "流空闲超时",
+ "desc": "流式空闲超时时间（秒）。"
+ }
},
"video": {
- "concurrent": {"title": "并发上限", "desc": "Reverse 接口并发上限。"},
- "timeout": {"title": "请求超时", "desc": "Reverse 接口超时时间（秒）。"},
- "stream_timeout": {"title": "流空闲超时", "desc": "流式空闲超时时间（秒）。"}
+ "concurrent": {
+ "title": "并发上限",
+ "desc": "Reverse 接口并发上限。"
+ },
+ "timeout": {
+ "title": "请求超时",
+ "desc": "Reverse 接口超时时间（秒）。"
+ },
+ "stream_timeout": {
+ "title": "流空闲超时",
+ "desc": "流式空闲超时时间（秒）。"
+ }
},
"image": {
- "timeout": {"title": "请求超时", "desc": "WebSocket 请求超时时间（秒）。"},
- "stream_timeout": {"title": "流空闲超时", "desc": "WebSocket 流式空闲超时时间（秒）。"},
- "final_timeout": {"title": "最终图超时", "desc": "收到中等图后等待最终图的超时秒数。"},
- "blocked_grace_seconds": {"title": "审查宽限秒数", "desc": "收到中等图后，判定疑似被审查的宽限秒数（默认 10 秒，可自定义）。"},
- "nsfw": {"title": "NSFW 模式", "desc": "WebSocket 请求是否启用 NSFW。"},
- "medium_min_bytes": {"title": "中等图最小字节", "desc": "判定中等质量图的最小字节数。"},
- "final_min_bytes": {"title": "最终图最小字节", "desc": "判定最终图的最小字节数（通常 JPG > 100KB）。"},
- "blocked_parallel_enabled": {"title": "启用并行补偿", "desc": "疑似审查/拦截时，是否启用并行补偿生成。"},
- "blocked_parallel_attempts": {"title": "拦截补偿并发次数", "desc": "疑似审查/拦截导致无最终图时，自动并行补偿生成次数。"}
+ "timeout": {
+ "title": "请求超时",
+ "desc": "WebSocket 请求超时时间（秒）。"
+ },
+ "stream_timeout": {
+ "title": "流空闲超时",
+ "desc": "WebSocket 流式空闲超时时间（秒）。"
+ },
+ "final_timeout": {
+ "title": "最终图超时",
+ "desc": "收到中等图后等待最终图的超时秒数。"
+ },
+ "blocked_grace_seconds": {
+ "title": "审查宽限秒数",
+ "desc": "收到中等图后，判定疑似被审查的宽限秒数（默认 10 秒，可自定义）。"
+ },
+ "nsfw": {
+ "title": "NSFW 模式",
+ "desc": "WebSocket 请求是否启用 NSFW。"
+ },
+ "medium_min_bytes": {
+ "title": "中等图最小字节",
+ "desc": "判定中等质量图的最小字节数。"
+ },
+ "final_min_bytes": {
+ "title": "最终图最小字节",
+ "desc": "判定最终图的最小字节数（通常 JPG > 100KB）。"
+ },
+ "blocked_parallel_enabled": {
+ "title": "启用并行补偿",
+ "desc": "疑似审查/拦截时，是否启用并行补偿生成。"
+ },
+ "blocked_parallel_attempts": {
+ "title": "拦截补偿并发次数",
+ "desc": "疑似审查/拦截导致无最终图时，自动并行补偿生成次数。"
+ }
},
"imagine_fast": {
- "n": {"title": "生成数量", "desc": "仅用于 grok-imagine-1.0-fast 的服务端统一生成数量（1-10）。"},
- "size": {"title": "图片尺寸", "desc": "仅用于 grok-imagine-1.0-fast 的服务端统一尺寸。"},
- "response_format": {"title": "响应格式", "desc": "仅用于 grok-imagine-1.0-fast 的服务端统一返回格式。"}
+ "n": {
+ "title": "生成数量",
+ "desc": "仅用于 grok-imagine-1.0-fast 的服务端统一生成数量（1-10）。"
+ },
+ "size": {
+ "title": "图片尺寸",
+ "desc": "仅用于 grok-imagine-1.0-fast 的服务端统一尺寸。"
+ },
+ "response_format": {
+ "title": "响应格式",
+ "desc": "仅用于 grok-imagine-1.0-fast 的服务端统一返回格式。"
+ }
},
"asset": {
- "upload_concurrent": {"title": "上传并发", "desc": "上传接口的最大并发数。推荐 30。"},
- "upload_timeout": {"title": "上传超时", "desc": "上传接口超时时间（秒）。推荐 60。"},
- "download_concurrent": {"title": "下载并发", "desc": "下载接口的最大并发数。推荐 30。"},
- "download_timeout": {"title": "下载超时", "desc": "下载接口超时时间（秒）。推荐 60。"},
- "list_concurrent": {"title": "查询并发", "desc": "资产查询接口的最大并发数。推荐 10。"},
- "list_timeout": {"title": "查询超时", "desc": "资产查询接口超时时间（秒）。推荐 60。"},
- "list_batch_size": {"title": "查询批次大小", "desc": "单次查询可处理的 Token 数量。推荐 10。"},
- "delete_concurrent": {"title": "删除并发", "desc": "资产删除接口的最大并发数。推荐 10。"},
- "delete_timeout": {"title": "删除超时", "desc": "资产删除接口超时时间（秒）。推荐 60。"},
- "delete_batch_size": {"title": "删除批次大小", "desc": "单次删除可处理的 Token 数量。推荐 10。"}
+ "upload_concurrent": {
+ "title": "上传并发",
+ "desc": "上传接口的最大并发数。推荐 30。"
+ },
+ "upload_timeout": {
+ "title": "上传超时",
+ "desc": "上传接口超时时间（秒）。推荐 60。"
+ },
+ "download_concurrent": {
+ "title": "下载并发",
+ "desc": "下载接口的最大并发数。推荐 30。"
+ },
+ "download_timeout": {
+ "title": "下载超时",
+ "desc": "下载接口超时时间（秒）。推荐 60。"
+ },
+ "list_concurrent": {
+ "title": "查询并发",
+ "desc": "资产查询接口的最大并发数。推荐 10。"
+ },
+ "list_timeout": {
+ "title": "查询超时",
+ "desc": "资产查询接口超时时间（秒）。推荐 60。"
+ },
+ "list_batch_size": {
+ "title": "查询批次大小",
+ "desc": "单次查询可处理的 Token 数量。推荐 10。"
+ },
+ "delete_concurrent": {
+ "title": "删除并发",
+ "desc": "资产删除接口的最大并发数。推荐 10。"
+ },
+ "delete_timeout": {
+ "title": "删除超时",
+ "desc": "资产删除接口超时时间（秒）。推荐 60。"
+ },
+ "delete_batch_size": {
+ "title": "删除批次大小",
+ "desc": "单次删除可处理的 Token 数量。推荐 10。"
+ }
},
"voice": {
- "timeout": {"title": "请求超时", "desc": "Voice 请求超时时间（秒）。"}
+ "timeout": {
+ "title": "请求超时",
+ "desc": "Voice 请求超时时间（秒）。"
+ }
},
"token": {
- "auto_refresh": {"title": "自动刷新", "desc": "是否开启 Token 自动刷新机制。"},
- "refresh_interval_hours": {"title": "刷新间隔", "desc": "普通 Token 刷新的时间间隔（小时）。"},
- "super_refresh_interval_hours": {"title": "Super 刷新间隔", "desc": "Super Token 刷新的时间间隔（小时）。"},
- "fail_threshold": {"title": "失败阈值", "desc": "单个 Token 连续失败多少次后被标记为不可用。"},
- "save_delay_ms": {"title": "保存延迟", "desc": "Token 变更合并写入的延迟（毫秒）。"},
- "usage_flush_interval_sec": {"title": "用量落库间隔", "desc": "用量类字段写入数据库的最小间隔（秒）。"},
- "reload_interval_sec": {"title": "同步间隔", "desc": "多 worker 场景下 Token 状态刷新间隔（秒）。"}
+ "auto_refresh": {
+ "title": "自动刷新",
+ "desc": "是否开启 Token 自动刷新机制。"
+ },
+ "refresh_interval_hours": {
+ "title": "刷新间隔",
+ "desc": "普通 Token 刷新的时间间隔（小时）。"
+ },
+ "super_refresh_interval_hours": {
+ "title": "Super 刷新间隔",
+ "desc": "Super Token 刷新的时间间隔（小时）。"
+ },
+ "fail_threshold": {
+ "title": "失败阈值",
+ "desc": "单个 Token 连续失败多少次后被标记为不可用。"
+ },
+ "save_delay_ms": {
+ "title": "保存延迟",
+ "desc": "Token 变更合并写入的延迟（毫秒）。"
+ },
+ "usage_flush_interval_sec": {
+ "title": "用量落库间隔",
+ "desc": "用量类字段写入数据库的最小间隔（秒）。"
+ },
+ "reload_interval_sec": {
+ "title": "同步间隔",
+ "desc": "多 worker 场景下 Token 状态刷新间隔（秒）。"
+ }
},
"cache": {
- "enable_auto_clean": {"title": "自动清理", "desc": "是否启用缓存自动清理，开启后按上限自动回收。"},
- "limit_mb": {"title": "清理阈值", "desc": "缓存大小阈值（MB），超过阈值会触发清理。"}
+ "enable_auto_clean": {
+ "title": "自动清理",
+ "desc": "是否启用缓存自动清理，开启后按上限自动回收。"
+ },
+ "limit_mb": {
+ "title": "清理阈值",
+ "desc": "缓存大小阈值（MB），超过阈值会触发清理。"
+ }
},
"nsfw": {
- "concurrent": {"title": "并发上限", "desc": "批量开启 NSFW 模式时的并发请求上限。推荐 10。"},
- "batch_size": {"title": "批次大小", "desc": "批量开启 NSFW 模式的单批处理数量。推荐 50。"},
- "timeout": {"title": "请求超时", "desc": "NSFW 开启相关请求的超时时间（秒）。推荐 60。"}
+ "concurrent": {
+ "title": "并发上限",
+ "desc": "批量开启 NSFW 模式时的并发请求上限。推荐 10。"
+ },
+ "batch_size": {
+ "title": "批次大小",
+ "desc": "批量开启 NSFW 模式的单批处理数量。推荐 50。"
+ },
+ "timeout": {
+ "title": "请求超时",
+ "desc": "NSFW 开启相关请求的超时时间（秒）。推荐 60。"
+ }
},
"usage": {
- "concurrent": {"title": "并发上限", "desc": "批量刷新用量时的并发请求上限。推荐 10。"},
- "batch_size": {"title": "批次大小", "desc": "批量刷新用量的单批处理数量。推荐 50。"},
- "timeout": {"title": "请求超时", "desc": "用量查询接口的超时时间（秒）。推荐 60。"}
+ "concurrent": {
+ "title": "并发上限",
+ "desc": "批量刷新用量时的并发请求上限。推荐 10。"
+ },
+ "batch_size": {
+ "title": "批次大小",
+ "desc": "批量刷新用量的单批处理数量。推荐 50。"
+ },
+ "timeout": {
+ "title": "请求超时",
+ "desc": "用量查询接口的超时时间（秒）。推荐 60。"
+ }
}
}
},
+ "logs": {
+ "pageTitle": "Grok2API - 日志查看",
+ "title": "日志查看",
+ "subtitle": "按文件、级别和关键词快速筛选，并以更易读的方式查看结构化日志。",
+ "filesTitle": "日志文件",
+ "rawTitle": "原始日志",
+ "empty": "没有匹配的日志记录",
+ "filters": {
+ "file": "日志文件",
+ "level": "级别",
+ "limit": "条数",
+ "keyword": "关键词",
+ "keywordPlaceholder": "traceID / path / 错误关键词",
+ "apply": "应用筛选",
+ "reset": "重置",
+ "excludeAdminRoutes": "仅在此页过滤 `/v1/admin/*`"
+ },
+ "levels": {
+ "all": "全部级别"
+ },
+ "stats": {
+ "file": "当前文件",
+ "entries": "已加载条目",
+ "entriesHint": "按当前筛选展示",
+ "errorWarn": "告警 / 错误",
+ "errorWarnHint": "warning + error",
+ "size": "总大小",
+ "sizeHint": "日志目录占用"
+ },
+ "loadFilesFailed": "加载日志文件失败",
+ "loadFailed": "加载日志失败",
+ "noFiles": "暂无日志文件",
+ "fileCount": "{count} 个日志文件",
+ "deleteNone": "请先选择要清理的日志文件",
+ "deleteConfirm": "确认清理 {count} 个日志文件？",
+ "deleteFailed": "清理日志失败",
+ "deleteResult": "已清理 {deleted} 个日志文件，失败 {failed} 个",
+ "toggle": {
+ "expand": "展开",
+ "collapse": "收起"
+ },
+ "autoRefresh": {
+ "buttonAria": "自动刷新",
+ "off": "自动刷新：关",
+ "offShort": "关闭",
+ "interval": "自动刷新：{seconds}s",
+ "intervalLabel": "{seconds}s",
+ "changed": "自动刷新：{label}",
+ "disabled": "自动刷新已关闭"
+ },
+ "deleteSelected": "清理所选"
+ },
"token": {
"pageTitle": "Grok2API - Token 管理",
"title": "Token 列表",
diff --git a/app/api/pages/admin.py b/app/api/pages/admin.py
index 75c9e3d2..b45206f8 100644
--- a/app/api/pages/admin.py
+++ b/app/api/pages/admin.py
@@ -37,3 +37,8 @@ async def admin_cache():
@router.get("/admin/token", include_in_schema=False)
async def admin_token():
return _admin_page_response("admin/pages/token.html")
+
+
+@router.get("/admin/logs", include_in_schema=False)
+async def admin_logs():
+ return _admin_page_response("admin/pages/logs.html")
diff --git a/app/api/v1/admin/__init__.py b/app/api/v1/admin/__init__.py
index 63db93d7..c259a9a7 100644
--- a/app/api/v1/admin/__init__.py
+++ b/app/api/v1/admin/__init__.py
@@ -4,6 +4,7 @@
from app.api.v1.admin.cache import router as cache_router
from app.api.v1.admin.config import router as config_router
+from app.api.v1.admin.logs import router as logs_router
from app.api.v1.admin.token import router as tokens_router
router = APIRouter()
@@ -11,5 +12,6 @@
router.include_router(config_router)
router.include_router(tokens_router)
router.include_router(cache_router)
+router.include_router(logs_router)
__all__ = ["router"]
diff --git a/app/api/v1/admin/logs.py b/app/api/v1/admin/logs.py
new file mode 100644
index 00000000..36012a25
--- /dev/null
+++ b/app/api/v1/admin/logs.py
@@ -0,0 +1,53 @@
+from fastapi import APIRouter, Depends, HTTPException, Query
+
+from app.core.auth import verify_app_key
+from app.core.log_viewer import (
+ LogViewerError,
+ delete_log_files,
+ list_log_files,
+ read_log_entries,
+)
+
+router = APIRouter()
+
+
+@router.get("/logs/files", dependencies=[Depends(verify_app_key)])
+async def get_log_files():
+ return {"files": list_log_files()}
+
+
+@router.get("/logs", dependencies=[Depends(verify_app_key)])
+async def get_logs(
+ file: str,
+ limit: int = Query(default=200, ge=1, le=1000),
+ level: str | None = Query(default=None),
+ keyword: str | None = Query(default=None),
+ exclude_admin_routes: bool = Query(default=False),
+):
+ try:
+ exclude_prefixes = ["/v1/admin/"] if exclude_admin_routes else []
+ return read_log_entries(
+ file,
+ limit=limit,
+ level=level,
+ keyword=keyword,
+ exclude_prefixes=exclude_prefixes,
+ )
+ except FileNotFoundError as exc:
+ raise HTTPException(
+ status_code=404,
+ detail=f"Log file not found: {exc.args[0]}",
+ )
+ except LogViewerError as exc:
+ raise HTTPException(status_code=400, detail=str(exc))
+
+
+@router.post("/logs/delete", dependencies=[Depends(verify_app_key)])
+async def remove_logs(payload: dict):
+ try:
+ files = payload.get("files") or []
+ if not isinstance(files, list) or not files:
+ raise HTTPException(status_code=400, detail="No log files selected")
+ return delete_log_files([str(item) for item in files])
+ except LogViewerError as exc:
+ raise HTTPException(status_code=400, detail=str(exc))
diff --git a/app/core/log_viewer.py b/app/core/log_viewer.py
new file mode 100644
index 00000000..dbc57d2c
--- /dev/null
+++ b/app/core/log_viewer.py
@@ -0,0 +1,227 @@
+from __future__ import annotations
+
+import json
+import os
+from collections import Counter
+from collections.abc import Iterator
+from datetime import datetime
+from pathlib import Path
+from typing import Any
+
+from app.core.logger import LOG_DIR
+
+ALLOWED_SUFFIXES = {".log", ".txt", ".jsonl"}
+DEFAULT_LIMIT = 200
+MAX_LIMIT = 1000
+
+
+class LogViewerError(ValueError):
+ """Raised when log viewer input is invalid."""
+
+
+def list_log_files() -> list[dict[str, Any]]:
+ files: list[dict[str, Any]] = []
+ for path in sorted(_allowed_log_paths().values(), key=_sort_key, reverse=True):
+ stat = path.stat()
+ files.append(
+ {
+ "name": path.name,
+ "size": stat.st_size,
+ "updated_at": datetime.fromtimestamp(stat.st_mtime).isoformat(),
+ }
+ )
+ return files
+
+
+def read_log_entries(
+ file_name: str,
+ *,
+ limit: int = DEFAULT_LIMIT,
+ level: str | None = None,
+ keyword: str | None = None,
+ exclude_prefixes: list[str] | None = None,
+) -> dict[str, Any]:
+ path = _resolve_log_path(file_name)
+ if not path.exists() or not path.is_file():
+ raise FileNotFoundError(file_name)
+
+ limit = max(1, min(int(limit or DEFAULT_LIMIT), MAX_LIMIT))
+ level_normalized = (level or "").strip().lower()
+ keyword_normalized = (keyword or "").strip().lower()
+ prefixes = [prefix.strip() for prefix in (exclude_prefixes or []) if prefix.strip()]
+
+ entries: list[dict[str, Any]] = []
+ counts: Counter[str] = Counter()
+ search_count = 0
+
+ for line in _iter_lines_reverse(path):
+ parsed = _parse_log_line(line)
+ if not _matches(parsed, level_normalized, keyword_normalized, prefixes):
+ continue
+ search_count += 1
+ log_level = str(parsed.get("level") or "unknown").lower()
+ counts[log_level] += 1
+ entries.append(parsed)
+ if len(entries) >= limit:
+ break
+
+ stat = path.stat()
+ return {
+ "file": {
+ "name": path.name,
+ "size": stat.st_size,
+ "updated_at": datetime.fromtimestamp(stat.st_mtime).isoformat(),
+ },
+ "entries": entries,
+ "stats": {
+ "matched": search_count,
+ "levels": dict(counts),
+ },
+ }
+
+
+def delete_log_files(file_names: list[str]) -> dict[str, Any]:
+ deleted: list[str] = []
+ missing: list[str] = []
+ failed: list[str] = []
+
+ for file_name in file_names:
+ path = _resolve_log_path(file_name)
+ if not path.exists() or not path.is_file():
+ missing.append(path.name)
+ continue
+ try:
+ path.unlink()
+ deleted.append(path.name)
+ except OSError:
+ failed.append(path.name)
+
+ return {
+ "deleted": deleted,
+ "missing": missing,
+ "failed": failed,
+ }
+
+
+def _allowed_log_paths() -> dict[str, Path]:
+ if not LOG_DIR.exists():
+ return {}
+
+ base_dir = LOG_DIR.resolve()
+ allowed: dict[str, Path] = {}
+ for path in LOG_DIR.iterdir():
+ if not path.is_file() or path.suffix.lower() not in ALLOWED_SUFFIXES:
+ continue
+ try:
+ resolved = path.resolve()
+ except OSError:
+ continue
+ if resolved.parent != base_dir:
+ continue
+ allowed[path.name] = resolved
+ return allowed
+
+
+def _validate_log_file_name(file_name: str) -> str:
+ candidate = Path(file_name)
+ if candidate.name != file_name:
+ raise LogViewerError("Invalid log file name")
+ if candidate.suffix.lower() not in ALLOWED_SUFFIXES:
+ raise LogViewerError("Unsupported log file")
+ return candidate.name
+
+
+def _resolve_log_path(file_name: str) -> Path:
+ safe_name = _validate_log_file_name(file_name)
+ path = _allowed_log_paths().get(safe_name)
+ if path is None:
+ raise FileNotFoundError(safe_name)
+ return path
+
+
+def _sort_key(path: Path) -> tuple[float, str]:
+ try:
+ return (path.stat().st_mtime, path.name)
+ except OSError:
+ return (0, path.name)
+
+
+def _iter_lines_reverse(path: Path, chunk_size: int = 8192) -> Iterator[str]:
+ with path.open("rb") as handle:
+ handle.seek(0, os.SEEK_END)
+ position = handle.tell()
+ buffer = b""
+
+ while position > 0:
+ read_size = min(chunk_size, position)
+ position -= read_size
+ handle.seek(position)
+ chunk = handle.read(read_size)
+ buffer = chunk + buffer
+ lines = buffer.split(b"\n")
+ buffer = lines[0]
+ for raw_line in reversed(lines[1:]):
+ line = raw_line.decode("utf-8", errors="replace").strip()
+ if line:
+ yield line
+
+ if buffer:
+ line = buffer.decode("utf-8", errors="replace").strip()
+ if line:
+ yield line
+
+
+def _parse_log_line(line: str) -> dict[str, Any]:
+ try:
+ data = json.loads(line)
+ if isinstance(data, dict):
+ parsed = data
+ else:
+ parsed = {"msg": line}
+ except json.JSONDecodeError:
+ parsed = {"msg": line}
+
+ extra = parsed.get("extra")
+ if isinstance(extra, dict):
+ for key, value in extra.items():
+ parsed.setdefault(key, value)
+
+ timestamp = parsed.get("time")
+ parsed["time_display"] = _format_time(timestamp)
+ parsed["level"] = str(parsed.get("level") or "unknown").lower()
+ parsed["msg"] = str(parsed.get("msg") or "")
+ parsed["caller"] = str(parsed.get("caller") or "-")
+ parsed["path"] = str(parsed.get("path") or "")
+ parsed["raw"] = line
+ return parsed
+
+
+def _format_time(value: Any) -> str:
+ if not value:
+ return "-"
+ try:
+ normalized = str(value).replace("Z", "+00:00")
+ dt = datetime.fromisoformat(normalized)
+ return dt.strftime("%Y-%m-%d %H:%M:%S")
+ except ValueError:
+ return str(value)
+
+
+def _matches(
+ entry: dict[str, Any],
+ level: str,
+ keyword: str,
+ exclude_prefixes: list[str],
+) -> bool:
+ if level and entry.get("level") != level:
+ return False
+
+ path = str(entry.get("path") or "")
+ if path and any(path.startswith(prefix) for prefix in exclude_prefixes):
+ return False
+
+ if keyword:
+ haystack = json.dumps(entry, ensure_ascii=False).lower()
+ if keyword not in haystack:
+ return False
+ return True
diff --git a/app/core/response_middleware.py b/app/core/response_middleware.py
index 4c0a07ec..64c582eb 100644
--- a/app/core/response_middleware.py
+++ b/app/core/response_middleware.py
@@ -37,6 +37,7 @@ async def dispatch(self, request: Request, call_next):
"/admin/config",
"/admin/cache",
"/admin/token",
+ "/admin/logs",
):
return await call_next(request)