avalonia-zafiro-development

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Avalonia Zafiro Development

Avalonia Zafiro 开发

This skill defines the mandatory conventions and behavioral rules for developing cross-platform applications with Avalonia UI and the Zafiro toolkit. These rules prioritize maintainability, correctness, and a functional-reactive approach.

本技能定义了使用Avalonia UI和Zafiro工具包开发跨平台应用的强制规范和行为准则。这些规则将可维护性、正确性和函数式响应式方法列为优先事项。

Core Pillars

核心支柱

Functional-Reactive MVVM: Pure MVVM logic using DynamicData and ReactiveUI.
Safety & Predictability: Explicit error handling with
```
Result
```
types and avoidance of exceptions for flow control.
Cross-Platform Excellence: Strictly Avalonia-independent ViewModels and composition-over-inheritance.
Zafiro First: Leverage existing Zafiro abstractions and helpers to avoid redundancy.

函数式响应式MVVM：使用DynamicData和ReactiveUI实现纯MVVM逻辑。
安全性与可预测性：使用
```
Result
```
类型进行显式错误处理，避免将异常用于流程控制。
跨平台卓越性：严格与Avalonia无关的ViewModel，以及组合优于继承的原则。
优先使用Zafiro：利用现有Zafiro抽象和辅助工具，避免冗余代码。

Guides

指南

Core Technical Skills & Architecture: Fundamental skills and architectural principles.
Naming & Coding Standards: Rules for naming, fields, and error handling.
Avalonia, Zafiro & Reactive Rules: Specific guidelines for UI, Zafiro integration, and DynamicData pipelines.
Zafiro Shortcuts: Concise mappings for common Rx/Zafiro operations.
Common Patterns: Advanced patterns like
```
RefreshableCollection
```
and Validation.

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

Procedure Before Writing Code

编写代码前的步骤

Search First: Search the codebase for similar implementations or existing Zafiro helpers.
Reusable Extensions: If a helper is missing, propose a new reusable extension method instead of inlining complex logic.
Reactive Pipelines: Ensure DynamicData operators are used instead of plain Rx where applicable.

先搜索：在代码库中搜索类似实现或现有Zafiro辅助工具。
可复用扩展：如果缺少辅助工具，建议编写新的可复用扩展方法，而非内联复杂逻辑。
响应式管道：在适用情况下，确保使用DynamicData操作符而非普通Rx操作。