ITERATION_4.md

迭代 4：打磨 — Gradio UI + 最终测试

日期: 2026-05-12 状态: 已完成

---

新增组件

Gradio Web UI

• 对话界面 + 调试面板 + 示例问题
• 实时流式返回（通过 graph.stream）
• 来源引用展示

最终测试

测试项	结果
全模块导入	✅
知识图谱构建 (79节点, 269边)	✅
图游走 (buckling → 22结果)	✅
LangGraph 编译 (7节点)	✅
Query 分类 (中英文)	✅
Agentic RAG 端到端 (3题)	✅
FastAPI /health	✅ (200)
RAGAS 评估框架	✅ (5 ground-truth cases)

---

项目总览

完整技术栈

层	组件
数据处理	PyMuPDF + LangChain TextSplitters + 自定义分块
索引	ChromaDB (稠密) + BM25 (稀疏) + NetworkX (知识图谱)
嵌入	BGE-M3 (FlagEmbedding), 1024维
Agent 框架	LangGraph (Supervisor + 5个专业Agent)
LLM	DeepSeek V4 Pro (API)
后端	FastAPI + SSE 流式
UI	Rich CLI + Gradio Web
评估	RAGAS (5 ground-truth cases)
部署	Docker Compose
版本管理	Git + GitHub (https://github.com/ZSHYC/cer-rag)

代码规模

• 36 个源文件
• ~2,800 行 Python
• 4 篇迭代文档