#Release 2.3.2

#发布日期

2026年7月21日

#发布信息

• 更新范围：从 2.3.0 版本文档对应提交 00c79cc651681d6dad230019f9aa4f4434b3f62d 之后，到当前提交 02d4e0591d8ddba5c485afd1e2ae6ac97aa1b262
• 版本号依据：packages/plugins/@yiwendata/yiask/package.json 当前工作区版本 2.3.2

#更新内容

#新功能

• 新增 KPI 与数据可视化的解释入口，支持在图表、指标卡和 Sheet 场景中查看指标口径、筛选、排序和分组来源。
• 新增指标调整能力，支持在解释抽屉中编辑指标标题、预定义指标描述、SQL 指标、嵌套 LogicForm 层级和指标筛选条件。
• 新增指标相关业务知识写入能力，将指标提示词纳入业务知识，提升指标问答与解释的一致性。
• 新增 Chat 消息 Token 用量与思考耗时展示，便于排查问答成本和执行耗时。
• 新增日历查询 $in 数组日期条件支持，增强日期类筛选表达能力。

#优化与重构

• 优化 ExplainShield 的交互与布局，支持移动端响应式展示、悬停/点击打开、可排序字段列表、分组级联选择和数据范围文案调整。
• 优化 KPI 可视化与指标抽屉布局，支持右轴标题、指标来源展示、预定义指标提示和指标明细优先展开。
• 优化 LogicForm 选择器展示和提交体验，增加去重逻辑、表格高度适配、底部固定确认按钮和复杂筛选只读展示。
• 优化 Chat 复制逻辑、空状态提示、组织提示词和执行日志关联，提升非 HTTPS 环境与排查场景的可用性。
• 更新 semanticdb-core 到 1.1.54，并同步初始 nbdata 数据。

#缺陷修复

• 修复权限明细按指标 schema 过滤、跨引用链 schema 权限投影和重复关键词检测空间透传问题。
• 修复指标解释中别名兜底、重复操作符后缀、空筛选条件、非活跃指标、预定义指标选择器和排序限制展示问题。
• 修复 Sheet 指标调整抽屉卸载、解释浮层首次引导与操作门禁相关问题。
• 修复 askAlisa 执行日志 ID 保留、嵌套实体预览选择和 LogicForm 结果 schema 排序筛选处理问题。
• 修复未登录状态下许可证告警展示问题。
• 修复 DeepAgent 超大文件写入保护与相关回退后的文件写入行为。

#迁移文件

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

#升级流程

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

#出现错误时

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