#Release 2.2.17

#发布日期

2026年7月1日

#发布信息

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

#更新内容

#新功能

• 新增 Feishu 卡片消息解析发送、飞书用户自动绑定以及消息去重与超时配置能力，提升飞书机器人在会话投递、账号关联和消息可靠性方面的可用性。
• 新增数据源客户端连接状态统计接口与配套监控脚本，支持从服务端查看连接状态并补充外部巡检能力，便于定位连接池与客户端在线情况。
• 新增自定义函数在查询与表格可视化链路中的透传与处理能力，便于在 LogicForm、数据展示和相关查询中复用自定义函数能力。
• 新增单用户 YiAsk 权限更新接口。管理员现在可以直接对单个用户写入 permissions 与 metricPermissions，无需通过 role 绑定链路间接调整。

#优化与重构

• 优化用户数据权限可视化与表权限展示方式，用户表权限页对可见性、摘要呈现和交互反馈做了整理，便于核对最终生效的数据表访问范围。
• 优化 schema 刷新、数据源重载与聊天初始化加载链路，减少多次刷新、并发重载和首屏等待时的状态抖动问题。
• 优化水印模板与 ACL 片段命名策略，优先使用用户名信息并统一片段命名，降低权限片段与展示文案不一致的情况。
• 优化子 Agent 调用链路，移除了 callAgent 对子 agent 的固定 5 轮工具循环上限，恢复为各 agent 默认的迭代控制策略。

#缺陷修复

• 修复 Excel 导出中数字格式和数值单元格处理不正确的问题，减少导出结果中数值展示异常和格式丢失。
• 修复 iframe 场景下侧边栏操作区仍然显示的问题，减少嵌入模式下的无效入口和界面干扰。
• 修复 schema 为空、默认参数缺失以及数据源刷新并发时的若干稳定性问题，减少 schema 管理与查询结果组装中的边界报错。
• 修复 Feishu 过期消息拦截逻辑在回滚后带来的行为偏差，并补充消息超时、去重和自动绑定相关异常处理。

#迁移文件

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

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

#升级流程

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

#出现错误时

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