AI ForgeAI-Native Workspace— 把 AI 对话、Agent 流水线、知识库 RAG、代码审查统一到一个工作台。已完成8 个阶段基础架构 → AI Chat → Agent Pipeline → Code Review → RAG → Redis/PostgreSQL/RabbitMQ → 测试与安全加固 → Docker 一键部署。https://github.com/lfl171/ai_forge.git特性多轮对话 SSE 流式模型逐 token 输出前端实时渲染 Markdown。Agent 流水线Requirement → Architecture → Database → API → Code Review 五阶段编排状态机驱动 异步事件推送。知识库 / RAG文档按 heading 分块CJK bigram 检索限域查询。代码审查Monaco 编辑器 AI 返回结构化 JSONscore / issues / suggestion。双 Profiledev零依赖内存模式prodPostgreSQL Redis RabbitMQ 一键拉起。安全加固请求体上限、CORS 白名单、AI 端点限流、安全响应头、错误信息收敛、Bean Validation。技术栈层选型前端React 18 · TypeScript · Vite 5 · Tailwind · Zustand · Monaco Editor · react-markdown后端Spring Boot 3.3 · Java 17 · Maven · Actuator数据PostgreSQL 16 · Redis 7 · RabbitMQ 3.13部署Docker · docker compose · nginx模块模块路径说明Dashboard/欢迎区、快捷入口、最近任务AI Chat/chat多轮对话 · Markdown · SSE 流式AI Agent/agent多 Agent Pipeline 可视化 实时事件Knowledge/knowledge知识库 / 文档 / RAG 检索Code Review/reviewMonaco Editor AI 结构化审查Tasks/tasksChat / Agent / Review / RAG 任务中心History/history按天聚合的任务历史Settings/settingsAPI Key / 模型 / 主题启动方式1. Docker 一键拉起推荐前提Docker Desktop / Docker Engine 已启动。# 在仓库根目录与本 README 同级# 1. 准备 LLM 凭据也可放进 .envexportAI_API_KEYsk-xxxexportAI_MODELgpt-4o-mini# 2. 构建 启动 postgres / redis / rabbitmq / backend / frontenddockercompose up-d--build# 3. 浏览器访问 http://localhost服务端口服务端口说明frontend (nginx)80唯一对外入口backend8080仅供内部访问可选直接访问调试postgres5432redis6379rabbitmq mgmt15672guest/guest关闭dockercompose down# 保留数据卷dockercompose down-v# 同时清理数据卷2. 本地开发dev profile零依赖适合前端 / 后端单端调试。前端cdfrontendnpminstallnpmrun dev# http://localhost:5173Vite proxy 把 /api 转发到 :8080后端dev profile内存仓储不连任何外部服务cdbackend mvn spring-boot:run# 或mvn -DskipTests package java -jar target/ai-forge-backend-0.1.0.jar# 健康检查curl http://localhost:8080/actuator/healthdev profile不会启动 JPA / Redis / RabbitMQ 自动配置Windows / Linux 装机即可跑。3. 本地模拟 prod 链路连真实基础设施# 后端依赖postgres / redis / rabbitmqdockercompose up-dpostgres redis rabbitmqcdbackendSPRING_PROFILES_ACTIVEprod mvn spring-boot:run配置 LLMAPI Key只在后端环境变量前端绝对不可见。# OpenAIexportAI_PROVIDERopenaiexportAI_API_KEYsk-xxxexportAI_MODELgpt-4o-mini# DeepSeekexportAI_PROVIDERdeepseekexportAI_BASE_URLhttps://api.deepseek.com/v1exportAI_MODELdeepseek-chatexportAI_API_KEYsk-xxx# 通义千问DashScope OpenAI 兼容exportAI_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1exportAI_MODELqwen-turboexportAI_API_KEYsk-xxx# MoonshotexportAI_BASE_URLhttps://api.moonshot.cn/v1exportAI_MODELmoonshot-v1-8kexportAI_API_KEYsk-xxx关键 APIPOST /api/chat/conversations 创建会话 GET /api/chat/conversations 会话列表 GET /api/chat/conversations/{id}/messages 历史消息 DELETE /api/chat/conversations/{id} 删除会话 POST /api/chat/conversations/{id}/stream SSE 流式对话 POST /api/agent/pipelines 创建 Agent 流水线 GET /api/agent/pipelines/{id} 查询状态 GET /api/agent/pipelines/{id}/events SSE 实时事件 POST /api/review 代码审查结构化 JSON POST /api/knowledge/bases 创建知识库 POST /api/knowledge/bases/{id}/documents 上传文档自动分块 POST /api/knowledge/bases/{id}/query RAG 检索问答 GET /actuator/health 健康检查携带 X-Request-Id 等安全响应头完整接口与事件说明见docs/API.md。安全要点Phase 07请求体上限表单 1MBheader 16KB文件 2MB swallow。入参校验Bean ValidationNotBlank/Size上传前Sanitizers.safeFilename。CORS通过forge.cors.allowed-origins白名单环境变量注入。AI 端点限流令牌桶forge.ratelimit.{window-seconds, max-requests}默认 60s/30 次返回 429 Retry-After。安全响应头X-Content-Type-Options、X-Frame-Options: DENY、Referrer-Policy、Permissions-Policyprod 额外Strict-Transport-Security。错误收敛5xx 不回传原始异常统一 “服务异常请稍后重试”全量堆栈仍写入日志。项目结构ai-forge/ ├── backend/ # Spring Boot 3.3 (Maven) │ ├── src/main/java/com/aiforge/ │ │ ├── ai/ # AiClient ChatRequest TokenSink │ │ ├── chat/ # Chat / Conversation 实体、Controller、Service │ │ ├── agent/ # Pipeline 状态机、Agent 编排 │ │ ├── knowledge/ # Chunker / Retriever / RAG │ │ ├── review/ # 代码审查 │ │ ├── security/ # Sanitizers / Filters │ │ └── config/ # Cors / Cache / Redis / Rabbit / GlobalException │ ├── src/main/resources/ # application.yml dev / prod profile │ ├── src/test/java/ # 24 个单元测试 Spring 上下文加载测试 │ ├── Dockerfile │ └── pom.xml ├── frontend/ # React 18 Vite TS │ ├── src/ │ │ ├── pages/ # Dashboard / Chat / Agent / Knowledge / Review ... │ │ ├── components/ # 通用 UI 组件 │ │ ├── stores/ # Zustand stores │ │ └── lib/ # API client │ ├── nginx.conf │ ├── Dockerfile │ └── package.json ├── docs/ # API / 架构 / 博客素材 ├── docker-compose.yml # postgres redis rabbitmq backend frontend └── README.md阶段路线Phase内容状态01项目骨架 UI✅02AI Chat SSE 真实流式✅03Agent Pipeline 调度✅04Code Review✅05Knowledge Base RAG✅06Redis PostgreSQL RabbitMQ✅07测试 安全加固✅08Docker 文档 博客素材✅LicenseMIT — 仅供学习交流生产使用请自行评估 LLM 凭据管理与依赖安全。