🌐 在线预览 • 📦 GitHub • 📦 Gitee • 📖 部署文档
一个功能强大的全栈 AI 代码生成平台，基于 Spring Boot 3.5.4 和 Vue 3 构建，集成 GPT、Qwen 等多种 AI 模型，专注于 Vue 3 项目的智能化生成服务。支持 AI 模型动态选择、两阶段代码生成、代码自动验证等先进功能。
AI Code Mother 是一个现代化的 AI 驱动代码生成平台，旨在通过人工智能技术简化和加速 Vue 3 应用开发流程。系统专注于 Vue 3 项目的智能化生成，通过动态模型选择、两阶段代码生成、自动代码验证等先进功能，为开发者提供高效、智能、可靠的代码生成解决方案。
- 🤖 动态模型选择: 支持 GPT、Qwen、OpenAI 等 20+ 个 AI 模型，根据任务复杂度智能选择
- 📋 两阶段生成: 计划生成 → 用户确认 → 代码生成，避免无效生成节省成本
- ✅ 代码自动验证: 集成 ESLint 代码质量检查，自动生成代码审查报告
- 🎯 Vue 3 专注: 专为 Vue 3 项目优化，支持 Composition API、TypeScript、Pinia 等现代特性
- 🔄 实时流式输出: 基于 SSE (Server-Sent Events) 的实时代码生成进度展示
- 📧 邮箱认证: 支持邮箱注册登录，邮件验证码双因素认证，提升账户安全性
- 🎁 积分系统: 完善的积分获取、消耗、过期机制（已修复 8 个 P0-P3 级别缺陷）
- 👥 邀请机制: 邀请码系统，邀请双方均可获得积分奖励，配套防刷机制
- 📦 版本管理: 完整的应用版本历史记录、一键回滚功能
- 🚀 一键部署: 规范的 deployment/ 目录，支持 Ubuntu 服务器一键部署
- 🔄 备份回滚: 自动备份数据库、应用、配置，支持交互式回滚
- 📊 监控系统: 集成 Prometheus 指标监控，支持 Grafana 可视化
- 🛡️ 安全加固: 支持 OpenResty 限流、WAF 防护、日志轮转
- ☁️ 腾讯云 COS: 生成文件自动上传云端，CDN 加速访问
- 🔧 智能工具: 网页截图、项目下载、代码预览、差异对比等实用功能
- 📱 全栈架构: Spring Boot 后端 + Vue 3 前端的现代化全栈解决方案
核心框架
- Spring Boot 3.5.4: 基于Java 21的现代化Spring应用框架
- Spring Web: RESTful API开发
- Spring AOP: 切面编程支持，用于权限校验和日志记录
- Spring Session: 分布式会话管理，支持Redis存储
AI集成
- LangChain4j 1.1.0: Java AI 应用开发框架，支持工具调用和流式输出
- LangGraph4j 1.6.0: AI 工作流编排引擎，支持复杂任务编排
- 动态模型工厂: 支持 20+ 个 AI 模型的动态选择和配置
- GPT-5 Codex: 高级编码模型，用于复杂代码生成
- GPT-5 Low: 基础编码模型，快速响应
- Qwen Turbo: 快速分类和简单任务处理
- 其他 OpenAI 兼容模型: 支持多种第三方模型
- AI 模型等级系统: 基础编码、标准编码、高级编码、基础推理、高级推理 5 个等级
- Reactor: 响应式编程支持 Server-Sent Events 流式输出
数据层
- MyBatis-Flex 1.11.0: 灵活的MyBatis增强ORM框架
- MySQL: 主数据库，存储用户、应用、版本、积分等数据
- HikariCP: 高性能数据库连接池
- 雪花算法: 分布式唯一ID生成策略
缓存与会话
- Redis 6.0+: 会话存储、邮箱验证码缓存
- Caffeine: 高性能本地缓存，优化热点数据访问
- Redisson 3.50.0: 分布式锁、高级Redis客户端
监控与运维
- Spring Boot Actuator: 应用监控和管理端点
- Micrometer + Prometheus: 指标收集和监控
- Grafana: 监控数据可视化(可选)
- 定时任务: 积分过期、邀请奖励自动发放
文档与工具
- Knife4j 4.4.0: Swagger UI增强版API文档
- Hutool 5.8.38: Java工具类库
- Lombok 1.18.36: 代码简化注解
云服务集成
- 腾讯云COS 5.6.227: 对象存储服务，用于文件存储和CDN加速
- Spring Mail: 邮件发送服务，用于验证码和通知
Web自动化
- Selenium 4.33.0: 网页自动化和截图
- WebDriverManager 6.1.0: 浏览器驱动自动管理
核心框架
- Vue 3.5.17: 渐进式JavaScript框架，使用Composition API
- TypeScript 5.8.0: 类型安全的JavaScript超集
- Vite 7.0.0: 下一代前端构建工具，极速热重载
UI与组件
- Ant Design Vue 4.2.6: 企业级UI组件库
- Vue Router 4.5.1: 官方路由管理器
- Pinia 3.0.3: 新一代状态管理库
HTTP与API
- Axios 1.11.0: Promise based HTTP客户端
- OpenAPI Generator: 从后端OpenAPI规范自动生成TypeScript客户端
内容渲染
- Markdown-it 14.1.0: Markdown解析和渲染引擎
- highlight.js 11.11.1: 语法高亮显示库，支持200+编程语言
开发工具
- ESLint: JavaScript/TypeScript代码检查
- Prettier: 代码格式化工具
- Vue DevTools: Vue调试工具
- Vue TSC: Vue TypeScript类型检查
系统包含 10 个核心数据表：
- user: 用户信息表，支持邮箱注册、邮箱验证
- user_points: 用户积分表，记录累计积分和可用积分
- points_record: 积分记录表，记录积分获取和消耗明细（新增 status 字段支持积分状态管理）
- invite_record: 邀请关系表，记录邀请人、被邀请人及奖励状态
- sign_in_record: 签到记录表，记录用户签到历史
- app: 应用信息表，存储用户创建的应用配置（新增 modelKey 字段支持动态模型选择）
- app_version: 应用版本表，记录每次应用修改的版本历史（新增 codeContentUrl 字段）
- chat_history: 聊天记录表，存储用户与 AI 的对话历史
- email_verification_code: 邮箱验证码表，临时存储验证码用于注册登录
- ai_model_config: AI 模型配置表，存储所有可用 AI 模型的配置信息（🆕 v1.1.0）
技术特性
- 雪花算法ID生成策略
- 软删除支持(逻辑删除)
- 时间戳自动管理
- 索引优化查询性能
🆕 动态模型选择系统
- 20+ AI 模型支持: GPT、Qwen、OpenAI 兼容模型等
- 4 级模型分类: SIMPLE（简单）、MEDIUM（中等）、HARD（困难）、EXPERT（专家）
- 智能模型推荐: 根据项目复杂度自动推荐合适的模型
- 质量系数显示: 前端显示模型质量系数（替代倍率），帮助用户选择
- 实时成本预估: 根据选择的模型预估积分消耗
🆕 两阶段代码生成流程
- 阶段一：计划生成
- AI 分析需求，生成详细的开发计划
- 包含文件列表、功能模块、技术选型等
- 用户可预览和修改计划
- 阶段二：代码生成
- 用户确认计划后开始生成代码
- 支持基于计划的增量生成
- 避免无效生成，节省 Token 成本
🆕 代码自动验证
- ESLint 集成: 自动执行 ESLint 代码质量检查
- Vue 项目结构验证: 验证项目结构是否符合 Vue 3 规范
- 自动生成审查报告: 包含代码质量评分、错误列表、修复建议
- 构建前验证: 在项目构建前发现潜在问题
生成类型支持
- Vue 3 项目生成: 专注于 Vue 3 完整前端应用（已移除 HTML 和多文件项目支持）
- 支持 Composition API、TypeScript、Pinia
- 自动配置路由、状态管理、UI 组件库
- 优化的项目结构和代码组织
实时流式输出
- 基于 Server-Sent Events (SSE) 的实时推送
- 实时展示 AI 思考过程和代码生成进度
- 支持生成过程中的取消操作
- 断线自动重连机制
- 🆕 优化 ChatMemory 管理，避免上下文过长（性能提升 50%+）
代码优化
- 自动代码格式化
- 语法检查和修正
- 最佳实践建议
- 性能优化提示
- 🆕 重复写入检测和警告
版本历史记录
- 自动记录每次应用修改的版本快照
- 保存完整的应用配置、生成内容、文件列表
- 记录版本创建时间和操作人
- 支持版本列表分页查询
版本回滚功能
- 一键回滚到任意历史版本
- 回滚操作会创建新版本记录
- 保持完整的版本变更链
- 仅应用创建者可执行回滚
权限控制
- 仅应用创建者可查看版本历史
- 仅应用创建者可执行版本回滚
- 版本数据逻辑删除，可恢复
积分获取机制
- 注册奖励: 新用户注册赠送初始积分
- 邀请奖励: 成功邀请好友注册，邀请双方均获得积分
- 每日签到: 每日首次登录获得签到积分（可扩展）
积分消耗场景
- AI 代码生成: 根据选择的 AI 模型和实际 Token 消耗量计费
- 不同模型有不同的积分消耗率（每千 Token 消耗的积分数）
- 质量系数会影响最终积分消耗（1.0-3.5倍）
- 典型 Vue 3 项目生成消耗: 50-200 积分
- 项目部署: 完全免费，不消耗积分
- 代码下载: 完全免费，不消耗积分
🆕 积分状态管理
- PENDING: 待处理 - 积分操作已创建但未确认
- COMPLETED: 已完成 - 积分成功增加或扣除
- FAILED: 已失败 - 积分操作失败，需要回滚
- REFUNDED: 已退款 - 失败任务的积分已退还
🆕 积分一致性保障
- 一致性检查器: 定期检查积分记录与用户积分余额是否一致
- 自动修复机制: 发现不一致时自动修复或报警
- 防重复扣费: 使用分布式锁防止并发扣费
- 事务保障: 积分操作使用数据库事务确保原子性
积分管理
- 累计积分: 记录用户历史获得的总积分
- 可用积分: 当前可使用的积分余额
- 冻结积分: 预留字段，支持积分冻结功能
- 积分明细: 完整的积分获取和消耗记录
积分过期机制
- 定时任务自动检查过期积分
- 支持设置积分有效期（如 180 天）
- 过期积分自动扣除
- 过期通知提醒（可扩展）
🆕 积分监控优化
- Prometheus 指标收集（已修复跨线程问题）
- 积分获取/消耗趋势统计
- 用户积分分布分析
- 异常积分变动预警
- Token 使用量监控
邀请码系统
- 每个用户拥有唯一邀请码
- 邀请码基于用户ID生成，永久有效
- 支持邀请链接一键分享
- 邀请码区分大小写
邀请奖励
- 邀请人奖励: 成功邀请好友注册，获得积分奖励
- 被邀请人奖励: 通过邀请码注册，同样获得积分奖励
- 双向激励: 促进用户主动分享和推广
- 自动发放: 定时任务自动检测并发放奖励
防刷机制
- IP检测: 记录注册IP，同一IP多次注册预警
- 设备ID检测: 通过浏览器指纹识别设备
- 时间窗口: 短时间内大量邀请触发人工审核
- 人工审核: 可疑邀请关系需人工确认后发放奖励
邀请状态管理
- PENDING: 待确认 - 邀请链接已创建
- REGISTERED: 已注册 - 被邀请人完成注册
- REWARDED: 已奖励 - 积分已成功发放
- 状态流转: 自动化状态更新和通知
邀请统计
- 邀请人数统计
- 成功注册人数
- 奖励积分总额
- 邀请转化率分析
邮箱注册登录
- 邮箱验证码注册
- 邮箱验证码登录
- 邮箱唯一性验证
- 密码MD5加密(加盐: Join2049)
会话管理
- 基于Redis的分布式会话
- 30天会话有效期
- 自动登录状态维护
- 安全退出登录
权限控制
- 基于角色的访问控制(user/admin)
@AuthCheck注解权限校验- 仅创建者可修改应用
- 管理员拥有全部权限
应用CRUD
- 创建新应用(配置名称、描述、生成类型)
- 查询应用列表(分页、搜索、过滤)
- 更新应用配置
- 删除应用(逻辑删除)
生成类型
- Vue 3 项目生成: 专注于 Vue 3 完整前端应用（v1.1.0+ 已聚焦 Vue 项目）
- 支持 Composition API、TypeScript、Pinia
- 自动配置路由、状态管理、UI 组件库
- 优化的项目结构和代码组织
应用部署
- 生成的项目自动上传到腾讯云COS
- 生成唯一的部署访问链接
- 支持自定义域名访问
- CDN加速文件访问
批量操作
- 批量删除应用
- 批量导出应用配置
- 批量部署项目
SSE流式传输
- 基于Server-Sent Events的单向推送
- 实时显示AI代码生成进度
- 自动处理连接中断和重连
- 支持多客户端同时接收
聊天历史
- 完整的AI对话历史记录
- 支持历史会话查询
- 上下文关联显示
- 聊天记录导出(可扩展)
实时通知
- 积分变动实时通知
- 邀请成功实时通知
- 系统消息推送
腾讯云COS
- 生成文件自动上传云端
- 支持大文件分片上传
- 自动生成访问URL
- CDN加速文件分发
文件管理
- 文件列表查看
- 文件下载
- 文件删除
- 存储空间统计
截图功能
- 基于Selenium的网页截图
- 支持全页面截图
- 自动压缩和优化
- 截图结果云端存储
Prometheus指标
- HTTP请求统计
- AI模型调用次数
- 数据库查询性能
- 缓存命中率
- 积分系统指标
- 邀请系统指标
健康检查
- 应用健康状态检查
- 数据库连接检查
- Redis连接检查
- 外部API可用性检查
日志管理
- 结构化日志记录
- 按级别分类(DEBUG/INFO/WARN/ERROR)
- 异常堆栈追踪
- 请求日志记录
ai-code-mother/
├── src/main/java/com/spring/aicodemother/ # 后端源码
│ ├── ai/ # AI 模型集成和服务
│ │ ├── AiManager.java # AI 模型管理器
│ │ ├── DynamicAiModelFactory.java # 🆕 动态模型工厂
│ │ ├── AiCodeGeneratorServiceFactory.java # 🆕 AI 服务工厂
│ │ ├── MessageStreamHandler.java # 流式消息处理
│ │ ├── model/ # AI 请求响应模型
│ │ └── tools/ # 🆕 AI 工具调用
│ │ ├── CodeValidationTool.java # 🆕 代码验证工具
│ │ └── VueProjectStructureValidationTool.java # 🆕 结构验证工具
│ ├── controller/ # REST API 控制器
│ │ ├── AppController.java # 应用管理
│ │ ├── AppVersionController.java # 版本管理
│ │ ├── UserController.java # 用户管理
│ │ ├── PointsController.java # 积分管理
│ │ ├── InviteController.java # 邀请管理
│ │ ├── AiModelController.java # 🆕 AI 模型管理
│ │ └── HealthController.java # 健康检查
│ ├── service/ # 业务逻辑层
│ │ ├── AppService.java # 应用服务
│ │ ├── AppVersionService.java # 版本服务
│ │ ├── UserService.java # 用户服务
│ │ ├── UserPointsService.java # 积分服务
│ │ ├── PointsRecordService.java # 积分记录服务
│ │ ├── InviteRecordService.java # 邀请服务
│ │ ├── ChatService.java # 聊天服务
│ │ ├── AiModelConfigService.java # 🆕 AI 模型配置服务
│ │ ├── AiPlanningService.java # 🆕 AI 计划生成服务
│ │ ├── PlanCacheService.java # 🆕 计划缓存服务
│ │ └── GenerationValidationService.java # 🆕 生成验证服务
│ ├── mapper/ # 数据访问层
│ │ └── *.java # MyBatis-Flex Mapper
│ ├── model/ # 数据模型
│ │ ├── entity/ # 实体类
│ │ ├── dto/ # 数据传输对象
│ │ ├── vo/ # 视图对象
│ │ └── enums/ # 枚举类型
│ ├── core/ # 核心业务逻辑
│ │ ├── CodeGenerator.java # 代码生成核心
│ │ ├── FileParser.java # 文件解析器
│ │ └── FileSaver.java # 文件保存器
│ ├── config/ # 配置类
│ │ ├── CorsConfig.java # 跨域配置
│ │ ├── RedisConfig.java # Redis配置
│ │ └── CosClientConfig.java # COS配置
│ ├── utils/ # 工具类
│ │ └── ScreenshotUtils.java # 截图工具
│ ├── manager/ # 第三方服务管理
│ │ └── CosManager.java # COS管理器
│ ├── schedule/ # 定时任务
│ │ ├── PointsExpireScheduler.java # 积分过期任务
│ │ ├── PointsConsistencyChecker.java # 🆕 积分一致性检查
│ │ └── InviteRewardScheduler.java # 邀请奖励任务
│ ├── monitor/ # 监控指标
│ │ ├── PointsMetricsCollector.java # 积分指标收集
│ │ ├── AiModelMetricsCollector.java # 🆕 AI 模型监控
│ │ ├── MonitorContext.java # 🆕 监控上下文
│ │ └── MonitorContextHolder.java # 🆕 上下文持有者（修复跨线程问题）
│ ├── exception/ # 异常处理
│ │ ├── GlobalExceptionHandler.java # 全局异常处理器
│ │ ├── BusinessException.java # 业务异常
│ │ └── ErrorCode.java # 错误码定义
│ ├── common/ # 公共类
│ │ ├── BaseResponse.java # 统一响应格式
│ │ └── ResultUtils.java # 响应工具类
│ └── annotation/ # 自定义注解
│ └── AuthCheck.java # 权限校验注解
│
├── src/main/resources/ # 资源文件
│ ├── application.yml # 应用配置
│ ├── application-dev.yml # 开发环境配置
│ ├── application-prod.yml # 生产环境配置
│ └── prompt/ # AI提示词模板
│ ├── html_generator.txt # HTML生成提示词
│ ├── multifile_generator.txt # 多文件生成提示词
│ └── vue_generator.txt # Vue生成提示词
│
├── ai-code-mother-frontend/ # 前端源码
│ ├── src/
│ │ ├── main.ts # 应用入口
│ │ ├── App.vue # 根组件
│ │ ├── request.ts # Axios配置
│ │ ├── layouts/ # 布局组件
│ │ │ └── BasicLayout.vue # 基础布局
│ │ ├── components/ # 可复用组件
│ │ │ ├── GlobalHeader.vue # 全局头部
│ │ │ ├── GlobalFooter.vue # 全局底部
│ │ │ ├── AiModelSelector.vue # 🆕 AI 模型选择器（544 行）
│ │ │ ├── DeployingModal.vue # 🆕 部署中弹窗
│ │ │ ├── DeploySuccessModal.vue # 部署成功弹窗
│ │ │ ├── PreviewLoading.vue # 🆕 预览加载组件
│ │ │ ├── DiffViewer.vue # 🆕 差异查看器
│ │ │ ├── CodeHighlight.vue # 代码高亮组件
│ │ │ └── MarkdownRenderer.vue # Markdown 渲染器
│ │ ├── pages/ # 页面组件
│ │ │ ├── HomePage.vue # 首页
│ │ │ ├── app/ # 应用管理页面
│ │ │ │ ├── AppChatPage.vue # 🆕 应用聊天页（重构为模块化）
│ │ │ │ ├── components/ # 🆕 应用组件
│ │ │ │ │ ├── AppHeaderBar.vue # 应用头部
│ │ │ │ │ ├── ChatPanel.vue # 聊天面板
│ │ │ │ │ └── CodePreviewPanel.vue # 代码预览面板
│ │ │ │ ├── composables/ # 🆕 组合式函数
│ │ │ │ │ ├── useAppDeployment.ts # 部署逻辑
│ │ │ │ │ ├── useAppInfo.ts # 应用信息
│ │ │ │ │ ├── useChatMessages.ts # 消息管理
│ │ │ │ │ ├── useCodeGeneration.ts # 代码生成（605 行）
│ │ │ │ │ ├── useVersionManagement.ts # 版本管理
│ │ │ │ │ └── useVisualEditor.ts # 可视化编辑
│ │ │ │ └── utils/ # 工具函数
│ │ │ │ └── contentFilters.ts # 🆕 内容过滤器
│ │ │ ├── user/ # 用户相关页面
│ │ │ │ ├── LoginPage.vue # 登录页
│ │ │ │ ├── RegisterPage.vue # 注册页
│ │ │ │ └── UserManagePage.vue # 用户管理
│ │ │ ├── points/ # 积分相关页面
│ │ │ │ ├── PointsPage.vue # 积分中心
│ │ │ │ └── InvitePage.vue # 邀请页面
│ │ │ └── docs/ # 文档页面
│ │ │ ├── QuickStartDoc.vue # 快速开始
│ │ │ ├── APIDoc.vue # API 文档
│ │ │ ├── FAQDoc.vue # 常见问题
│ │ │ ├── features/ # 功能文档
│ │ │ │ ├── AIGenerationDoc.vue # AI 生成文档
│ │ │ │ └── PointsSystemDoc.vue # 积分系统文档
│ │ │ └── tutorial/ # 教程目录
│ │ ├── router/ # 路由配置
│ │ │ └── index.ts # 路由定义
│ │ ├── stores/ # Pinia 状态管理
│ │ │ ├── user.ts # 用户状态
│ │ │ └── app.ts # 应用状态
│ │ ├── api/ # API 客户端（自动生成）
│ │ │ ├── aImoxingpeizhi.ts # 🆕 AI 模型配置 API
│ │ │ └── appController.ts # 应用控制器 API
│ │ ├── assets/ # 静态资源
│ │ │ ├── Deploy.svg # 🆕 部署图标
│ │ │ ├── Online search.svg # 🆕 在线搜索图标
│ │ │ ├── ToolsCall.svg # 🆕 工具调用图标
│ │ │ ├── refresh.svg # 🆕 刷新图标
│ │ │ └── (共 18 个 SVG 图标) # Deploy、ToolsCall、thinking 等
│ │ └── styles/ # 🆕 样式文件
│ │ ├── lovable-theme.css # Lovable 主题
│ │ └── lovable-theme-override.css # 主题覆盖
│ ├── public/ # 公共资源
│ ├── .env.development # 开发环境变量
│ ├── .env.production # 生产环境变量
│ └── package.json # 依赖配置
│
├── deployment/ # 🆕 部署包目录
│ ├── backend/ # 后端 JAR 包
│ ├── frontend/ # 前端构建产物
│ ├── config/ # 配置文件
│ │ ├── nginx.conf # Nginx 配置
│ │ ├── openresty.conf # OpenResty 配置
│ │ ├── aicodehub.service # Systemd 服务
│ │ └── logrotate-aicodehub # 日志轮转
│ ├── scripts/ # 部署脚本
│ │ ├── deploy.sh # 一键部署
│ │ ├── check_env.sh # 环境检查
│ │ ├── backup.sh # 备份脚本
│ │ ├── rollback.sh # 回滚脚本
│ │ └── service_manager.sh # 服务管理
│ ├── sql/ # 数据库迁移脚本
│ ├── docs/ # 部署文档
│ ├── .env.prod.example # 环境变量模板
│ └── README.md # 部署说明
├── sql/ # 数据库脚本
│ ├── create_table.sql # 建表脚本
│ ├── add_24_models.sql # 🆕 新增 24 个模型
│ ├── fix_model_config_pricing_v2.sql # 🆕 修复模型定价
│ └── v1.1.0_ai_model_tier_system.sql # 🆕 模型等级系统
├── tmp/ # 临时文件目录
│ ├── code_output/ # 生成代码输出
│ └── screenshots/ # 截图输出
├── tasks/ # 🆕 任务和计划
│ └── todo.md # 任务清单
├── prometheus.yml # Prometheus 配置
├── pom.xml # Maven 配置
├── mvnw / mvnw.cmd # Maven Wrapper
└── README.md # 项目说明文档
| 组件 | 版本要求 | 说明 |
|---|---|---|
| Java | 21+ | Spring Boot 3.5.4运行要求 |
| Node.js | 18+ | 前端开发和构建环境 |
| MySQL | 8.0+ | 主数据库 |
| Redis | 6.0+ | 会话存储和缓存 |
| Chrome/Chromium | 最新版 | Selenium截图功能依赖 |
| 组件 | 用途 |
|---|---|
| Docker | 容器化部署 |
| Nginx | 反向代理和静态文件服务 |
| Prometheus | 指标收集和监控 |
| Grafana | 监控数据可视化 |
- IDE: IntelliJ IDEA 2023+ / VS Code
- API测试: Postman / Apifox
- 数据库工具: Navicat / DataGrip
- Git客户端: SourceTree / GitKraken
# 检查Java版本
java -version # 需要Java 21
# 检查Node.js版本
node -version # 需要18.0+
# 启动MySQL服务
mysql -u root -p
CREATE DATABASE ai_code_mother CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
# 启动Redis服务
redis-server# 执行建表脚本
mysql -u root -p ai_code_mother < sql/create_table.sql# 克隆项目
git clone [repository-url]
cd ai-code-motherspring:
# 应用名称
application:
name: ai-code-mother-backend
# 数据库配置
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/ai_code_mother?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
username: root # 修改为你的MySQL用户名
password: your_password # 修改为你的MySQL密码
# HikariCP 连接池配置（生产环境建议）
hikari:
maximum-pool-size: 20 # 最大连接数
minimum-idle: 5 # 最小空闲连接数
connection-timeout: 30000 # 连接超时时间（毫秒）
idle-timeout: 600000 # 空闲超时时间（毫秒）
max-lifetime: 1800000 # 连接最大生命周期（毫秒）
# Redis 配置
data:
redis:
host: 127.0.0.1 # Redis服务器地址
port: 6379 # Redis端口
password: # Redis密码（如无密码留空）
database: 0 # Redis数据库索引（0-15）
ttl: 3600 # 缓存存活时间（秒）
# Lettuce 连接池配置（生产环境建议）
lettuce:
pool:
max-active: 8 # 最大活跃连接数
max-idle: 8 # 最大空闲连接数
min-idle: 2 # 最小空闲连接数
max-wait: -1ms # 最大等待时间
# Session 配置
session:
store-type: redis # 使用Redis存储Session
timeout: 2592000 # Session过期时间（秒，30天）
# 邮件服务配置
mail:
host: smtp.qq.com # SMTP服务器地址（示例：QQ邮箱）
port: 587 # SMTP端口（587为TLS加密端口）
username: your-email@qq.com # 发件邮箱地址
password: your-smtp-password # SMTP密码或授权码
protocol: smtp
default-encoding: UTF-8
properties:
mail:
smtp:
auth: true # 启用SMTP认证
starttls:
enable: true # 启用TLS加密
required: true
ssl:
trust: smtp.qq.com # 信任的SMTP服务器
# 其他常用邮箱配置示例：
# Gmail: smtp.gmail.com:587
# 163邮箱: smtp.163.com:465 (SSL)
# 阿里云邮箱: smtp.aliyun.com:465
# 激活的配置文件
profiles:
active: dev # 开发环境使用dev
# 服务器配置
server:
port: 8123 # 后端服务端口
servlet:
context-path: /api # API上下文路径
session:
cookie:
max-age: 2592000 # Cookie过期时间（秒，30天）
http-only: true # 仅HTTP访问，防止XSS攻击
secure: false # 开发环境使用HTTP（生产环境改为true）
# AI 模型配置（核心配置）
langchain4j:
open-ai:
# 推理AI模型配置（用于复杂的代码生成任务）
reasoning-streaming-chat-model:
base-url: https://204992.xyz/v1 # OpenAI兼容API地址
api-key: sk-your-api-key-here # 你的API密钥
model-name: gpt-5-codex-medium # 高级编码模型
max-tokens: 4000 # 最大生成Token数
temperature: 0.7 # 生成温度（0-2，越高越随机）
timeout: 300s # 请求超时时间（5分钟）
log-requests: true # 记录请求日志（开发环境）
log-responses: true # 记录响应日志（开发环境）
# 路由AI模型配置（用于简单的分类和路由任务）
routing-chat-model:
base-url: https://204992.xyz/v1
api-key: sk-your-api-key-here
model-name: gpt-5-low # 基础编码模型（快速响应）
max-tokens: 50 # 路由任务只需少量Token
temperature: 0.3 # 较低温度确保稳定性
timeout: 30s
log-requests: true
log-responses: true
# 流式聊天模型配置（用于动态模型选择）
streaming-chat-model:
base-url: https://204992.xyz/v1
api-key: sk-your-api-key-here
model-name: gpt-5-low # 默认流式模型
max-tokens: 8192 # 支持长文本生成
temperature: 0.7
timeout: 300s
log-requests: true
log-responses: true
# 腾讯云 COS 对象存储配置（用于文件存储和部署）
cos:
client:
host: your-custom-domain.com # 自定义域名（可选）
secretId: your-secret-id # 腾讯云SecretId
secretKey: your-secret-key # 腾讯云SecretKey
region: ap-shanghai # COS地域（ap-beijing/ap-shanghai/ap-guangzhou等）
bucket: your-bucket-name # 存储桶名称
# 获取方式：登录腾讯云控制台 > 访问管理 > API密钥管理
# Pexels 图片搜索配置（可选功能）
pexels:
api-key: your-pexels-api-key
# 获取方式：https://www.pexels.com/api/
# Pixabay 插画搜索配置（可选功能）
pixabay:
api-key: your-pixabay-api-key
# 获取方式：https://pixabay.com/api/docs/
# 阿里云 DashScope 配置（可选功能）
dashscope:
api-key: your-dashscope-api-key
image-model: wan2.2-t2i-flash
# 获取方式：https://dashscope.console.aliyun.com/
# Knife4j API文档配置
knife4j:
enable: true # 启用API文档
setting:
language: zh_cn # 中文界面
# SpringDoc OpenAPI配置
springdoc:
group-configs:
- group: 'default'
packages-to-scan: com.spring.aicodemother.controller
# 监控端点配置
management:
endpoints:
web:
exposure:
include: health,info,prometheus # 暴露的端点
endpoint:
health:
show-details: always # 显示详细健康信息
# 日志配置（可选）
logging:
level:
root: INFO
com.spring.aicodemother: DEBUG # 开发环境使用DEBUG级别
file:
name: logs/application.log # 日志文件路径
max-size: 100MB # 单个日志文件最大大小
max-history: 30 # 保留30天的日志作为application.yml的替代方案，可以使用环境变量：
# 数据库配置
export DB_HOST=localhost
export DB_PORT=3306
export DB_NAME=ai_code_mother
export DB_USERNAME=root
export DB_PASSWORD=your_password
# Redis配置
export REDIS_HOST=127.0.0.1
export REDIS_PORT=6379
export REDIS_PASSWORD=
# AI API配置
export OPENAI_API_BASE_URL=https://204992.xyz/v1
export OPENAI_API_KEY=sk-your-api-key-here
export OPENAI_MODEL_REASONING=gpt-5-codex-medium
export OPENAI_MODEL_ROUTING=gpt-5-low
# 邮件配置
export MAIL_HOST=smtp.qq.com
export MAIL_PORT=587
export MAIL_USERNAME=your-email@qq.com
export MAIL_PASSWORD=your-smtp-password
# COS配置
export COS_SECRET_ID=your-secret-id
export COS_SECRET_KEY=your-secret-key
export COS_REGION=ap-shanghai
export COS_BUCKET=your-bucket-name# 编译项目
./mvnw clean compile # Linux/Mac
mvnw.cmd clean compile # Windows
# 运行测试（可选）
./mvnw test # Linux/Mac
mvnw.cmd test # Windows
# 启动应用
./mvnw spring-boot:run # Linux/Mac
mvnw.cmd spring-boot:run # Windows
# 或者打包后运行
./mvnw clean package -DskipTests
java -jar target/ai-code-mother-0.0.1-SNAPSHOT.jar# 进入前端目录
cd ai-code-mother-frontend创建环境配置文件：
开发环境配置 (.env.development)
# API基础URL
VITE_API_BASE_URL=http://localhost:8123/api
# 应用标题
VITE_APP_TITLE=AI Code Mother
# 环境标识
VITE_ENV=development
# 是否启用调试模式
VITE_DEBUG=true
# API超时时间（毫秒）
VITE_API_TIMEOUT=60000生产环境配置 (.env.production)
# API基础URL（修改为你的生产环境地址）
VITE_API_BASE_URL=https://your-domain.com/api
# 应用标题
VITE_APP_TITLE=AI Code Mother
# 环境标识
VITE_ENV=production
# 是否启用调试模式
VITE_DEBUG=false
# API超时时间（毫秒）
VITE_API_TIMEOUT=60000# 安装依赖
npm install
# 或使用yarn
yarn install
# 或使用pnpm（推荐，更快）
pnpm install
# 生成API客户端（需要后端服务先启动）
npm run openapi2ts
# 启动开发服务器
npm run dev
# 构建生产版本
npm run build
# 预览生产构建
npm run preview
# 类型检查
npm run type-check
# 代码检查
npm run lint
# 代码格式化
npm run formatpackage.json 关键配置
{
"scripts": {
"dev": "vite", // 启动开发服务器
"build": "vite build", // 构建生产版本
"preview": "vite preview", // 预览生产构建
"openapi2ts": "openapi-typescript http://localhost:8123/api/v3/api-docs -o src/api/openapi.d.ts", // 生成API类型
"type-check": "vue-tsc --noEmit", // TypeScript类型检查
"lint": "eslint . --ext .vue,.js,.jsx,.cjs,.mjs,.ts,.tsx,.cts,.mts --fix", // 代码检查
"format": "prettier --write src/" // 代码格式化
}
}vite.config.ts 关键配置
export default defineConfig({
server: {
port: 5173, // 开发服务器端口
proxy: {
'/api': { // API代理配置
target: 'http://localhost:8123',
changeOrigin: true,
// rewrite: (path) => path.replace(/^\/api/, '')
}
}
},
build: {
outDir: 'dist', // 构建输出目录
sourcemap: false, // 生产环境不生成sourcemap
minify: 'terser', // 使用terser压缩
chunkSizeWarningLimit: 1500 // chunk大小警告阈值（KB）
}
})| 服务 | 地址 | 说明 |
|---|---|---|
| 前端应用 | http://localhost:5173 | Vue 3 用户界面 |
| 后端API | http://localhost:8123/api | REST API 服务 |
| API文档 | http://localhost:8123/api/doc.html | Knife4j 交互式 API 文档 |
| OpenAPI规范 | http://localhost:8123/api/v3/api-docs | OpenAPI 3.0 JSON 规范 |
| 健康检查 | http://localhost:8123/api/health | 应用健康状态 |
| Prometheus指标 | http://localhost:8123/api/actuator/prometheus | 监控指标端点 |
| Actuator端点 | http://localhost:8123/api/actuator | Spring Boot Actuator |
-
访问前端应用: 打开浏览器访问 http://localhost:5173
-
注册账户:
- 点击"注册"按钮
- 输入邮箱地址
- 点击"发送验证码"（需要配置好邮件服务）
- 输入收到的6位验证码
- 设置密码和用户名
- 可选：输入邀请码获得额外积分
- 点击"注册"完成账户创建
-
登录系统:
- 输入注册的邮箱
- 点击"发送验证码"
- 输入验证码登录
-
创建第一个应用:
- 进入"应用管理"页面
- 点击"创建应用"
- 填写应用名称和描述
- 选择生成类型（推荐：Vue 3 项目）
- 点击创建
-
生成代码:
- 在应用列表中点击"生成代码"
- 输入详细的需求描述（参考推荐测试提示词）
- 选择合适的 AI 模型
- 等待 AI 生成代码
- 查看生成结果
-
部署项目:
- 点击"部署"按钮
- 等待项目构建和上传
- 获取在线预览链接
启动应用后，建议进行以下验证：
# 1. 检查后端健康状态
curl http://localhost:8123/api/health
# 预期输出: {"status":"UP"}
# 2. 检查数据库连接
# 访问 http://localhost:8123/api/actuator/health
# 查看 db.status 应为 UP
# 3. 检查Redis连接
# 查看 redis.status 应为 UP
# 4. 测试前端API连接
# 打开浏览器访问 http://localhost:5173
# 打开开发者工具查看Network请求是否正常
# 5. 查看API文档
# 访问 http://localhost:8123/api/doc.html
# 应能看到完整的API接口列表问题1: 后端启动失败 - 数据库连接错误
# 检查MySQL服务状态
# Windows
net start mysql
# Linux/Mac
sudo systemctl status mysql
# 或
brew services list | grep mysql
# 验证数据库存在
mysql -u root -p
SHOW DATABASES;
# 应能看到 ai_code_mother
# 检查用户名密码是否正确
mysql -u your_username -p your_password ai_code_mother问题2: 后端启动失败 - Redis连接错误
# 检查Redis服务状态
# Windows
redis-server
# Linux
sudo systemctl status redis
# 或
ps aux | grep redis
# Mac
brew services list | grep redis
# 测试Redis连接
redis-cli ping
# 应返回 PONG问题3: 前端API调用失败
# 检查后端是否启动
curl http://localhost:8123/api/health
# 检查端口是否被占用
# Windows
netstat -ano | findstr 8123
# Linux/Mac
lsof -i :8123
# 清除浏览器缓存并重试
# Chrome: Ctrl+Shift+Delete问题4: AI模型调用失败
# 检查API密钥配置
# 查看 application.yml 中的 langchain4j.open-ai.*.api-key
# 测试API连接
curl -X POST https://204992.xyz/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key-here" \
-d '{
"model": "gpt-5-low",
"messages": [{"role": "user", "content": "Hello"}]
}'
# 检查后端日志
tail -f logs/application.log | grep -i "error"问题5: 邮件验证码发送失败
# 检查邮件配置
# 查看 application.yml 中的 spring.mail 配置
# 常见问题：
# 1. QQ邮箱需要使用授权码而非密码
# 2. Gmail需要开启"允许不够安全的应用"
# 3. 163邮箱需要开启SMTP服务
# 查看后端日志确认错误详情
tail -f logs/application.log | grep -i "mail"最小配置要求:
- CPU: 双核 2.0 GHz+
- 内存: 4 GB RAM
- 磁盘: 10 GB 可用空间
推荐配置:
- CPU: 四核 2.5 GHz+
- 内存: 8 GB RAM
- 磁盘: 20 GB 可用空间（SSD 更佳）
网络要求:
- 可访问 OpenAI 兼容 API（或配置代理）
- 可访问腾讯云 COS（如需文件存储功能）
- 可访问邮件 SMTP 服务器
1. 邮箱注册
- 访问注册页面
- 输入邮箱地址
- 点击"发送验证码"，系统将发送6位数字验证码到邮箱
- 输入验证码、设置密码、填写用户名
- 可选：输入邀请码获得额外积分奖励
- 点击注册，系统自动创建账户并赠送初始积分
2. 邮箱登录
- 访问登录页面
- 输入注册的邮箱地址
- 点击"发送验证码"
- 输入收到的验证码
- 点击登录即可
3. 会话管理
- 登录状态保持30天
- 可随时退出登录
- 多设备登录互不影响
1. 创建应用
- 登录后进入"应用管理"页面
- 点击"创建应用"按钮
- 填写应用信息:
- 应用名称
- 应用描述
- 生成类型：Vue 3 项目（当前版本专注于 Vue 3 项目生成）
- 点击创建
2. 生成代码
- 在应用列表中找到创建的应用
- 点击"生成代码"按钮
- 选择合适的 AI 模型（根据项目复杂度选择）
- 输入详细的需求描述（可参考推荐测试提示词）
- 系统实时显示AI生成过程:
- AI思考过程
- 工具调用信息
- 代码生成进度
- 文件列表
- 生成完成后可以:
- 在线预览代码
- 下载完整项目压缩包
- 部署到云端（免费）
3. 代码预览与下载
- 支持在线查看生成的代码
- 代码高亮显示
- 支持复制代码
- 一键下载完整项目压缩包
4. 项目部署（完全免费）
- 生成完成后点击"部署"按钮
- 系统自动将项目构建并上传到腾讯云COS
- 生成唯一的在线预览链接
- 通过链接即可访问部署的项目
- 支持分享链接给他人访问
- 注意：项目部署不消耗积分，完全免费
1. 查看版本历史
- 进入应用详情页面
- 点击"版本历史"标签
- 查看所有历史版本列表，包括:
- 版本号
- 创建时间
- 版本说明
- 操作人
2. 版本回滚
- 在版本历史列表中找到目标版本
- 点击"回滚"按钮
- 确认回滚操作
- 系统自动恢复应用到该版本状态
- 回滚操作会创建新的版本记录
1. 查看积分余额
- 登录后在用户中心查看当前积分
- 累计积分:历史获得的总积分
- 可用积分:当前可使用的积分
2. 获取积分
- 注册奖励: 新用户注册赠送100积分
- 邀请奖励: 成功邀请好友注册，双方各得50积分
- 每日签到: 每日首次登录获得10积分(可扩展)
3. 消耗积分
- AI 代码生成（唯一消耗场景）:
- 根据选择的 AI 模型和实际消耗的 Token 数量计费
- 不同模型有不同的积分消耗率（每千 Token 消耗的积分数）
- 模型等级分类：
- 基础编码模型（如 gpt-5-low）: 约 1-3 积分/千Token
- 标准编码模型（如 qwen-turbo）: 约 3-5 积分/千Token
- 高级编码模型（如 gpt-5-codex-medium）: 约 5-10 积分/千Token
- 基础推理模型: 约 10-15 积分/千Token
- 高级推理模型: 约 15-30 积分/千Token
- 质量系数会影响最终积分消耗（1.0-3.5倍）
- 典型 Vue 3 项目生成消耗: 50-200 积分（取决于项目复杂度和模型选择）
💡 积分优化建议:
- 简单项目选择基础编码模型，节省积分
- 复杂项目选择高级推理模型，保证质量
- 使用两阶段生成流程，避免无效生成浪费积分
- 项目部署和代码下载不消耗积分，完全免费
4. 积分明细
- 进入"积分中心"
- 查看积分获取和消耗记录
- 每条记录包含:
- 积分类型(获取/消耗)
- 积分数量
- 操作说明
- 操作时间
5. 积分有效期
- 积分有效期为180天
- 即将过期的积分会提前通知
- 过期积分自动扣除
1. 获取邀请码
- 登录后进入"邀请好友"
- 系统自动为每个用户生成唯一邀请码
- 复制邀请码或邀请链接
2. 分享邀请
- 方式一: 分享邀请码，好友注册时输入
- 方式二: 分享邀请链接，好友点击直接跳转注册页
3. 获得奖励
- 好友通过邀请码/链接完成注册
- 系统自动检测邀请关系
- 邀请人和被邀请人各获得50积分
- 奖励在好友注册后24小时内自动发放
4. 邀请统计
- 进入"邀请好友"
- 查看邀请数据:
- 邀请人数
- 成功注册人数
- 获得积分总额
- 邀请排行榜
5. 防刷规则
- 同一IP短时间内多次注册会被限制
- 异常邀请行为需人工审核
- 作弊行为将扣除全部奖励积分
编译和构建
# 编译项目
./mvnw clean compile
# 打包应用
./mvnw clean package
# 跳过测试打包
./mvnw clean package -DskipTests运行测试
# 运行所有测试
./mvnw test
# 运行特定测试类
./mvnw test -Dtest=UserServiceTest
# 运行特定测试方法
./mvnw test -Dtest=UserServiceTest#testRegister热部署
- 项目使用Spring Boot DevTools支持热部署
- 修改代码后自动重启应用
- 静态资源修改无需重启
开发命令
# 启动开发服务器
npm run dev
# 类型检查
npm run type-check
# 代码检查和自动修复
npm run lint
# 代码格式化
npm run format
# 构建生产版本
npm run build
# 预览生产构建
npm run previewAPI客户端生成
# 从后端OpenAPI规范生成TypeScript类型
npm run openapi2ts
# 注意: 需要后端服务先启动组件开发规范
- 使用Composition API
- 使用
<script setup>语法 - TypeScript严格类型检查
- 组件名使用PascalCase
- Props和Emits明确定义类型
1. 后端API开发
@RestController
@RequestMapping("/example")
public class ExampleController {
@PostMapping("/")
public BaseResponse<ExampleVO> createExample(@RequestBody ExampleDTO dto) {
// 实现业务逻辑
return ResultUtils.success(result);
}
}2. 更新OpenAPI文档
- 重启后端服务
- 访问 http://localhost:8123/api/v3/api-docs 确认API已更新
3. 生成前端API客户端
cd ai-code-mother-frontend
npm run openapi2ts4. 在前端使用API
import { exampleControllerCreateExample } from '@/api/exampleController';
const result = await exampleControllerCreateExample(params);1. 实体类定义
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Table("table_name")
public class Entity implements Serializable {
@Id(keyType = KeyType.Generator, value = KeyGenerators.snowFlakeId)
private Long id;
@Column("column_name")
private String columnName;
@Column(value = "isDelete", isLogicDelete = true)
private Integer isDelete;
}2. 命名规范
- 表名: 小写下划线分隔 (user_points)
- 列名: 驼峰命名 (userId, createTime)
- 索引名: idx_表名_列名
- 外键名: fk_表名_关联表名
3. 必需字段
- id: 雪花算法主键
- createTime: 创建时间
- updateTime: 更新时间
- isDelete: 逻辑删除标志
1. 使用统一异常
// 参数错误
ThrowUtils.throwIf(condition, ErrorCode.PARAMS_ERROR, "错误信息");
// 业务异常
throw new BusinessException(ErrorCode.OPERATION_ERROR, "操作失败");
// 权限异常
throw new BusinessException(ErrorCode.NO_AUTH_ERROR, "无权限");2. 错误码定义
基础错误码
0: 成功40000: 请求参数错误40100: 未登录40101: 无权限40300: 禁止访问40400: 请求数据不存在42900: 请求过于频繁50000: 系统内部异常50001: 操作失败
邮箱相关错误码
40001: 验证码无效或已过期40002: 邮箱已存在40003: 邮箱格式不正确42901: 邮件发送过于频繁，请稍后再试50100: 邮件发送失败
3. 统一响应格式
{
"code": 0,
"data": {},
"message": "ok"
}后端规范
- 遵循阿里巴巴Java开发手册
- 使用Lombok简化代码
- 方法注释使用JavaDoc格式
- 异常必须处理或向上抛出
- 避免使用魔法值
前端规范
- 遵循Vue 3官方风格指南
- 使用ESLint和Prettier格式化
- 组件Props必须定义类型
- 避免在模板中使用复杂表达式
- API调用统一错误处理
# 基础操作
POST /api/app/add # 创建新应用
POST /api/app/update # 更新应用信息
POST /api/app/delete # 删除应用
GET /api/app/get/vo # 获取应用详情（?id={appId}）
GET /api/app/download/{appId} # 下载应用代码（ZIP格式）
# 列表查询
POST /api/app/my/list/page/vo # 分页获取当前用户的应用列表
POST /api/app/good/list/page/vo # 分页获取精选应用列表（带缓存）
# AI代码生成（🆕 v1.1.0）
POST /api/app/generatePlan/{appId} # 生成开发计划（两阶段生成第一步）
GET /api/app/chat/gen/code # AI对话生成代码（SSE流式，?appId={id}&userMessage=xxx&modelKey=xxx）
POST /api/app/chat/stop # 停止当前代码生成任务
# 部署
POST /api/app/deploy # 部署应用到生产环境
# 管理员接口（需要ADMIN权限）
POST /api/app/admin/update # 管理员更新应用
POST /api/app/admin/delete # 管理员删除应用
POST /api/app/admin/list/page/vo # 管理员分页获取应用列表
GET /api/app/admin/get/vo # 管理员获取应用详情
POST /api/app/version/list/page # 分页查询版本列表
GET /api/app/version/list/{appId} # 查询应用所有版本
GET /api/app/version/get/{versionId} # 获取版本详情
POST /api/app/version/rollback # 版本回滚
# 认证相关
POST /api/user/email/send # 发送邮箱验证码
POST /api/user/register # 用户注册
POST /api/user/login # 用户登录
POST /api/user/logout # 用户登出
POST /api/user/reset-password # 重置密码
# 用户信息
GET /api/user/get/login # 获取当前登录用户信息
GET /api/user/profile # 获取用户主页信息（?userId={id}）
POST /api/user/profile/update # 更新当前用户个人资料
POST /api/user/apps # 获取用户应用列表
# 管理员接口（需要ADMIN权限）
POST /api/user/add # 创建用户
GET /api/user/get # 根据ID获取用户信息
GET /api/user/get/vo # 根据ID获取用户VO
POST /api/user/update # 更新用户信息
POST /api/user/delete # 删除用户
POST /api/user/list/page/vo # 分页获取用户列表
GET /api/points/overview # 获取积分概览（可用、累计获得、累计消耗）
GET /api/points/current # 获取当前积分状态（可用积分、冻结积分）
GET /api/points/records # 查询积分明细记录（?type=SIGN_IN/REGISTER/INVITE/GENERATE）
GET /api/invite/code # 获取邀请码和邀请链接
GET /api/invite/records # 查询邀请记录列表
GET /api/health/ # 健康检查
GET /api/actuator/prometheus # Prometheus指标
GET /api/actuator/health # 详细健康状态
1. 用户注册
curl -X POST "http://localhost:8123/api/user/register" \
-H "Content-Type: application/json" \
-d '{
"userEmail": "test@example.com",
"emailCode": "123456",
"userPassword": "password123",
"checkPassword": "password123",
"userName": "测试用户",
"inviteCode": "INVITE123"
}'2. 创建应用
curl -X POST "http://localhost:8123/api/app/add" \
-H "Content-Type: application/json" \
-H "Cookie: JSESSIONID=xxx" \
-d '{
"appName": "我的Vue应用",
"appDesc": "这是一个测试应用"
}'3. 生成开发计划（两阶段生成第一步）
curl -X POST "http://localhost:8123/api/app/generatePlan/123" \
-H "Content-Type: application/json" \
-H "Cookie: JSESSIONID=xxx" \
-d '{
"userMessage": "做一个图片画廊应用，支持分类浏览和图片预览功能",
"modelKey": "gpt-5-codex-medium"
}'4. AI代码生成（SSE流式）
// 前端使用EventSource接收SSE流式响应
const appId = 123;
const userMessage = "做一个待办事项管理应用";
const modelKey = "gpt-5-codex-medium";
const eventSource = new EventSource(
`http://localhost:8123/api/app/chat/gen/code?appId=${appId}&userMessage=${encodeURIComponent(userMessage)}&modelKey=${modelKey}`
);
eventSource.onmessage = (event) => {
console.log('收到消息:', event.data);
// 处理实时生成的代码片段
};
eventSource.onerror = (error) => {
console.error('连接错误:', error);
eventSource.close();
};
// 停止代码生成
fetch('http://localhost:8123/api/app/chat/stop', {
method: 'POST',
credentials: 'include'
});5. 部署应用
curl -X POST "http://localhost:8123/api/app/deploy" \
-H "Content-Type: application/json" \
-H "Cookie: JSESSIONID=xxx" \
-d '{
"id": 123
}'6. 下载应用代码
curl -X GET "http://localhost:8123/api/app/download/123" \
-H "Cookie: JSESSIONID=xxx" \
-o my-app.zip7. 查询积分概览
curl -X GET "http://localhost:8123/api/points/overview" \
-H "Cookie: JSESSIONID=xxx"8. 查询积分明细
# 查询所有积分记录
curl -X GET "http://localhost:8123/api/points/records" \
-H "Cookie: JSESSIONID=xxx"
# 按类型筛选（SIGN_IN/REGISTER/INVITE/GENERATE）
curl -X GET "http://localhost:8123/api/points/records?type=GENERATE" \
-H "Cookie: JSESSIONID=xxx"9. 获取邀请码
curl -X GET "http://localhost:8123/api/invite/code" \
-H "Cookie: JSESSIONID=xxx"
# 返回示例
{
"code": 0,
"data": {
"inviteCode": "INVNJZKYSJH",
"inviteUrl": "http://localhost:5173/user/register?inviteCode=INVNJZKYSJH"
},
"message": "ok"
}10. 版本回滚
curl -X POST "http://localhost:8123/api/app/version/rollback" \
-H "Content-Type: application/json" \
-H "Cookie: JSESSIONID=xxx" \
-d '{
"appId": 123,
"versionId": 456
}'| 错误码 | 说明 | 处理建议 |
|---|---|---|
| 0 | 成功 | 正常处理响应数据 |
| 40000 | 请求参数错误 | 检查请求参数格式和必填项 |
| 40001 | 验证码无效或已过期 | 重新获取验证码 |
| 40002 | 邮箱已存在 | 使用其他邮箱或直接登录 |
| 40003 | 邮箱格式不正确 | 检查邮箱格式 |
| 40100 | 未登录错误 | 跳转登录页面 |
| 40101 | 无权限错误 | 提示用户权限不足 |
| 40300 | 禁止访问 | 检查访问权限 |
| 40400 | 资源不存在 | 提示资源已被删除或不存在 |
| 42900 | 请求过于频繁 | 稍后重试，建议添加防抖限流 |
| 42901 | 邮件发送过于频繁 | 等待60秒后重试 |
| 50000 | 系统内部异常 | 联系管理员或稍后重试 |
| 50001 | 操作失败 | 查看错误消息并重试 |
| 50100 | 邮件发送失败 | 检查邮件配置或稍后重试 |
项目提供完整的生产环境部署方案，支持 Ubuntu 20.04/22.04 LTS 服务器。
1. 服务器要求
- 操作系统: Ubuntu 20.04 LTS 或 22.04 LTS
- CPU: 2核心以上
- 内存: 4GB 以上（推荐 8GB）
- 磁盘: 20GB 可用空间以上
- 网络: 公网 IP，80/443 端口可访问
2. 必需的外部服务
确保以下服务可用：
- MySQL 8.0+: 数据库服务
- Redis 6.0+: 缓存和会话存储
- AI API 服务: GPT API Key（从 https://204992.xyz 获取）
- 腾讯云 COS: 对象存储服务（需要 SecretId/SecretKey）
- SMTP 邮件服务: 邮件发送（如 QQ 邮箱、Gmail）
3. 环境依赖清单
| 软件 | 版本要求 | 用途 |
|---|---|---|
| Java | 21 | 运行 Spring Boot 应用 |
| MySQL | 8.0+ | 主数据库 |
| Redis | 6.0+ | 会话存储和缓存 |
| Nginx | 1.18+ | 反向代理和静态文件服务 |
| Chrome/Chromium | 最新版 | 网页截图功能 |
步骤 1: 上传部署包
# 将部署包上传到服务器
scp -r deployment/ user@your-server:/tmp/步骤 2: 连接服务器
ssh user@your-server步骤 3: 环境检查
cd /tmp/deployment/scripts
chmod +x *.sh
bash check_env.sh环境检查会验证：
- ✓ 操作系统版本
- ✓ 必需软件是否安装
- ✓ 端口是否可用（80, 443, 8123, 3306, 6379）
- ✓ 磁盘空间是否充足
- ✓ 必需目录权限
步骤 4: 配置环境变量
复制并编辑环境变量文件：
cp /tmp/deployment/.env.prod.example /tmp/deployment/.env.prod
nano /tmp/deployment/.env.prod必须配置的关键参数（80+ 配置项，以下为核心配置）：
# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_NAME=ai_code_mother
DB_USERNAME=root
DB_PASSWORD=your_secure_password # 修改为你的 MySQL 密码
# Redis 配置
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD= # 如有密码请填写
# AI API 配置（核心配置）
OPENAI_API_BASE_URL=https://204992.xyz/v1
OPENAI_API_KEY=sk-your-api-key-here # 替换为你的 API Key
OPENAI_MODEL_REASONING=gpt-5-codex-medium
OPENAI_MODEL_ROUTING=gpt-5-low
# 邮件配置
MAIL_HOST=smtp.qq.com # SMTP 服务器地址
MAIL_PORT=587 # SMTP 端口
MAIL_USERNAME=your-email@qq.com # 发件邮箱
MAIL_PASSWORD=your-smtp-auth-code # SMTP 授权码（不是密码）
# 腾讯云 COS 配置
COS_SECRET_ID=your-secret-id # 腾讯云 SecretId
COS_SECRET_KEY=your-secret-key # 腾讯云 SecretKey
COS_REGION=ap-shanghai # COS 地域
COS_BUCKET=your-bucket-name # 存储桶名称步骤 5: 一键部署
sudo bash deploy.sh部署脚本会自动完成（预计 10-15 分钟）：
- ✓ 安装所有依赖软件（Java 21, MySQL, Redis, Nginx）
- ✓ 创建应用用户和目录（aicode 用户, /var/app/aicodehub）
- ✓ 初始化数据库（导入 SQL 表结构和初始数据）
- ✓ 部署后端应用（JAR 包 + Systemd 服务）
- ✓ 部署前端文件（Vue 构建产物到 /var/www/aicodehub）
- ✓ 配置 Nginx（反向代理 + SSL 支持）
- ✓ 配置日志轮转（自动清理旧日志）
- ✓ 启动所有服务
- ✓ 执行健康检查
步骤 6: 验证部署
# 检查后端健康状态
curl http://localhost:8123/api/health/
# 预期输出: {"status":"UP"}
# 检查前端访问
curl http://localhost/
# 预期输出: HTML 页面内容
# 完整健康检查
bash service_manager.sh health步骤 7: 访问应用
部署成功后，在浏览器访问：
- HTTP:
http://你的服务器IP - HTTPS:
https://你的域名（需要配置 SSL 证书）
deployment/ (总大小: 147 MB)
├── backend/ # 后端应用（143MB JAR包）
│ └── ai-code-mother-0.0.1-SNAPSHOT.jar
├── frontend/ # 前端应用（Vue 3 构建产物, 3.3MB）
│ ├── index.html
│ ├── assets/ # JS/CSS/图标
│ └── favicon.ico
├── config/ # 配置文件（8KB）
│ ├── nginx.conf # Nginx 配置
│ ├── openresty.conf # OpenResty 配置（限流、WAF）
│ ├── aicodehub.service # Systemd 服务配置
│ └── logrotate-aicodehub # 日志轮转配置
├── scripts/ # 部署脚本（32KB）
│ ├── deploy.sh # 一键部署脚本（8.2KB）
│ ├── check_env.sh # 环境检查脚本（7.4KB）
│ ├── init_database.sh # 数据库初始化脚本
│ ├── service_manager.sh # 服务管理脚本
│ ├── backup.sh # 备份脚本
│ └── rollback.sh # 回滚脚本
├── sql/ # 数据库脚本（143KB, 20+ 个）
│ ├── create_table.sql # 建表脚本
│ ├── ai_model_config.sql # AI 模型配置
│ ├── v1.1.0_ai_model_tier_system.sql # 模型等级系统
│ └── migration_*.sql # 迁移脚本
├── docs/ # 完整文档（1281 行）
│ ├── DEPLOYMENT.md # 完整部署指南（677 行）
│ ├── DEPLOYMENT_CHECKLIST.md # 部署检查清单（250 行）
│ └── QUICK_REFERENCE.md # 快速参考手册（354 行）
├── .env.prod.example # 环境变量模板（80+ 配置项）
├── README.md # 部署包说明
└── REVIEW_REPORT.md # 部署包审查报告
使用服务管理脚本：
cd /tmp/deployment/scripts
# 启动服务
bash service_manager.sh start
# 停止服务
bash service_manager.sh stop
# 重启服务
bash service_manager.sh restart
# 查看服务状态
bash service_manager.sh status
# 查看实时日志
bash service_manager.sh logs
# 健康检查
bash service_manager.sh health使用 systemctl 命令：
# 启动后端服务
sudo systemctl start aicodehub
# 停止后端服务
sudo systemctl stop aicodehub
# 重启后端服务
sudo systemctl restart aicodehub
# 查看服务状态
sudo systemctl status aicodehub
# 查看服务日志
sudo journalctl -u aicodehub -f创建备份：
cd /tmp/deployment/scripts
# 每日备份
bash backup.sh daily
# 每周备份
bash backup.sh weekly
# 手动备份
bash backup.sh manual备份内容包括：
- 数据库完整备份
- 应用配置文件
- 前端静态文件
- Nginx 配置
- 日志文件
执行回滚：
# 交互式选择备份版本
bash rollback.sh
# 按提示选择要回滚的备份
# 系统会自动：
# 1. 停止服务
# 2. 恢复数据库
# 3. 恢复应用文件
# 4. 恢复配置
# 5. 重启服务
# 6. 健康检查日志位置：
# 应用日志
/var/app/aicodehub/logs/application.log
# Nginx 访问日志
/var/log/nginx/access.log
# Nginx 错误日志
/var/log/nginx/error.log
# Systemd 服务日志
sudo journalctl -u aicodehubPrometheus 监控：
# 访问监控指标端点
curl http://localhost:8123/api/actuator/prometheus
# 可监控指标包括：
# - HTTP 请求统计
# - AI 模型调用次数和 Token 使用量
# - 数据库查询性能
# - 缓存命中率
# - 积分系统指标完整部署文档：deployment/docs/DEPLOYMENT.md (677 行详细指南)
1. 后端部署
# 打包
./mvnw clean package -DskipTests
# 运行
java -jar target/ai-code-mother-0.0.1-SNAPSHOT.jar \
--spring.profiles.active=prod \
--server.port=81232. 前端部署
# 构建
cd ai-code-mother-frontend
npm run build
# 部署dist目录到Web服务器(Nginx)
cp -r dist/* /var/www/html/3. Nginx配置
server {
listen 80;
server_name your-domain.com;
# 前端静态文件
location / {
root /var/www/html;
try_files $uri $uri/ /index.html;
}
# 后端API代理
location /api/ {
proxy_pass http://localhost:8123;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# SSE支持
proxy_buffering off;
proxy_cache off;
proxy_set_header Connection '';
proxy_http_version 1.1;
chunked_transfer_encoding off;
}
}1. 环境变量配置
完整的环境变量配置清单（80+ 配置项）：
# ==================== 数据库配置 ====================
export DB_HOST=localhost # 数据库主机地址
export DB_PORT=3306 # 数据库端口
export DB_NAME=ai_code_mother # 数据库名称
export DB_USERNAME=root # 数据库用户名
export DB_PASSWORD=your_secure_password # 数据库密码
export DB_DRIVER=com.mysql.cj.jdbc.Driver # 数据库驱动
export DB_URL="jdbc:mysql://${DB_HOST}:${DB_PORT}/${DB_NAME}?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai"
# HikariCP 连接池配置
export DB_POOL_MAX_SIZE=20 # 最大连接数
export DB_POOL_MIN_IDLE=5 # 最小空闲连接数
export DB_POOL_TIMEOUT=30000 # 连接超时时间（毫秒）
export DB_POOL_IDLE_TIMEOUT=600000 # 空闲超时时间（毫秒）
export DB_POOL_MAX_LIFETIME=1800000 # 连接最大生命周期（毫秒）
# ==================== Redis 配置 ====================
export REDIS_HOST=127.0.0.1 # Redis 服务器地址
export REDIS_PORT=6379 # Redis 端口
export REDIS_PASSWORD= # Redis 密码（如无密码留空）
export REDIS_DATABASE=0 # Redis 数据库索引（0-15）
export REDIS_TTL=3600 # 缓存存活时间（秒）
# Redis Lettuce 连接池配置
export REDIS_POOL_MAX_ACTIVE=8 # 最大活跃连接数
export REDIS_POOL_MAX_IDLE=8 # 最大空闲连接数
export REDIS_POOL_MIN_IDLE=2 # 最小空闲连接数
export REDIS_POOL_MAX_WAIT=-1 # 最大等待时间（-1 表示无限等待）
# ==================== Session 配置 ====================
export SESSION_STORE_TYPE=redis # Session 存储类型
export SESSION_TIMEOUT=2592000 # Session 过期时间（秒，30天）
export SESSION_COOKIE_MAX_AGE=2592000 # Cookie 过期时间（秒，30天）
export SESSION_COOKIE_HTTP_ONLY=true # 仅HTTP访问，防止XSS
export SESSION_COOKIE_SECURE=false # 开发环境使用HTTP（生产环境改为true）
# ==================== AI API 配置（核心配置） ====================
# OpenAI 兼容 API 配置
export OPENAI_API_BASE_URL=https://204992.xyz/v1 # API 基础URL
export OPENAI_API_KEY=sk-your-api-key-here # API 密钥
# 推理模型配置（用于复杂代码生成）
export OPENAI_MODEL_REASONING=gpt-5-codex-medium # 高级编码模型
export OPENAI_REASONING_MAX_TOKENS=4000 # 最大生成Token数
export OPENAI_REASONING_TEMPERATURE=0.7 # 生成温度（0-2）
export OPENAI_REASONING_TIMEOUT=300 # 超时时间（秒，5分钟）
# 路由模型配置（用于简单分类任务）
export OPENAI_MODEL_ROUTING=gpt-5-low # 基础编码模型
export OPENAI_ROUTING_MAX_TOKENS=50 # 路由任务Token数
export OPENAI_ROUTING_TEMPERATURE=0.3 # 较低温度确保稳定性
export OPENAI_ROUTING_TIMEOUT=30 # 超时时间（秒）
# 流式模型配置（用于动态模型选择）
export OPENAI_MODEL_STREAMING=gpt-5-low # 默认流式模型
export OPENAI_STREAMING_MAX_TOKENS=8192 # 支持长文本生成
export OPENAI_STREAMING_TEMPERATURE=0.7 # 生成温度
export OPENAI_STREAMING_TIMEOUT=300 # 超时时间（秒，5分钟）
# 模型日志配置
export OPENAI_LOG_REQUESTS=true # 记录请求日志（开发环境）
export OPENAI_LOG_RESPONSES=true # 记录响应日志（开发环境）
# ==================== 腾讯云 COS 配置 ====================
export COS_HOST=your-custom-domain.com # 自定义域名（可选）
export COS_SECRET_ID=your-secret-id # 腾讯云 SecretId
export COS_SECRET_KEY=your-secret-key # 腾讯云 SecretKey
export COS_REGION=ap-shanghai # COS 地域（ap-beijing/ap-shanghai/ap-guangzhou等）
export COS_BUCKET=your-bucket-name # 存储桶名称
# 获取方式：登录腾讯云控制台 > 访问管理 > API密钥管理
# ==================== 邮件服务配置 ====================
export MAIL_HOST=smtp.qq.com # SMTP 服务器地址（QQ邮箱示例）
export MAIL_PORT=587 # SMTP 端口（587为TLS加密端口）
export MAIL_USERNAME=your-email@qq.com # 发件邮箱地址
export MAIL_PASSWORD=your-smtp-auth-code # SMTP 授权码（不是邮箱密码）
export MAIL_PROTOCOL=smtp # 邮件协议
export MAIL_DEFAULT_ENCODING=UTF-8 # 默认编码
export MAIL_SMTP_AUTH=true # 启用SMTP认证
export MAIL_SMTP_STARTTLS_ENABLE=true # 启用TLS加密
export MAIL_SMTP_STARTTLS_REQUIRED=true # TLS加密必需
export MAIL_SMTP_SSL_TRUST=smtp.qq.com # 信任的SMTP服务器
# 其他常用邮箱配置：
# Gmail: smtp.gmail.com:587
# 163邮箱: smtp.163.com:465 (SSL)
# 阿里云邮箱: smtp.aliyun.com:465
# ==================== 可选服务配置 ====================
# Pexels 图片搜索配置（可选）
export PEXELS_API_KEY=your-pexels-api-key
# 获取方式：https://www.pexels.com/api/
# Pixabay 插画搜索配置（可选）
export PIXABAY_API_KEY=your-pixabay-api-key
# 获取方式：https://pixabay.com/api/docs/
# 阿里云 DashScope 配置（可选）
export DASHSCOPE_API_KEY=your-dashscope-api-key
export DASHSCOPE_IMAGE_MODEL=wan2.2-t2i-flash
# 获取方式：https://dashscope.console.aliyun.com/
# ==================== 应用配置 ====================
export SPRING_PROFILES_ACTIVE=prod # 激活的配置文件
export SERVER_PORT=8123 # 后端服务端口
export SERVER_CONTEXT_PATH=/api # API 上下文路径
# ==================== 监控配置 ====================
export MANAGEMENT_ENDPOINTS_INCLUDE=health,info,prometheus # 暴露的端点
export MANAGEMENT_HEALTH_SHOW_DETAILS=always # 显示详细健康信息
# ==================== 日志配置 ====================
export LOGGING_LEVEL_ROOT=INFO # 根日志级别
export LOGGING_LEVEL_APP=DEBUG # 应用日志级别
export LOGGING_FILE_NAME=logs/application.log # 日志文件路径
export LOGGING_FILE_MAX_SIZE=100MB # 单个日志文件最大大小
export LOGGING_FILE_MAX_HISTORY=30 # 保留30天的日志配置说明：
- 必需配置：数据库、Redis、AI API、邮件、COS 配置
- 可选配置：Pexels、Pixabay、DashScope 配置（不配置不影响核心功能）
- 生产环境：请将所有
your-*占位符替换为实际值 - 安全建议：敏感信息（密码、密钥）使用环境变量，不要硬编码到代码中
2. 性能调优
# application-prod.yml
spring:
datasource:
hikari:
maximum-pool-size: 20
minimum-idle: 5
connection-timeout: 30000
idle-timeout: 600000
max-lifetime: 1800000
data:
redis:
lettuce:
pool:
max-active: 8
max-idle: 8
min-idle: 2
# JVM参数
java -Xms2g -Xmx2g -XX:+UseG1GC \
-XX:MaxGCPauseMillis=200 \
-XX:+HeapDumpOnOutOfMemoryError \
-jar app.jar3. 监控配置
# Prometheus配置 (prometheus.yml)
global:
scrape_interval: 15s
scrape_configs:
- job_name: 'ai-code-mother'
metrics_path: '/api/actuator/prometheus'
static_configs:
- targets: ['localhost:8123']4. 日志配置
logging:
level:
root: INFO
com.spring.aicodemother: DEBUG
file:
name: logs/application.log
max-size: 100MB
max-history: 30
pattern:
console: "%d{yyyy-MM-dd HH:mm:ss} - %msg%n"
file: "%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n"5. 安全配置
- 使用HTTPS(SSL证书)
- 配置防火墙规则
- 定期备份数据库
- 设置强密码策略
- 启用访问日志
- 配置限流和防刷
6. 备份策略
# 数据库备份脚本
#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/backup/mysql"
mysqldump -u root -p ai_code_mother > $BACKUP_DIR/ai_code_mother_$DATE.sql
find $BACKUP_DIR -name "*.sql" -mtime +30 -deleteQ: 后端启动失败，提示数据库连接错误 A:
- 检查MySQL服务是否启动
- 验证数据库连接配置(地址、端口、用户名、密码)
- 确认数据库
ai_code_mother已创建 - 检查防火墙是否阻止连接
Q: 前端启动后无法调用后端API A:
- 确认后端服务已启动(http://localhost:8123/api/health)
- 检查跨域配置是否正确
- 清除浏览器缓存
- 检查浏览器控制台的错误信息
Q: OpenAPI代码生成失败 A:
# Windows清除代理环境变量后重试
set HTTP_PROXY= && set HTTPS_PROXY= && npm run openapi2ts
# Linux/Mac
unset HTTP_PROXY && unset HTTPS_PROXY && npm run openapi2tsQ: Redis连接失败 A:
- 检查Redis服务是否启动:
redis-cli ping - 验证Redis配置(host、port)
- 检查Redis密码配置
- 测试环境需要Redis运行才能通过测试
Q: 邮箱验证码收不到 A:
- 检查邮箱地址是否正确
- 查看垃圾邮件文件夹
- 验证邮件服务配置(SMTP服务器、端口、凭证)
- 检查后端日志是否有发送失败记录
Q: AI代码生成失败 A:
- 检查AI API密钥是否配置正确
- 验证API密钥是否有效和有余额
- 检查网络连接是否正常
- 查看后端日志的详细错误信息
- 确认积分是否足够
Q: 积分扣除了但代码生成失败 A:
- 系统会自动退还失败任务的积分
- 如未退还,联系管理员人工处理
- 查看积分记录确认扣除和退还情况
Q: 邀请好友后没有获得积分 A:
- 确认好友已完成注册
- 邀请奖励在好友注册后24小时内发放
- 检查是否触发了防刷机制
- 查看邀请记录的状态
Q: 版本回滚后数据丢失 A:
- 版本回滚只恢复应用配置,不影响其他数据
- 回滚操作会创建新版本记录
- 可以再次回滚到之前的版本
- 所有版本数据都保留
Q: 生产环境启动慢 A:
- 调整JVM堆内存参数:
-Xms2g -Xmx2g - 使用G1垃圾回收器:
-XX:+UseG1GC - 优化数据库连接池配置
- 启用Caffeine本地缓存
Q: SSE连接频繁断开 A:
- 检查Nginx配置是否支持长连接
- 禁用Nginx缓冲:
proxy_buffering off - 设置合适的超时时间
- 实现客户端自动重连机制
Q: 文件上传到COS失败 A:
- 检查COS配置(SecretId、SecretKey、Region、Bucket)
- 验证COS桶权限设置
- 检查网络连接
- 查看文件大小是否超限
Q: Prometheus指标无法收集 A:
- 确认Actuator端点已启用
- 检查Prometheus配置文件
- 验证网络连接和端口
- 查看应用日志是否有错误
Q: 数据库查询慢 A:
- 添加合适的索引
- 优化SQL查询语句
- 使用分页查询避免全表扫描
- 启用Redis缓存热点数据
- 使用Caffeine缓存频繁访问的数据
Q: 并发量大时系统卡顿 A:
- 增加数据库连接池大小
- 增加Redis连接池大小
- 调整JVM内存参数
- 使用负载均衡
- 优化代码中的同步锁
Q: 前端首次加载慢 A:
- 启用代码分割和懒加载
- 压缩和优化图片资源
- 启用Gzip压缩
- 使用CDN加速静态资源
- 优化打包配置
1. 查看后端日志
# 实时查看日志
tail -f logs/application.log
# 搜索错误日志
grep ERROR logs/application.log
# 查看最近100行
tail -n 100 logs/application.log2. 查看数据库日志
# MySQL错误日志
tail -f /var/log/mysql/error.log
# 慢查询日志
tail -f /var/log/mysql/slow.log3. 检查系统资源
# 查看内存使用
free -h
# 查看CPU使用
top
# 查看磁盘使用
df -h
# 查看端口占用
netstat -tulpn | grep 81234. 测试网络连接
# 测试数据库连接
mysql -h localhost -u root -p
# 测试Redis连接
redis-cli ping
# 测试HTTP接口
curl http://localhost:8123/api/healthQ: 一键部署脚本执行失败，提示权限不足 A:
- 确保使用
sudo执行部署脚本 - 检查当前用户是否有管理员权限
- 验证脚本是否有执行权限:
chmod +x deploy.sh - 查看部署日志:
cat /tmp/deployment/logs/deploy.log
Q: 部署过程中提示端口被占用（8123/80/3306/6379） A:
# 查看端口占用情况
sudo netstat -tulpn | grep 8123
sudo netstat -tulpn | grep 80
sudo netstat -tulpn | grep 3306
sudo netstat -tulpn | grep 6379
# 停止占用端口的进程
sudo kill -9 <PID>
# 或修改配置文件使用其他端口Q: 环境检查脚本提示缺少依赖 A:
# Ubuntu 手动安装依赖
sudo apt update
sudo apt install -y openjdk-21-jdk mysql-server redis-server nginx chromium-browser
# 验证安装
java -version
mysql --version
redis-server --version
nginx -vQ: 数据库初始化失败 A:
- 检查 MySQL 服务是否启动:
sudo systemctl status mysql - 验证 root 密码是否正确
- 手动执行 SQL 脚本:
mysql -u root -p < deployment/sql/create_table.sql mysql -u root -p < deployment/sql/v1.1.0_ai_model_tier_system.sql
- 检查 SQL 脚本是否有语法错误
Q: 部署完成后无法访问（显示 502/504） A:
- 检查后端服务状态:
sudo systemctl status aicodehub - 查看后端日志:
sudo journalctl -u aicodehub -n 100 - 验证 Nginx 配置:
sudo nginx -t - 检查防火墙规则:
sudo ufw status - 确认端口 8123 正在监听:
sudo netstat -tulpn | grep 8123
Q: SSL 证书配置失败 A:
# 使用 Let's Encrypt 免费证书
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com
# 手动配置证书
# 编辑 /etc/nginx/sites-available/aicodehub
# 添加 SSL 配置
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;Q: 不知道该选择哪个 AI 模型？ A: 根据项目复杂度选择：
| 项目类型 | 推荐模型 | 质量系数 | 积分消耗 |
|---|---|---|---|
| 简单页面（5个文件以内） | gpt-5-low | 1.0x | 低 |
| 标准项目（5-10个文件） | qwen-turbo | 1.5x | 中 |
| 复杂应用（10+个文件） | gpt-5-codex-medium | 2.0x | 高 |
| 企业级项目 | gpt-5-codex-high | 2.5x | 很高 |
Q: AI 模型调用超时 A:
- 检查网络连接是否稳定
- 验证 API Key 是否有效
- 尝试使用更快的模型（如 gpt-5-low）
- 检查后端配置中的超时时间设置（默认 5 分钟）
- 查看是否有大量并发请求导致 API 限流
Q: 生成的代码质量不好 A:
- 使用更高级的模型: 如 gpt-5-codex-high
- 优化提示词: 提供更详细的需求描述
- 使用两阶段生成: 先生成计划，确认后再生成代码
- 启用代码验证: 自动检查代码质量
- 提供示例: 在需求中包含期望的代码风格示例
Q: Token 消耗太快，积分不够用 A:
- 选择合适的模型: 简单项目不要用高级模型
- 使用两阶段生成: 避免无效生成浪费积分
- 优化提示词: 简洁明确，避免冗余
- 邀请好友: 邀请双方各得 50 积分
- 查看积分明细: 了解积分消耗情况，优化使用策略
Q: 生成的 Vue 项目无法运行 A:
# 1. 检查 Node.js 版本（需要 18+）
node -v
# 2. 清除缓存并重新安装依赖
cd your-project
rm -rf node_modules package-lock.json
npm install
# 3. 检查是否有依赖冲突
npm ls
# 4. 尝试使用其他包管理器
pnpm install # 或 yarn installQ: Vue 项目构建失败 A:
- 查看构建错误信息
- 检查代码验证报告中的错误
- 常见问题修复:
# TypeScript 类型错误 npm run type-check # ESLint 错误 npm run lint --fix # 依赖版本冲突 npm update
Q: 部署后页面显示 404 A:
- 检查 Nginx 配置中的
root路径是否正确 - 确认前端文件已正确部署到
/var/www/aicodehub - 检查
index.html是否存在 - Nginx 配置需要添加:
location / { try_files $uri $uri/ /index.html; }
Q: Vue 项目依赖安装失败 A:
# 使用国内镜像加速
npm config set registry https://registry.npmmirror.com
# 清除 npm 缓存
npm cache clean --force
# 使用 pnpm（更快更稳定）
npm install -g pnpm
pnpm install
# 跳过可选依赖
npm install --no-optionalQ: Java 版本不对，提示需要 Java 21 A:
# Ubuntu 安装 Java 21
sudo apt install openjdk-21-jdk
# 切换 Java 版本
sudo update-alternatives --config java
# 验证版本
java -versionQ: Node.js 版本太低 A:
# 使用 nvm 管理 Node.js 版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
# 安装 Node.js 18
nvm install 18
nvm use 18
# 验证版本
node -v # 应显示 v18.x.xQ: 环境变量配置不生效 A:
# 方法1: 添加到 ~/.bashrc（当前用户）
echo 'export OPENAI_API_KEY=your-key' >> ~/.bashrc
source ~/.bashrc
# 方法2: 添加到 /etc/environment（全局）
sudo nano /etc/environment
# 添加: OPENAI_API_KEY=your-key
# 方法3: 使用 .env 文件
cp deployment/.env.prod.example deployment/.env.prod
nano deployment/.env.prod
# 在部署脚本中加载: source deployment/.env.prodQ: Chrome/Chromium 未安装，截图功能失败 A:
# Ubuntu 安装 Chromium
sudo apt install chromium-browser chromium-chromedriver
# 验证安装
chromium-browser --version
# 如果无法安装，使用 Chrome
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt-get install -fQ: 积分计算方式是什么？ A: 积分消耗 = (Token 数量 / 1000) × 模型积分消耗率 × 质量系数
示例：
- 使用 gpt-5-low（3积分/1K tokens，质量系数1.0）
- 生成消耗了 10,000 tokens
- 积分消耗 = (10000 / 1000) × 3 × 1.0 = 30 积分
Q: 如何获取更多积分？ A:
- 注册奖励: 新用户注册赠送 100 积分
- 邀请好友: 邀请双方各得 50 积分（无上限）
- 每日签到: 每日首次登录获得 10 积分（可扩展）
- 参与活动: 关注官方活动获得额外积分
Q: 积分有效期多久？ A:
- 积分有效期为 180 天（6个月）
- 即将过期的积分会提前 30 天通知
- 过期积分自动扣除
- 建议定期使用，避免浪费
Q: 积分扣除有误如何处理？ A:
- 查看积分明细记录，确认扣除情况
- 检查是否是生成失败后已自动退还
- 联系管理员提供以下信息:
- 用户 ID
- 积分记录 ID
- 操作时间
- 预期积分 vs 实际积分
- 系统会进行一致性检查并自动修复
Q: 登录后立即退出，无法保持登录状态 A:
- 检查浏览器是否禁用 Cookie
- 清除浏览器缓存和 Cookie
- 检查后端 Session 配置是否正确
- 验证 Redis 连接是否正常:
redis-cli ping - 检查跨域配置: CORS 和 credentials
Q: 页面白屏，控制台报错 A:
// 常见错误修复
// 1. 检查是否有 JavaScript 错误
// 打开浏览器控制台查看错误详情
// 2. 检查 API 基础 URL 是否正确
// .env.development 或 .env.production
// 3. 清除缓存并刷新
Ctrl + Shift + Delete (Chrome)
Ctrl + F5 (强制刷新)
// 4. 检查路由配置
// router/index.tsQ: 文件上传失败 A:
- 检查文件大小是否超过限制（默认 10MB）
- 验证 COS 配置是否正确
- 查看浏览器网络请求的错误信息
- 检查后端日志:
tail -f logs/application.log | grep COS
Q: 如何提升代码生成速度？ A:
- 选择更快的模型: gpt-5-low 响应速度最快
- 优化提示词: 简洁明确，减少 Token 消耗
- 使用 ChatMemory 优化: 系统已自动优化，限制 30 条消息
- 避免生成过大项目: 建议单次生成不超过 20 个文件
Q: 如何减少服务器内存占用？ A:
# 调整 JVM 内存参数
# 编辑 /etc/systemd/system/aicodehub.service
Environment="JAVA_OPTS=-Xms1G -Xmx2G -XX:+UseG1GC"
# 优化数据库连接池
# application-prod.yml
hikari:
maximum-pool-size: 10 # 从 20 降低到 10
minimum-idle: 2 # 从 5 降低到 2Q: 如何提升并发处理能力？ A:
- 增加连接池大小: 数据库和 Redis 连接池
- 启用缓存: Caffeine 本地缓存 + Redis 分布式缓存
- 使用负载均衡: Nginx upstream 配置多个后端实例
- 优化数据库查询: 添加索引，使用分页查询
- 启用 CDN: 静态资源使用 CDN 加速
我们欢迎所有形式的贡献！
- Fork项目仓库
- 创建特性分支
git checkout -b feature/AmazingFeature
- 提交更改
git commit -m 'Add some AmazingFeature' - 推送到分支
git push origin feature/AmazingFeature
- 开启Pull Request
代码风格
- 后端遵循阿里巴巴Java开发手册
- 前端遵循Vue 3官方风格指南
- 使用ESLint和Prettier保持代码风格统一
提交消息规范
<type>(<scope>): <subject>
<body>
<footer>
类型(type):
- feat: 新功能
- fix: 修复bug
- docs: 文档更新
- style: 代码格式调整
- refactor: 重构
- test: 测试相关
- chore: 构建/工具链更新
示例:
feat(points): 添加积分过期自动扣除功能
- 实现定时任务自动检查过期积分
- 添加积分过期通知功能
- 更新积分记录表结构
Closes #123
测试要求
- 新功能必须添加单元测试
- 确保所有测试通过
- 测试覆盖率不低于70%
文档更新
- 更新相关API文档
- 更新用户使用文档
- 添加代码注释
提交Issue时请包含:
- 问题描述
- 复现步骤
- 期望行为
- 实际行为
- 环境信息(OS、Java版本、Node版本等)
- 错误日志或截图
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
感谢以下开源项目和服务:
- Spring Boot - 强大的Java应用框架
- Vue.js - 渐进式JavaScript框架
- Ant Design Vue - 优秀的Vue UI组件库
- LangChain4j - Java AI应用框架
- MyBatis-Flex - 灵活的MyBatis增强框架
- OpenAI - AI 模型服务提供商
- Vite - 快速的前端构建工具
- Redis - 高性能内存数据库
- Prometheus - 开源监控系统
- Redisson - Redis Java客户端
- Hutool - Java工具类库
- 动态 AI 模型选择系统: 支持 20+ 个 AI 模型，4 级模型分类
- 两阶段代码生成流程: 计划生成 → 用户确认 → 代码生成
- 代码自动验证: ESLint 集成，自动生成代码审查报告
- 企业级部署方案: 完整的 deployment/ 目录，支持一键部署
- 修复积分系统 8 个 P0-P3 级别缺陷
- 新增积分状态管理和一致性检查器
- 新增备份和回滚机制
- 新增 OpenResty 支持（限流、WAF）
- 新增日志轮转配置
- 优化 ChatMemory 管理，Vue 项目生成速度提升 50%+
- 修复 Token 监控跨线程问题
- 增加流式 AI 模型超时时间到 5 分钟
- 集成 Lovable 主题系统
- 新增 AI 模型选择器组件（544 行）
- 新增部署中弹窗、预览加载、差异查看器等组件
- 重构聊天页面为模块化组件
- 新增 18 个 SVG 图标（Deploy、ToolsCall、Online search、refresh、thinking 等）
- 前端聊天页面模块化（从 5844 行重构为多个组件）
- 新增 composables 目录，提取复用逻辑
- 优化项目结构和代码组织
- 新增 677 行完整部署文档
- 新增部署检查清单和快速参考手册
- 新增环境变量模板（80+ 配置项）
- 修复 ChatMemory 无限增长问题: 限制临时记忆最大消息数为 30
- Vue 项目生成中后期速度显著提升（从 30-40 秒/文件优化到 10-15 秒/文件）
- 邮箱认证体系
- 版本管理系统
- 积分激励系统
- 邀请裂变机制
- 内置模板库
让 AI 为您的代码生成插上翅膀！
我们致力于打造最易用、最智能的 AI 代码生成平台 专注于 Vue 3 项目的智能化生成，为开发者提供高效、优质的代码生成服务
💡 创新 · 🚀 高效 · 🎨 优雅 · 🔒 安全
Made with ❤️ by Join2049
Copyright © 2025 AI Code Mother. All rights reserved.