#Release 2.0.6

#发布日期

2026年4月23日

#发布信息

• 更新范围：从 2.0.5 版本文档对应提交 c57e8240247edef4c652ff99352d2479e2bde944 之后，到 @yiwendata/yiask 版本更新提交 f415dffe0690a8723d509fa0ca848e612dc090a9
• 版本提交：f415dffe0690a8723d509fa0ca848e612dc090a9

#更新内容

#新功能

• 角色权限接口新增用户岗位与所属空间同步能力。在 updateOrCreateWithPermissions 中为用户配置角色时，现在可以同时写入 position 和 spaces，服务端会校验空间是否存在，并自动补齐用户与空间的关联，便于批量初始化多空间用户体系。
• Redis 适配器新增哨兵模式支持。现在可通过 REDIS_MODE=sentinel 及相关 REDIS_SENTINEL_* 环境变量为 PubSub、分布式锁和 WorkerId 分配器统一接入 Redis Sentinel，提升 PM2 集群和多节点部署下的高可用能力。

#优化与重构

• 优化 KPI 指标卡的说明展示方式，将简单 Tooltip 改为支持 Markdown 的 Popover，说明内容可承载更长文本、换行和链接，减少指标解释被截断的问题。
• 优化服务端 Bearer Token 获取逻辑，抽出统一工具函数，飞书消息服务、调度服务与用户权限链路改为共用同一套 token 解析方式，降低多入口权限校验不一致的风险。
• 优化建模导入导出能力，指标相关数据包现在会一并包含 yiask_logicform2api_functions，并在导入时按空间与类型去重、复用已有记录，便于跨环境迁移自定义逻辑表单执行函数。

#缺陷修复

• 修复建模数据迁移时遗漏 logicform2api 配置的问题，避免指标能力迁移后自定义 LF 执行函数缺失。
• 修复 Alisa 查询结果向 NocoBase 组件格式转换时，关联字段路径不兼容的问题，补齐点路径格式的数据键，避免部分表格或页面块无法正确读取结果。
• 修复 KPI 描述较长时悬浮提示可读性差的问题，避免说明内容被截断后难以理解。

#迁移文件

如需执行数据库迁移，请下载迁移文件：migration-1776957697531.nbdata

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

#升级流程

1. 上传迁移文件 migration-1776957697531.nbdata，等待迁移执行完成。
2. 更新部署版本到 2.0.6。
3. 如果是 Kubernetes 部署，请同步调整 Volume 挂载方式：/app/nocobase 改为挂载到 emptyDir，/app/nocobase/storage 继续挂载到原有持久化存储。
4. 进入应用 container，执行 yarn nocobase upgrade。
5. 必要时重启 container，并确认服务恢复正常。

K8s 挂载示例见：在 Kubernetes 部署