一个用于生成 AI 辅助绩效评估报告 的 Web 系统。核心流程:用户登录 → 创建项目 → 上传材料 → 逐步执行工作流 → 生成内容 → 支持多模型对比、人工复核、版本历史,并导出为 Word / PDF。后台管理台可管理 Prompt、知识库与模型配置。
- 多步骤工作流:step1–step14 分步生成评估报告,支持多轮人工复核与确认提交
- 多模型对比:同一环节并行对比多个模型输出,择优采纳
- 双层短期记忆:后端 LangGraph MemorySaver + 前端 localStorage 双保险,未确认前不落业务表
- 版本历史:每次确认提交生成版本快照,可回溯
- 导出:一键导出 Word / PDF
- 管理台:用户管理、模型注册、Prompt / 知识库管理、审计日志、用量分析
| 层 | 技术 |
|---|---|
| 前端 | Vue 3 + TypeScript + Vite + Element Plus + Tailwind CSS + Pinia |
| 后端 | FastAPI + LangGraph(agentic workflow) |
| 数据 | PostgreSQL(主库)+ Redis(缓存 / 任务) |
| 存储 | 本地文件(data/uploads 上传、data/outputs 产出) |
/f/AgentSystem/
├── frontend/ # Vue 3 应用
│ ├── src/
│ │ ├── pages/ # 页面组件
│ │ ├── components/ # 可复用组件
│ │ ├── layouts/ # 布局模板
│ │ ├── router/ # 路由
│ │ ├── stores/ # Pinia 状态
│ │ ├── services/ # axios API 客户端
│ │ ├── styles/ # Tailwind + CSS
│ │ └── assets/
│ └── package.json
├── Backend/
│ ├── app/ # FastAPI 应用
│ │ ├── api/v1/routes/ # 路由(auth/chat/projects/files/steps…)
│ │ ├── core/ # 配置、异常、依赖注入
│ │ ├── services/ # 业务逻辑层
│ │ ├── models/ # SQLAlchemy ORM
│ │ ├── schemas/ # Pydantic 请求/响应
│ │ └── main.py # FastAPI 实例
│ ├── agent/ # LangGraph 项目(user_graphs / admin_graphs)
│ ├── database_schema.sql # PostgreSQL schema
│ └── pyproject.toml # 依赖(uv 管理)
└── docs/ # 设计文档中心
- Node.js 20+ / pnpm
- Python 3.11+ / uv
- PostgreSQL(默认连接
postgres:123456@localhost:5432/postgres) - Redis(使用异步 worker 时需要)
cd Backend
uv sync
uv run python init_db.py # 或直接把 database_schema.sql 导入 PostgreSQLcd Backend
uv run uvicorn app.main:app --reload # http://localhost:8000cd frontend
pnpm install
pnpm dev # http://localhost:5173cd Backend/agent
pip install -e ".[dev]"
langgraph dev # LangGraph Studio: http://localhost:2024前端已配置通过 GitHub Actions 自动构建并部署到 GitHub Pages,推送到 main 分支即触发部署。
说明:GitHub Pages 只能托管静态前端,后端(FastAPI + PostgreSQL + Redis)无法一起部署。当前为静态占位部署——页面(首页 / 登录页等 UI)可正常打开,登录、项目等需要后端的交互功能需另接远程后端后可用。若你已有远程后端,在 frontend/.env.production 中配置 VITE_API_BASE_URL 指向它,重新构建即可接通。
frontend/vite.config.ts:生产构建base = '/EvalFlow-Pro/'(Pages 子路径);开发仍为/frontend/src/router/index.ts:路由使用 hash 模式(createWebHashHistory),避免刷新子页面 404.github/workflows/deploy-pages.yml:push 到main自动构建并部署到 Pages。由于项目存在历史 TS 类型错误,CI 用vite build跳过vue-tsc类型检查(本地pnpm build会因类型检查失败,属已知问题,建议后续单独清理)
首次使用需在 GitHub 仓库 Settings → Pages → Source 选择 GitHub Actions。
GitHub 直接访问可能较慢,可用镜像代理加速 clone / 下载。以下前缀任选其一(失效时换另一个):
# 加速 clone
git clone https://ghfast.top/https://github.com/linnanjun007-crypto/EvalFlow-Pro.git
git clone https://gh-proxy.com/https://github.com/linnanjun007-crypto/EvalFlow-Pro.git
git clone https://ghproxy.net/https://github.com/linnanjun007-crypto/EvalFlow-Pro.git设计文档集中在 docs/(系统设计 / 架构图 / 模块拆分 / 技术方案 / 数据库设计 / API 契约 / 任务 DAG),索引见 docs/README.md。本地启动步骤见 GETTING-STARTED.md。ECC 工具使用见 ECC-GUIDE.md。