本工具是 .NET MAUI 自定义处理器的使用指南，主要面向需要在共享代码中调整原生控件行为的开发者。
用途与决策：若只需改变内置控件在某一平台的外观或行为，应选择定制现有处理器，使用 AppendToMapping 或 PrependToMapping；若改动只针对部分控件实例，可先继承控件再在映射器中做类型判断；若需要全新的跨平台控件并提供原生支持，则创建新处理器，使用 partial class 分平台实现。
主要能力与注意点：指南强调优先使用 AppendToMapping 而非 ModifyMapping，后者会整体替换默认映射逻辑，未来框架新增行为会被静默丢弃。映射器定制是全局的，会影响该控件的所有实例，因此实例级差异需靠子类 + 类型检查守卫。原生事件订阅必须在 HandlerChanging 中取消订阅，否则原生视图生命周期长于托管包装器会造成内存泄漏。共享处理器文件与各平台分部类的命名空间和类名必须完全一致，否则会静默生成不同类。PlatformView 的条件 using 别名要放在共享文件顶部，以便 ViewHandler<TControl, TPlatformView> 泛型按平台正确解析。每个平台分部都必须重写 CreatePlatformView()，缺失会报指向基类的编译错误。
映射器选择：PropertyMapper 用于把可绑定属性同步到原生视图，属性值变化时运行；CommandMapper 用于控件到处理器的即发即忘动作，每次调用只运行一次且无返回值；属性同步逻辑不应放入 CommandMapper，否则属性变化时不会重跑，原生视图会过期。新处理器还需在 MauiProgram.cs 中通过 ConfigureMauiHandlers 注册。
适用场景：需要精细控制 MAUI 控件在各平台上的原生呈现与交互时使用。限制方面，资料未涉及收费、价格或平台覆盖范围等信息，暂未提供。