#Release 2.2.21

#发布日期

2026年7月16日

#发布信息

• 更新范围：从最新版本文档对应提交 9a49061c4fdc6137bdeaf42a2c6deb67dfcae0c3 之后，到当前提交 dd14e610cd505fae0803d4f2a7ab3f3051b6a18b
• 版本号依据：packages/plugins/@yiwendata/yiask/package.json 当前工作区版本 2.2.21

#更新内容

#新功能

• 新增建模质检块，支持在建模流程中直接查看数据质量检查结果，并补充多语言文案与 Nora 提示词规则。
• 新增 Chatbox 并发会话流能力，优化多会话同时生成时的状态隔离、流式更新与会话列表展示。
• 新增 DeepAgent 检查点序列化与维护逻辑，提升长任务恢复、检查点查询和异常续跑的稳定性。
• 新增定时任务 sessionId 支持，并补充调度工具的使用规则，便于任务执行链路关联会话上下文。
• 新增生成文件预览下载增强能力，CSV、HTML、图片等预览场景支持更完整的下载入口和文件类型处理。

#优化与重构

• 优化 Nora、askAlisa 与归因工具提示词规则，补充实体列表查询、工具调用和分析输出约束，提升问答与分析链路的一致性。
• 优化 AI 员工列表权限处理，按被代理用户解析角色与权限，减少跨角色查看时的数据偏差。
• 优化移动端表单选择、生成文件预览页面标题溢出、交互式 HTML 预览编辑态消息处理等前端细节。
• 优化 KPI 趋势方向判断，补充更明确的方向类型与比较逻辑，减少正负向指标展示误判。

#缺陷修复

• 修复 DeepAgent 流式中断重试、内置 task 工具误用和检查点查询异常导致的长任务执行不稳定问题。
• 修复定时任务 prompt 未从顶层字段持久化和回填的问题，并补充历史 agenda job prompt 回填迁移。
• 修复 AI 员工列表中代理用户、市场创建者角色过滤和角色查找不准确的问题。
• 修复钻取分析嵌套来源筛选条件转换错误，提升复杂钻取筛选的准确性。
• 修复调试载荷缺少 schema、思考中消息展开箭头不可见、Markdown/CSV 预览误显示导出入口等展示问题。
• 修复用户资料字段过滤类型安全、移动端懒加载选择器上下文、生成文件预览样式和标题展示等问题。

#迁移文件

如需同步本版本元数据调整，请下载迁移文件：migration-1784166119051.filtered.nbdata

#升级流程

1. 上传迁移文件 migration-1784166119051.filtered.nbdata，等待迁移执行完成。
2. 更新部署版本到 2.2.21。

#出现错误时

1. 【出现 invalid SQL 报错时】进入应用 container，重新执行 yarn nocobase upgrade。
2. 可尝试重启 container
3. 若接收者权限调度、复杂筛选条件互转、LogicForm 条件展示或可视化友好错误提示未生效，重启应用后重新检查页面缓存、迁移执行结果与运行环境配置。