Spaces:
Paused
Paused
| """ | |
| FastAPI + React 18 单文件全栈应用 | |
| 专为 Kaggle/Colab 环境设计，展示企业级前后端分离架构 | |
| 功能特点： | |
| 1. 后端：FastAPI (异步、高性能、自动文档) | |
| 2. 前端：React 18 + Tailwind CSS (现代化UI、组件化) | |
| 3. 部署：单文件运行，自动处理静态资源，支持 ngrok 穿透 | |
| 使用方法： | |
| python server.py | |
| """ | |
| import os | |
| import sys | |
| import uvicorn | |
| from fastapi import FastAPI, UploadFile, File, HTTPException | |
| from fastapi.responses import HTMLResponse | |
| from fastapi.middleware.cors import CORSMiddleware | |
| from pydantic import BaseModel | |
| from typing import List, Optional | |
| import shutil | |
| # 导入项目核心模块 | |
| # 确保项目根目录在 sys.path 中 | |
| sys.path.append(os.getcwd()) | |
| try: | |
| from config import ENABLE_MULTIMODAL | |
| except Exception: | |
| ENABLE_MULTIMODAL = False | |
| # ============================================================ | |
| # 1. FastAPI 后端定义 | |
| # ============================================================ | |
| app = FastAPI( | |
| title="Adaptive RAG Enterprise API", | |
| description="基于 FastAPI 和 React 构建的企业级 RAG 系统演示", | |
| version="1.0.0" | |
| ) | |
| # 允许跨域 (虽然单体部署不需要，但为了开发规范加上) | |
| app.add_middleware( | |
| CORSMiddleware, | |
| allow_origins=["*"], | |
| allow_credentials=True, | |
| allow_methods=["*"], | |
| allow_headers=["*"], | |
| ) | |
| # 全局 RAG 系统实例 | |
| rag_system = None | |
| def get_rag_system(): | |
| global rag_system | |
| if rag_system is None: | |
| try: | |
| print("🔄 初始化 RAG 系统...") | |
| from main import AdaptiveRAGSystem | |
| rag_system = AdaptiveRAGSystem() | |
| print("✅ RAG 系统初始化完成") | |
| except Exception as e: | |
| print(f"❌ RAG 系统初始化失败: {e}") | |
| raise HTTPException(status_code=500, detail=str(e)) | |
| return rag_system | |
| # --- 数据模型 --- | |
| class ChatRequest(BaseModel): | |
| message: str | |
| history: List[dict] = [] | |
| class ChatResponse(BaseModel): | |
| answer: str | |
| sources: List[str] = [] | |
| metrics: Optional[dict] = None | |
| images: List[str] = [] | |
| # --- API 路由 --- | |
| async def health_check(): | |
| """健康检查接口""" | |
| return {"status": "ok", "service": "Adaptive RAG", "multimodal": ENABLE_MULTIMODAL} | |
| async def chat_endpoint(request: ChatRequest): | |
| """聊天接口""" | |
| system = get_rag_system() | |
| try: | |
| # 调用 RAG 系统的主查询方法 | |
| # 注意：这里假设 main.py 中的 AdaptiveRAGSystem 有 query 方法 | |
| # 如果是 main_graphrag.py，可能需要调整调用逻辑 | |
| result = system.query(request.message) | |
| # 解析结果 | |
| answer = result.get("answer", "无法生成回答") | |
| sources = [doc.page_content[:200] + "..." for doc in result.get("source_documents", [])] | |
| metrics = result.get("retrieval_metrics", {}) | |
| # 处理多模态图片结果 (如果有) | |
| images = [] | |
| if ENABLE_MULTIMODAL and "images" in result: | |
| # 这里简化处理，实际可能需要返回图片URL或Base64 | |
| images = result["images"] | |
| return ChatResponse( | |
| answer=answer, | |
| sources=sources, | |
| metrics=metrics, | |
| images=images | |
| ) | |
| except Exception as e: | |
| import traceback | |
| traceback.print_exc() | |
| raise HTTPException(status_code=500, detail=f"处理请求时出错: {str(e)}") | |
| async def upload_file(file: UploadFile = File(...)): | |
| """文件上传接口""" | |
| try: | |
| # 确保上传目录存在 | |
| upload_dir = "./data/uploads" | |
| os.makedirs(upload_dir, exist_ok=True) | |
| file_path = os.path.join(upload_dir, file.filename) | |
| with open(file_path, "wb") as buffer: | |
| shutil.copyfileobj(file.file, buffer) | |
| return {"filename": file.filename, "status": "success", "message": "文件上传成功，将在下次索引重建时生效"} | |
| except Exception as e: | |
| raise HTTPException(status_code=500, detail=f"文件上传失败: {str(e)}") | |
| # ============================================================ | |
| # 2. 前端 React 应用 (嵌入在 Python 字符串中) | |
| # ============================================================ | |
| HTML_CONTENT = """ | |
| <!DOCTYPE html> | |
| <html lang="zh-CN"> | |
| <head> | |
| <meta charset="UTF-8"> | |
| <meta name="viewport" content="width=device-width, initial-scale=1.0"> | |
| <title>Enterprise RAG System (React)</title> | |
| <!-- 引入 React 和 ReactDOM --> | |
| <script crossorigin src="https://unpkg.com/react@18/umd/react.production.min.js"></script> | |
| <script crossorigin src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script> | |
| <!-- 引入 Babel 用于解析 JSX --> | |
| <script src="https://unpkg.com/@babel/standalone/babel.min.js"></script> | |
| <!-- 引入 Tailwind CSS --> | |
| <script src="https://cdn.tailwindcss.com"></script> | |
| <!-- 引入 Markdown 渲染库 --> | |
| <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script> | |
| <!-- 引入 FontAwesome 图标 --> | |
| <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css"> | |
| <style> | |
| .markdown-body p { margin-bottom: 0.5rem; } | |
| .markdown-body ul { list-style-type: disc; margin-left: 1.5rem; } | |
| .markdown-body ol { list-style-type: decimal; margin-left: 1.5rem; } | |
| .markdown-body pre { background-color: #f3f4f6; padding: 1rem; border-radius: 0.5rem; overflow-x: auto; } | |
| .markdown-body code { background-color: #f3f4f6; padding: 0.2rem 0.4rem; border-radius: 0.25rem; font-family: monospace; } | |
| /* 自定义滚动条 */ | |
| ::-webkit-scrollbar { width: 8px; } | |
| ::-webkit-scrollbar-track { background: #f1f1f1; } | |
| ::-webkit-scrollbar-thumb { background: #cbd5e1; border-radius: 4px; } | |
| ::-webkit-scrollbar-thumb:hover { background: #94a3b8; } | |
| .typing-indicator span { | |
| display: inline-block; | |
| width: 6px; | |
| height: 6px; | |
| background-color: #94a3b8; | |
| border-radius: 50%; | |
| animation: typing 1.4s infinite ease-in-out both; | |
| margin: 0 2px; | |
| } | |
| .typing-indicator span:nth-child(1) { animation-delay: -0.32s; } | |
| .typing-indicator span:nth-child(2) { animation-delay: -0.16s; } | |
| @keyframes typing { | |
| 0%, 80%, 100% { transform: scale(0); } | |
| 40% { transform: scale(1); } | |
| } | |
| </style> | |
| </head> | |
| <body class="bg-slate-50 h-screen flex flex-col font-sans text-slate-800"> | |
| <div id="root" class="h-full w-full"></div> | |
| <script type="text/babel"> | |
| const { useState, useEffect, useRef } = React; | |
| function App() { | |
| const [messages, setMessages] = useState([]); | |
| const [inputMessage, setInputMessage] = useState(''); | |
| const [loading, setLoading] = useState(false); | |
| const [sidebarOpen, setSidebarOpen] = useState(true); | |
| const [showSources, setShowSources] = useState(true); | |
| const [showMetrics, setShowMetrics] = useState(false); | |
| const [multimodalEnabled, setMultimodalEnabled] = useState(false); | |
| const [uploadStatus, setUploadStatus] = useState(null); | |
| const chatContainerRef = useRef(null); | |
| const fileInputRef = useRef(null); | |
| // 初始化检查健康状态 | |
| useEffect(() => { | |
| fetch('/api/health') | |
| .then(res => res.json()) | |
| .then(data => setMultimodalEnabled(data.multimodal)) | |
| .catch(err => console.error("无法连接到后端", err)); | |
| }, []); | |
| // 自动滚动到底部 | |
| useEffect(() => { | |
| if (chatContainerRef.current) { | |
| chatContainerRef.current.scrollTop = chatContainerRef.current.scrollHeight; | |
| } | |
| }, [messages, loading]); | |
| const sendMessage = async () => { | |
| if (!inputMessage.trim() || loading) return; | |
| const userMsg = inputMessage.trim(); | |
| setMessages(prev => [...prev, { role: 'user', content: userMsg }]); | |
| setInputMessage(''); | |
| setLoading(true); | |
| try { | |
| const response = await fetch('/api/chat', { | |
| method: 'POST', | |
| headers: { 'Content-Type': 'application/json' }, | |
| body: JSON.stringify({ message: userMsg }) | |
| }); | |
| if (!response.ok) throw new Error('API request failed'); | |
| const data = await response.json(); | |
| setMessages(prev => [...prev, { | |
| role: 'assistant', | |
| content: data.answer, | |
| sources: data.sources, | |
| metrics: data.metrics, | |
| images: data.images | |
| }]); | |
| } catch (error) { | |
| setMessages(prev => [...prev, { | |
| role: 'assistant', | |
| content: '⚠️ 系统遇到错误，请稍后重试。' | |
| }]); | |
| console.error(error); | |
| } finally { | |
| setLoading(false); | |
| } | |
| }; | |
| const handleFileUpload = async (event) => { | |
| const file = event.target.files[0]; | |
| if (!file) return; | |
| const formData = new FormData(); | |
| formData.append('file', file); | |
| setUploadStatus({ type: 'info', message: '正在上传...' }); | |
| try { | |
| const response = await fetch('/api/upload', { | |
| method: 'POST', | |
| body: formData | |
| }); | |
| if (response.ok) { | |
| setUploadStatus({ type: 'success', message: '上传成功！' }); | |
| } else { | |
| throw new Error('Upload failed'); | |
| } | |
| } catch (error) { | |
| setUploadStatus({ type: 'error', message: '上传失败' }); | |
| } | |
| setTimeout(() => setUploadStatus(null), 3000); | |
| }; | |
| const handleKeyDown = (e) => { | |
| if (e.key === 'Enter' && !e.shiftKey) { | |
| e.preventDefault(); | |
| sendMessage(); | |
| } | |
| }; | |
| return ( | |
| <div className="flex h-full max-w-7xl mx-auto w-full shadow-2xl bg-white overflow-hidden"> | |
| {/* 左侧侧边栏 */} | |
| <div className={`bg-slate-900 text-white flex flex-col flex-shrink-0 transition-all duration-300 ${sidebarOpen ? 'w-64' : 'w-0'}`}> | |
| <div className="p-4 border-b border-slate-700 flex items-center justify-between"> | |
| <div className="flex items-center space-x-2 font-bold text-xl overflow-hidden whitespace-nowrap"> | |
| <i className="fa-solid fa-brain text-blue-400"></i> | |
| <span>Adaptive RAG</span> | |
| </div> | |
| </div> | |
| <div className="flex-1 overflow-y-auto p-4 space-y-6"> | |
| {/* 系统状态 */} | |
| <div> | |
| <h3 className="text-xs font-semibold text-slate-400 uppercase tracking-wider mb-2">系统状态</h3> | |
| <div className="flex items-center space-x-2 text-sm"> | |
| <span className="w-2 h-2 rounded-full bg-green-500"></span> | |
| <span>API 服务正常</span> | |
| </div> | |
| <div className="flex items-center space-x-2 text-sm mt-1"> | |
| <span className={`w-2 h-2 rounded-full ${multimodalEnabled ? 'bg-green-500' : 'bg-gray-500'}`}></span> | |
| <span>多模态支持: {multimodalEnabled ? '开启' : '关闭'}</span> | |
| </div> | |
| </div> | |
| {/* 知识库管理 */} | |
| <div> | |
| <h3 className="text-xs font-semibold text-slate-400 uppercase tracking-wider mb-2">知识库管理</h3> | |
| <div | |
| className="bg-slate-800 rounded-lg p-3 text-center border border-dashed border-slate-600 hover:border-blue-400 transition-colors cursor-pointer" | |
| onClick={() => fileInputRef.current.click()} | |
| > | |
| <input | |
| type="file" | |
| ref={fileInputRef} | |
| className="hidden" | |
| onChange={handleFileUpload} | |
| /> | |
| <i className="fa-solid fa-cloud-arrow-up text-2xl text-slate-400 mb-2"></i> | |
| <p className="text-xs text-slate-300">点击上传 PDF/图片</p> | |
| </div> | |
| {uploadStatus && ( | |
| <p className={`text-xs mt-2 text-center ${uploadStatus.type === 'success' ? 'text-green-400' : 'text-red-400'}`}> | |
| {uploadStatus.message} | |
| </p> | |
| )} | |
| </div> | |
| {/* 设置 */} | |
| <div> | |
| <h3 className="text-xs font-semibold text-slate-400 uppercase tracking-wider mb-2">设置</h3> | |
| <div className="flex items-center justify-between text-sm py-1"> | |
| <span>显示检索源</span> | |
| <button | |
| className={`w-8 h-4 rounded-full relative transition-colors ${showSources ? 'bg-blue-600' : 'bg-slate-700'}`} | |
| onClick={() => setShowSources(!showSources)} | |
| > | |
| <span className={`absolute top-0.5 left-0.5 w-3 h-3 bg-white rounded-full transition-transform ${showSources ? 'translate-x-4' : ''}`}></span> | |
| </button> | |
| </div> | |
| <div className="flex items-center justify-between text-sm py-1"> | |
| <span>显示指标</span> | |
| <button | |
| className={`w-8 h-4 rounded-full relative transition-colors ${showMetrics ? 'bg-blue-600' : 'bg-slate-700'}`} | |
| onClick={() => setShowMetrics(!showMetrics)} | |
| > | |
| <span className={`absolute top-0.5 left-0.5 w-3 h-3 bg-white rounded-full transition-transform ${showMetrics ? 'translate-x-4' : ''}`}></span> | |
| </button> | |
| </div> | |
| </div> | |
| </div> | |
| <div className="p-4 border-t border-slate-700 text-xs text-slate-500 text-center"> | |
| Enterprise Edition v1.0 | |
| </div> | |
| </div> | |
| {/* 主聊天区域 */} | |
| <div className="flex-1 flex flex-col h-full bg-slate-50 relative"> | |
| {/* 顶部导航栏 */} | |
| <div className="h-16 bg-white border-b border-slate-200 flex items-center justify-between px-6 shadow-sm z-10"> | |
| <div className="flex items-center"> | |
| <button onClick={() => setSidebarOpen(!sidebarOpen)} className="text-slate-500 hover:text-slate-700 focus:outline-none mr-4"> | |
| <i className="fa-solid fa-bars text-xl"></i> | |
| </button> | |
| <h1 className="text-lg font-semibold text-slate-700">智能知识库助手 (React版)</h1> | |
| </div> | |
| <div className="flex items-center space-x-4"> | |
| <a href="/docs" target="_blank" className="text-sm text-blue-600 hover:text-blue-800 font-medium"> | |
| <i className="fa-solid fa-book-open mr-1"></i> API 文档 | |
| </a> | |
| </div> | |
| </div> | |
| {/* 聊天记录 */} | |
| <div className="flex-1 overflow-y-auto p-6 space-y-6 scroll-smooth" ref={chatContainerRef}> | |
| {messages.length === 0 && ( | |
| <div className="flex flex-col items-center justify-center h-full text-center space-y-4 opacity-50"> | |
| <div className="w-20 h-20 bg-blue-100 rounded-full flex items-center justify-center text-blue-500 text-4xl mb-4"> | |
| <i className="fa-solid fa-robot"></i> | |
| </div> | |
| <h2 className="text-2xl font-bold text-slate-700">有什么可以帮您？</h2> | |
| <p className="text-slate-500 max-w-md">我可以回答关于知识库的问题，支持多模态检索和图谱分析。</p> | |
| <div className="grid grid-cols-2 gap-4 mt-8 w-full max-w-lg"> | |
| <button onClick={() => setInputMessage('GraphRAG 的核心原理是什么？')} className="p-4 bg-white border border-slate-200 rounded-xl hover:border-blue-400 hover:shadow-md transition-all text-left text-sm"> | |
| GraphRAG 的核心原理是什么？ | |
| </button> | |
| <button onClick={() => setInputMessage('分析这些文档的主要主题')} className="p-4 bg-white border border-slate-200 rounded-xl hover:border-blue-400 hover:shadow-md transition-all text-left text-sm"> | |
| 分析这些文档的主要主题 | |
| </button> | |
| </div> | |
| </div> | |
| )} | |
| {messages.map((msg, index) => ( | |
| <div key={index} className={`flex flex-col space-y-2 ${msg.role === 'user' ? 'items-end' : 'items-start'}`}> | |
| {msg.role === 'user' ? ( | |
| <div className="flex items-end space-x-2 max-w-[80%]"> | |
| <div className="bg-blue-600 text-white px-5 py-3 rounded-2xl rounded-tr-none shadow-md"> | |
| {msg.content} | |
| </div> | |
| <div className="w-8 h-8 rounded-full bg-slate-200 flex items-center justify-center text-slate-500 flex-shrink-0"> | |
| <i className="fa-solid fa-user"></i> | |
| </div> | |
| </div> | |
| ) : ( | |
| <div className="flex items-start space-x-3 max-w-[90%] w-full"> | |
| <div className="w-8 h-8 rounded-full bg-green-100 flex items-center justify-center text-green-600 flex-shrink-0 mt-1"> | |
| <i className="fa-solid fa-robot"></i> | |
| </div> | |
| <div className="flex flex-col space-y-2 w-full"> | |
| <div | |
| className="bg-white border border-slate-200 px-6 py-4 rounded-2xl rounded-tl-none shadow-sm w-full markdown-body" | |
| dangerouslySetInnerHTML={{ __html: marked.parse(msg.content) }} | |
| ></div> | |
| {showSources && msg.sources && msg.sources.length > 0 && ( | |
| <div className="bg-slate-50 border border-slate-200 rounded-xl p-3 text-xs text-slate-600 mt-2"> | |
| <div className="font-semibold mb-2 flex items-center text-slate-400"> | |
| <i className="fa-solid fa-quote-left mr-2"></i> 参考来源 | |
| </div> | |
| {msg.sources.map((source, idx) => ( | |
| <div key={idx} className="mb-2 last:mb-0 pl-3 border-l-2 border-blue-300"> | |
| {source} | |
| </div> | |
| ))} | |
| </div> | |
| )} | |
| {showMetrics && msg.metrics && ( | |
| <div className="flex flex-wrap gap-2 mt-1"> | |
| <span className="px-2 py-1 bg-slate-100 rounded text-xs text-slate-500 border border-slate-200"> | |
| <i className="fa-solid fa-clock mr-1"></i> {msg.metrics.latency ? msg.metrics.latency.toFixed(3) : 0}s | |
| </span> | |
| <span className="px-2 py-1 bg-slate-100 rounded text-xs text-slate-500 border border-slate-200"> | |
| <i className="fa-solid fa-file-lines mr-1"></i> Docs: {msg.metrics.retrieved_docs_count || 0} | |
| </span> | |
| </div> | |
| )} | |
| </div> | |
| </div> | |
| )} | |
| </div> | |
| ))} | |
| {loading && ( | |
| <div className="flex items-start space-x-3"> | |
| <div className="w-8 h-8 rounded-full bg-green-100 flex items-center justify-center text-green-600 flex-shrink-0 mt-1"> | |
| <i className="fa-solid fa-robot"></i> | |
| </div> | |
| <div className="bg-white border border-slate-200 px-5 py-3 rounded-2xl rounded-tl-none shadow-sm"> | |
| <div className="typing-indicator"> | |
| <span></span><span></span><span></span> | |
| </div> | |
| </div> | |
| </div> | |
| )} | |
| </div> | |
| {/* 输入区域 */} | |
| <div className="bg-white p-4 border-t border-slate-200"> | |
| <div className="max-w-4xl mx-auto relative"> | |
| <textarea | |
| value={inputMessage} | |
| onChange={(e) => setInputMessage(e.target.value)} | |
| onKeyDown={handleKeyDown} | |
| placeholder="输入您的问题... (Shift + Enter 换行)" | |
| className="w-full pl-4 pr-12 py-3 bg-slate-50 border border-slate-200 rounded-xl focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent resize-none shadow-inner text-sm" | |
| rows="2" | |
| ></textarea> | |
| <button | |
| onClick={sendMessage} | |
| disabled={loading || !inputMessage.trim()} | |
| className="absolute right-2 bottom-2.5 p-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 disabled:opacity-50 disabled:cursor-not-allowed transition-colors shadow-md" | |
| > | |
| <i className="fa-solid fa-paper-plane"></i> | |
| </button> | |
| </div> | |
| <div className="text-center mt-2 text-xs text-slate-400"> | |
| Powered by Adaptive RAG & FastAPI & React | |
| </div> | |
| </div> | |
| </div> | |
| </div> | |
| ); | |
| } | |
| const root = ReactDOM.createRoot(document.getElementById('root')); | |
| root.render(<App />); | |
| </script> | |
| </body> | |
| </html> | |
| """ | |
| async def read_root(): | |
| """返回单页应用前端""" | |
| return HTMLResponse(content=HTML_CONTENT) | |
| if __name__ == "__main__": | |
| print("="*60) | |
| print("🚀 企业级 RAG 服务器启动中...") | |
| print(" 后端: FastAPI") | |
| print(" 前端: Vue 3 + Tailwind") | |
| print(" 地址: http://0.0.0.0:8000") | |
| print(" 文档: http://0.0.0.0:8000/docs") | |
| print("="*60) | |
| uvicorn.run(app, host="0.0.0.0", port=8000) | |