diff --git a/AI助手后端接口文档.md b/AI助手后端接口文档.md new file mode 100644 index 0000000..3a22e69 --- /dev/null +++ b/AI助手后端接口文档.md @@ -0,0 +1,396 @@ +# AI助手后端接口文档 + +## 重要提示 - 分类API更新需求 + +前端已修复分类数量显示问题，需要后端配合更新以下API： + +### 论坛分类API (`/api/categories`) +返回的分类数据需要包含 `postCount` 字段： +```json +{ + "code": 200, + "data": { + "list": [ + { + "id": 1, + "name": "学术交流", + "description": "学术讨论与交流", + "postCount": 15, // ← 新增：该分类下的帖子数量 + "status": 1, + "createdAt": "2024-12-21T10:00:00Z" + } + ] + } +} +``` + +### 资源分类API (`/api/categories`) +当用于资源模块时，需要包含 `resourceCount` 字段： +```json +{ + "code": 200, + "data": { + "list": [ + { + "id": 1, + "name": "学术资料", + "description": "学术相关资源", + "resourceCount": 8, // ← 新增：该分类下的资源数量 + "status": 1, + "createdAt": "2024-12-21T10:00:00Z" + } + ] + } +} +``` + +--- + +## 概述 + +AI助手功能为UniLife平台提供智能问答服务，支持多轮对话、会话管理、历史记录等功能。 + +## 基础信息 + +- **基础URL**: `/api/ai` +- **认证方式**: JWT Token (Header: `Authorization: Bearer `) +- **响应格式**: JSON + +## 通用响应格式 + +```json +{ + "code": 200, + "message": "success", + "data": { ... }, + "timestamp": "2024-12-21T10:30:00Z" +} +``` + +## 数据模型 + +### ChatMessage 聊天消息 + +```json +{ + "id": "string", + "sessionId": "string", + "role": "user|assistant|system", + "content": "string", + "timestamp": "2024-12-21T10:30:00Z", + "userId": "number" +} +``` + +### ChatSession 聊天会话 + +```json +{ + "id": "string", + "userId": "number", + "title": "string", + "createdAt": "2024-12-21T10:30:00Z", + "updatedAt": "2024-12-21T10:30:00Z", + "lastMessageTime": "2024-12-21T10:30:00Z", + "messageCount": "number" +} +``` + +## API接口 + +### 1. 发送消息 (核心接口) + +**POST** `/ai/chat` + +向AI发送消息并获取回复。 + +**请求体:** +```json +{ + "message": "如何学习Java编程?", + "sessionId": "session_123", // 可选，不传则创建新会话 + "conversationHistory": [ // 可选，用于上下文 + { + "role": "user", + "content": "之前的问题", + "timestamp": "2024-12-21T10:25:00Z" + } + ] +} +``` + +**响应:** +```json +{ + "code": 200, + "message": "success", + "data": { + "messageId": "msg_456", + "content": "学习Java编程可以从以下几个方面开始:\n\n1. **基础语法**\n - 变量和数据类型\n - 控制流程\n - 面向对象\n\n2. **实践项目**\n - 简单的控制台程序\n - Web应用开发\n\n```java\npublic class HelloWorld {\n public static void main(String[] args) {\n System.out.println(\"Hello, World!\");\n }\n}\n```\n\n希望这个建议对你有帮助！", + "sessionId": "session_123", + "timestamp": "2024-12-21T10:30:00Z" + } +} +``` + +### 2. 获取聊天会话列表 + +**GET** `/ai/sessions` + +获取用户的所有聊天会话。 + +**查询参数:** +- `page`: number (默认: 1) +- `size`: number (默认: 20) + +**响应:** +```json +{ + "code": 200, + "data": { + "sessions": [ + { + "id": "session_123", + "userId": 1, + "title": "Java学习咨询", + "createdAt": "2024-12-21T10:00:00Z", + "updatedAt": "2024-12-21T10:30:00Z", + "lastMessageTime": "2024-12-21T10:30:00Z", + "messageCount": 5 + } + ], + "total": 10 + } +} +``` + +### 3. 获取会话消息历史 + +**GET** `/ai/sessions/{sessionId}/messages` + +获取指定会话的消息历史。 + +**路径参数:** +- `sessionId`: string - 会话ID + +**查询参数:** +- `page`: number (默认: 1) +- `size`: number (默认: 50) + +**响应:** +```json +{ + "code": 200, + "data": { + "messages": [ + { + "id": "msg_001", + "sessionId": "session_123", + "role": "user", + "content": "如何学习Java编程?", + "timestamp": "2024-12-21T10:25:00Z", + "userId": 1 + }, + { + "id": "msg_002", + "sessionId": "session_123", + "role": "assistant", + "content": "学习Java编程可以从基础语法开始...", + "timestamp": "2024-12-21T10:30:00Z", + "userId": null + } + ], + "total": 5, + "sessionInfo": { + "id": "session_123", + "title": "Java学习咨询", + "createdAt": "2024-12-21T10:00:00Z" + } + } +} +``` + +### 4. 创建新的聊天会话 + +**POST** `/ai/sessions` + +创建一个新的聊天会话。 + +**请求体:** +```json +{ + "title": "新的聊天" // 可选，不传则自动生成 +} +``` + +**响应:** +```json +{ + "code": 200, + "data": { + "sessionId": "session_456", + "title": "新的聊天" + } +} +``` + +### 5. 更新会话标题 + +**PUT** `/ai/sessions/{sessionId}` + +更新指定会话的标题。 + +**路径参数:** +- `sessionId`: string + +**请求体:** +```json +{ + "title": "Java学习讨论" +} +``` + +**响应:** +```json +{ + "code": 200, + "message": "会话标题更新成功" +} +``` + +### 6. 删除聊天会话 + +**DELETE** `/ai/sessions/{sessionId}` + +删除指定的聊天会话及其所有消息。 + +**路径参数:** +- `sessionId`: string + +**响应:** +```json +{ + "code": 200, + "message": "会话删除成功" +} +``` + +### 7. 清空会话消息 + +**DELETE** `/ai/sessions/{sessionId}/messages` + +清空指定会话的所有消息，但保留会话。 + +**路径参数:** +- `sessionId`: string + +**响应:** +```json +{ + "code": 200, + "message": "会话消息已清空" +} +``` + +## 错误码说明 + +| 错误码 | 说明 | +|--------|------| +| 400 | 请求参数错误 | +| 401 | 未授权访问 | +| 403 | 无权限访问 | +| 404 | 会话或消息不存在 | +| 429 | 请求频率过高 | +| 500 | AI服务异常 | +| 503 | AI服务暂时不可用 | + +## 实现建议 + +### 1. 数据库设计 + +**ai_sessions表:** +```sql +CREATE TABLE ai_sessions ( + id VARCHAR(64) PRIMARY KEY, + user_id BIGINT NOT NULL, + title VARCHAR(200) NOT NULL, + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + last_message_time TIMESTAMP, + message_count INT DEFAULT 0, + INDEX idx_user_id (user_id), + INDEX idx_updated_at (updated_at) +); +``` + +**ai_messages表:** +```sql +CREATE TABLE ai_messages ( + id VARCHAR(64) PRIMARY KEY, + session_id VARCHAR(64) NOT NULL, + user_id BIGINT, + role ENUM('user', 'assistant', 'system') NOT NULL, + content TEXT NOT NULL, + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + INDEX idx_session_id (session_id), + INDEX idx_created_at (created_at), + FOREIGN KEY (session_id) REFERENCES ai_sessions(id) ON DELETE CASCADE +); +``` + +### 2. AI服务集成 + +建议集成以下AI服务之一： +- **OpenAI GPT API** - 功能强大，支持多种模型 +- **百度文心一言** - 中文优化，国内访问稳定 +- **阿里通义千问** - 企业级服务，安全可靠 +- **智谱GLM** - 性价比高，中文效果好 + +### 3. 关键功能 + +1. **上下文管理**: 维护对话历史，提供连贯的多轮对话 +2. **流式输出**: 支持Server-Sent Events实现打字机效果 +3. **内容安全**: 过滤敏感内容，确保回复安全合规 +4. **速率限制**: 防止滥用，控制每用户请求频率 +5. **缓存机制**: 相似问题缓存回复，提高响应速度 + +### 4. 安全考虑 + +- 所有接口需要JWT认证 +- 验证用户对会话的权限 +- 过滤和审核用户输入 +- 监控和记录异常使用行为 +- 设置合理的内容长度限制 + +### 5. 性能优化 + +- 使用连接池管理AI服务连接 +- 实现请求排队和负载均衡 +- 添加Redis缓存热门问答 +- 定期清理过期会话数据 +- 监控API调用频率和成本 + +## 前端配合说明 + +前端已实现： +- ✅ 现代化聊天界面设计 +- ✅ Markdown内容渲染 +- ✅ 打字机效果动画 +- ✅ 会话历史管理 +- ✅ 响应式设计 +- ✅ 示例问题快速发送 +- ✅ 键盘快捷键支持 + +需要后端配合： +- 🔄 实现上述所有API接口 +- 🔄 选择并集成AI服务 +- 🔄 建立数据库表结构 +- 🔄 添加安全和性能优化 + +## 测试建议 + +1. **单元测试**: 测试各API接口的基本功能 +2. **集成测试**: 测试AI服务的集成和响应 +3. **压力测试**: 测试并发请求的处理能力 +4. **安全测试**: 验证权限控制和内容安全 +5. **用户体验测试**: 测试实际使用场景和响应时间 \ No newline at end of file diff --git a/unilife-frontend/src/api/ai.ts b/unilife-frontend/src/api/ai.ts new file mode 100644 index 0000000..a77d227 --- /dev/null +++ b/unilife-frontend/src/api/ai.ts @@ -0,0 +1,82 @@ +import api from './index' +import type { ApiResponse } from '@/types' + +// AI聊天相关接口 +export interface ChatMessage { + id: string + role: 'user' | 'assistant' | 'system' + content: string + timestamp: string +} + +export interface ChatSession { + id: string + title: string + createdAt: string + updatedAt: string + lastMessageTime: string + messageCount: number +} + +export interface SendMessageRequest { + message: string + sessionId?: string + conversationHistory?: ChatMessage[] +} + +export interface SendMessageResponse { + messageId: string + content: string + sessionId: string + timestamp: string +} + +export interface ChatHistoryResponse { + sessions: ChatSession[] + total: number +} + +export interface ChatMessagesResponse { + messages: ChatMessage[] + total: number + sessionInfo: ChatSession +} + +// 发送消息给AI +export const sendMessage = (data: SendMessageRequest) => { + return api.post>('/ai/chat', data) +} + +// 获取聊天历史列表 +export const getChatHistory = (page = 1, size = 20) => { + return api.get>('/ai/sessions', { + params: { page, size } + }) +} + +// 获取指定会话的消息历史 +export const getChatMessages = (sessionId: string, page = 1, size = 50) => { + return api.get>(`/ai/sessions/${sessionId}/messages`, { + params: { page, size } + }) +} + +// 创建新的聊天会话 +export const createChatSession = (title?: string) => { + return api.post>('/ai/sessions', { title }) +} + +// 删除聊天会话 +export const deleteChatSession = (sessionId: string) => { + return api.delete(`/ai/sessions/${sessionId}`) +} + +// 更新会话标题 +export const updateSessionTitle = (sessionId: string, title: string) => { + return api.put(`/ai/sessions/${sessionId}`, { title }) +} + +// 清空会话消息 +export const clearSessionMessages = (sessionId: string) => { + return api.delete(`/ai/sessions/${sessionId}/messages`) +} \ No newline at end of file diff --git a/unilife-frontend/src/router/index.ts b/unilife-frontend/src/router/index.ts index 0a086a0..8e6fe76 100644 --- a/unilife-frontend/src/router/index.ts +++ b/unilife-frontend/src/router/index.ts @@ -55,6 +55,12 @@ const router = createRouter({ component: () => import('@/views/schedule/TaskView.vue'), meta: { requiresAuth: true } }, + { + path: '/ai-assistant', + name: 'ai-assistant', + component: () => import('@/views/AIAssistantView.vue'), + meta: { requiresAuth: true } + }, { path: '/profile', name: 'profile', diff --git a/unilife-frontend/src/types/index.ts b/unilife-frontend/src/types/index.ts index 87cb692..f8e526a 100644 --- a/unilife-frontend/src/types/index.ts +++ b/unilife-frontend/src/types/index.ts @@ -110,6 +110,8 @@ export interface Category { status: number createdAt: string updatedAt: string + postCount?: number // 该分类下的帖子数量 + resourceCount?: number // 该分类下的资源数量 } // 资源相关类型 diff --git a/unilife-frontend/src/views/AIAssistantView.vue b/unilife-frontend/src/views/AIAssistantView.vue new file mode 100644 index 0000000..668ad2c --- /dev/null +++ b/unilife-frontend/src/views/AIAssistantView.vue @@ -0,0 +1,864 @@ + + + + + \ No newline at end of file diff --git a/unilife-frontend/src/views/forum/ForumView.vue b/unilife-frontend/src/views/forum/ForumView.vue index c235ee1..976e509 100644 --- a/unilife-frontend/src/views/forum/ForumView.vue +++ b/unilife-frontend/src/views/forum/ForumView.vue @@ -17,6 +17,7 @@ 资源 课程表 日程管理 + AI助手
@@ -63,6 +64,18 @@

讨论分类

+ +
+ + + + 全部分类 + {{ totalPostsCount }} +
{{ category.name }} - 0 + {{ category.postCount || 0 }}
@@ -351,6 +364,7 @@ const postFormRef = ref() // 真实数据 const categories = ref([]) const posts = ref([]) +const totalPostsCount = ref(0) // 总帖子数量，用于"全部分类"显示 const pagination = ref({ page: 1, size: 10, @@ -517,6 +531,11 @@ const loadPosts = async () => { pagination.value.total = response.data.total || 0 pagination.value.pages = response.data.pages || 0 + // 只有在未选择分类时才更新总数（即显示所有帖子时） + if (!selectedCategory.value && !searchKeyword.value.trim()) { + totalPostsCount.value = response.data.total || 0 + } + // 调试信息：打印帖子的点赞状态 console.log('加载的帖子数据:', posts.value.map(p => ({ id: p.id, @@ -545,6 +564,10 @@ const loadCategories = async () => { if (response.code === 200) { categories.value = response.data.list || [] + console.log('分类列表加载成功:', categories.value) + + // 加载每个分类的帖子数量 + await loadCategoryPostCounts() } else { console.error('加载分类失败:', response.message) } @@ -554,10 +577,59 @@ const loadCategories = async () => { } } +// 加载每个分类的帖子数量 +const loadCategoryPostCounts = async () => { + try { + for (const category of categories.value) { + try { + const response = await getPosts({ + categoryId: category.id, + page: 1, + size: 1 + }) as any as ApiResponse<{ + total: number + list: Post[] + pages: number + }> + + if (response.code === 200) { + // 直接修改分类对象的postCount属性 + category.postCount = response.data.total || 0 + } + } catch (error) { + console.error(`加载分类${category.name}的帖子数量失败:`, error) + category.postCount = 0 + } + } + console.log('分类帖子数量加载完成:', categories.value.map(c => ({ name: c.name, count: c.postCount }))) + } catch (error) { + console.error('加载分类帖子数量失败:', error) + } +} + +// 加载总帖子数量 +const loadTotalPostsCount = async () => { + try { + const response = await getPosts({ page: 1, size: 1 }) as any as ApiResponse<{ + total: number + list: Post[] + pages: number + }> + + if (response.code === 200) { + totalPostsCount.value = response.data.total || 0 + } + } catch (error) { + console.error('加载总帖子数失败:', error) + } +} + onMounted(() => { console.log('论坛页面加载完成') loadCategories() loadPosts() + // 初始化时加载总帖子数 + loadTotalPostsCount() }) diff --git a/unilife-frontend/src/views/forum/PostDetailView.vue b/unilife-frontend/src/views/forum/PostDetailView.vue index ff28448..6e4b121 100644 --- a/unilife-frontend/src/views/forum/PostDetailView.vue +++ b/unilife-frontend/src/views/forum/PostDetailView.vue @@ -17,6 +17,7 @@ 资源 课程表 日程管理 + AI助手
diff --git a/unilife-frontend/src/views/profile/ProfileView.vue b/unilife-frontend/src/views/profile/ProfileView.vue index 8697fc0..af6dc8a 100644 --- a/unilife-frontend/src/views/profile/ProfileView.vue +++ b/unilife-frontend/src/views/profile/ProfileView.vue @@ -16,6 +16,8 @@ 论坛 资源 课程表 + 日程管理 + AI助手
diff --git a/unilife-frontend/src/views/resources/ResourceDetailView.vue b/unilife-frontend/src/views/resources/ResourceDetailView.vue index 9282bd5..4b6807d 100644 --- a/unilife-frontend/src/views/resources/ResourceDetailView.vue +++ b/unilife-frontend/src/views/resources/ResourceDetailView.vue @@ -16,6 +16,8 @@ 论坛 资源 课程表 + 日程管理 + AI助手
diff --git a/unilife-frontend/src/views/resources/ResourcesView.vue b/unilife-frontend/src/views/resources/ResourcesView.vue index 084bee5..099f536 100644 --- a/unilife-frontend/src/views/resources/ResourcesView.vue +++ b/unilife-frontend/src/views/resources/ResourcesView.vue @@ -17,6 +17,7 @@ 资源 课程表 日程管理 + AI助手
@@ -72,7 +73,7 @@ 全部资源 - {{ totalResources }} + {{ allResourcesCount }}
{{ category.name }} - {{ category.count || 0 }} + {{ category.resourceCount || 0 }}
@@ -370,6 +371,7 @@ const currentPage = ref(1) const pageSize = ref(10) const totalResources = ref(0) const totalPages = ref(0) +const allResourcesCount = ref(0) // 总资源数量，用于"全部资源"显示 // 数据列表 const resources = ref([]) @@ -467,6 +469,11 @@ const loadResources = async () => { totalResources.value = response.data.total totalPages.value = response.data.pages + // 只有在未选择分类时才更新总数（即显示所有资源时） + if (!selectedCategory.value && !searchKeyword.value.trim()) { + allResourcesCount.value = response.data.total || 0 + } + console.log('资源列表加载成功:', { total: totalResources.value, pages: totalPages.value, @@ -498,6 +505,9 @@ const loadCategories = async () => { if (response.code === 200) { categories.value = response.data.list console.log('分类列表加载成功:', categories.value) + + // 加载每个分类的资源数量 + await loadCategoryResourceCounts() } else { console.error('分类列表API返回错误:', response) ElMessage.error(response.message || '获取分类列表失败') @@ -508,6 +518,36 @@ const loadCategories = async () => { } } +// 加载每个分类的资源数量 +const loadCategoryResourceCounts = async () => { + try { + for (const category of categories.value) { + try { + const response = await getResources({ + category: category.id, + page: 1, + size: 1 + }) as any as ApiResponse<{ + total: number + list: any[] + pages: number + }> + + if (response.code === 200) { + // 直接修改分类对象的resourceCount属性 + category.resourceCount = response.data.total || 0 + } + } catch (error) { + console.error(`加载分类${category.name}的资源数量失败:`, error) + category.resourceCount = 0 + } + } + console.log('分类资源数量加载完成:', categories.value.map(c => ({ name: c.name, count: c.resourceCount }))) + } catch (error) { + console.error('加载分类资源数量失败:', error) + } +} + // 下载资源 const downloadResource = async (resource: ExtendedResource) => { try { @@ -703,7 +743,25 @@ onMounted(async () => { console.log('资源页面加载完成') await loadCategories() await loadResources() + await loadTotalResourcesCount() }) + +// 加载总资源数量 +const loadTotalResourcesCount = async () => { + try { + const response = await getResources({ page: 1, size: 1 }) as any as ApiResponse<{ + total: number + list: any[] + pages: number + }> + + if (response.code === 200) { + allResourcesCount.value = response.data.total || 0 + } + } catch (error) { + console.error('加载总资源数失败:', error) + } +}