AI Platform — 轻量级 AI 智能对话平台产品系统

AI Platform 面向个人开发者和小团队，解决自建 AI 对话应用成本高、配置复杂的问题。用户可自定义 Agent 角色与模型参数，通过 DeepSeek 大模型进行多轮对话，适用于智能客服、知识问答、代码咨询等业务场景。

本项目包含以下核心功能模块：

（1）用户认证：注册、登录，采用 Sa-Token 实现 token 认证（30 天有效期），支持并发登录控制，所有数据按用户 ID 隔离。

（2）Agent 配置管理：用户可创建、编辑、查看、删除自己的 Agent 配置，每个 Agent 可独立设置系统提示词（System Prompt）、模型名称、温度参数、最大 Token 数等，删除采用逻辑删除可恢复。

（3）多轮 AI 对话：前端发送消息后，后端通过 AgentScope 引擎编排调用 DeepSeek 大模型，支持多轮历史上下文拼接，首次对话自动生成会话标题。

（4）对话历史管理：会话列表分页展示、查看历史消息记录、删除会话并级联逻辑删除关联消息。

（5）API Key 管理：用户可自行配置 DeepSeek API Key，AES 加密存储、不返回明文，实现用量隔离与成本自担。

主体逻辑为：用户登录 → 选择/创建 Agent → 发送消息 → 后端拉取上下文 → 调用 AgentScope 引擎 → 返回 AI 回复并持久化。

项目采用三层分离全栈架构：

agentscope-engine（Python/FastAPI，8000）：Agent 引擎层，封装 AgentScope 2.0.5，暴露 /chat、/health 调 DeepSeek，仅内网。
ai-platform-server（Spring Boot 3.3.2，9000）：业务后端，承担认证、Agent 配置、对话编排、历史管理。
ai-platform-web（Vue3+Vite+Element Plus，5173）：前端负责 UI，Vite 代理 /api 至后端。
编码结构：后端 Controller→Service→Mapper→Entity 分层，含 REST 控制器、统一响应、全局异常、DTO 校验、分页/自动填充、AES 加密；前端 Vue3+TS，api 层按领域拆分、axios 拦截器注入 token、Pinia 状态管理、路由懒加载+登录守卫。

核心技术点：1）跨语言集成：Java 经 HTTP 调 Python 引擎，模型层解耦；2）API Key 安全：AES 加密存储，解析优先级「用户配置→环境变量→拒绝」；3）逻辑删除：四表 deleted 字段全局过滤可恢复；4）多轮上下文：拉取历史组装 UserMsg，首条回复自动生成标题；5）Sa-Token 认证：token 30 天、并发登录；6）数据隔离：查询按 userId 过滤。

实现难点：跨语言协议对齐（JSON+Pydantic 校验）、API Key 隐私三级保护、会话级联逻辑删除、AgentScope 流式预留。数据库：ai_platform 四表（InnoDB+utf8mb4）。