#Release 2.2.20

#发布日期

2026年7月12日

#发布信息

• 更新范围：从 2.2.18 版本文档对应提交 28ef92b92f485be7811bd67db8500b946328b9fa 之后，到当前提交 f6db211e0706bad82148886e55a8ca96c8a1c2dc
• 版本号依据：packages/plugins/@yiwendata/yiask/package.json 当前工作区版本 2.2.20

#更新内容

#新功能

• 新增 LogicForm 权限查询自动投影到关联 schema 字段的能力，并支持多 schema 投影，减少复杂关联查询下权限条件手工补齐的成本。
• 新增角色与 AI 员工同步、隐藏分享链接区配置、作用域 schema 导出以及大模型思考内容处理与重试状态能力，补强权限联动、部署控制和推理态反馈链路。
• 新增水印文本自动换行与字号自适应、代码字段 JSON 格式化按钮，以及实体选择器表格模式，提升管理配置与数据查看体验。

#优化与重构

• 优化用户级权限、角色权限与关联表权限的合并投影逻辑，补充同字段排除规则、顶层 $or 合并与嵌套行权限保留，进一步收敛复杂权限场景下的查询生成行为。
• 优化仪表板分享与删除权限、移动端页头和标签吸顶表现、用户中心下拉关闭以及若干管理端交互细节，减少桌面端与移动端界面行为不一致的问题。
• 优化 Redis 锁实现、会计期间增强脚本、建模批量导出与 schema 刷新流程，提升任务调度、时间语义处理和建模导出链路的稳定性。

#缺陷修复

• 修复企业微信通知 markdown 链接、定时任务关联用户 UUID 类型、角色同步时主数据源策略保留等问题，减少通知调度与角色同步异常。
• 修复 LogicForm 实体候选预览、单候选自动跳过、未知项优先澄清、自定义节点保存校验以及调试信息保留等问题，提升复杂查询对话的稳定性。
• 修复用户权限汇总、关联表权限徽标、dashboard 分享/删除控制、iframe 场景入口显示及 schema 建模若干边界问题，降低权限展示与管理端操作偏差。

#迁移文件

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

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

#升级流程

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

#出现错误时

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