Avalonia Zafiro 开发

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 和验证（Validation）。

编写代码前的流程

1. 先搜索：在代码库中搜索类似的实现或现有的 Zafiro 辅助类。
2. 可复用扩展：如果缺少辅助类，应提议一个新的可复用扩展方法，而不是将复杂逻辑内联。
3. 响应式流水线：确保在适用场景下使用 DynamicData 运算符而非纯 Rx。

使用场景

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

局限性

• 仅在任务明确符合上述范围时使用此技能。

• 不要将输出结果视为环境特定验证、测试或专家评审的替代方案。

• 如果缺少必要的输入、权限、安全边界或成功标准，请停止并请求澄清。