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,400 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载本篇技术指南围绕 AASAgentic Awesome Skills仓库中的avalonia-viewmodels-zafiro技能展开系统讲解如何在 Avalonia 应用中基于ReactiveUI与Zafiro工具包编写 ViewModel、增强命令、多步骤向导Wizard、应用导航与 UI 分区以及 View-ViewModel 的映射与依赖注入组合。读完本篇你将掌握一套可直接落地的函数式响应式 MVVM 编码规范包括IEnhancedCommand、SlimWizard、[Section]自动注册与DataTypeViewLocator的完整用法。核心原则函数式响应式 MVVM在 Zafiro 体系中ViewModel 的设计遵循五条核心原则源自 SKILL.md函数式响应式Functional-Reactive使用 ReactiveUI 的ReactiveObject、WhenAnyValue等原语承载状态与逻辑让数据流显式、可组合、可预测。增强命令Enhanced Commands统一使用IEnhancedCommand管理命令获得进度上报、Name/Text元数据等更强能力。向导模式Wizard Pattern复杂多步流程用SlimWizardWizardBuilder以声明式方式组织取代手写状态机。自动分区发现Automatic Section Discovery通过[Section]特性自动注册和发现 UI 分区如侧边栏、标签页避免手工维护注册表。清晰组合Clean Composition用DataTypeViewLocator完成 ViewModel→View 的映射并在统一的CompositionRoot中集中管理依赖。这五条原则共同指向一个目标让 ViewModel 纯粹、可测试、与 Avalonia 平台解耦。同级技能 avalonia-zafiro-development 进一步补充了四条强制规范纯 MVVM用 DynamicData 与 ReactiveUI、显式错误处理用Result类型而非异常控制流、跨平台卓越ViewModel 严格不引用 Avalonia 类型、组合优于继承、以及“Zafiro First”优先复用现有抽象与助手避免重复造轮子。响应式 ViewModel从ReactiveObject到自动属性用[Reactive]简化属性定义ViewModel 应以ReactiveObject为基类并使用ReactiveUI.SourceGenerators提供的[Reactive]特性标注字段编译器会自动生成可观察的属性包装。这种做法把传统手写RaiseAndSetIfChanged的样板代码压缩到最小public partial class MyViewModel : ReactiveObject { [Reactive] private string name; [Reactive] private bool isBusy; }注意类必须声明为partial[Reactive]修饰的是私有字段name、isBusy生成的公开属性即为Name、IsBusy。用WhenAnyValue做观察与变换属性间的派生状态应通过WhenAnyValue组合订阅并做变换配合ToPropertyEx输出为只读可观察属性viewmodels.mdthis.WhenAnyValue(x x.Name) .Select(name !string.IsNullOrEmpty(name)) .ToPropertyEx(this, x x.CanSubmit);ToPropertyEx会生成CanSubmit这个ObservableAsPropertyHelper驱动的属性供 XAML 双向/单向绑定直接使用。由于生成器产出的属性名取自表达式整个链路类型安全重构友好。增强命令用IEnhancedCommand管理交互为什么用增强命令Zafiro 的IEnhancedCommand同时扩展了ICommand与IReactiveCommand在此之上附加了Name、Text等元数据。这让命令不仅是一个可执行动作还能携带面向 UI 的展示信息按钮文案、命令标识便于日志、遥测与自动化测试。创建并增强命令先用ReactiveCommand.Create同步或ReactiveCommand.CreateFromTask异步创建基础命令再调用.Enhance(...)注入元数据public IEnhancedCommand Submit { get; } public MyViewModel() { Submit ReactiveCommand.CreateFromTask(OnSubmit, canSubmit) .Enhance(text: Submit Data, name: SubmitCommand); }canSubmit可以是IObservablebool通常由WhenAnyValue变换而来如前述CanSubmit实现“输入合法才可提交”的声明式交互约束OnSubmit返回Task表示异步操作。第二个可选参数也可以直接传入可观察对象来驱动命令的可执行状态。统一错误处理HandleErrorsWith命令执行失败时推荐用HandleErrorsWith把异常自动投递到NotificationService避免在每个命令体内手写 try/catchviewmodels.mdSubmit.HandleErrorsWith(uiServices.NotificationService, Submission Failed) .DisposeWith(disposable);同源的最佳实践在 patterns.md 中再次强调不要在手写Subscribe里堆业务逻辑而是让错误沿响应式管道流到统一的展示层——例如LoadProjects.HandleErrorsWith(uiServices.NotificationService, Could not load projects)。错误处理管道化之后ViewModel 的每个命令都具备一致的失败反馈行为。生命周期管理CompositeDisposable与DisposeWith响应式编程中订阅与命令均有生命周期忘记释放会造成内存泄漏与幽灵回调。规范做法是让 ViewModel 实现IDisposable用CompositeDisposable汇集所有订阅并在Dispose时统一释放public class MyViewModel : ReactiveObject, IDisposable { private readonly CompositeDisposable disposables new(); public void Dispose() disposables.Dispose(); }凡是用到的 observable 订阅、命令增强链、验证规则一律追加.DisposeWith(disposables)确保组件销毁时订阅同步解除。同级技能 avalonia-reactive-rules.md 也把DisposeWith列为生命周期管理的强制要求。向导模式用SlimWizard声明式编排多步流程用WizardBuilder定义步骤复杂多步流程注册、创建项目、部署向导等应使用SlimWizard。每个步骤对应一个 ViewModel步骤间通过上一个步骤的结果prevResult流转链式声明让流程结构一目了然wizards.mdSlimWizardstring 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();上面示例展示了三种不同的推进方式第一步等待内部信号NextUnit且需通过验证WhenValid第二步等待 ViewModel 中某个特定命令成功执行NextCommand(vm vm.CustomNextCommand)最后一步直接以自定义转换函数产出结果并给出按钮文案Finish。导航规则NextUnit()当步骤 ViewModel 发出一个简单信号时推进到下一步。NextCommand()当指定命令成功执行后推进适用于“点击按钮并完成操作才进入下一步”的场景。WhenValid()等待当前 ViewModel 的验证通过后才允许导航与 Zafiro 的验证扩展协同工作。Always()任何情况下都允许导航。向导收尾配置WithCompletionFinalStep()最后一个步骤完成即标记向导结束普通完成型。WithCommitFinalStep()适用于最后一步执行“保存 / 部署”等提交动作的向导。与INavigator集成向导本身不直接驱动 UI而是通过INavigator导航执行public async Task CreateSomething() { var wizard BuildWizard(); var result await wizard.Navigate(navigator); // Handle result }SlimWizard会自动处理“返回Back”命令因此在所有流程中用户都能获得一致的返回体验无需每个向导单独实现回退逻辑。导航与 UI 分区INavigator与[Section]页面级导航INavigator负责在视图/ViewModel 之间切换public class MyViewModel(INavigator navigator) { public async Task GoToDetails() { await navigator.Navigate(() new DetailsViewModel()); } }主构造函数注入是 Zafiro 项目的常见风格与 DI 容器配合时由容器解析INavigator实例。用[Section]标记模块化分区分区Section是 UI 中的模块化部件例如侧边栏项或标签页。需要作为分区的 ViewModel 用[Section]特性标注并携带显示名与图标[Section(Wallet, icon: fa-wallet)] public class WalletSectionViewModel : IWalletSectionViewModel { // ... }icon参数支持 FontAwesome 图标如fa-home前提是在应用中配置了ProjektankerIconControlProvider图标提供器。自动注册与切换在CompositionRoot中可以通过扩展方法扫描并自动注册所有带[Section]特性的分区无需手工逐一添加services.AddAnnotatedSections(logger); services.AddSectionsFromAttributes(logger);运行时切换当前激活分区通过IShellViewModel完成shellViewModel.SetSection(Browse);这套机制让“新增一个侧边栏页面”的成本降为两步标记[Section] 在组合根自动注册其余注册与切换逻辑全部由框架接管。组合与映射DataTypeViewLocator与CompositionRootView-ViewModel 自动映射Zafiro 用DataTypeViewLocator依据 ViewModel 的数据类型自动解析对应 View。在App.axaml的数据模板中注册它并引入 Zafiro 内置模板Application.DataTemplates DataTypeViewLocator / DataTemplateInclude Sourceavares://Zafiro.Avalonia/DataTemplates.axaml / /Application.DataTemplates映射既可以全局注册也可以采用命名约定或由源生成器显式生成。DataTypeViewLocator保证“ViewModel 类型 → View”的解析与 XAML 数据模板无缝衔接。集中式 CompositionRoot所有服务注册应集中在CompositionRoot把 View 层topLevelView需要的 UI 服务注入进来最终对外暴露IShellViewModelpublic static class CompositionRoot { public static IShellViewModel CreateMainViewModel(Control topLevelView) { var services new ServiceCollection(); services .AddViewModels() .AddUIServices(topLevelView); var serviceProvider services.BuildServiceProvider(); return serviceProvider.GetRequiredServiceIShellViewModel(); } }按作用域注册 ViewModelViewModel 的作用域需依据生命周期谨慎选择临时页面用Transient全局唯一的 Shell 用Singletonpublic static IServiceCollection AddViewModels(this IServiceCollection services) { return services .AddTransientIHomeSectionViewModel, HomeSectionSectionViewModel() .AddSingletonIShellViewModel, ShellViewModel(); }应用启动时的 View 注入在OnFrameworkInitializationCompleted中用Connect帮助方法把 ShellView、主 ViewModel 与主窗口三者接线public override void OnFrameworkInitializationCompleted() { this.Connect( () new ShellView(), view CompositionRoot.CreateMainViewModel(view), () new MainWindow()); base.OnFrameworkInitializationCompleted(); }需要手工实例化某个类但又要从IServiceProvider解析其依赖时使用ActivatorUtilities.CreateInstancecomposition.md它能在不显式传参的情况下完成构造函数依赖注入。进阶集合、验证与响应式管道的强制规范围绕 Zafiro ViewModel 体系同级技能还沉淀了几条高频模式直接提升真实项目的代码质量动态集合验证Mandatory Validation Pattern对动态集合的验证统一走 Zafiro 验证扩展用 DynamicData 管道组合出验证流avalonia-reactive-rules.mdthis.ValidationRule( StagesSource .Connect() .FilterOnObservable(stage stage.IsValid) .IsEmpty(), b !b, _ Stages are not valid) .DisposeWith(Disposables);RefreshableCollection 模式管理可刷新列表时RefreshableCollection.Create内部维护SourceCache/SourceList对外暴露ReadOnlyObservableCollection刷新时用EditDiff做增量更新而非清空重建patterns.mdvar refresher RefreshableCollection.Create( () GetDataTask(), model model.Id) .DisposeWith(disposable); LoadData refresher.Refresh; Items refresher.Items;DynamicData 操作符优先操作集合时优先使用 DynamicData 的Connect、Filter、Transform、Sort、Bind、DisposeMany而不是普通 Rx 操作符禁止为局部问题随手新建SourceList/SourceCache禁止把业务逻辑写进Subscribe。这些规则保证了数据管道可读、集中、可释放。何时使用与注意事项适用场景任务与上述范围明确匹配时启用——包括新建或重构 Avalonia ViewModel、实现多步向导、搭建 Shell 导航与分区 UI、以及配置 View-ViewModel 组合与映射。不适用场景任务超出该范围如纯后端逻辑、非 Avalonia 平台代码时不应套用本技能。必要提醒本技能输出不能替代针对具体环境的验证、测试与专家评审当所需输入、权限、安全边界或成功判据缺失时应停下并澄清后再继续。上述规范的参考实现可对照社区项目AngorCreateProjectFlowV2.cs是复杂 Wizard 构建的范例HomeViewModel.cs则是使用函数式响应式命令的简单分区 ViewModel 范例SKILL.md。总结avalonia-viewmodels-zafiro提供了一整套可复制的 Avalonia MVVM 工程范式以ReactiveObject[Reactive]WhenAnyValue搭建响应式状态层以IEnhancedCommandHandleErrorsWith统一命令与错误流以SlimWizard声明式编排多步流程以[Section]IShellViewModel管理模块化分区最终通过DataTypeViewLocator与CompositionRoot完成 View-ViewModel 的解耦接线。配合 DynamicData 集合管道与 Zafiro 验证扩展这套方法能让跨平台 Avalonia 应用在可维护性、可测试性与一致性上显著受益。若需进一步了解配套规范可继续阅读仓库内 avalonia-zafiro-development 技能集中的 naming-standards.md、zafiro-shortcuts.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,400 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载相关推荐ReactiveUI与Avalonia集成构建跨平台响应式桌面应用的终极指南ReactiveUI与Avalonia集成构建跨平台响应式桌面应用的终极指南 ReactiveUI是一个基于响应式扩展Rx的跨平台MVVM框架专门为.N前端移动开发桌面应用跨平台异步编程MVVM架构完全解析在Swift中构建响应式应用的终极指南MVVM架构完全解析在Swift中构建响应式应用的终极指南 MVVM架构是iOS开发中最流行的架构模式之一它通过清晰的职责分离和响应式数据绑定帮助你构建更教程文档移动开发leetcode-rust中的测试驱动开发如何编写健壮的算法测试leetcode rust中的测试驱动开发如何编写健壮的算法测试 在算法开发领域测试驱动开发TDD是确保代码质量和正确性的关键实践。 leetcode示例工程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考