#Release 2.2.8

#发布日期

2026年6月1日

#发布信息

• 更新范围：从 2.2.7 版本文档对应提交 be395e43524eea73bb837648fb23a52cb9422e3b 之后，到当前提交 1683534dd41fd51d5ce2d936881ea5df2816d86d
• 版本号依据：packages/plugins/@yiwendata/yiask/package.json 当前工作区版本 2.2.8

#更新内容

#新功能

• 新增 DeepAgent checkpoint 定时清理能力。系统会按计划清理长时间未活跃会话的 checkpoint，减少历史上下文持续堆积带来的存储占用和恢复负担。
• 新增按会话维度的 DeepAgent 流式事件日志存储能力。每个会话线程现在会单独落盘 stream 事件日志，便于排查多轮任务执行过程中的上下文与输出问题。
• 新增 askAlisa 完整调试载荷导出能力。聊天调试面板支持直接下载完整 JSON，便于复现问答链路、共享问题现场和离线排查。
• 新增 schema 示例数据生成增强能力。现在支持 ref 属性层级示例和 pattern 约束，便于生成更贴近模型定义的演示数据。
• 新增 YiAsk schema 写权限校验。批量生成全量 schema 演示数据前会校验 yiask_schema 写权限，避免无权限用户误触发全局写入操作。
• 新增筛选条件到 query 的简化转换能力。convertFilterToQuery 现在会折叠冗余 $and 结构并合并字段条件，便于后续查询构造和分组推荐链路复用。

#优化与重构

• 优化 schema 管理与刷新链路。useSchemas 与聊天页入口的 schema 刷新逻辑完成梳理，减少进入聊天页时 schema 状态滞后或管理状态不一致的问题。
• 优化 DeepAgent 工具调用上下文与提示词细节。工具参数截断逻辑、文件写入说明以及数据计算规则说明完成整理，减少复杂任务中工具输入噪声和模型误用风险。
• 优化归因分析与相关可视化样式。归因弹窗、下钻按钮和图表区块的布局细节更统一，减少复杂分析结果下的阅读拥挤感。

#缺陷修复

• 修复建模导入技能时创建人与更新人丢失的问题，导入后的技能记录现在会回填为当前导入用户，并保留 importer 相关信息。
• 修复外部数据场景下 pred 字段路径映射不正确的问题，减少逻辑表单执行时字段路径解析偏差。
• 修复分组建议误把 query 操作符当成字段的问题，减少 groupby 推荐中出现 $or、$in 等非字段项的情况。
• 修复进入聊天路由后 schema 未及时刷新的问题，减少切换页面后聊天上下文仍使用旧 schema 的情况。
• 修复生成文件预览中内联样式序列化丢失的问题，分享或导出 HTML 预览时可更完整保留原始展示效果。
• 修复聊天区与生成文件预览页若干样式问题，减少空消息态、侧边聊天面板和窄屏场景下的布局异常。
• 修复图表标题中单字符未知词被错误标红的问题，减少标题解析中的误报提示。

#迁移文件

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

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

#升级流程

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

#出现错误时

1. 【出现 invalid SQL 报错时】进入应用 container，重新执行 yarn nocobase upgrade。
2. 若 schema 刷新、DeepAgent 日志或调试导出能力未生效，重启应用后重新检查页面缓存与对应运行环境配置。