docs: 完善 README.md，添加项目结构和快速开始指南；新增质量门决策文件；更新故事状态为完成

README.md

@@ -0,0 +1,88 @@
+# Penguin.AvaloniaUI
+
+一个现代化的跨平台 UI 控件库，专为 Avalonia 应用程序设计，提供业务场景控件和响应式 MVVM 支持。
+
+## 技术栈
+
+| 技术 | 版本 | 用途 |
+|-----------|---------|---------|
+| .NET | 9.0 | 应用运行时环境 |
+| Avalonia | 11.3.7 | 跨平台桌面 UI 框架 |
+| ReactiveUI.Avalonia | 11.3.0 | 响应式 MVVM 实现 |
+| Semi.Avalonia | 11.2.1.9 | 现代化设计主题 |
+| xUnit | 2.6.6 | 单元测试框架 |
+
+## 样式系统决策
+
+- **日期**: 2025-10-16
+- **决策**: 使用 Semi.Avalonia
+- **理由**: Semi.Avalonia 在 NuGet 上可直接获取（版本 11.2.1.9），集成简单（只需添加 xmlns 和主题引用），提供了基于 Semi Design 的现代化设计系统。评估和集成耗时不到 10 分钟，符合我们的效率要求。
+
+## 项目结构
+
+```
+D:\32_avalonia.ui/
+├── src/
+│   ├── Penguin.AvaloniaUI/              # 核心控件库
+│   │   ├── Controls/                     # 业务场景控件
+│   │   ├── Layouts/                      # 布局控件
+│   │   ├── Themes/                       # 主题系统
+│   │   └── Utils/                        # 工具类
+│   │
+│   ├── Example/                          # 示例应用
+│   │   ├── Views/                        # 视图/窗口
+│   │   ├── ViewModels/                   # 视图模型
+│   │   └── Models/                       # 测试数据模型
+│   │
+│   └── Penguin.AvaloniaUI.Tests/        # 单元测试
+│       ├── Controls/
+│       ├── Layouts/
+│       ├── Themes/
+│       └── Utils/
+├── docs/                                 # 项目文档
+├── Directory.Packages.props              # 统一包版本管理
+└── Penguin.AvaloniaUI.sln               # 解决方案文件
+```
+
+## 快速开始
+
+### 先决条件
+
+- .NET 9.0 SDK 或更高版本
+- Windows、macOS 或 Linux
+
+### 构建
+
+```bash
+# 恢复包
+dotnet restore
+
+# 编译所有项目
+dotnet build
+
+# 运行测试
+dotnet test
+
+# 运行示例应用
+dotnet run --project src/Example/Example.csproj
+```
+
+### 开发
+
+项目使用 Central Package Management（统一包版本管理）。所有包版本在 `Directory.Packages.props` 中定义。在项目文件中添加新包时，不要指定版本号：
+
+```xml
+<ItemGroup>
+  <PackageReference Include="PackageName" />
+</ItemGroup>
+```
+
+代码格式通过 `.editorconfig` 强制执行。运行格式检查：
+
+```bash
+dotnet format --verify-no-changes
+```
+
+## 许可证
+
+详情请参阅 [LICENSE](LICENSE) 文件。