Doc Agent Web 🤖

基于 Vue 3 + Vite 的智能文档问答前端界面，配合 doc-agent 后端提供 RAG (检索增强生成) 文档问答功能。

✨ 功能特性

• 💬 智能对话 - 基于文档内容的 AI 问答
• 📄 文档管理 - 上传、查看、删除文档
• 🔧 服务状态 - 查看后端服务健康状态
• 📚 引用来源 - 显示答案来源文档
• 🎨 现代 UI - 响应式设计，深色主题

🛠️ 技术栈

• 前端框架: Vue 3 + Vue Router
• 构建工具: Vite 5
• UI 组件: 自定义组件
• Markdown 渲染: marked
• HTTP 客户端: Axios (通过 API 代理)

📦 项目结构

doc-agent-web/
├── src/
│   ├── App.vue              # 根组件
│   ├── main.js              # 入口文件
│   ├── router/              # 路由配置
│   ├── views/               # 页面组件
│   │   ├── Chat.vue         # 对话页面
│   │   ├── Documents.vue    # 文档管理
│   │   └── Health.vue       # 服务状态
│   └── components/          # 可复用组件
├── public/                  # 静态资源
├── index.html               # HTML 模板
├── vite.config.js           # Vite 配置
├── nginx.conf               # Nginx 配置
├── Dockerfile               # Docker 构建
└── docker-compose.yml       # Docker 编排

🚀 快速开始

本地开发

# 安装依赖
npm install

# 启动开发服务器 (带热重载)
npm run dev

# 构建生产版本
npm run build

# 预览生产构建
npm run preview

Docker 部署

# 构建并启动
docker compose up -d --build

# 查看日志
docker compose logs -f

# 停止服务
docker compose down

访问 http://localhost:3000

🔌 API 配置

前端通过 Nginx 反向代理连接到后端 API：

• 开发环境: http://localhost:3000/api → http://localhost:8000
• 生产环境: http://doc-agent-backend:8000

📝 环境变量

创建 .env 文件（可选）：

VITE_API_BASE_URL=http://localhost:8000

🐳 Docker 说明

镜像构建

• 构建阶段: Node.js 20 Alpine - 安装依赖并构建
• 运行阶段: Nginx 1.27 Alpine - 托管静态文件

端口映射

• 3000:80 - Web 界面

依赖服务

• doc-agent-backend - 后端 API 服务（必需）

📄 许可证

MIT License

🤝 相关项目

• doc-agent - 后端 API 服务

📞 支持

如有问题，请提交 Issue 或联系作者。