#Release 2.2.3

#发布日期

2026年5月15日

#发布信息

• 更新范围：从 2.2.2 版本文档对应提交 83ffd2de669de631f038700680fe8d4077a88d22 之后，到当前提交 106cecfb67bbd4cf033c06a0c38c0a7f93d61985
• 版本更新提交：106cecfb67bbd4cf033c06a0c38c0a7f93d61985

#更新内容

#新功能

• 新增生成文件纯净模式持久化能力。共享文件设置与预览页现在会保留 pure mode，并通过迁移同步 yiask_report 相关元数据，保证跨会话查看时的展示状态一致。
• 新增生成文件导出下拉能力。预览页和聊天中的文件预览现在支持 PDF、图片和 HTML 下载，提升生成结果的可导出性。
• 新增飞书富文本消息图表类型按请求渲染能力，支持按请求生成指定图表类型以及饼图。
• 新增用户记忆管理增强能力，优化记忆提取、注入与持久化链路，提升连续对话场景下的上下文稳定性。
• 新增角色指标权限缺失跳过处理能力，避免单个缺失指标阻断同一角色下的其他权限同步。

#优化与重构

• 优化生成文件预览标题与默认模式处理，减少页面标题异常和预览状态错乱。
• 优化 SQL 预览与错误展示链路，允许在无预览情况下保存 SQL 视图，并将错误详情收起到可切换区域。
• 优化逻辑表单选择器交互，补充对比弹窗与复制动作，提升配置比对效率。
• 优化 AI 员工角色列表中的技能合并逻辑，避免空值场景下的合并异常。
• 优化 DeepAgent 沙箱缓存时长，延长到 3 天以减少短期重复初始化。

#缺陷修复

• 修复树形表格结构处理中的行键问题，避免层级表格展开、懒加载和筛选时出现标识不稳定。
• 修复生成文件预览页的文档标题设置问题，避免打开页面时标题缺失。

#迁移文件

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

使用指南见：版本更新指南

#升级流程

1. 上传迁移文件 migration-1778767284974.nbdata，等待迁移执行完成。
2. 更新部署版本到 2.2.3。
3. 进入应用 container，执行 yarn nocobase upgrade。
4. 必要时重启 container，并确认服务恢复正常。

#出现错误时

1. 【出现 invalid SQL 报错时】进入应用 container，重新执行 yarn nocobase upgrade。
2. 若生成文件预览、权限同步或迁移元数据未生效，重启应用后重新检查对应配置。