WisQuery 一套开箱即用、可 Docker 一键部署的 智能问数 + 知识库 + 智能问答 一体化平台

项目地址https://gitee.com/careshow/wis-query.git仅供学习参考一套开箱即用、可 Docker 一键部署的智能问数 知识库 智能问答一体化平台。后端 FastAPI PostgreSQLpgvector pgvector 向量库前端 React Antd遵循 OpenAI 兼容协议可自由接入任何 OpenAI 兼容 LLMOpenAI / DeepSeek / 通义千问 / 智谱 / Ollama / 自建网关…。智能问数模块的思路基于数据源 schema → 让 LLM 生成 SQL → 用 sqlglot 校验只允许 SELECT → 执行查询 → LLM 用自然语言回答。✨ 功能特性用户登录JWT 认证默认管理员自动创建admin / admin123智能问答自定义模型多轮对话会话管理智能问数支持 PostgreSQL / MySQL / SQLiteText-to-SQL图表自动建议SQL 安全校验知识库上传 txt/md/pdf/docx/html → 自动分块 → pgvector 向量检索 → RAG 回答附引用来源⚙️模型管理可视化管理 LLM / Embedding 模型支持一键测试Docker 一键启动三个容器postgres / backend / frontend即可跑起来️ 架构┌────────────────────────────────────────────────────────┐ │ Frontend (React Vite Antd ECharts) nginx │ │ ↓ /api/* 反向代理 │ ├────────────────────────────────────────────────────────┤ │ Backend (FastAPI SQLAlchemy pgvector) │ │ ├─ /auth 登录注册 │ │ ├─ /models LLM/Embedding 模型管理 │ │ ├─ /datasources 数据源管理 Schema 提取 │ │ ├─ /knowledge 知识库 文档 RAG │ │ └─ /chat 三场景统一对话入口 │ ├────────────────────────────────────────────────────────┤ │ PostgreSQL 16 pgvector │ │ ├─ 业务表users / conversations / messages… │ │ └─ knowledge_chunks.embedding 向量存储 │ └────────────────────────────────────────────────────────┘ 快速启动# 1. 克隆 / 进入项目 cd WisQuery # 2. 准备环境变量务必修改 JWT_SECRET_KEY 和 LLM 凭据 cp .env.example .env vim .env # 3. 一键启动 docker compose up -d --build # 首次启动会下载镜像、构建前端、初始化数据库约 2~5 分钟 # 看到 ai-postgres / ai-backend / ai-frontend healthy 即成功 # 4. 访问 # 前端http://localhost:5173 # API 文档http://localhost:5173/api/docs # 默认账号admin / admin123修改 .env 中的关键配置# 必填JWT 密钥生产环境务必改成随机 32 位字符串 JWT_SECRET_KEY32-char-random-string # 必填LLM 凭据OpenAI 兼容协议 DEFAULT_LLM_BASE_URLhttps://api.openai.com/v1 DEFAULT_LLM_API_KEYsk-xxx DEFAULT_LLM_MODELgpt-4o-mini # 必填Embedding 凭据 DEFAULT_EMBEDDING_BASE_URLhttps://api.openai.com/v1 DEFAULT_EMBEDDING_API_KEYsk-xxx DEFAULT_EMBEDDING_MODELtext-embedding-3-small或者不修改 .env直接启动也行启动后用默认账号登录进入「模型管理」页面添加你的模型配置设为默认即可。国内常用模型示例提供商base_urlmodel_nameDeepSeekhttps://api.deepseek.com/v1deepseek-chat智谱 GLMhttps://open.bigmodel.cn/api/paas/v4glm-4-flash通义千问 DashScopeOpenAI 兼容https://dashscope.aliyuncs.com/compatible-mode/v1qwen-plusOllama 本地http://host.docker.internal:11434/v1qwen2.5:7b注意在 Docker 容器内访问宿主机用host.docker.internal:11434。 目录结构. ├── backend/ # FastAPI 后端 │ ├── app/ │ │ ├── api/v1/ # 路由auth / models / datasources / knowledge / chat │ │ ├── core/ # 配置 / 鉴权 / 依赖 │ │ ├── db/ # SQLAlchemy 异步会话 │ │ ├── models/ # ORM │ │ ├── schemas/ # Pydantic │ │ ├── services/ # 业务llm / text2sql / rag / chat / ingest / datasource │ │ ├── init_db.py # 启动建表 种子数据 │ │ └── main.py │ ├── requirements.txt │ └── Dockerfile ├── frontend/ # React 前端 │ ├── src/ │ │ ├── api/ # axios 接口 │ │ ├── pages/ # Login / Chat / Text2SQL / Knowledge / Models / DataSources │ │ ├── components/ # Layout / ChatPanel │ │ ├── store/ # zustand │ │ ├── App.tsx │ │ └── main.tsx │ ├── package.json │ ├── vite.config.ts │ ├── nginx.conf # 反向代理 SPA fallback │ └── Dockerfile ├── docker/ │ └── postgres/init/ # 启动启用 pgvector ├── docker-compose.yml ├── .env.example └── README.md 本地开发后端cd backend python -m venv .venv source .venv/bin/activate pip install -r requirements.txt export DATABASE_URLpostgresqlasyncpg://aiplatform:aiplatform_passlocalhost:5432/aiplatform python -m app.init_db uvicorn app.main:app --reload --port 8000前端cd frontend npm install npm run dev # http://localhost:5173前端 Vite 已经把/api代理到http://backend:8000。️ 安全说明SQL 生成后用sqlglot解析校验只允许 SELECT禁止 DML/DDL。默认管理员密码仅用于首次登录生产环境务必修改FIRST_ADMIN_PASSWORD。JWT 密钥使用JWT_SECRET_KEY务必改成随机字符串。用户注册的接口默认开放生产可在app/api/v1/auth.py中关闭仅允许管理员创建。 常见问题首次启动后端连不上数据库等几秒让 PostgreSQL 完成pg_isready。depends_on: condition: service_healthy已经处理。Embedding 调用报错OpenAI 的text-embedding-3-small维度是 1536。如果换其他模型如text-embedding-3-large3072需要同步修改app/models/knowledge.py中的Vector(1536)。Ollama 在 Docker 里连不上base_url 填http://host.docker.internal:11434/v1。构建前端太慢取消frontend/Dockerfile中npm config set registry ...的注释可走国内镜像。