添加安装验证清单,更新安装指南使用 npx 命令
This commit is contained in:
parent
792bfc8a09
commit
1dc15a9719
|
|
@ -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 版本
|
||||
- 错误信息截图
|
||||
- 文件结构截图
|
||||
|
||||
---
|
||||
|
||||
**验证日期:** ___________
|
||||
**验证人:** ___________
|
||||
**结果:** ☐ 通过 ☐ 失败
|
||||
Loading…
Reference in New Issue