avalonia-zafiro-development

Avalonia Zafiro 开发

此技能规定了使用 Avalonia UI 和 Zafiro 工具包开发跨平台应用程序时必须遵循的约定和行为规则。这些规则优先考虑可维护性、正确性和函数响应式方法。

核心支柱

1. 函数响应式 MVVM：使用 DynamicData 和 ReactiveUI 实现纯 MVVM 逻辑。
2. 安全性与可预测性：使用 Result 类型显式处理错误，避免将异常用于流程控制。
3. 卓越的跨平台能力：ViewModel 严格独立于 Avalonia，并优先采用组合而非继承。
4. Zafiro 优先：利用现有的 Zafiro 抽象和辅助方法，避免重复实现。

指南

• 核心技术技能与架构：基础技能和架构原则。
• 命名与编码标准：命名、字段和错误处理规则。
• Avalonia、Zafiro 与响应式规则：有关 UI、Zafiro 集成和 DynamicData 管道的具体指南。
• Zafiro 快捷操作：常见 Rx/Zafiro 操作的简明映射。
• 常见模式：RefreshableCollection 和验证等高级模式。

兼容性与验证

这些是项目／工具包约定，并非通用的 .NET 规则；请遵循实际代码库的要求以及固定版本的 Zafiro/ReactiveUI/DynamicData API。请验证快捷操作的语义（尤其是 null／空／空白之间的区别），不要假设表格中的操作等价。请验证集合预期的空集合／全部有效行为：筛选出有效项后检查集合非空，并不能证明每一项都有效。调整响应式示例时，请保留取消机制、UI 线程调度和释放资源的所有权。

编写代码前的步骤

1. 先搜索：在代码库中搜索类似实现或现有的 Zafiro 辅助方法。
2. 可复用扩展：如果缺少辅助方法，请提出新增可复用的扩展方法，而不是内联复杂逻辑。
3. 响应式管道：在适用时，确保使用 DynamicData 运算符，而非纯 Rx。

适用场景

此技能适用于执行概述中描述的工作流或操作。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为可替代特定环境验证、测试或专家审查的内容。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。