#Release 2.3.0

#发布日期

2026年7月17日

#发布信息

• 更新范围：从 2.2.21 版本文档对应提交 dd14e610cd505fae0803d4f2a7ab3f3051b6a18b 之后，到当前提交 00c79cc651681d6dad230019f9aa4f4434b3f62d
• 版本号依据：packages/plugins/@yiwendata/yiask/package.json 当前工作区版本 2.3.0

#更新内容

#新功能

• 新增 YiAsk 许可证管理能力，支持许可证状态校验、授权设置页面、许可证过期提醒和域名限制校验。
• 新增许可证账号数量限制能力，并补充用户权限 Hook，支持按许可证约束控制可用账号数量。
• 新增按用户名释放许可证席位能力，便于管理员在授权管理中处理账号占用。
• 新增 Office 生成文件支持，DeepAgent 生成文件链路可识别并处理更多办公文件类型。

#优化与重构

• 重构许可证校验逻辑，改为内置公钥与多版本公钥支持，移除通过环境变量配置公钥的方式。
• 优化许可证管理页面布局、文案与多语言内容，统一授权设置入口标识为 license-management。
• 简化许可证席位管理实现，移除独立席位集合相关逻辑，降低授权状态维护复杂度。
• 优化 DeepAgent 文件处理与工具使用提示词，明确生成文件处理边界和执行工具使用规范。
• 优化 LogicForm 选择器的表格展示与提交交互，减少不必要滚动并支持重新提交不同选项。

#缺陷修复

• 修复许可证账号统计逻辑，排除超级管理员和锁定用户，避免授权数量统计偏差。
• 修复许可证服务在公钥、宽限期、域名限制、账号释放等场景下的校验与测试覆盖问题。
• 修复 Chat 中重复用户消息、重复 LogicForm 自动选择和已完成 Todo 影响思考边界的问题。
• 修复嵌套实体场景下 LogicForm 选择器表格未正确展示的问题。
• 修复代码编辑器片段容器默认挂载逻辑，减少弹层容器异常导致的展示问题。

#迁移文件

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

#升级流程

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

#出现错误时

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