# Goals and Background Context

### Goals

- 在 1 个月内完成 MVP，验证 PropertyGrid 和 UserGuide 的核心功能
- 建立基于 Semi Design 和苹果颜色系统的多主题框架，支持至少 2 种主题（浅色、暗色）和运行时切换
- 实现支持国际化扩展的架构，MVP 阶段默认使用一种语言，预留语言切换扩展点
- 完成 PropertyGrid 控件，支持常用属性类型（string, int, double, bool, enum, DateTime），实现自动 UI 生成、属性分组和基础验证
- 完成 UserGuide 系列控件，包括新手引导流程和增强 Tooltip，提升用户体验
- 确保架构设计考虑未来 AOT 编译支持，MVP 阶段允许使用反射
- 在开发过程中产出 5+ 个可复用的基础控件和工具类（TwoColumnLayout、Overlay、RichTooltip、ThemeManager 等）
- 为后续控件开发（LoggingControl、TextEditor 等）打下坚实基础

### Background Context

当前 Avalonia 生态主要聚焦于基础控件库（Button、TextBox 等），但真正加速开发的是**业务场景集成控件**（PropertyGrid、LoggingControl、UserGuide），这些在上位机和 AI 桌面应用场景中尤为关键。开发者被迫在每个项目中重复实现相似的复合控件，平均花费 30-50% 的时间在这些重复工作上。此外，许多现有库为了兼容旧版本（.NET Framework、Avalonia 0.x），牺牲了现代特性，AOT 支持不完善。

本项目旨在填补这一空白，采用**自顶向下开发策略**：先定义业务控件需求，再从中分解必要的基础控件。我们专注于上位机和 AI 桌面应用场景，基于 .NET 8+、Avalonia 11.x、ReactiveUI 和 Semi Design 样式系统，打造一套现代化、高度场景化的业务控件库。与传统控件库追求极致通用性不同，我们允许合理的取舍，优先满足目标场景的核心需求，确保开发效率和技术栈的前瞻性。

### Change Log

| Date       | Version | Description          | Author   |
|------------|---------|----------------------|----------|
| 2025-10-15 | 1.0     | Initial PRD creation | PM Agent |

---