与你的文档聊天 — RAG 问答产品系统

面向需求方：中小企业、咨询与律师事务所、客服与运营团队、培训机构——所有"手头有一堆文档、需要快速从里面找到答案"的团队。
行业痛点：
文档分散（合同、手册、政策、报告），人工检索慢且容易漏
传统搜索只能做关键词匹配，问不出"跨文档的综合答案"
市面上多数演示需要 API Key、向量数据库、复杂环境才能跑，客户无法在 1 分钟内判断价值
适用行业：法律服务（合同条款问答）、金融（合规文档检索）、电商（客服知识库）、医疗（诊疗指南检索）、教育培训（课程资料问答）。

多格式文档上传：PDF / DOCX / TXT / Markdown / CSV / JSON / 日志
任意语言提问，回答流式输出（打字机效果）
回答附带来源引用：每条结论可点击查看原始文档段落，可验证、可追溯
混合检索：词法打分 + 可选向量嵌入，无 Key 也能获得良好检索效果
多 LLM 供应商：OpenAI / DeepSeek / Anthropic Claude / 本地 Ollama，一个接口全兼容
零配置 Demo 模式：无需任何 API Key 即可完整体验全流程
自带 Key（BYOK）：访客可在界面粘贴自己的 Key 立即体验，无需服务器配置
多文档联合搜索 + 会话历史：支持追问与上下文

后端：Python + FastAPI； 前端：原生 JS 单页应用
解析层：DOCX 用标准库直接解 ZIP/XML； PDF 用 pypdf + 内置纯标准库兜底解析器——可选库缺失也绝不崩溃
检索层：纯 Python 稀疏向量余弦相似度（无 NumPy、离线可用），配置嵌入接口后自动升级为"词法 + 稠密"混合打分
LLM 层：OpenAI 兼容协议（覆盖 OpenAI/DeepSeek/Ollama/vLLM）+ Anthropic 原生 Messages API + Demo 模式三路实现，统一异步流式接口
流式传输：SSE 逐 token 推送（sources / token / done / error 事件）
存储：JSON 文件持久化，重启不丢数据，无数据库依赖
部署：单容器 Docker（ 即上线），内置健康检查docker compose up
测试：30 个自动化测试（解析、分块、检索排序、完整 API 生命周期），标准库 unittest 即可运行