#Release 2.2.5

#发布日期

2026年5月21日

#发布信息

• 更新范围：从 2.2.4 版本文档对应提交 ba62df0e84e7f5849277d3457874a9076bf60f54 之后，到当前提交 0469de8cb5ce0b64e018ac0f18c21e23e829b427
• 版本号依据：packages/plugins/@yiwendata/yiask/package.json 当前工作区版本 2.2.5

#更新内容

#新功能

• 新增页面水印插件与启停配置能力。后台页面现在支持全局半透明平铺水印，可配置水印文字、透明度和字号，并支持按需启用或关闭，降低截图泄露风险。
• 新增按空间维度持久化会话能力。聊天框现在支持通过 URL space 参数进入指定空间，并在会话请求中透传空间信息，便于多空间场景下保持独立上下文。
• 新增按 URL 预选 AI 员工能力。聊天页支持通过查询参数直接打开指定 agent，方便从外部入口或嵌入场景快速进入目标助手。
• 新增分析弹窗统一壳层与执行状态处理能力。归因分析、下钻分析与相关可视化链路现在补充统一的分析弹窗结构、执行中状态和移动端图表切换适配，减少复杂分析场景下的跳转成本。
• 新增筛选条件大小写敏感开关与图表标题未知词标记能力，便于处理精确匹配类筛选需求，并帮助识别标题解析中未命中的词项。

#优化与重构

• 优化归因分析与逻辑表单可视化体验。AnalysisModalShell、LogicformVisualizer、BarView 和相关标签展示链路完成统一重构，分析结果的逻辑结构、尾项汇总、贡献值说明和交互布局更清晰。
• 优化生成文件预览与移动端布局。预览页工具栏、侧边栏和图表类型切换器在窄屏下的响应式表现更稳定，减少移动端遮挡、折行和操作拥挤问题。
• 优化虚拟字段与属性元数据透传能力。YiaskPropertyRecord 现在支持 is_virtual 标记，字段转换与权限相关链路可更准确识别虚拟属性。
• 优化 Docker 构建与插件打包链路，补齐水印插件构建接入与相关运行依赖，减少部署环境中的插件缺失或构建不一致问题。
• 优化 askAlisa 排查入口与若干展示细节，便于在问答异常场景下更快定位问题来源。

#缺陷修复

• 修复简单查询和 identity 查询被自动补充默认时间范围的问题，避免无时间意图的逻辑表单被错误追加时间条件。
• 修复建模导入流程中 parent_property 引用映射缺失的问题，减少导入后父子字段关联丢失的情况。
• 修复角色全量查看权限展开不完整的问题，角色权限同步现在会补齐 full view 权限，避免部分可见范围遗漏。
• 修复 schema 映射编辑关闭后父视图未刷新的问题，减少配置保存后列表状态滞后。
• 修复嵌套逻辑表单实体比较与名称字段解析问题，提升复杂逻辑选择、归因分析和字段名称推断场景下的稳定性。
• 修复 YiAsk 查询逻辑中的兼容性问题，并同步升级 semanticdb-core 依赖版本，减少推荐数据与相关分析链路中的异常情况。

#迁移文件

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

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

#升级流程

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

#出现错误时

1. 【出现 invalid SQL 报错时】进入应用 container，重新执行 yarn nocobase upgrade。
2. 若水印、空间会话或分析视图未生效，重启应用后重新检查对应插件设置与页面缓存状态。