# 使用示例

## 示例1：初始化数据

首次使用技能时，需要初始化数据文件：

```bash
# 进入技能目录
cd ~/.openclaw/workspace/skills/food-expiry-reminder

# 运行初始化脚本
python scripts/init_data.py
```

输出：
```
✅ 已创建数据文件: /path/to/skills/food-expiry-reminder/data/food_data.json
📁 数据目录: /path/to/skills/food-expiry-reminder/data
```

## 示例2：添加食品

### 添加牛奶
```bash
python scripts/add_food.py "牛奶" "2024-03-01" 7 "冰箱" 2 "全脂牛奶"
```

输出：
```
✅ 已添加食品: 牛奶
  生产日期: 2024-03-01
  保质期: 7天
  过期日期: 2024-03-08
  存放位置: 冰箱
  数量: 2
  备注: 全脂牛奶
```

### 添加鸡蛋
```bash
python scripts/add_food.py "鸡蛋" "2024-02-28" 30 "冰箱" 12 "有机鸡蛋"
```

### 添加面包
```bash
python scripts/add_food.py "面包" "2024-03-03" 5 "pantry" 1 ""
```

### 添加冷冻蔬菜
```bash
python scripts/add_food.py "冷冻蔬菜" "2024-01-15" 180 "冷冻室" 3 "混合蔬菜"
```

## 示例3：列出所有食品

```bash
python scripts/list_foods.py
```

输出示例：
```
================================================================================
📋 所有食品清单
================================================================================

1. 牛奶 (2个) 🟡 即将过期
   ID: a1b2c3d4
   生产日期: 2024-03-01
   保质期: 7 天
   过期日期: 2024-03-08
   剩余天数: 4 天
   存放位置: 冰箱
   备注: 全脂牛奶
   添加时间: 2024-03-04

2. 面包 (1个) 🔴 已过期
   ID: b2c3d4e5
   生产日期: 2024-03-03
   保质期: 5 天
   过期日期: 2024-03-08
   已过期: 1 天
   存放位置: pantry
   添加时间: 2024-03-04

3. 鸡蛋 (12个) 🟢 安全
   ID: c3d4e5f6
   生产日期: 2024-02-28
   保质期: 30 天
   过期日期: 2024-03-29
   剩余天数: 25 天
   存放位置: 冰箱
   备注: 有机鸡蛋
   添加时间: 2024-03-04

4. 冷冻蔬菜 (3个) 🟢 安全
   ID: d4e5f6g7
   生产日期: 2024-01-15
   保质期: 180 天
   过期日期: 2024-07-13
   剩余天数: 131 天
   存放位置: 冷冻室
   备注: 混合蔬菜
   添加时间: 2024-03-04

================================================================================
📊 统计信息:
   食品总数: 4 种
   🔴 已过期: 1 种
   🟡 一周内过期: 1 种
   🟠 两周内过期: 0 种
   🟢 安全: 2 种

💡 提示:
   使用 'python check_expiry.py' 检查过期状态
   使用 'python get_reminders.py' 获取提醒
   使用 'python add_food.py' 添加新食品
================================================================================
```

## 示例4：检查过期状态

```bash
python scripts/check_expiry.py
```

输出示例：
```
============================================================
📊 食品过期状态检查
📅 检查日期: 2024-03-04
============================================================

🔴 已过期的食品:
   • 面包 (1个) - 过期 1 天
     位置: pantry, 过期日期: 2024-03-08

🟡 一周内将过期的食品:
   • 牛奶 (2个) - 4 天后过期
     位置: 冰箱, 过期日期: 2024-03-08

🟢 安全的食品 (两周后过期):
   • 鸡蛋 (12个) - 25 天后过期
     位置: 冰箱
   • 冷冻蔬菜 (3个) - 131 天后过期
     位置: 冷冻室

============================================================
📈 统计信息:
   总计食品: 4 种
   已过期: 1 种
   一周内过期: 1 种
   两周内过期: 0 种
   安全: 2 种
============================================================

🔔 提醒:
   • 有 1 种食品已过期，请立即处理！
   • 有 1 种食品一周内将过期，请优先食用！
```

## 示例5：获取一周内过期提醒

```bash
python scripts/get_reminders.py
```

输出示例：
```
============================================================
🔔 一周内将过期的食品提醒
============================================================

⚠️  发现 1 种食品一周内将过期：

📌 牛奶 (2个)
   4 天后过期 - 过期日期: 2024-03-08
   存放位置: 冰箱
   备注: 全脂牛奶

💡 建议:
   1. 优先食用这些即将过期的食品
   2. 检查是否可以冷冻保存延长保质期
   3. 考虑分享给家人朋友
   4. 如果已变质，请及时丢弃

============================================================
📅 检查时间: 2024-03-04 11:30:00
============================================================
```

## 示例6：手动编辑数据文件

如果需要批量添加或修改数据，可以直接编辑`data/food_data.json`文件：

```json
{
  "foods": [
    {
      "id": "manual001",
      "name": "酸奶",
      "production_date": "2024-03-03",
      "expiry_days": 14,
      "expiry_date": "2024-03-17",
      "location": "冰箱",
      "quantity": 4,
      "notes": "希腊酸奶",
      "created_at": "2024-03-04T12:00:00",
      "updated_at": "2024-03-04T12:00:00"
    }
  ],
  "created_at": "2024-03-04T09:00:00",
  "updated_at": "2024-03-04T12:00:00"
}
```

## 示例7：设置定时提醒

可以设置cron任务每天自动检查：

```bash
# 编辑crontab
crontab -e

# 添加以下行（每天上午9点检查）
0 9 * * * cd /path/to/skills/food-expiry-reminder && python scripts/get_reminders.py
```

## 示例8：结合OpenClaw使用

在OpenClaw中，可以创建快捷命令：

```bash
# 创建别名
alias food-check='cd ~/.openclaw/workspace/skills/food-expiry-reminder && python scripts/check_expiry.py'
alias food-list='cd ~/.openclaw/workspace/skills/food-expiry-reminder && python scripts/list_foods.py'
alias food-remind='cd ~/.openclaw/workspace/skills/food-expiry-reminder && python scripts/get_reminders.py'

# 使用别名
food-check
food-list
food-remind
```