AI 技能AI 插件人工智能【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills点击查看免费下载复杂业务场景中的多步骤流程如创建项目、分步配置、向导式部署是桌面应用开发的常见痛点。本文基于开源仓库plugins/agentic-awesome-skills-claude/skills/avalonia-viewmodels-zafiro/中的技能文档系统讲解如何在 Avalonia 应用中借助Zafiro工具包与ReactiveUI通过SlimWizard与WizardBuilder以声明式方式定义步骤、编排导航逻辑并获取最终结果。阅读完本文你将掌握向导的构建语法、四种导航规则的适用场景、与INavigator的集成方式以及WithCompletionFinalStep/WithCommitFinalStep等收尾配置的最佳实践。一、为什么需要 SlimWizard多步骤流程的声明式解决思路在传统的 Avalonia ReactiveUI 应用中多步骤流程往往靠手写状态机或大量布尔标志位step1Visible、step2Visible……驱动代码随着步骤增多迅速变得难以维护导航条件散落各处、返回逻辑重复实现、校验时机不统一。Zafiro 的SlimWizard模式将这些问题收敛为一个声明式的步骤链每一步对应一个 ViewModel步骤之间的前进条件、跳转参数、最终结果都以链式 API 表达。正如该技能文档所强调的SlimWizard的核心价值是让流程“可声明、可维护”同时它自动处理 “Back” 返回命令从而在不同流程之间提供一致的用户体验见 wizards.md。该技能文档所属的整套技能见 SKILL.md将其列为五大核心原则之一函数式响应式编程基于ReactiveObject、WhenAnyValue管理状态增强命令使用IEnhancedCommand获得进度上报与名称/文本元数据向导模式用SlimWizardWizardBuilder实现复杂流程自动 Section 发现[Section]特性注册 UI 分区干净组合DataTypeViewLocator映射 ViewModel 与 View。其中向导模式正是本文要深入的主题它与技能文档中的 ViewModel 命令体系viewmodels.md、导航基础设施navigation_sections.md天然互补向导中的每一步 ViewModel 遵循同一套响应式命令与校验约定。二、定义向导WizardBuilder 链式语法详解向导的骨架由WizardBuilder构建。每一步对应一个 ViewModelStartWith给出第一步的工厂方法Then负责串联后续步骤且每一步可以读取前一步的结果作为参数。技能文档给出了一个完整示例SlimWizardstring wizard WizardBuilder .StartWith(() new Step1ViewModel(data)) .NextUnit() .WhenValid() .Then(prevResult new Step2ViewModel(prevResult)) .NextCommand(vm vm.CustomNextCommand) .Then(result new SuccessViewModel(Done!)) .Next((_, s) s, Finish) .WithCompletionFinalStep();逐段拆解这段链式调用的含义链式片段作用StartWith(() new Step1ViewModel(data))定义向导第一步的 ViewModel 工厂data可以是外层传入的上下文数据.NextUnit().WhenValid()第一步的导航规则等待当前 ViewModel 校验通过后由“简单信号”触发前进.Then(prevResult new Step2ViewModel(prevResult))第二步接收上一步的产物prevResult作为构造参数.NextCommand(vm vm.CustomNextCommand)第二步的导航由 ViewModel 内特定的命令成功执行来驱动.Then(result new SuccessViewModel(Done!))收尾步骤可继续接收上一步结果.Next((_, s) s, Finish)自定义“Finish”按钮将当前状态s作为向导最终结果返回.WithCompletionFinalStep()标记最后一步完成后向导即宣告结束注意泛型参数SlimWizardstring尖括号中的类型就是向导最终产出的结果类型。在这个例子里整个过程最终返回一个string“Done!”而实际项目中它往往是一个领域模型、DTO 或保存指令。2.1 步骤之间的数据传递Then(prevResult new Step2ViewModel(prevResult))这类写法揭示了SlimWizard的数据流设计每一步的工厂函数接收上一步的返回值从而把多步骤流程组织成一条类型安全的数据管道。这意味着步骤间传递的是强类型对象而非object或全局状态向导结果类型如SlimWizardMyResult在编译期即可约束每一步 ViewModel 只关心自己需要的那部分数据职责清晰。这种设计让多步骤表单、配置流、创建流程等场景可以轻松表达“第 2 步依赖第 1 步的输入”这类常见诉求。三、四种导航规则何时前进由你决定SlimWizard允许为每一步配置前进触发条件这是声明式流程的核心灵活性所在。技能文档归纳了四种导航规则规则触发时机典型场景NextUnit()发出一个简单信号时前进点击“下一步”按钮、UI 事件广播等无需参数校验的推进NextCommand(vm vm.CustomNextCommand)指定命令成功执行时前进步骤内执行了异步操作如调用服务、保存数据且成功后才允许进入下一步WhenValid()当前 ViewModel 的校验全部通过后才允许导航表单输入校验未填完/非法时“下一步”不可用Always()无条件允许导航纯展示步骤、信息确认页等其中几个规则通常组合使用例如示例中的.NextUnit().WhenValid()既要求校验通过又要求收到前进信号。这种组合语义让“按钮可点”与“数据合法”两件事被解耦表达而不是在按钮的CanExecute里写满判断。从实现角度看NextCommand与技能文档中强调的IEnhancedCommand体系一脉相承见 viewmodels.mdCustomNextCommand本身就是一个由ReactiveCommand.Create/CreateFromTask创建并经.Enhance(...)包装的增强命令它天然携带Name、Text等元数据并可配合HandleErrorsWith把失败信息路由到NotificationService——命令失败时自然不会触发前进错误处理也因此统一。四、导航集成用 INavigator 驱动向导SlimWizard本身只负责定义流程实际的页面切换交给 Zafiro 的导航抽象INavigator。技能文档给出了集成范式public async Task CreateSomething() { var wizard BuildWizard(); var result await wizard.Navigate(navigator); // Handle result }要点解读BuildWizard()内部用WizardBuilder组装出SlimWizardTResultwizard.Navigate(navigator)是异步方法向导运行时由navigator负责在每一步 ViewModel 之间切换视图await返回的是向导最终结果调用方在流程结束后统一处理而不是在各步骤里散落地收集数据“返回”导航由SlimWizard内部自动接管因此每步都会获得一致的 Back 体验调用方无需为每步单独实现回退逻辑。INavigator同时是技能文档中通用导航的基础设施见 navigation_sections.md例如navigator.Navigate(() new DetailsViewModel())这样的普通页面跳转与向导导航共用同一抽象保持了整个应用的导航模型统一。五、步骤收尾配置Completion 与 Commit 的选择向导最后一步如何处理是很多实现容易含糊的地方。SlimWizard提供了两个收尾选项语义差异非常明确WithCompletionFinalStep()最后一步完成即标记向导结束。适用于纯流程式向导——最后一步通常是“完成/摘要”页展示结果或给出提示不需要额外副作用。WithCommitFinalStep()通常用于向导末尾执行最终“保存Save”或“部署Deploy”动作的场景。最后一步负责触发真正的业务提交例如写入数据库、发布配置、启动部署流程提交成功后才宣告完成。选择依据很简单如果向导的终点是“告知结果”用Completion如果终点是“执行动作”用Commit。这两种配置与NextCommand天然搭配——例如 Commit 步骤可以绑定vm.SaveCommand作为前进条件确保只有保存成功才能完成向导。六、与整套技能的配合让向导融入应用向导并非孤立存在在avalonia-viewmodels-zafiro技能体系中它和其他四块内容构成完整的 ViewModel 开发范式步骤 ViewModel 本身遵循 viewmodels.md 的规范继承ReactiveObject、用[Reactive]源生成器特性声明属性、用WhenAnyValue派生计算属性、命令经.Enhance()包装并通过CompositeDisposable管理生命周期。向导每一步的“校验”与“命令”底层依赖的就是这套约定。向导页面切换依赖 navigation_sections.md 中的INavigator若向导以 Section 形式嵌入 Shell如“创建”作为一个可切换分区还可借助[Section]特性自动注册。向导内 ViewModel 的实例化与 View 映射由 composition.md 中的CompositionRootDataTypeViewLocator承接在App.axaml的Application.DataTemplates中注册DataTypeViewLocator /在组合根里以合适的作用域注册各步骤 ViewModel向导工厂通过 DI 解析依赖必要时用ActivatorUtilities.CreateInstance手动实例化并注入依赖。技能文档还给出了一条落地参考真实项目Angor中的CreateProjectFlowV2.cs即复杂 Wizard 构建的范例见 SKILL.md可作为进阶学习时对照的工程实现。七、小结SlimWizard模式把 Avalonia 多步骤流程从“手写状态机”提升为“声明式数据管道”构建WizardBuilder.StartWith(...).Then(...)链式定义步骤与数据传递泛型结果类型保证类型安全导航NextUnit、NextCommand、WhenValid、Always四种规则按需组合精确表达前进时机集成通过INavigator异步驱动Back 命令自动处理调用方只需等待最终结果收尾按业务语义选择WithCompletionFinalStep告知结果或WithCommitFinalStep执行保存/部署动作。将这套模式与同技能文档中的响应式 ViewModel、增强命令、Section 导航与组合根一起使用可以在 Avalonia 应用中构建出结构清晰、易于测试、可长期维护的向导式交互。相关技能文件完整保存在仓库plugins/agentic-awesome-skills-claude/skills/avalonia-viewmodels-zafiro/目录下英文原版位于plugins/agentic-awesome-skills/skills/avalonia-viewmodels-zafiro/包含 SKILL.md、viewmodels.md、wizards.md、navigation_sections.md、composition.md 五份文档可随时查阅对照。赞分享AI 技能AI 插件人工智能【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills点击查看免费下载相关推荐基于 Zafiro 与 ReactiveUI 构建 Avalonia ViewModel 与增强命令的最佳实践agentic-awesome-skills 实战指南基于 Zafiro 与 ReactiveUI 构建 Avalonia ViewModel 与增强命令的最佳实践agentic awesome skills 实AI 技能AI 插件人工智能构建多步骤上传流程jQuery File Upload向导式上传构建多步骤上传流程jQuery File Upload向导式上传 你是否遇到过用户上传文件时手忙脚乱的场景一次性展示所有上传选项往往让用户无所适从导致上传前端UI组件agentic-awesome-skills基于 Avalonia 与 Zafiro 的函数式响应式 MVVM 开发指南agentic awesome skills基于 Avalonia 与 Zafiro 的函数式响应式 MVVM 开发指南 本指南以仓库中的 avaloniaAI 技能AI 插件人工智能上一篇Egg.js DI 依赖注入完全指南Proto、Inject 与动态注入的模块化实践下一篇MooTool Next Flutter P3 阶段验收全解析flutter analyze 零告警与 33 项单元测试的技术实现创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考