v4.0.0

[4.0.0] - 2025-12-18

💥 重大变更

• feat: 对话系统全面重构 🚀

  • LLM 提供商架构升级，引入统一的 ChatModelProvider 接口
  • 新增多个 LLM 提供商支持：星辰、星火、Coze、Dify、Ollama、OpenAI、智谱
  • 重构 ChatModelFactory 和 EmbeddingModelFactory，采用工厂模式统一管理
  • 对话记忆系统全面升级（ChatMemory、Conversation 重构）
  • 新增意图检测功能 (IntentDetector)
  • 优化 Tool Calling 机制和元数据管理
  • 新增星辰大模型流式对话支持 (XingChenChatModel + XingChenClient)
  • 新增星火大模型支持 (XingHuoChatModel)
  • Dify Workflow 集成 (WorkflowRequest)

• feat: API 接口全面标准化 📋

  • 集成 Swagger/OpenAPI 文档，提供完整的 API 接口文档
  • 新增统一的请求参数类 (Param)：
    • Agent 相关：AgentAddParam, AgentUpdateParam, AgentDeleteParam
    • Config 相关：ConfigAddParam, ConfigUpdateParam, ConfigGetModelsParam
    • Device 相关：DeviceAddParam, DeviceUpdateParam, DeviceBatchUpdateParam, DeviceDeleteParam
    • User 相关：LoginParam, RegisterParam, ResetPasswordParam, TelLoginParam, SendCaptchaParam, UserUpdateParam
    • Role 相关：RoleAddParam, RoleUpdateParam
    • Template 相关：TemplateAddParam, TemplateUpdateParam
    • 其他：TestVoiceParam
  • 新增统一的响应数据类 (DTO)：
    • AgentDTO, ConfigDTO, DeviceDTO, MessageDTO, RoleDTO, TemplateDTO, UserDTO
    • LoginResponseDTO, PermissionDTO
  • 引入 DtoConverter 统一处理实体与 DTO 转换
  • 所有 Controller 层全面重构，采用 Param/DTO 模式

• feat: 缓存架构升级 ⚡

  • 新增 Redis 缓存配置 (RedisCacheConfig)
  • 新增布隆过滤器管理器 (BloomFilterManager)
  • 新增缓存辅助工具类 (CacheHelper)
  • 引入 Redisson 分布式锁支持 (redisson-config.yml)

新增功能

对话服务增强

• feat: 新增文件播放器服务 (FilePlayer, ThreadPlayer)
• feat: 新增语音合成服务 (FileSynthesizer, ThreadSynthesizer, Synthesizer 接口)
• feat: 新增句子处理抽象 (Sentence)
• feat: 新增唤醒服务 (WakeUp)
• feat: 新增对话辅助工具 (DialogueHelper)
• feat: 新增超时和再见消息供应器 (TimeoutMessageSupplier, GoodbyeMessageSupplier)
• feat: 新增退出关键词检测器 (ExitKeywordDetector)

TTS/STT 服务扩展

• feat: 新增阿里云 NLS TTS 服务 (AliyunNlsTtsService)
• feat: 新增阿里云 NLS STT 服务 (AliyunNlsSttService)

Tool Calling 增强

• feat: 新增 Quote0Function 工具函数
• feat: 新增 ChatModelObservationHandler 监控处理器
• feat: 新增 XiaozhiToolMetadata 工具元数据管理
• feat: Tool Calling 结果转换器优化 (ToolCallStringResultConverter)

认证与授权

• feat: SaToken 配置升级，增强权限控制
• feat: 新增 @SaIgnore 注解支持（如 OTA 请求权限豁免）

优化与改进

架构优化

• refactor: 配置文件从 properties 迁移到 yml 格式
  • application.properties → application.yml
  • application-dev.properties → application-dev.yml
  • application-prod.properties → application-prod.yml
• refactor: 所有 Mapper XML 文件优化
• refactor: Service 层全面重构，统一业务逻辑
• refactor: 实体类优化 (Base, SysConfig, SysDevice, SysMessage, SysRole, SysUser)

对话流程优化

• update: VAD 服务优化 (VadService)
• update: 绘本服务优化 (HuiBenService)
• update: 音乐服务优化 (MusicService)
• update: 消息处理器优化 (MessageHandler)
• update: 会话管理器优化 (SessionManager)
• update: WebSocket 处理优化 (WebSocketHandler, WebSocketSession)

前端优化

• update: 配置管理组件优化 (ConfigManager.vue)
• update: 新增拖拽上传覆盖层组件 (DragUploadOverlay.vue)
• update: 新增音频播放器 Composable (useAudioPlayer.ts)
• update: 新增拖拽上传 Composable (useDragUpload.ts)
• update: 新增记忆视图 Composable (useMemoryView.ts)
• update: 新增记忆管理视图 (MemoryManagementView.vue)
• update: 新增 Web Audio 录音处理器 (audio-recorder-processor.js)
• update: 新增格式化工具类 (format.ts)
• update: Provider 配置优化 (providerConfig.ts)
• update: LLM 工厂配置更新 (llm_factories.json)
• update: 国际化资源更新 (zh-CN.ts, en-US.ts)

工具类优化

• update: 音频工具类优化 (AudioUtils, AudioEnhancer, OpusProcessor)
• update: 通用工具类优化 (CommonUtils, DateUtils, CmsUtils)
• update: Emoji 工具类优化 (EmojiUtils)
• update: 文件上传工具优化 (FileUploadUtils)
• update: 邮件工具优化 (EmailUtils)

数据库

• update: 数据库初始化脚本更新 (init.sql)
• add: 新增 2025-12-17 数据库变更脚本 (db/2025_12_17.sql)
• delete: 删除旧的数据库变更脚本 (db/2025_11_01.sql, db/2025_11_29.sql)

删除

• delete: 删除 AudioService（功能整合到新的播放器和合成器架构）
• delete: 删除 StreamResponseListener 接口（统一到新的流式响应机制）

依赖更新

• update: 依赖包更新 (pom.xml)
• update: 前端依赖更新 (package.json, bun.lock)
• update: 生产环境配置更新 (web/.env.production)

v3.0.0

[3.0.0] - 2025-11-01

💥 重大变更

• feat: 前端架构全面升级到 Vue3 🎉

  • 完整迁移到 Vue 3.5.22 + Composition API
  • 使用 Vite 7 作为构建工具，提升开发体验和构建速度
  • 采用 TypeScript 5.9 增强类型安全
  • 状态管理升级到 Pinia 3
  • 路由升级到 Vue Router 4
  • 采用 Composables 模式重构代码，提高可复用性

• feat: 后端架构全面升级与重构 🚀

  • 引入 JWT 认证机制，增强安全性
  • 新增统一结果封装 (ResultMessage/ResultStatus)
  • 新增事件驱动架构 (ChatSessionOpenEvent、ChatAbortEvent 等)
  • 新增完整的权限管理系统 (RBAC)
  • Controller 层全面重构，代码结构更清晰

新增功能

前端

• feat: 升级 Node.js 运行时到 v22
• feat: 引入现代化开发工具链
  • 使用 oxlint 和 ESLint 9 进行代码检查
  • 集成 Vue DevTools 8 用于调试
  • 采用 Prettier 3.6 统一代码风格
• feat: UI 组件库升级到 Ant Design Vue 4.2.6
• feat: 新增 @vueuse/core 工具库，提供丰富的组合式 API
• feat: 新增全局加载组件和错误边界
• feat: 新增浮动聊天组件，优化交互体验

后端核心功能

• feat: 新增 JWT 认证系统 (JwtUtil)
  • 支持 Token 生成和刷新
  • 支持微信登录 Token
  • 支持自定义 claims
• feat: 新增微信登录服务 (WxLoginService)
• feat: 新增权限管理系统
  • 角色权限映射 (SysAuthRole, SysPermission, SysRolePermission)
  • 完整的 RBAC 权限控制
• feat: 新增验证码工具 (CaptchaUtils)
• feat: 新增邮件工具 (EmailUtils)
• feat: 新增短信服务 (SmsUtils)
• feat: 新增文件哈希工具 (FileHashUtil)
• feat: 新增音频增强工具 (AudioEnhancer)

AI & LLM

• feat: 新增 OpenAI LLM 服务 (OpenAiLlmService)
  • 支持流式响应
  • 支持深度思考模式
  • 支持 Function Calling
  • 新增 Token 回调机制
• feat: 新增 MCP (Model Context Protocol) 支持
  • MCP Session 管理
  • MCP 设备服务集成
• feat: 增强对话服务 (DialogueService)
  • 优化会话管理
  • 改进消息处理流程
  • 支持事件驱动
• feat: VAD 服务重大重构
  • 优化语音活动检测
  • 改进 Silero VAD 模型
  • 新增高级参数配置

依赖更新

• update: 阿里云 SDK 全面升级
  • nls-sdk-transcriber: 2.2.1 → 2.2.18
  • nls-sdk-tts: 2.2.17 → 2.2.18
  • dashscope-sdk-java: 2.20.2 → 2.20.6
  • 新增阿里云短信服务 SDK 2.0.24
• update: Spring Boot 依赖更新
  • 新增 spring-boot-starter-data-redis (缓存增强)
  • spring-ai-starter-mcp-client 集成
• update: commons-io: 2.11.0 → 2.18.0
• update: okhttp: 5.0.0-alpha.14 → 4.9.3 (提升稳定性)
• update: 新增 okio 3.13.0

优化与改进

前端优化

• perf: Vite 开发服务器性能大幅提升
• perf: 生产构建体积优化和加载速度提升
• perf: 优化路由守卫和权限检查
• update: Docker 镜像更新到 node:22-alpine
• update: 依赖包全面更新到最新稳定版本
• update: 优化开发环境配置和热更新机制
• dx: 更好的 TypeScript 类型推导和提示
• dx: 更快的热模块替换 (HMR)

后端优化

• refactor: 全局异常处理增强 (GlobalExceptionHandler)
  • 新增资源未找到异常 (ResourceNotFoundException)
  • 新增未授权异常 (UnauthorizedException)
  • 统一异常响应格式
• refactor: 认证拦截器重构 (AuthenticationInterceptor)
  • 支持 JWT 认证
  • 优化权限验证逻辑
• refactor: 会话管理重构 (SessionManager)
  • 改进会话生命周期管理
  • 优化并发处理
• refactor: 消息处理器重构 (MessageHandler)
  • 优化消息流转
  • 改进错误处理
• refactor: WebSocket 处理器优化 (WebSocketHandler)
  • 增强连接管理
  • 改进异常处理
• refactor: 对话记忆系统优化
  • DatabaseChatMemory 重构
  • MessageWindowConversation 改进
  • Conversation 接口优化
• refactor: LLM 工具调用优化
  • ToolsGlobalRegistry 改进
  • XiaoZhiToolCallingManager 重构
  • 新增 NewChatFunction
• refactor: STT 服务优化
  • 所有 STT 提供商代码优化
  • 改进错误处理和日志
• refactor: 实体类优化
  • SysConfig, SysDevice, SysMessage, SysUser 改进
• refactor: Mapper XML 优化
  • 所有 Mapper 文件重构
  • SQL 优化
• refactor: Service 层全面重构
  • 新增事务配置 (TransactionConfig)
  • 优化业务逻辑
  • 改进数据访问层

Docker 更新

• update: docker-compose.yml 配置优化
  • 改进服务依赖关系
  • 优化健康检查
  • 增强网络配置
• update: Dockerfile-node 升级到 Node 22

---

Full Changelog: v3.0.0...v3.0.0