# Gift-Advisor 测试用户指南

## 📅 测试信息
- **测试时间**：2026年4月1日 - 4月7日（7天）
- **测试版本**：Gift-Advisor 2.0.0 MVP
- **测试目标**：验证用户体验，收集反馈，改进产品
- **测试用户**：10位（你是第一批测试用户！）

## 🚀 快速开始

### 方式1：命令行测试（推荐）
```bash
# 进入项目目录
cd /path/to/gift-advisor

# 激活虚拟环境
source venv/bin/activate

# 运行测试工具
python scripts/test_cli.py
```

### 方式2：Python代码调用
```python
from src.api import parse_and_recommend, recommend_gift

# 自然语言输入
result = parse_and_recommend("送妈妈的生日礼物，预算500元左右")

# 指定参数输入
result = recommend_gift(
    relation="女友",
    occasion="情人节",
    budget_min=300,
    budget_max=2000,
    special_requirements="浪漫一点"
)
```

## 🎯 测试任务

### 基础测试（必做）
1. **注册与登录**（如果有Web界面）
2. **基础场景测试**：
   - 送妈妈生日礼物（预算500元）
   - 送女友情人节礼物（预算1000元）
   - 送同事离职礼物（预算200元）
3. **功能完整性测试**：
   - 自然语言输入
   - 参数指定输入
   - 推荐结果查看
   - 祝福语生成

### 进阶测试（选做）
1. **特殊场景测试**：
   - 商务送礼（送老板、客户）
   - 道歉礼物
   - 感谢礼物
   - 节日礼物（春节、中秋、圣诞）
2. **边界测试**：
   - 极低预算（50元以下）
   - 极高预算（5000元以上）
   - 特殊关系（老师、医生、邻居）
   - 特殊要求（环保、手工、高科技）

### 深度体验测试（加分）
1. **多次使用**：在不同时间、不同场景使用
2. **分享测试**：邀请一位朋友一起体验
3. **对比测试**：与现有礼物推荐工具对比

## 📋 测试场景示例

### 场景1：送妈妈生日礼物
- **输入**：`送妈妈的生日礼物，预算500元左右，要实用养生`
- **预期**：推荐3-5个实用养生类礼物
- **检查点**：
  - 推荐是否合理
  - 价格是否符合预算
  - 推荐理由是否充分
  - 是否有养生相关推荐

### 场景2：送女友情人节礼物
- **输入**：`给女朋友的情人节礼物，预算1000元，要浪漫有纪念意义`
- **预期**：推荐3-5个浪漫有纪念意义的礼物
- **检查点**：
  - 是否浪漫主题
  - 是否有纪念意义
  - 价格范围是否合适
  - 推荐创意如何

### 场景3：送同事离职礼物
- **输入**：`同事离职送什么礼物好，预算200元，要有意义`
- **预期**：推荐3-5个有意义的商务礼物
- **检查点**：
  - 是否适合商务关系
  - 是否有纪念意义
  - 价格是否适中
  - 是否避免尴尬礼物

## 📊 数据记录

### 使用日志
请记录每次使用的情况：
```
日期: 2026-04-01 10:30
场景: 送妈妈生日礼物
输入: 送妈妈的生日礼物，预算500元
推荐数量: 5个
满意度: 4/5分
问题: 第3个推荐不太合适
建议: 增加更多养生类礼物
```

### 性能记录
- **响应时间**：从输入到出结果的时间
- **推荐质量**：1-5分评分
- **易用性**：1-5分评分
- **创意性**：1-5分评分

## 🐛 问题反馈

### 反馈方式
1. **直接反馈**：通过微信/邮件直接告诉我们
2. **问卷反馈**：填写在线问卷
3. **文档记录**：记录在测试文档中

### 反馈内容
请包括以下信息：
1. **问题描述**：具体发生了什么问题
2. **复现步骤**：如何重现这个问题
3. **预期结果**：你期望看到什么
4. **实际结果**：实际看到了什么
5. **截图/日志**：如果有的话
6. **建议改进**：你的改进建议

### 问题分类
- 🐛 **Bug**：功能不正常，报错等
- 💡 **功能建议**：希望增加的功能
- 🎨 **体验优化**：使用体验改进建议
- 📈 **性能问题**：响应慢，卡顿等
- 🔧 **兼容性问题**：特定环境下的问题

## 📝 测试问卷

### 基本信息
1. **姓名**：（可选）
2. **测试时间段**：4月__日 - 4月__日
3. **总测试次数**：约__次

### 使用体验（1-5分）
1. **易用性**：工具是否容易上手？
2. **响应速度**：推荐生成是否快速？
3. **界面友好**：界面是否清晰易懂？
4. **功能完整**：功能是否满足需求？
5. **推荐质量**：推荐的礼物是否合适？

### 推荐质量评估
1. **最满意的推荐**：哪个推荐让你最满意？为什么？
2. **最不满意的推荐**：哪个推荐最不合适？为什么？
3. **创意评分**：推荐是否有创意？1-5分
4. **实用性评分**：推荐是否实用？1-5分
5. **准确性评分**：是否符合你的需求？1-5分

### 商业价值评估
1. **愿意付费吗**：如果这是付费工具，你愿意支付多少钱？
2. **使用频率**：你预计会多久使用一次？
3. **推荐给朋友**：你会推荐给朋友吗？为什么？
4. **核心价值**：这个工具对你最大的价值是什么？
5. **改进优先级**：你最希望改进哪些方面？

### 开放性问题
1. **整体感受**：用一句话描述你的测试体验
2. **最大亮点**：你最喜欢这个工具的哪个方面？
3. **最大痛点**：你最不满意哪个方面？
4. **未来期待**：你希望这个工具未来能做什么？
5. **其他建议**：任何其他建议或想法

## 🎁 测试奖励

### 参与奖励
所有完成测试的用户将获得：
1. **优先体验权**：未来新功能的优先体验资格
2. **特别感谢**：在项目文档中特别感谢
3. **优惠权益**：未来付费版本的优惠折扣

### 优秀反馈奖励
提供有价值反馈的用户将获得：
1. **Beta测试资格**：参与下一阶段测试
2. **产品顾问**：有机会成为产品顾问
3. **特别礼物**：神秘小礼物一份

## 🔧 技术支持

### 常见问题
1. **无法运行**：确保Python版本为3.8+
2. **依赖问题**：运行`pip install -r requirements.txt`
3. **报错处理**：记录错误信息并反馈给我们
4. **使用疑问**：查看本指南或直接询问

### 联系方式
- **技术支持**：微信/电话 [等待填写]
- **反馈邮箱**：gift-advisor-feedback@example.com
- **紧急问题**：直接联系项目负责人

### 工作时间
- **技术支持**：工作日 9:00-18:00
- **紧急支持**：24小时响应（严重问题）
- **反馈处理**：24小时内回复

## 📈 测试进度跟踪

### 每日任务
- **第一天**（4月1日）：基础功能测试
- **第二天**（4月2日）：进阶场景测试
- **第三天**（4月3日）：深度体验测试
- **第四天**（4月4日）：对比测试
- **第五天**（4月5日）：问题复现测试
- **第六天**（4月6日）：最终体验测试
- **第七天**（4月7日）：反馈整理

### 里程碑
- ✅ **4月1日**：测试启动，基础功能验证
- ⏳ **4月3日**：中期检查，收集初步反馈
- ⏳ **4月5日**：深度体验，问题修复验证
- ⏳ **4月7日**：测试结束，整理最终报告

## 💪 测试承诺

### 我们的承诺
1. **认真对待反馈**：每一条反馈都会认真分析
2. **及时响应**：24小时内回复问题
3. **持续改进**：根据反馈不断优化产品
4. **保护隐私**：严格保护测试用户隐私

### 你的承诺
1. **认真测试**：按照指南完成测试任务
2. **诚实反馈**：提供真实的使用感受
3. **及时沟通**：遇到问题及时反馈
4. **遵守约定**：遵守测试时间安排

## 🎉 感谢参与！

感谢你成为Gift-Advisor的第一批测试用户！
你的反馈对我们至关重要，将直接影响产品的未来发展。

**让我们一起打造更好的礼物推荐工具！** 🎁