{"repo":"biao994/DocPaws","free":true,"listed":false,"github":"https://github.com/biao994/DocPaws","clone":"git clone https://github.com/biao994/DocPaws.git","description":"工程化 RAG 文档助手：知识库、PDF 索引、Agent 工具编排、scope 检索、引用溯源与拒答阈值。FastAPI + Vue3","language":"Python","stars":189,"topics":["fastapi","langchain","rag","vue"],"license":"MIT","category":"ai-agents","readme_excerpt":"# DocPaws 工程化 RAG 文档助手：知识库管理、PDF 索引、流式对话、引用与检索阈值拒答。 后端 FastAPI + SQLModel，前端 Vue 3 + Vite。 架构文档见 docs/architecture/layering.md 、 usecases-style.md 。 详细后端说明见 backend/README.md ，评估见 eval/README.md 。 界面预览 首页 — Welcome、会话侧栏、选知识库输入框。 知识库浏览 — 个人知识库、文件夹树、PDF 上传。 RAG 对话与引用 — 库内有答案的问题，流式回答、来源引用、scope（全库 / 文件夹 / 单文件）。 检索拒答 — 库外问题或距离未过阈值时拒答，避免幻觉。 核心能力 - 个人知识库、文件夹、PDF 上传与 manifest 增量索引 - RAG 对话（ scope ：全库 / 文件夹 / 单文件）、流式 SSE、思考过程展示 - 检索距离阈值拒答 （ RETRIEVAL MAX DISTANCE ，详见 backend/README.md ） - Golden 20 可复现评估（ eval/ ） 环境要求 - Miniconda 或 Anaconda（推荐 Conda 管理后端 Python 3.11） - Node.js 20+（前端） - Docker（推荐： docker compose up -d 起 Postgres + Redis + MinIO） - LLM + Embedding API Key（DeepSeek / OpenAI 兼容 / SiliconFlow 等） 快速启动 0. 基础设施 在项目根目录 DocPaws/ ： 服务 地址 说明 ------ ------ ------ PostgreSQL 127.0.0.1:5432 账号 docpaws / docpaws ，库 docpaws MinIO API http://127.0.0.1:9000 上传 PDF 对象存储 MinIO 控制台 http://127.0.0.1:9001 账号 minioadmin / minioadmin123 Redis 127.0.0.1:6379 DB /0 缓存， /1 Celery broker， /2 result 停止： docker compose down （数据在 Docker volume 中保留）。 1. 后端 在 Anaconda Prompt 或已 conda init 的终端中，于项目根目录操作： 复制环境变量并填入 API Key（Windows PowerShell）： macOS / Linux： cp .env.example .env 。其余变量见 .env.example 注释。 - API 文档： - 数据库：不设 DATABASE URL 时用 SQLite（ backend/data/ ）；生产建议在 .env 配置 DATABASE URL=postgresql+psycopg://docpaws:docpaws@127.0.0.1:5432/docpaws - 上传与 FAISS 索引仍在 backend/data/ （或 .env 指定路径） 2. 前端 - 开发地址： - /api 由 Vite 代理到 http://127.0.0.1:8000 ；改后端端口时同步改 frontend/vite.config.js - CORS ORIGINS 需包含前端 Orig","default_branch":null,"files":null,"tree":[],"storefront":"/r/biao994","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/biao994/DocPaws/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}