diff --git a/安装验证清单.md b/安装验证清单.md new file mode 100644 index 0000000..5907712 --- /dev/null +++ b/安装验证清单.md @@ -0,0 +1,155 @@ +# 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 版本 + - 错误信息截图 + - 文件结构截图 + +--- + +**验证日期:** ___________ +**验证人:** ___________ +**结果:** ☐ 通过 ☐ 失败