[Proposal] 可视化知识库管理与项目部署体验 #10

背景

EduAvatar 包含 LangGraph Agent、FAISS 知识库管理服务和数字人前端等多个组件。当前功能可以通过命令行和管理界面运行，但首次配置、处理进度、错误定位和部署检查仍需要更完整的用户体验。

目标

让教师或开发者通过可视化界面完成“上传资料 → 构建索引 → 查看知识 → 检索测试”的闭环，并能可靠地配置、启动和检查项目服务。

当前能力

• 知识库管理服务支持文件上传和文本入库。
• 支持从指定目录批量构建知识库。
• 支持查看知识列表和执行检索测试。
• LangGraph Agent 与数字人前端可作为两个本地服务分别启动。
• 项目已提供依赖文件、环境变量示例和基础启动命令。
• 浏览器端提供数字人问答交互界面。

Proposal（后续完善）

• 为上传、解析、分块、向量化和保存阶段显示处理进度。
• 为不支持的文件、模型下载失败、端口占用等问题提供操作建议。
• 增加统一的启动前配置检查，验证 API Key、模型、索引和端口。
• 为 Agent、知识库服务和数字人前端增加健康检查接口。
• 提供开发环境与生产环境的分步部署文档。
• 增加日志入口和必要的敏感信息隐藏规则。
• 提供一键启动脚本或容器编排示例，但保留手动启动方式。

验收标准

• 用户可在界面完成上传、入库、列表查看和检索测试。
• 长时间处理任务能够显示阶段和进度，不会表现为无响应。
• 缺少 API Key、模型文件、知识库索引或端口冲突时可在启动前发现。
• Agent、知识库服务和数字人前端均提供可检查的健康状态。
• 部署文档包含环境要求、配置、启动、端口和常见问题。
• 日志不会输出 API Key 等敏感配置。
• 自动化启动失败后仍能按照文档手动启动各组件。

涉及模块

• faiss_frontend/app.py
• faiss_frontend/templates/
• backend/agent/langgraph.json
• fronted/LiveTalking-main/app.py
• 项目根目录 README 与部署文档