v2.1.0 — 用户工单系统全链路 + 业务数据真库化 + 附件多格式解析 + Nacos 网关

概览

v2.0.0 之后累计合入 18 个 PR（#18 ~ #35），围绕四条主线：用户工单系统全链路、业务数据真库化（去 Mock）、后台管理系统能力密集增强、附件多格式解析与微服务化（Nacos + 网关）。全仓测试 951 个，全部通过（starter 549 + app-server 77 + customer-channel 8 + admin-server 317）。

⚠️ 升级须知

• 三个 Maven 模块改名（groupId/依赖坐标同步变化）：customer-work-spring-boot-starter → customer-work-starter、customer-work-app → customer-work-app-server、customer-web → customer-channel；customer-work-downstream-app 模块已移除
• 新增模块：customer-work-gateway（Spring Cloud Gateway 统一路由入口）、customer-work-app（用户端 H5，Vue3+Vant4，非 Maven 模块）
• 数据库迁移：customer_admin 库新增 Flyway V14 ~ V26；agent_scope_customer_work 库建表种子同步更新（工单/用户/聊天记录/附件等域），见 mysql/ 目录
• 新增可选外部依赖（不可达自动降级/跳过）：MinIO（附件原文件存储）、PaddleOCR serving（自建 OCR 引擎）、Nacos（服务注册与运行时配置）、XXL-JOB（分布式调度）

新增：用户工单系统全链路（PR #24 ~ #26）

• 工单 7 态状态机 + 用户认证 + REST/WebSocket 双向实时通道，机器人-人工分发闭环
• 新用户端 H5 customer-work-app（Vue3+Vite+Vant4）：聊天、订单、工单、消息反馈、头像上传
• 坐席侧：坐席工作台页面、坐席接入凭证、坐席订单管理全链路、用户工单后台模块
• 会话生命周期：空闲超时/强制结束、"重新开始对话"重开回 AI 自助而非直达人工排队

业务数据真库化（PR #24）

• 业务持久层全面 MyBatis-Plus 化，废除裸 JDBC 手写 SQL
• 售后/会员/投诉/知识库四域业务后端全部 Jdbc 化，业务数据不再走 Mock
• 工单/用户/聊天记录三域 Store SPI（接口 + InMemory 默认 + MyBatis-Plus 实现）

后台管理系统增强（PR #18 ~ #23、#31）

• 智能体高级能力：子 Agent 协作（含动态子 Agent、执行过程透传前端嵌套展示）、计划模式、任务列表、技能学习；模型主备容错
• Plan Mode 人工确认闭环（HITL） + 会话一键回滚 + AI Code Review + 沙箱验证修复闭环 + Docker 沙箱产物同步
• 多角色协作编程 + 代码知识库问答（P3 降级版）
• 模型厂商扩展至 DashScope / Anthropic / Gemini 原生接入
• SQL 配置管理与报表菜单动态挂载、系统工具（HTTP 请求工具）与智能体多选挂载
• Skill 多存储目标上传（本地/Nacos/SFTP）、定时任务内置 cron 动态调度器 + XXL-JOB 接入
• admin → 8080 运行时配置 Nacos 打通

admin-web 前端改版（PR #27、#29）

• Element Plus 按需引入、useCrudPage composable 统一 8 个管理页
• 全站视觉 token 收敛 + 暗色模式；修复点击菜单闪白重载、登录卡片暗色态

新增：附件多格式解析（PR #30）

• 对话与 VibeCoding/用户端附件解析：视觉 OCR / PDF / Office / Markdown
• OCR 支持自建 PaddleOCR 开源引擎（配置切换，免 Key 私有化），默认引擎切至 paddleocr
• 附件原文件存储支持 MinIO；文本类型白名单扩展约 50 种（sql/yaml/log/主流源码）+ 可配置追加

新增：微服务化与智能路由中控中心（PR #32、#33）

• Nacos 服务注册 + Spring Cloud Gateway 统一路由（新模块 customer-work-gateway，BOM 隔离）
• 敏感词一次拦截中间件、会话总结建议、工单智能分配

安全加固

• sessionId 路径穿越防御、系统工具 SSRF 收口、入站附件类型白名单
• MCP HTTP/SSE 连接透传 config headers（修复鉴权服务 401）

文档

• README 精简为项目概览 + 全景架构图 + Roadmap，全量细节平移至 docs/ 目录（PR #36）

修复

• HandoffService 单参构造补 @Autowired，修复 store-mode=jdbc 空转（PR #34）
• chatStream 过滤整段回放事件，消除流式回复重复 2-3 遍
• 修复 2.0 GA 下新会话业务工具组整体丢失（模型侧无订单查询工具）
• DefaultActiveGroupsToolkit 覆盖 copy() 返回自身，修复守卫被防御性拷贝丢弃
• 系统提示词注入当前日期与单号不猜测约束
• 导出 xlsx POI classpath 版本分裂修复（easyexcel 4.0.3 + POI 5.5.1）
• AgentAccessCredentialTest 篡改签名偶发失败修复（PR #35）

Full Changelog: v2.0.0...v2.1.0