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点击查看免费下载本篇技术指南聚焦于在 Avalonia 应用中以 Zafiro 工具包与 ReactiveUI 为基石构建函数式、响应式、可恢复resilient的 ViewModel 与命令体系。文中内容以仓库内 avalonia-viewmodels-zafiro/viewmodels.md 为骨架并融合同技能包中 SKILL.md、composition.md、wizards.md 与 navigation_sections.md 的实践要点。读完本文你将掌握如何用[Reactive]源生成器快速声明可观察属性、用WhenAnyValue派生计算状态、用IEnhancedCommand携带命令元数据并统一处理错误以及如何用CompositeDisposable管理订阅与命令生命周期最终写出可维护、可测试的 Avalonia 界面层代码。一、技能定位什么是 Zafiro 风格的 ViewModel在 Zafiro 应用中ViewModel 被期望具备三个特性functional函数式、reactive响应式、resilient可恢复/健壮。这一原则在技能包的 SKILL.md 中被总结为五大核心原则Functional-Reactive Approach使用 ReactiveUI 的ReactiveObject、WhenAnyValue等处理状态与逻辑Enhanced Commands利用IEnhancedCommand增强命令管理支持进度上报与名称/文本元数据Wizard Pattern复杂流程用SlimWizard与WizardBuilder声明式构建Automatic Section Discovery用[Section]特性自动注册与发现 UI 区块Clean Composition用DataTypeViewLocator完成 ViewModel 到 View 的映射并在CompositionRoot中统一管理依赖。本文重点展开其中的第 1、2 点响应式 ViewModel 与增强命令它们是所有 Avalonia Zafiro 界面开发的基础单元。二、响应式 ViewModel从ReactiveObject与[Reactive]开始2.1 基类选择所有 ViewModel 应以ReactiveObject作为基类。ReactiveUI 的ReactiveObject实现了INotifyPropertyChanged并通过RaisePropertyChanged机制驱动整个响应式管线。2.2 使用源生成器简化属性声明相比手工编写RaiseAndSetIfChanged样板代码Zafiro 项目推荐使用ReactiveUI.SourceGenerators提供的[Reactive]特性基于字段来声明可观察属性代码量大幅缩减且不易出错public partial class MyViewModel : ReactiveObject { [Reactive] private string name; [Reactive] private bool isBusy; }要点说明类必须声明为partial源生成器会在编译期补全属性定义Name、IsBusy及变更通知逻辑字段命名采用 camelCase生成的属性为 PascalCase任何读取Name、IsBusy的表达式都会自动建立订阅关系从而驱动下游响应式链。2.3 属性观察与派生状态用WhenAnyValue观察属性变化并做投影转换transformation再通过ToPropertyEx将其物化为只读的可观察属性。经典场景是输入非空 → 允许提交this.WhenAnyValue(x x.Name) .Select(name !string.IsNullOrEmpty(name)) .ToPropertyEx(this, x x.CanSubmit);机制解读WhenAnyValue(x x.Name)建立对Name的持续订阅每次变化都会推入下游.Select(...)将字符串投影为bool完成派生状态计算.ToPropertyEx(this, x x.CanSubmit)将可观察序列转为只读属性CanSubmit可直接绑定到按钮的IsEnabled。实战建议把依赖其他属性的计算状态统一用WhenAnyValue链表达避免在 setter 里手工联动状态来源单一、链路清晰、易于测试。三、增强命令IEnhancedCommand的创建与增强3.1 为什么需要IEnhancedCommandZafiro 定义了IEnhancedCommand接口它同时扩展了 WPF/跨平台通用的ICommand与 ReactiveUI 的IReactiveCommand并额外携带元数据Name、Text。这些元数据可被 UI 层消费例如按钮文本、可访问性名称、日志标识让命令在可执行之外还具备可描述能力。3.2 创建命令的标准写法创建命令的推荐路径是用ReactiveCommand.Create同步或ReactiveCommand.CreateFromTask异步构建随后调用Enhance()附加元数据public IEnhancedCommand Submit { get; } public MyViewModel() { Submit ReactiveCommand.CreateFromTask(OnSubmit, canSubmit) .Enhance(text: Submit Data, name: SubmitCommand); }参数说明参数含义OnSubmit异步执行体返回TaskReactiveCommand会自动管理执行中状态IsExecutingcanSubmit可执行性控制可传IObservablebool与上一节CanSubmit属性天然衔接text命令展示文本如按钮文案Submit Dataname命令标识名用于日志、测试与可访问性如SubmitCommand3.3 错误处理HandleErrorsWith默认情况下异步命令抛出的异常会进入 ReactiveUI 的异常管道Zafiro 提供了HandleErrorsWith扩展将命令错误自动定向到NotificationService由统一的通知/弹窗组件向用户呈现避免在每个命令执行体里手写 try/catch 重复逻辑Submit.HandleErrorsWith(uiServices.NotificationService, Submission Failed) .DisposeWith(disposable);两个关键点第二个参数Submission Failed作为用户可读的失败提示前缀或标题真实异常信息如消息、堆栈由NotificationService负责格式化呈现返回的订阅对象必须挂到CompositeDisposable上见下文确保随 ViewModel 销毁而解除。3.4 进度上报进阶IEnhancedCommand设计初衷之一即进度上报progress reporting。结合IsExecuting可观察属性可以在 UI 上驱动进度条或忙碌指示器——例如把Submit.IsExecuting与isBusy属性联动或在 XAML 中直接绑定Command.IsExecuting。四、资源管理CompositeDisposable与DisposeWith响应式编程的本质是大量订阅而每个订阅都占用资源。Zafiro 的纪律是所有订阅与命令生命周期统一交给CompositeDisposable管理ViewModel 实现IDisposablepublic class MyViewModel : ReactiveObject, IDisposable { private readonly CompositeDisposable disposables new(); public void Dispose() disposables.Dispose(); }统一规范任何可观察订阅、命令增强返回的句柄一律追加.DisposeWith(disposables)ViewModel 被关闭/移除时Dispose()一次性释放全部订阅防止内存泄漏与幽灵订阅导致的重复执行在 Zafiro 的组合容器如ShellViewModel管理多个 Section中子 ViewModel 的释放由容器统一驱动保持层级清晰。[!TIP] 凡是在构造函数或其他初始化阶段建立的订阅务必.DisposeWith(disposables)这是 Avalonia ReactiveUI 应用保持长期稳定运行的最重要习惯之一。五、与技能包其他环节的衔接viewmodels.md描述的是单元级实践而整个技能包SKILL.md给出了完整的配套方案建议组合使用命令与向导多步骤复杂流程用 WizardBuilder 与 SlimWizard 声明式定义步骤与导航规则NextUnit()、NextCommand()、WhenValid()、Always()其中的每个步骤 ViewModel 均遵循本文的响应式与命令规范导航与区块区块型 ViewModel 用[Section]特性注册、经 INavigator 与 IShellViewModel 切换其内部命令仍用IEnhancedCommand实现组合与映射ViewModel 依赖由 CompositionRoot ServiceCollection 注入View 映射交给DataTypeViewLocator与本文的响应式 ViewModel 无缝配合。六、小结与适用前提在 Avalonia Zafiro 应用中构建 ViewModel 的正确姿势可归纳为四句话继承ReactiveObject用[Reactive]源生成器声明属性用WhenAnyValueSelectToPropertyEx派生计算状态用ReactiveCommand.Create(FromTask)Enhance()生成带元数据、可执行性可控、错误统一上报的IEnhancedCommand所有订阅一律挂入CompositeDisposable随 ViewModel 释放。需要说明的适用前提与限制依据技能包 SKILL.md本模式面向使用ReactiveUI Zafiro 工具包的 Avalonia 项目纯命令式非响应式架构的项目需评估改造成本[Reactive]依赖ReactiveUI.SourceGenerators需在项目文件中启用源生成支持本文所述模式不能替代环境相关的验证与测试落地前应结合具体项目进行依赖注入、生命周期与异常路径的实测。参考实现可进一步研读仓库内 viewmodels.md 原文以及技能包中的 composition.md、wizards.md、navigation_sections.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点击查看免费下载相关推荐agentic-awesome-skills基于 Avalonia 与 Zafiro 的函数式响应式 MVVM 开发指南agentic awesome skills基于 Avalonia 与 Zafiro 的函数式响应式 MVVM 开发指南 本指南以仓库中的 avaloniaAI 技能AI 插件人工智能Avalonia 多步骤向导实战基于 Zafiro 与 ReactiveUI 的 SlimWizard 声明式流程构建指南Avalonia 多步骤向导实战基于 Zafiro 与 ReactiveUI 的 SlimWizard 声明式流程构建指南 复杂业务场景中的多步骤流程如创建AI 技能AI 插件人工智能Avalonia Zafiro 实战模式指南RefreshableCollection、集合校验与错误处理管线agentic-awesome-skills 技能库Avalonia Zafiro 实战模式指南RefreshableCollection、集合校验与错误处理管线agentic awesome skillAI 技能AI 插件人工智能上一篇electron-vue 项目文件结构实战指南渲染进程与主进程的目录组织与源码解读下一篇CANN ops-math 算子库 aclnnDropoutBackward 接口实战指南Dropout 反向传播在 NPU 上的掩码缩放实现创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考