#Release 2.2.18

#发布日期

2026年7月6日

#发布信息

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

#更新内容

#新功能

• 新增管理端聊天中的 LogicForm 查询直达能力、ask 查询自动发送以及会话恢复后的上下文裁剪，提升复杂查询发起、续聊衔接和长会话使用体验。
• 新增指标归因增强能力，支持指标维度追加归因、指标血缘后续动作，以及在归因链路中按执行列属性识别来源信息，便于继续追踪指标来源与计算过程。
• 新增自定义函数结果类型传递能力，并支持在查询执行、表格可视化和结果处理中复用自定义函数。
• 新增移动端布局与交互适配，覆盖聊天输入区、Agent 切换、图表类型切换、表格/Sheet 工具栏、AI 员工卡片与调试入口等核心界面，提升手机端可用性。
• 新增会计期间增强脚本、数据源客户端连接状态统计接口与监控脚本，便于扩展时间语义处理并排查连接池与驻留客户端状态。

#优化与重构

• 优化用户数据权限可视化与单用户权限写入链路，补充单用户权限更新接口，并进一步整理表权限可见范围与无角色用户下的权限兼容逻辑。
• 优化 schema 刷新与数据源重载流程，补充加载态控制、空 schema 容错和并发重载收敛，减少建模与聊天初始化阶段的状态抖动。
• 优化飞书消息投递链路，补充卡片消息解析发送、飞书用户自动绑定、消息去重与超时控制，提升机器人消息可靠性和账号映射效率。
• 优化建模清理空间时的 schema 引用清理与错误透出，便于在空间清理失败时直接定位原因。

#缺陷修复

• 修复简单查询默认 limit 100、表格分页切换后未刷新、临时公式值缺少 schema 时格式化异常等问题，减少查询结果与可视化展示偏差。
• 修复 Android 端钻取维度弹窗无法点击、搜索框自动聚焦、移动端若干按钮与遮罩交互不稳定等问题，提升触屏场景下的交互稳定性。
• 修复接收者权限明细和投影视图中无角色用户的兼容性问题，并避免嵌套鉴权 token 复用及多余 Authorization 头带来的权限串扰。
• 修复 Excel 导出数字格式处理、知识图谱节点标识展示、定时通知成功日志记录及服务端显式入口导入等稳定性问题。

#迁移文件

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

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

#升级流程

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

#出现错误时

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