版本 2.2.0（2025-11-20）

更新概述

本次发布包含多项新功能与体验优化：新增项目级仪表盘、深色模式、Webhook 重试与签名校验、审批流可视化编排，以及导出 API（/v2/exports）。同时修复了移动端大文件上传失败、富文本粘贴表格错位、跨时区日报日期偏移与审计日志分页重复等问题，并通过按需加载与资源并行预取优化了首屏白屏时长。

新增功能

• 项目级仪表盘
  • 支持自定义配置图卡
  • 提供跨维度筛选能力
  • 支持自动刷新
• 深色模式
  • 新增深色主题
  • 支持跟随系统外观设置
• Webhook 增强
  • 新增投递重试机制
  • 新增签名校验能力
  • 提供投递追踪信息
• 审批流可视化编排
  • 支持拖拽式编排
  • 支持多分支条件与抄送节点
• API
  • 新增 /v2/exports 接口
  • 支持增量导出
  • 支持字段映射模板

功能改进

• 性能优化
  • 引入按需加载与资源并行预取，降低首屏白屏时长

问题修复

• 移动端上传
  • 修复分片续传阈值配置错误导致的大文件上传失败
• 富文本编辑
  • 修复粘贴表格错位问题
  • 新增 HTML 标准化与样式白名单，提升粘贴内容一致性
• 跨时区日报
  • 修复跨时区场景下的日期偏移问题
  • 统一以 UTC 存储并在前端按时区渲染
• 审计日志
  • 修复在极端条件下查询分页出现重复数据的问题

安全更新

• 安全增强
  • 新增 Webhook 签名校验能力（详见“新增功能”），提升回调投递安全性
  • 富文本处理新增 HTML 标准化与样式白名单，增强内容输入安全性
• 已知的安全漏洞修复：无

已知问题

• 暂无已知问题

升级说明

• Webhook
  • 新增的签名校验与重试为可配置能力；如需启用签名校验，请在接收端同步实现签名验证逻辑，避免回调被拒绝
  • 建议先在灰度环境验证回调链路与重试策略，再在生产环境启用
• 富文本与内容粘贴
  • 由于引入 HTML 标准化与样式白名单，部分自定义标签或行内样式可能被过滤
  • 如有依赖复杂样式的内容模板，请在升级后进行粘贴与渲染验证
• 时区与报表
  • 后端统一以 UTC 存储时间；前端按时区渲染
  • 若存在直接读取数据库或对时间存储有本地时区假设的外部集成，请评估并适配为 UTC 处理
• 移动端上传
  • 建议核对移动端大文件分片续传阈值配置，确保与实际网络与文件大小策略一致
• API 适配
  • 新增 /v2/exports 接口支持增量导出与字段映射模板；如需使用相关能力，请依据最新 API 文档完成对接
• 前端资源
  • 由于启用按需加载与并行预取，若使用自建反向代理/缓存，请确保遵循标准缓存与预加载头的转发与缓存策略，以避免资源获取异常

版本说明：v3.0.0（2026-01-15）

更新概述

本次为 3.x 的主版本发布，聚焦平台架构升级与企业级能力扩展，同时提升稳定性与安全性。核心更新包括：模块化插件架构、多租户与组织空间、企业级 SSO（OIDC/SAML 2.0）、存储引擎升级至 v2（支持在线无感迁移与数据校验工具）、新增 release-cli 运维工具；并修复了队列阻塞、数据库死锁导致的偶发 500、批量导入内存峰值等问题，默认启用更严格的安全策略。

新增功能

• 模块化插件架构
  • 支持在线启停插件，无需中断核心服务。
  • 插件版本隔离，降低相互影响风险。
  • 沙箱化权限控制，限制插件访问范围。
• 多租户与组织空间
  • 资源隔离：不同租户/组织的计算与存储资源相互独立。
  • 限流隔离：按租户/组织维度独立限流。
  • 计费隔离：支持按租户/组织维度核算。
• 企业级单点登录（SSO）
  • 支持 OIDC 与 SAML 2.0 协议对接。
  • 提供细粒度角色权限模板，便于统一授权管理。
• 存储引擎升级至 v2
  • 提供在线无感迁移能力，减少迁移对业务的影响。
  • 内置数据校验工具，保障迁移一致性与完整性。
• 新增 release-cli
  • 一键执行检查、备份、迁移与回滚流程。
  • 支持 Dry-Run 演练模式，提前发现风险。

功能改进

• 稳定性与资源利用
  • 降低长连接场景的内存碎片化。
  • 优化连接池回收策略，改善高并发下的资源复用效率。
• 可观测性
  • 队列消费者重构并补充可观测指标，便于定位堆积与处理瓶颈。

问题修复

• 队列阻塞导致任务积压
  • 重构消费者逻辑，解决老问题并补充可观测指标以持续监控处理时延与积压量。
• 数据库死锁引发的偶发 500
  • 梳理并收敛事务边界，增加指数退避重试策略，降低死锁对请求可用性的影响。
• 批量导入内存峰值过高
  • 改为流式解析与分批提交，显著降低峰值内存占用并提升大批量导入稳定性。

安全更新

• 默认禁用内嵌 iframe。
• 启用严格内容安全策略（CSP）。
• 修复一处 SSRF 风险点，降低服务端请求被滥用的风险。

已知问题

• 当前未新增已知问题。如在升级或使用过程中发现异常，请反馈以便后续修正。

升级说明

• 升级前准备
  • 建议在预生产环境使用 release-cli 的 Dry-Run 模式完成全量检查与演练。
  • 在业务低峰期安排升级窗口并做好回退预案。
• 数据与存储
  • 使用 release-cli 执行备份。
  • 触发存储引擎 v2 的在线迁移与数据校验，观察迁移与校验结果。
  • 如需回滚，可通过 release-cli 执行回滚流程。
• 插件与扩展
  • 升级后建议先启用核心/必要插件，逐步验证后再按需启用其它插件，确保在版本隔离与沙箱权限下运行。
• 安全策略变更适配
  • 严格 CSP 与默认禁用 iframe 可能影响依赖内嵌页面或第三方资源的场景，请评估并完成必要的前端与集成适配。
• 身份与权限
  • 若启用企业级 SSO，请根据组织的 IdP 配置对接 OIDC/SAML 2.0，并结合细粒度角色权限模板完成授权策略配置。

提示：本次为主版本更新，涉及基础能力与安全策略调整，建议分阶段灰度发布并关注可观测指标与错误告警。