Elsa Studio 3.6.0-rc1 版本特性详解:工作流设计器、编辑器生产力与认证集成

原创2026-10-02 18:47:142,206 阅读
文章标签:后端工作流自动化流程编排低代码AI Agent

Elsa Studio 3.6.0-rc1 版本特性详解:工作流设计器、编辑器生产力与认证集成

导读

本文基于 Elsa 开源仓库中的 3.6.0-rc1 发布说明,系统梳理 Elsa Studio 这一版本的核心更新:包括基于顶点的连线路由(Vertices)、TreeView 化活动选择器、活动级测试、Save As 与快捷键、OIDC PKCE 与 JWT 认证支持、登录页重设计及法语本地化等。通过对照 src/studio 下的源码实现与测试,读者可以同时掌握每个特性的操作方式、配置要点和底层调用链,为升级、二次开发与集成排障提供可直接落地的参考。

说明:Elsa Studio 是 Elsa(The Workflow Engine for .NET)的可视化设计器前端,基于 Blazor 构建。本文所有特性均来自 3.6.0-rc1 发布说明,并以当前仓库 src/studio 中的源码作为实现证据。

一、版本概览:3.6.0-rc1 的定位与主题

3.6.0-rc1 是 Elsa Studio 3.6 系列的首个候选版本,主线是把“设计工作流”这件事做得更快、更准、更顺手。官方发布说明将其拆分为五大主题:

主题 代表特性 PR 编号(原文引用)
Workflow Designer improvements Vertices、TreeView 活动选择器、Flowchart 性能、活动测试 #480 / #544 / #499 / #541
Workflow Editor productivity Save As、Ctrl+S/Cmd+S、定义列表复制 #625 / #635 / #569
Auth & integration OIDC PKCE、JWT 观察器工厂 #519 / #463
UI/UX polish 登录页重设计、一致性修复 #696 / #511 / #512 / #555
Localization 法语翻译 #532

从仓库结构看,这些变更主要落在 src/studio/modules/Elsa.Studio.Workflows(设计器与编辑器)、src/studio/modules/Elsa.Studio.Login 与 src/studio/modules/Elsa.Studio.ExternalAuthentication(认证)三个模块中,下文逐项展开。

二、工作流设计器改进

2.1 Vertices:更精确的连线路由与更干净的图示

“Vertices support for more precise connector routing and cleaner diagrams”(#480)是本次设计器最重要的底层改进。Vertices(顶点)允许连线(Edge/Connector)携带明确的折线顶点序列,使连线不必只走单一的直角路径,而是可以按拓扑结构精确绕行,避免连线与节点交叉重叠。

在源码中,这一能力体现在 Designer.tsx、ElsaEdge.tsx 与 EdgeOpsContext.tsx 等组件中——设计器的连线层(ElsaEdge)负责根据端点与顶点数据渲染路径,而 EdgeOpsContext 提供对连线的操作上下文。可以推断:活动节点在画布上移动后,设计器会基于节点边界重新计算顶点,从而"cleaner diagrams"。

实际收益:复杂流程图中连线互相叠压、误读连接关系的问题显著减少;对从 BPMN 导入或人工编排的多分支流程,连线走向更符合阅读直觉。

2.2 基于 TreeView 的活动选择器(#544)

针对活动目录庞大时"找活动难"的痛点,本版本用 TreeView 替换了原有选择器(#544),并配套新增 CategoryDisplayResolver(#557),使活动按 ActivityDescriptor.Category 分层组织。

源码实现位于 ActivityPickers/Treeview/ActivityPicker.razor 与 ActivityPickers/Treeview/ActivityPicker.razor.cs。其关键逻辑在 BuildTree() 方法中:

  • 从 ActivityRegistry.ListBrowsable() 获取全部可浏览活动描述符;
  • 将 activity.Category 按 / 拆分(如 "Control/Flow" 拆成 ["Control", "Flow"])逐层创建或复用分类节点;
  • 叶子节点即具体活动,支持基于 MudTreeView<string> 的搜索(_searchText)与拖放(级联注入的 DragDropManager)。

与之配套的测试见 TreeviewActivityPickerTests.cs,可作为自定义选择器行为验证的参考。

用法:在设计器中点击活动面板,按分类树逐级展开即可快速定位;在搜索框输入关键词可即时过滤。对拥有上百个扩展活动的生产环境,这一改动显著缩短了拖拽前的检索时间。

2.3 Flowchart 处理与性能优化(#499 / #669 / #670 / #686)

本版本围绕 Flowchart 模型做了三方面优化:

  1. 节点处理修正(#669):修复"多余 Flowchart 节点出现"的问题——通过正确识别 Elsa.Flowchart 类型活动来判定是否属于流程图容器,避免非流程图活动被误渲染为容器节点。
  2. 编辑器响应性(#670):修复 InputsTab"晚一拍(one-interaction-late)"的 UI 更新问题,取消值变更时的防抖重建,让输入即时反映到编辑器状态。
  3. 尺寸计算性能(#686):对活动尺寸计算引入**分批(batching)与缓存(caching)**策略,减少大流程图中反复重算尺寸的开销,直接改善画布滚动、缩放与拖拽时的帧率。

这些改动共同服务于"大流程图不卡、编辑即所见"的体验目标,属于纯粹的运行时/渲染层优化,无需用户额外配置。

2.4 活动测试支持(#541 / #612)

“Activity testing support to speed up iteration while designing workflows”让开发者在不发布、不启动完整工作流的情况下,单独验证某个活动的输入输出。

前端入口是活动属性面板新增的 Tests 页签,实现在 TestTab.razor.cs。核心调用链如下:

  1. OnTestRunClick()(TestTab.razor.cs)通过 IBackendApiClientProvider 获取 ITestsApi;
  2. 构造 TestActivityRequest:WorkflowDefinitionHandle.ByDefinitionVersionId(...) 定位工作流定义版本,ActivityHandle.FromActivityNodeId(...) 定位当前活动节点;
  3. 调用 testsApi.TestActivityAsync(request) 执行测试;
  4. UpdateDataModels() 将响应中的 Status、ActivityState(剔除 _ 前缀的内部键)、Outcomes、Outputs 及 Exception(含 Message 与 StackTrace)渲染到数据面板。

配套改进 #612 将故障异常消息(fault exception messages)纳入 TestTab 组件,测试失败时能直接看到异常信息与堆栈,便于在设计阶段就地修复。

三、工作流编辑器生产力

3.1 Save As(另存为,#625)

编辑器新增 "Save As" 能力,允许把当前工作流以新定义保存,而不是覆盖原版本。相关实现位于 WorkflowEditor.razor 及其 code-behind WorkflowEditor.razor.cs,后端服务见 WorkflowDefinitionEditorService.cs 与契约 IWorkflowDefinitionEditorService.cs。

适用场景:把线上稳定版本复制出来做实验性改造;以某流程为模板快速生成新流程。注意 Save As 会产生新的定义 ID(及新的版本链),与"版本另存"语义一致。

3.2 Ctrl+S / Cmd+S 快捷键(#635)

编辑器新增保存快捷键:Windows/Linux 下 Ctrl+S、macOS 下 Cmd+S,实现仍落在 WorkflowEditor.razor.cs。相比手动点击保存按钮,频繁迭代时键盘保存明显降低操作成本,也避免忘记保存导致的丢失。

3.3 从定义列表复制工作流(#569)

除编辑器内的 Save As 外,工作流定义列表也支持直接复制(Duplicate),实现在 WorkflowDefinitionList.razor.cs 与复制对话框 CloneWorkflowDialog.razor。复制服务契约见 IWorkflowCloningDialogService.cs 与实现 WorkflowCloningDialogService.cs。

三条路径(编辑器 Save As / 快捷键 / 列表复制)覆盖了"另存-新建-复制"的完整需求面,是本版本生产力改进的完整闭环。

四、认证与集成

4.1 OIDC 授权码流程的 PKCE 支持(#519)

PKCE(RFC 7636)防止授权码在公共客户端场景下被截获重放。3.6.0-rc1 为 OIDC 授权码流程补齐 PKCE 支持(#519)。

从源码结构看:

配置提示:启用外部登录时,请确认 Identity Provider(如 Keycloak、Azure AD、Auth0)的授权端点支持 PKCE,并在客户端注册中允许公共客户端的 code challenge;否则浏览器端授权码流程无法完成令牌交换。

4.2 WorkflowInstanceObserverFactory 的 JWT 支持(#463)

工作流实例的实时观察器工厂新增 JWT 支持(#463),使 SignalR 实时通道(实时工作流更新)可以携带 Bearer Token 完成鉴权。

实现位于 WorkflowInstanceObserverFactory.cs,关键逻辑:

  1. 通过 IRemoteFeatureProvider.IsEnabledAsync("Elsa.RealTimeWorkflowUpdates", ...) 探测服务端是否启用实时特性;
  2. 未启用时回退为 PollingWorkflowInstanceObserver(轮询方式,无需 JWT 通道);
  3. 启用时构建指向 hubs/workflow-instance 的 HubConnection,并通过 IHttpConnectionOptionsConfigurator(见 IHttpConnectionOptionsConfigurator 相关模块)异步配置连接鉴权选项——即把 JWT 注入 HttpConnectionOptions.AccessTokenProvider,这正是 #463 引入 JWT 支持的位置;
  4. 若 SignalR 端点不存在(404),记录警告日志并回退轮询,日志明确提示服务端需调用 app.UseWorkflowsSignalRHubs() 安装中间件。

排障要点:升级后若实时更新不生效,优先检查服务端是否安装了 SignalR Hubs 中间件;若 JWT 过期策略过短,观察器可能因令牌失效而掉线,需关注 IHttpConnectionOptionsConfigurator 中令牌刷新逻辑。

五、UI/UX 打磨与本地化

5.1 登录页重设计(#696)

登录页整体重设计并现代化(#696)。登录相关组件集中在 src/studio/modules/Elsa.Studio.Login,包括 LoginState、RedirectToLogin、IAuthenticationProvider、ICredentialsValidator、IEndSessionService、IJwtAccessor 等组件与契约。新版登录页统一了本地账号登录与外部身份提供方(OIDC)入口的视觉风格,并保持对用户名/密码与外部认证两种模式的兼容。

5.2 UI 一致性修复(#511 / #512 / #555)

  • #511 Normalise UI Inconsistencies:统一 Studio 各页面的间距、字号、控件样式;
  • #512:修复缺失的闭合标签,并为新元素补充 dense 紧凑设置;
  • #555:多页面微调。

同时 #539 移除了工作流属性页签中的重复组件,#549/#559 将内容格式化器重构为 ContentVisualizer,并支持 Markdown 描述(#659)——活动/工作流的描述字段现在可以直接以 Markdown 渲染,适合存放带格式的说明文档。

5.3 法语翻译(#532)

本版本由 @agriffard 贡献法语翻译(#532),并同步更新了 README 中的本地化配置说明(#556)。本地化资源位于各 Studio 模块的 resx 文件中(见 src/studio/framework 下 .resx 资源),接入方式遵循 Elsa Studio 的多语言资源机制。

六、其他值得关注的变更

结合"Full Changelog"与当前仓库源码,以下变更同样值得留意:

变更 PR 说明/源码位置
每活动 MergeMode 选择器 #507 流程图 Join 节点的合并模式可在活动级配置
RadioList UI Hint #537 输入属性支持单选列表控件
可配置的缩放(resizing) #561 画布节点尺寸调整可配置开关
工作流输入作为活动输入 #601 工作流级输入可直接作为活动输入绑定
详情页展示工作流状态 JSON #603 Details 页签新增 workflow state 的 JSON 视图
模块加载可覆盖 #543 允许扩展自定义模块加载行为
JsInteropBase 模块 URL 修复 #545 修复 Elsa.Studio.Workflows.Designer 的模块 URL
实例页名称字段与子工作流日志跳转修复 #505 / #504 实例列表/日志交互改进
编辑器加载时刷新组件 #571 从服务端加载最新模型后刷新组件
编辑失焦修复 #573 修复编辑时组件失去焦点
分页大小切换复选框修复 #506 修复分页大小更新导致勾选状态丢失
自定义错误组件与用户消息服务 #490 可定制错误组件与用户提示服务
Studio 移除 Agents/Secrets/Webhooks/WorkflowContexts #513 / #517 相关功能从 Studio 内置面移除(由对应模块/扩展承载)
.NET 10 LTS 目标支持 #674 多目标框架(multi-targeting)支持 .NET 10 LTS
公共 API XML 文档补全 #608 / #609 消除 CS1591 警告,提升 IDE 提示质量

其中 "Remove Agents/Secrets/Webhooks/WorkflowContexts"(#513/#517)属于功能布局调整而非删除能力:相关后端能力由独立模块(如 src/modules/Elsa.Secrets、src/modules/Elsa.Http.Webhooks)继续提供,Studio 侧则保持更聚焦的工作流编辑体验。

七、新贡献者

本版本吸引了 10 位新贡献者(首次合入 PR):@LarsNijholt(#463)、@lanseth(#490)、@agriffard(#532)、@michael-livingston(#519)、@Schneggo(#543)、@BasJanssenQuadira(#560)、@lukhipolito(#571)、@RalfvandenBurg(#497)、@mberthillot-flowwa(#601)、@mcook-dev(#603),涉及认证、本地化、UI、模块加载等多个方向,说明 Studio 生态具备清晰的扩展点与低门槛贡献路径。

八、升级与验证建议

  1. 升级路径:本版本介于 3.5.1 与 3.6.0 正式版之间(Full Changelog 区间 3.5.1...3.6.0-rc1),升级前请先在测试环境验证;若使用外部认证,请同步升级 Elsa.Studio.Login 与 Elsa.Studio.ExternalAuthentication 相关包,确保 PKCE 与 JWT 通道生效。
  2. 验证清单:
    • 打开复杂流程图,确认连线走线清晰、无多余 Flowchart 节点;
    • 用 TreeView 分类定位活动,验证搜索与拖放;
    • 在活动属性 Tests 页签运行活动测试,确认 Status/Outcomes/Output/Fault 面板输出;
    • 编辑器内执行 Ctrl+S/Cmd+S 与 Save As,并核对定义列表中复制功能;
    • 若服务端启用了 Elsa.RealTimeWorkflowUpdates,确认已调用 app.UseWorkflowsSignalRHubs() 且观察器日志无 404 回退告警;
    • 检查登录页样式与本地账号/外部 OIDC 登录(含 PKCE 回调)。
  3. 测试参考:设计器相关回归用例可参考 src/studio/modules/Elsa.Studio.Workflows.Tests(如 WorkflowEditorLifecycleTests、TreeviewActivityPickerTests)以及 src/studio/modules/Elsa.Studio.ExternalAuthentication.Tests,便于快速确认改动是否符合预期。

结语

Elsa Studio 3.6.0-rc1 是一次典型的"体验驱动"版本:底层以 Vertices 与尺寸计算优化改善大图流畅度,交互层以 TreeView 选择器、活动测试、Save As/快捷键/复制三件套提升编辑效率,安全层补齐 PKCE 与 JWT 通道,视觉层完成登录页现代化与全站一致性收拢。结合 发布说明 与 src/studio 源码阅读,可以清晰看到每个特性从 PR 到组件、契约、服务的完整落点,为后续升级与二次开发提供了可循的技术脉络。

登录后查看全文
elsa-core