ToolJet v3.20.183-lts 发布——Flex 布局引擎与 Microsoft Graph 文件存储功能上线
ToolJet v3.20.183-lts 发布：Flex 布局引擎与 Microsoft Graph 文件存储功能上线
发布时间：
热门开源低代码平台 ToolJet 发布了 v3.20.183-lts。这次更新虽然是一次针对性补丁，但为应用开发者带来了两项非常实用的新功能。ToolJet 目前在 GitHub 上已获得超过 38,000 颗 Star，并拥有活跃的自托管社区，持续为长期支持分支推出稳定改进。本次更新也再次体现了 LTS 版本值得持续关注的原因。
本次更新的重点包括全新的 Flex 布局容器组件：开发者无需再借助 CSS 变通方案，就能更好地控制 UI 布局；此外，Microsoft Graph 集成也得到扩展，现已支持文件和文件夹存储操作。除此之外，本次更新还修复了一个关键的 SSO 问题。对于在自定义域名上运行 ToolJet 的自托管用户来说，这项修复值得立即应用。
v3.20.183-lts 有哪些新内容
新功能
Flex 布局容器组件
本次更新中最直接面向开发者的功能，是全新的基础 Flex 布局容器组件。过去，要在 ToolJet 应用中实现精确对齐和响应式布局，通常需要绕开网格系统，或注入自定义 CSS。现在，开发者可以直接在应用构建器界面中配置 CSS Flexbox 选项，自由控制布局方向、换行、对齐方式和间距，无需再修改原始样式表。对于使用 ToolJet 构建复杂多列布局或自适应布局的内部仪表盘、运营工具来说，这是一次实用的体验升级，也让 ToolJet 的布局能力更符合现代前端开发的预期。
Microsoft Graph 文件与文件夹存储操作
ToolJet 的 Microsoft Graph 集成可将 ToolJet 应用与 Microsoft 365 服务连接起来。此次更新大幅扩展了该集成的能力，加入了完整的文件和文件夹管理功能。现在，ToolJet 应用可以通过 Graph 集成层，在 OneDrive 和 SharePoint 中创建、读取、更新、移动和删除文件及文件夹，无需再编写自定义 API 连接器。对于在 Microsoft 365 环境中将 ToolJet 作为内部工具平台的组织来说，这填补了一个重要的功能空白，也免去了此前对变通方案或外部脚本的依赖。
改进
Team 计划席位上限提升，Starter 计划停用
在定价和套餐方面，Team 计划现已支持更多用户席位，旧版 Starter 计划也已正式停用。使用 ToolJet 开源自托管版本的用户不受云端套餐调整影响，但如果你正在使用 ToolJet Cloud，或正在评估托管方案，就需要注意：Starter 计划已经取消。现有 Starter 用户今后需要迁移到 Team 计划。对于自托管用户而言，需要注意的是，此类上游限制调整偶尔也会影响本地部署中的用户数限制策略，因此升级后最好检查一下实例的套餐配置。
统一 Prompt 输入区的字体规格
本次 UI 优化将文本 Prompt 输入区的字号统一为 14px，与编辑器其他区域的排版比例保持一致。虽然改动不大，却能消除在 ToolJet 编辑器不同区域之间切换时产生的视觉突兀感；在 Prompt 输入区与常规编辑器面板并列显示的 AI 辅助工作流中，这一点尤其明显。
Bug 修复
修复自定义域名工作区的 SSO 重定向循环
对于在自定义域名上运行 ToolJet 的自托管用户来说，这是期待已久的修复。此前的路由认证 Bug 会导致用户返回自定义域名工作区时，SSO 认证流程失败：用户虽然能够成功完成认证，却会陷入重定向循环，无法进入工作区。本次修复调整了路由规则，无论工作区使用自定义域名还是 ToolJet 默认域名，SSO 回调都能正确处理。如果你的团队一直无法在自定义域名的 ToolJet 实例上顺利完成 SSO 登录，仅凭这一项修复也值得升级。
如何升级
如果你通过 Docker Compose 运行 ToolJet，升级到 v3.20.183-lts 非常简单：拉取最新镜像、重启容器，然后检查日志即可：
# 拉取最新镜像
docker compose pull
# 使用新版本重启
docker compose up -d
# 检查日志中是否存在问题
docker compose logs -f本次发布没有数据库迁移或破坏性架构变更，因此按标准流程拉取更新并重启即可。和往常一样，升级前请先备份数据库——如果是团队每天依赖 ToolJet 的生产实例，这一点尤其重要。如果你是从早于 v3.20.182-lts 的版本升级，请先查看中间版本的更新日志，再直接升级到当前版本。
要升级吗？
如果你的 ToolJet 实例通过自定义域名接入了 SSO，这几乎是一次必须进行的更新：修复重定向循环后，用户无法登录这一实际的身份验证阻塞问题将得到解决。其他用户则可以按需决定。Flex 布局组件和更完善的 Microsoft Graph 支持都是不错的新增功能，但如果当前环境运行稳定，也没有紧迫到必须立即升级。
这次更新的风险较低：没有破坏性变更，没有架构迁移，修复和功能调整也都比较聚焦。在生产环境中运行 ToolJet 的团队，可以将升级安排在下一个维护窗口。对于使用 LTS 版本的用户，更可以放心升级——本次更新遵循了 LTS 版本一贯的保守、补丁级发布节奏。
详情请参阅 GitHub 上的完整发布说明。