# Gift Advisor - AI礼物推荐专家

> **MVP版本完成！** 帮你解决送礼决策焦虑

## ✨ 功能特点

- 🎯 **智能推荐** - 根据关系、场合、预算推荐3-5个精选礼物
- 📝 **自然语言** - 支持自然语言输入，自动解析需求
- 🚫 **禁忌过滤** - 自动过滤不合适的礼物（送钟、送鞋等）
- 💬 **推荐理由** - 生成有说服力的推荐理由
- 🎉 **祝福语** - 根据场合生成祝福语

## 📦 MVP功能范围

**已实现**：
- ✅ 50个场景模板（父母、伴侣、朋友、长辈、孩子、商务）
- ✅ 自然语言解析
- ✅ 规则推荐引擎
- ✅ 禁忌过滤
- ✅ 推荐理由生成
- ✅ 祝福语模板

**未实现**（下一版）：
- ❌ 真实电商API（京东联盟、淘宝客）
- ❌ 价格比价
- ❌ 用户记忆银行
- ❌ 场景模拟

## 🚀 使用方法

### Python API

```python
from src.api import parse_and_recommend, recommend_gift

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

# 方式2：指定参数
result = recommend_gift(
    relation="女友",
    occasion="情人节",
    budget_min=300,
    budget_max=2000
)

# 输出示例
{
  "success": true,
  "recommendations": [
    {
      "name": "永生花盒",
      "price": 299,
      "reason": "永恒的爱；女友会被你的心意感动",
      "score": 95
    },
    ...
  ],
  "blessing": "情人节快乐！愿我们的爱情永远甜蜜！"
}
```

## 📊 场景覆盖

| 关系 | 场合 | 场景数 |
|------|------|--------|
| 父母 | 生日、母亲节、父亲节 | 6 |
| 伴侣 | 生日、情人节、纪念日 | 8 |
| 朋友 | 生日、节日、感谢 | 6 |
| 长辈 | 生日、节日 | 4 |
| 孩子 | 生日、学习 | 4 |
| 商务 | 客户、同事、领导 | 4 |
| 特殊 | 道歉、表白、乔迁 | 6 |
| 兴趣 | 运动、音乐、旅行 | 6 |

**总计**：50个场景，每个场景2-3个礼物推荐

## 🧪 测试

```bash
cd /root/.skillhub/gift-advisor
python3 -m pytest tests/ -v

# 结果：20 passed
```

## 📁 目录结构

```
gift-advisor/
├── SKILL.md              # 技能包说明
├── README.md             # 本文件
├── src/
│   ├── __init__.py
│   ├── api.py            # 主入口API
│   ├── recommender.py    # 推荐引擎
│   ├── parser.py         # 自然语言解析
│   ├── filter.py         # 禁忌过滤
│   ├── reason.py         # 推荐理由生成
│   ├── blessing.py       # 祝福语模板
│   ├── knowledge.py      # 知识库（50场景）
│   └── config.py         # 配置管理
├── tests/                # 测试文件
├── examples/             # 示例
├── assets/               # 资源文件
└── docs/                 # 文档
```

## 📝 开发日志

- **2026-03-30** - MVP版本完成
  - 10个核心模块
  - 50个场景模板
  - 20个测试用例全部通过

## 👤 作者

Shike (时刻爱生活)

## 📜 License

MIT
