156 lines
3.3 KiB
Markdown
156 lines
3.3 KiB
Markdown
# 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 版本
|
||
- 错误信息截图
|
||
- 文件结构截图
|
||
|
||
---
|
||
|
||
**验证日期：** ___________
|
||
**验证人：** ___________
|
||
**结果：** ☐ 通过 ☐ 失败
|