#Release 2.2.2

#发布日期

2026年5月14日

#发布信息

• 更新范围：从 2.2.1 版本文档对应提交 97a4db8ef81ce52498aa52859604c1f4a911f4ec 之后，到当前提交 83ffd2de663b8f3f4af8e641b9ff83f8372f5b2d
• 版本更新提交：83ffd2de663b8f3f4af8e641b9ff83f8372f5b2d

#更新内容

#新功能

• 新增飞书会话持久化能力。飞书消息服务引入数据库会话存储与历史加载机制，支持更稳定的跨会话上下文恢复。
• 新增 KPI 自定义归因跟踪能力，支持显式记录自定义归因结果，提升归因链路可审计性。
• 新增数据映射 SQL 对齐能力，建模映射链路支持 SQL transform alignment，降低跨环境映射差异。
• 新增树形集合模式支持，补充 tree collection / tree schema 处理能力，并支持按层级结构切换表格展示策略。
• 新增仓库层 resolveCount 结果处理能力，提升复杂查询场景下统计返回的一致性。
• 新增 DeepAgent 系统主题趋势色支持，增强聊天与工作区在不同主题下的视觉一致性。

#优化与重构

• 优化 AI 员工工具链路，将业务知识展示摘要与 LLM 原始 payload 解耦，减少提示词污染并提升可读性。
• 优化角色与指标权限接口文档，补充 metricPermissions 字段约定与行为说明，方便外部系统按接口规范对接。
• 优化仓库层父子关联处理逻辑，补齐创建记录时父字段值保留与层级关联推断能力。
• 优化字段模型与表单模型行为，减少 resolveUse 造成的模型跳转抖动，并补充加载态反馈。
• 优化 DeepAgent 超时配置，延长执行时限至 1 小时，降低长任务被提前中断的概率。

#缺陷修复

• 修复 updateOrCreateWithPermissions 在指标不存在时整批同步失败的问题。现在缺失指标权限会被跳过，不再阻断同一角色下其他行列权限同步。
• 修复建模导入流程中的用户空间规范化问题，避免 users[].spaces 格式不一致导致权限与绑定异常。
• 修复 YiaskRepository 父子筛选与父 ID 处理异常，提升层级筛选、循环展开与复杂过滤场景的稳定性。
• 修复 schema 表单视图中的错误展示行为，保持原始错误信息与 AI 分析结果同时可见，便于快速定位问题。
• 修复逻辑表单列权限校验中的字段名处理问题，减少列权限判断误差。
• 修复技能工作区标题读取与默认选中逻辑异常，避免首次进入时展示状态错乱。
• 修复公共路径跳转异常与生成文件预览下载链路中的细节问题，提升预览与导航稳定性。

#迁移文件

本版本无新增必需迁移文件。

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

#升级流程

1. 更新部署版本到 2.2.2。
2. 进入应用 container，执行 yarn nocobase upgrade。
3. 必要时重启 container，并确认服务恢复正常。

#出现错误时

1. 【出现 invalid SQL 报错时】进入应用 container，重新执行 yarn nocobase upgrade。
2. 若角色权限、用户空间绑定或数据映射未生效，重启应用后重新检查对应配置。