Crest v1.5.1

Crest v1.5.1 发布说明

发布日期：2026-06-01

Crest v1.5.1 是 v1.5 系列维护版本，主要处理 v1.5.0 发布后在安装交付、示例资源、权限、导出、数据集选择和审计链路中发现的问题。该版本继续面向全新私有化部署环境，不建议在早期开发版本数据库上直接原地升级。已有环境迁移时，请先备份元数据库和运行目录，并导出业务资源后再导入新环境。

一、安装与交付

本版本将内置示例资源从核心数据库初始化流程中拆出，安装时可通过 CREST_LOAD_DEMO 控制是否加载演示数据。默认安装仍会加载示例资源，便于验收和二次开发；正式生产环境如需纯净初始化，可在安装前设置：

CREST_LOAD_DEMO=false

针对已加载示例资源的环境，本版本提供清理脚本：

bash cleanup-demo-data.sh --yes

清理范围包括内置示例数据源、数据集、图表、大屏资源以及 crest_demo_retail 演示库。Kubernetes 部署文档同步补充了示例资源开关和清理方案，避免生产环境误带演示数据。

本版本发布镜像：

ghcr.io/sevoniva/crest:v1.5.1
ghcr.io/sevoniva/crest:main

镜像支持 linux/amd64 和 linux/arm64。离线包包含应用镜像、MySQL 镜像、安装脚本、配置模板、Docker Compose 文件和离线安装说明。

二、功能修复

• 修复管理员登录后业务菜单权限异常，导致工作台显示无业务菜单权限的问题。
• 修复数据集列表、数据源列表、新建仪表盘和新建数据大屏中数据集无法选择或持续加载的问题。
• 修复内置研发效能大屏部分图表持续刷新、数据未加载或下钻数据异常的问题。
• 修复仪表盘发布时出现 405 请求错误，并同时提示“已被他人更新”和“发布成功”的问题。
• 修复导出中心下载在文件过期、文件缺失、用户信息解析异常等场景下的错误提示和下载失败问题。
• 修复审计日志入口、菜单权限和接口访问校验不稳定的问题，管理员和审计只读角色可正常查看审计记录。
• 修复 v1.5.1 镜像构建中遗漏前端导出通知模块的问题。
• 移除旧版 commons-lang:commons-lang 传递依赖，关闭相关 Dependabot 安全告警。

三、体验优化

• 优化工作台、系统设置、数据源、数据集、数据血缘、导出中心等页面的浅色界面一致性。
• 调整系统设置侧边栏、角色管理、权限管理、审计日志等页面的表格、按钮、边框和间距，减少视觉割裂。
• 优化顶部导航、Logo、用户入口和“数据准备”下拉菜单的交互状态。
• 优化导出中心通知逻辑，多个任务完成时合并提示，避免连续弹出多条成功消息。
• 优化表格数据显示，对 \n、\t、HTML 换行和空白实体做兼容处理，避免在页面中直接显示转义字符。
• 增强表格复制体验，仪表盘、大屏、分享页面和“查看数据”中的表格可按选区复制，复制结果保持表格结构，便于粘贴到 Excel。
• 优化研发效能演示大屏的累计流、阶段漏斗、投入产出矩阵和明细下钻数据表现。

四、文档与接口

• 更新 README、安装文档、Kubernetes 文档、开发文档和数据血缘说明。
• API 文档页按 Crest 产品模块重新整理，覆盖仪表盘与数据大屏、图表、数据集、数据源、数据血缘、导出中心、系统设置、基础能力和权限管理。
• 明确示例资源、核心初始化脚本和清理脚本的边界，降低后续部署和运维成本。

五、验证范围

本版本发布前已完成以下检查：

• 前端构建。
• 后端测试与打包。
• 本地 Docker 环境运行验证。
• 工作台、数据源、数据集、仪表盘、数据大屏、审计日志、权限管理和导出中心关键链路验证。
• 内置演示资源初始化和大屏数据加载验证。
• 依赖安全告警复查。