AI配置增加字段适配处理

2025-12-23 16:51:53 +08:00
parent 2d033e6a3e
commit 7f89fd17d3
22 changed files with 2951 additions and 4 deletions
@@ -0,0 +1,107 @@
+# Implementation Plan: Coze AI Integration
+
+## Overview
+
+本实现计划将重构AiChatServiceImpl，添加通用的Coze工作流调用方法，并优化EpicScriptServiceImpl#createScript接口以调用Coze AI生成剧本内容。实现采用增量方式，每个任务都建立在前一个任务的基础上。
+
+## Tasks
+
+- [x] 1. 扩展AiConfigService接口和实现
+  - [x] 1.1 在AiConfigService接口中添加getByConfigKey方法
+    - 添加方法签名：`AiConfig getByConfigKey(String configKey)`
+    - 添加方法级注释说明功能和参数
+    - _Requirements: 5.1_
+  - [x] 1.2 在AiConfigServiceImpl中实现getByConfigKey方法
+    - 使用LambdaQueryWrapper查询config_key匹配且is_enabled=1的配置
+    - 返回查询结果，不存在则返回null
+    - _Requirements: 1.2, 5.1, 5.2_
+
+- [x] 2. 扩展AiChatService接口
+  - [x] 2.1 在AiChatService接口中添加callWorkflowByConfigKey方法
+    - 添加方法签名：`String callWorkflowByConfigKey(String configKey, String input, String userId)`
+    - 添加重载方法：`String callWorkflowByConfigKey(String configKey, Map<String, Object> parameters, String userId)`
+    - 添加方法级注释说明功能、参数和返回值
+    - _Requirements: 1.1, 1.4_
+
+- [x] 3. 实现通用工作流调用方法
+  - [x] 3.1 在AiChatServiceImpl中实现callWorkflowByConfigKey方法
+    - 调用aiConfigService.getByConfigKey获取配置
+    - 验证配置存在且启用，否则抛出异常
+    - 构建工作流请求（workflow_id, user_id, stream=true, parameters.input）
+    - 设置请求头（Authorization, Content-Type）
+    - _Requirements: 1.2, 1.3, 1.6, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6_
+  - [x] 3.2 实现流式响应处理方法
+    - 解析SSE格式响应（event:和data:行）
+    - 提取event为Message且node_type为End的content
+    - 从content的JSON中提取output字段
+    - 处理Done事件完成流处理
+    - _Requirements: 3.1, 3.2, 3.3, 3.4_
+  - [x] 3.3 实现错误处理逻辑
+    - 处理配置不存在/禁用的情况
+    - 处理API调用失败（非200状态码）
+    - 处理流式解析失败
+    - 确保错误消息不包含敏感信息
+    - _Requirements: 1.6, 3.5, 6.1, 6.2, 6.4, 6.5_
+  - [x] 3.4 编写Property 1属性测试：请求格式正确性
+    - **Property 1: Request Format Correctness**
+    - **Validates: Requirements 2.1, 2.2, 2.3, 2.4, 2.5, 2.6**
+  - [x] 3.5 编写Property 2属性测试：流式响应解析
+    - **Property 2: Stream Response Parsing**
+    - **Validates: Requirements 3.1, 3.2, 3.3**
+
+- [x] 4. Checkpoint - 验证通用AI调用服务
+  - 确保所有测试通过，如有问题请询问用户
+
+- [x] 5. 实现爽文剧本AI生成
+  - [x] 5.1 在EpicScriptServiceImpl中添加输入组装方法
+    - 创建assembleScriptInput方法
+    - 将EpicScriptCreateRequest的字段组装为格式化字符串
+    - 包含title, theme, style, length, plotIntro, plotTurning, plotClimax, plotEnding
+    - _Requirements: 4.2_
+  - [x] 5.2 修改createScript方法调用AI生成
+    - 调用assembleScriptInput组装输入
+    - 调用aiChatService.callWorkflowByConfigKey("coze.course.life.generate", input, userId)
+    - 解析AI返回的内容并存储到EpicScript实体
+    - 处理AI调用失败的情况
+    - _Requirements: 4.1, 4.3, 4.4, 4.5_
+  - [x] 5.3 编写Property 3属性测试：输入组装完整性
+    - **Property 3: Input Assembly Completeness**
+    - **Validates: Requirements 4.2**
+
+- [x] 6. 实现配置参数合并
+  - [x] 6.1 实现custom_params合并逻辑
+    - 解析AiConfig.customParams JSON字符串
+    - 将custom_params与运行时参数合并
+    - 运行时参数优先级高于custom_params
+    - _Requirements: 5.3_
+  - [x] 6.2 实现超时和重试配置
+    - 应用AiConfig.timeoutMs设置
+    - 实现基于retry_count和retry_delay_ms的重试逻辑
+    - _Requirements: 5.4, 5.5, 6.3_
+  - [x] 6.3 编写Property 4属性测试：配置应用正确性
+    - **Property 4: Configuration Application**
+    - **Validates: Requirements 1.3, 5.2, 5.3**
+
+- [x] 7. 完善错误处理和日志
+  - [x] 7.1 完善错误消息格式
+    - 确保错误消息包含config_key和状态码
+    - 确保不暴露API token等敏感信息
+    - 添加详细的日志记录
+    - _Requirements: 6.1, 6.2, 6.4, 6.5_
+  - [x] 7.2 编写Property 5属性测试：错误消息质量
+    - **Property 5: Error Message Quality**
+    - **Validates: Requirements 6.4, 6.5**
+
+- [x] 8. Final Checkpoint - 确保所有测试通过
+  - 运行所有单元测试和属性测试
+  - 确保所有测试通过，如有问题请询问用户
+
+## Notes
+
+- All tasks are required for comprehensive implementation
+- Each task references specific requirements for traceability
+- Checkpoints ensure incremental validation
+- Property tests validate universal correctness properties
+- Unit tests validate specific examples and edge cases
+- 实现语言：Java (Spring Boot)
+- 测试框架：JUnit 5