# UI/UX Pro Max 安装验证清单

## ✅ 文件检查

运行以下命令验证文件是否存在：

### Windows PowerShell
```powershell
# 检查 Kiro 配置
Test-Path .kiro/steering/ui-ux-pro-max.md

# 检查共享数据库
Test-Path .shared/ui-ux-pro-max

# 检查搜索脚本
Test-Path .shared/ui-ux-pro-max/scripts/search.py

# 列出数据文件
Get-ChildItem .shared/ui-ux-pro-max/data -Filter "*.csv"
```

### macOS/Linux
```bash
# 检查 Kiro 配置
ls .kiro/steering/ui-ux-pro-max.md

# 检查共享数据库
ls .shared/ui-ux-pro-max

# 检查搜索脚本
ls .shared/ui-ux-pro-max/scripts/search.py

# 列出数据文件
ls .shared/ui-ux-pro-max/data/*.csv
```

## ✅ 功能测试

### 1. 测试 Python 搜索脚本

```bash
# 搜索 SaaS 产品推荐
python .shared/ui-ux-pro-max/scripts/search.py "SaaS" --domain product

# 搜索玻璃态风格
python .shared/ui-ux-pro-max/scripts/search.py "glassmorphism" --domain style

# 搜索配色方案
python .shared/ui-ux-pro-max/scripts/search.py "healthcare" --domain color
```

**预期结果：** 应该看到搜索结果，包含设计推荐、颜色、风格等信息。

### 2. 测试 Kiro 集成

在 Kiro 聊天窗口中输入以下任一命令：

```
为我的 SaaS 产品设计一个落地页
```

```
创建一个医疗分析仪表板
```

```
设计一个电商网站首页，使用玻璃态风格
```

**预期结果：**
1. Kiro 会自动运行搜索命令
2. 显示找到的设计风格、配色方案
3. 生成包含专业 UI 的 HTML 代码
4. 代码包含：
   - Tailwind CSS
   - 响应式设计
   - 专业配色
   - 合适的字体
   - 无障碍支持

## ✅ 安装成功的标志

### 必须满足的条件

- [ ] `.kiro/steering/ui-ux-pro-max.md` 文件存在
- [ ] `.shared/ui-ux-pro-max/` 目录存在
- [ ] `.shared/ui-ux-pro-max/scripts/search.py` 可执行
- [ ] `.shared/ui-ux-pro-max/data/` 包含至少 9 个 CSV 文件
- [ ] Python 搜索命令能返回结果
- [ ] Kiro 能识别并使用该技能

### 数据文件清单

应该包含以下 CSV 文件：

1. `products.csv` - 产品类型推荐
2. `styles.csv` - UI 风格
3. `colors.csv` - 配色方案
4. `typography.csv` - 字体配对
5. `landing.csv` - 落地页结构
6. `charts.csv` - 图表类型
7. `ux.csv` - UX 指南
8. `prompts.csv` - AI 提示
9. `stacks/*.csv` - 技术栈指南

## 🔧 故障排除

### 问题 1：Python 命令失败

**症状：**
```
'python' 不是内部或外部命令
```

**解决：**
1. 安装 Python 3.x
2. 确保 Python 在系统 PATH 中
3. 尝试使用 `python3` 代替 `python`

### 问题 2：Kiro 未识别技能

**症状：** Kiro 不使用设计数据库，生成的 UI 不专业

**解决：**
1. 确认文件位置正确
2. 重启 Kiro
3. 重新加载工作区
4. 检查 `.kiro/steering/ui-ux-pro-max.md` 文件内容是否完整

### 问题 3：搜索无结果

**症状：** 搜索脚本运行但返回 0 结果

**解决：**
1. 检查 `.shared/ui-ux-pro-max/data/` 目录是否有 CSV 文件
2. 尝试不同的关键词
3. 检查 CSV 文件是否损坏

## 📞 获取帮助

如果以上检查都通过但仍有问题：

1. 查看 Gitea 仓库的 Issues
2. 联系项目负责人：zhiming
3. 提供以下信息：
   - 操作系统版本
   - Python 版本
   - 错误信息截图
   - 文件结构截图

---

**验证日期：** ___________  
**验证人：** ___________  
**结果：** ☐ 通过 ☐ 失败
