A:初版

src/Sharp/Wpf/README.md

@@ -0,0 +1,113 @@
+Sharp.Wpf
+=========
+
+WPF 常用基础能力工具包，开箱即用：
+
+- 全局异常处理：统一捕获 UI/后台异常，弹窗与日志钩子
+- MVVM 基础：ViewModelBase、RelayCommand、AsyncCommand
+- Dispatcher 封装：IDispatcher/DispatcherService
+- 对话与文件对话：IDialogService、IFileDialogService
+- 常用转换器：Bool/NullOrEmpty 可见性、布尔取反、枚举描述
+- 附加行为：EventToCommand（事件转 ICommand）
+- 窗口工具：WindowPlacement（位置/大小/状态持久化）
+
+安装/引用
+---------
+
+- 作为仓库子项目引用：
+
+```xml
+<ItemGroup>
+  <ProjectReference Include="..\Wpf\Wpf.csproj" />
+</ItemGroup>
+```
+
+- 或通过 NuGet（计划发布）：`<PackageReference Include="Sharp.Wpf" Version="x.y.z" />`
+
+快速上手
+--------
+
+1) 在 App 启动注册全局异常处理
+
+```csharp
+using System.Windows;
+using Sharp.Wpf.Exceptions;
+
+public partial class App : Application
+{
+    protected override void OnStartup(StartupEventArgs e)
+    {
+        base.OnStartup(e);
+        new UiExceptionHandler().Register(new ExceptionHandlingOptions
+        {
+            ShowDialog = true,
+            DialogTitle = "应用程序错误"
+        });
+    }
+}
+```
+
+2) 在 XAML 启用窗口位置记忆、事件到命令、可见性转换器
+
+```xml
+<Window x:Class="Demo.MainWindow"
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:b="clr-namespace:Sharp.Wpf.Behaviors;assembly=Sharp.Wpf"
+        xmlns:w="clr-namespace:Sharp.Wpf.Windowing;assembly=Sharp.Wpf"
+        xmlns:conv="clr-namespace:Sharp.Wpf.Converters;assembly=Sharp.Wpf"
+        w:WindowPlacement.RememberPlacement="True"
+        w:WindowPlacement.PlacementId="MainWindow">
+  <Window.Resources>
+    <conv:BoolToVisibilityConverter x:Key="Bool2Vis" />
+  </Window.Resources>
+  <StackPanel>
+    <Button Content="点击弹窗"
+            b:EventToCommand.EventName="Click"
+            b:EventToCommand.Command="{Binding ShowDialogCommand}" />
+    <TextBlock Text="处理中..."
+               Visibility="{Binding IsBusy, Converter={StaticResource Bool2Vis}}"/>
+  </StackPanel>
+</Window>
+```
+
+3) ViewModel 使用命令与对话服务
+
+```csharp
+using System;
+using System.Threading.Tasks;
+using Sharp.Wpf.Commands;
+using Sharp.Wpf.Mvvm;
+using Sharp.Wpf.Services;
+
+public sealed class MainViewModel : ViewModelBase
+{
+    private readonly IDialogService _dialog = new DialogService();
+    public IAsyncCommand ShowDialogCommand { get; }
+
+    public MainViewModel()
+    {
+        ShowDialogCommand = new AsyncCommand(async () =>
+        {
+            try { IsBusy = true; await Task.Delay(300); await _dialog.ShowInfoAsync("Hello!"); }
+            finally { IsBusy = false; }
+        });
+    }
+}
+```
+
+4) 文件/文件夹对话
+
+```csharp
+var file = await new FileDialogService().OpenFileAsync("All Files|*.*");
+var folder = await new FileDialogService().SelectFolderAsync();
+```
+
+注意
+----
+
+- 需要 `UseWPF` 与 `net8.0-windows` 目标框架。
+- 本库同时启用 `UseWindowsForms` 以使用系统文件夹选择对话框。
+- 若要禁用全局异常弹窗，可在 `ExceptionHandlingOptions` 中设置 `ShowDialog = false` 并仅使用 `Log` 钩子记录。
+- `EventToCommand` 通过反射订阅事件，适用于大多数 Routed 事件；如需传递事件参数，可设置 `PassEventArgsToCommand="True"`。
+