Files
ui/docs/prd/next-steps.md
2025-10-15 23:40:13 +08:00

4.4 KiB
Raw Blame History

Next Steps

UX Expert Prompt

你好!我是 Penguin.AvaloniaUI 控件库的产品经理。我们刚刚完成了 MVP 的 PRD现在需要你的 UX 专业知识来完善用户体验设计。

**项目背景:**
- 目标:为上位机和 AI 桌面应用开发者提供业务场景控件库PropertyGrid、UserGuide 等)
- 技术栈Avalonia UI、.NET 8+、ReactiveUI、Semi Design 样式系统
- MVP 时间线1 个月4 周)
- MVP 范围:主题框架 + PropertyGrid + UserGuide

**你的任务:**
1. **审查 UI Design Goals 部分**(本文档中的"User Interface Design Goals"
   - 验证设计原则是否符合上位机和 AI 应用的用户习惯
   - 确认"信息密度优先"和"暗色模式友好"的设计方向

2. **补充关键用户流程图**可选MEDIUM 优先级)
   - "开发者配置 PropertyGrid"的完整流程
   - "用户使用 UserGuide 引导"的完整流程
   - "主题切换"的触发路径

3. **设计苹果颜色系统的具体色值**
   - 为浅色和暗色主题定义 Primary, Secondary, Success, Warning, Error, Background, Surface 等颜色的具体 HEX 值
   - 确保色彩对比度符合 4.5:1 要求
   - 参考Apple Human Interface Guidelines (https://developer.apple.com/design/human-interface-guidelines/color)

4. **评估 Semi.Avalonia 的可用性**(与 Architect 协作)
   - 检查 Semi Design 样式是否满足"紧凑布局"需求
   - 确认 Semi 的颜色系统能否与苹果颜色系统集成
   - 如果不可用,提出 Plan B自定义样式系统

**交付物:**
- 苹果颜色系统色值规范文档Markdown 或 Figma
- 可选2-3 个关键用户流程图
- Semi.Avalonia 可用性评估报告

**时间预估:** 2-3 天

请先阅读 docs/brief.md 和本 PRD了解项目的完整背景然后开始你的工作。如有疑问随时联系我

Architect Prompt

你好!我是 Penguin.AvaloniaUI 控件库的产品经理。我们刚刚完成了 MVP 的 PRD现在需要你设计技术架构为开发阶段提供清晰的实现蓝图。

**项目背景:**
- 目标:为上位机和 AI 桌面应用开发者提供业务场景控件库PropertyGrid、UserGuide 等)
- 技术栈Avalonia UI、.NET 8+、ReactiveUI、Semi Design 样式系统
- MVP 时间线1 个月4 周)
- MVP 范围:主题框架 + PropertyGrid + UserGuide

**你的任务:**
1. **审查 Technical Assumptions 部分**(本文档中的"Technical Assumptions"
   - 确认技术栈选择的合理性Monorepo、单体库、ReactiveUI
   - 验证依赖管理策略Semi.Avalonia、AOT 支持策略)

2. **设计核心架构**
   - 项目结构和命名空间组织Controls、Layouts、Themes、Utils
   - 主题系统的技术实现方案ResourceDictionary 动态加载)
   - PropertyGrid 的反射实现方案(平衡性能和可维护性)
   - UserGuide 的 Overlay 和步骤管理架构

3. **明确技术决策**
   - **国际化方案选择**Avalonia 内置 IResourceProvider vs 自定义 LocalizationManager
   - **PropertyGrid 反射策略**:直接反射 vs Fluent API 配置
   - **Semi.Avalonia 集成方案**:完全依赖 vs 部分使用 vs 自定义样式
   - **性能测量工具**:如何测量 60fps、100ms、200ms 等性能指标

4. **识别技术风险并提出缓解措施**
   - Semi.Avalonia 可用性风险(与 UX Expert 协作评估)
   - PropertyGrid 反射性能风险50 属性 < 200ms
   - ReactiveUI 学习曲线风险

5. **设计架构文档结构**
   - 高层架构图(项目结构、依赖关系)
   - 核心控件的类图PropertyGrid、UserGuide
   - 主题系统的序列图(主题切换流程)
   - 关键数据模型定义PropertyItem、GuideStep

**关键约束:**
- MVP 阶段允许使用反射AOT 支持是"架构考虑",不是硬性要求)
- 如果 Semi.Avalonia 不可用,允许放弃并自定义样式系统
- 测试策略:单元测试 + 手动测试(不需要 UI 自动化测试)

**交付物:**
- 架构设计文档docs/architecture.md
- 技术决策记录ADR
- (可选)核心控件的技术规格书

**时间预估:** 3-5 天

请先阅读 docs/brief.md 和本 PRD了解项目的完整背景和产品需求。优先完成 Semi.Avalonia 的评估Story 1.1 的前置任务),因为这会影响 Epic 1 的实现方案。如有疑问,随时联系我!

End of PRD