Elsa Studio 3.6.0-rc1 版本特性详解:工作流设计器、编辑器生产力与认证集成
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 模型做了三方面优化:
- 节点处理修正(#669):修复"多余 Flowchart 节点出现"的问题——通过正确识别
Elsa.Flowchart类型活动来判定是否属于流程图容器,避免非流程图活动被误渲染为容器节点。 - 编辑器响应性(#670):修复 InputsTab"晚一拍(one-interaction-late)"的 UI 更新问题,取消值变更时的防抖重建,让输入即时反映到编辑器状态。
- 尺寸计算性能(#686):对活动尺寸计算引入**分批(batching)与缓存(caching)**策略,减少大流程图中反复重算尺寸的开销,直接改善画布滚动、缩放与拖拽时的帧率。
这些改动共同服务于"大流程图不卡、编辑即所见"的体验目标,属于纯粹的运行时/渲染层优化,无需用户额外配置。
2.4 活动测试支持(#541 / #612)
“Activity testing support to speed up iteration while designing workflows”让开发者在不发布、不启动完整工作流的情况下,单独验证某个活动的输入输出。
前端入口是活动属性面板新增的 Tests 页签,实现在 TestTab.razor.cs。核心调用链如下:
OnTestRunClick()(TestTab.razor.cs)通过IBackendApiClientProvider获取ITestsApi;- 构造
TestActivityRequest:WorkflowDefinitionHandle.ByDefinitionVersionId(...)定位工作流定义版本,ActivityHandle.FromActivityNodeId(...)定位当前活动节点; - 调用
testsApi.TestActivityAsync(request)执行测试; 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)。
从源码结构看:
- src/studio/modules/Elsa.Studio.Login 中新增契约
IOpenIdConnectPkceStateService(见 Contracts/IOpenIdConnectPkceStateService.cs),负责 PKCE 状态(code_verifier / code_challenge)的生成与暂存;ReceiveAuthorizationCode组件(ReceiveAuthorizationCode.cs)接收回调并用 verifier 换取令牌; - Blazor WebAssembly 端的 PKCE 事务存储位于 BrowserExternalAuthenticationPkceService.cs 与 BrowserExternalAuthenticationPkceTransactionStore.cs,对应契约 IExternalAuthenticationPkceTransactionStore.cs,相关行为测试见 ExternalAuthenticationWasmTests.cs。
配置提示:启用外部登录时,请确认 Identity Provider(如 Keycloak、Azure AD、Auth0)的授权端点支持 PKCE,并在客户端注册中允许公共客户端的 code challenge;否则浏览器端授权码流程无法完成令牌交换。
4.2 WorkflowInstanceObserverFactory 的 JWT 支持(#463)
工作流实例的实时观察器工厂新增 JWT 支持(#463),使 SignalR 实时通道(实时工作流更新)可以携带 Bearer Token 完成鉴权。
实现位于 WorkflowInstanceObserverFactory.cs,关键逻辑:
- 通过
IRemoteFeatureProvider.IsEnabledAsync("Elsa.RealTimeWorkflowUpdates", ...)探测服务端是否启用实时特性; - 未启用时回退为
PollingWorkflowInstanceObserver(轮询方式,无需 JWT 通道); - 启用时构建指向
hubs/workflow-instance的HubConnection,并通过IHttpConnectionOptionsConfigurator(见 IHttpConnectionOptionsConfigurator 相关模块)异步配置连接鉴权选项——即把 JWT 注入HttpConnectionOptions.AccessTokenProvider,这正是 #463 引入 JWT 支持的位置; - 若 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 生态具备清晰的扩展点与低门槛贡献路径。
八、升级与验证建议
- 升级路径:本版本介于 3.5.1 与 3.6.0 正式版之间(Full Changelog 区间
3.5.1...3.6.0-rc1),升级前请先在测试环境验证;若使用外部认证,请同步升级 Elsa.Studio.Login 与 Elsa.Studio.ExternalAuthentication 相关包,确保 PKCE 与 JWT 通道生效。 - 验证清单:
- 打开复杂流程图,确认连线走线清晰、无多余 Flowchart 节点;
- 用 TreeView 分类定位活动,验证搜索与拖放;
- 在活动属性 Tests 页签运行活动测试,确认 Status/Outcomes/Output/Fault 面板输出;
- 编辑器内执行
Ctrl+S/Cmd+S与 Save As,并核对定义列表中复制功能; - 若服务端启用了
Elsa.RealTimeWorkflowUpdates,确认已调用app.UseWorkflowsSignalRHubs()且观察器日志无 404 回退告警; - 检查登录页样式与本地账号/外部 OIDC 登录(含 PKCE 回调)。
- 测试参考:设计器相关回归用例可参考 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 到组件、契约、服务的完整落点,为后续升级与二次开发提供了可循的技术脉络。