birdbuddy

查询您的 Bird Buddy 智能喂鸟器 - 检查状态、电池、食物水平，并通过物种识别查看最近的鸟类访客。

# Bird Buddy Skill

Query your Bird Buddy smart bird feeder. Check feeder status, see recent bird visitors with species names, and fetch sighting photos.

## Requirements
- `pybirdbuddy` Python package: `pip install pybirdbuddy`
- `BIRDBUDDY_EMAIL` and `BIRDBUDDY_PASSWORD` environment variables (email/password login only — Google SSO not supported)

## Commands

### Check feeder status (battery, food, signal)
```bash
python3 {skillDir}/run.py status
```

### Get recent bird sightings with species names
```bash
python3 {skillDir}/run.py recent [hours=24] [limit=5]
```

### Get raw postcard feed
```bash
python3 {skillDir}/run.py feed [hours=24]
```

### Get full details and photo URLs for a specific postcard
```bash
python3 {skillDir}/run.py sighting <postcard_id>
```

## Example agent interactions
- "What birds visited my feeder today?" → `recent 24 10`
- "How is my Bird Buddy doing?" → `status`
- "Show me photos from the last visit" → `recent 24 1` then `sighting <id>`
- "What was the last bird at my feeder?" → `recent 1 1`

---

## 中文说明

# Bird Buddy 技能

查询您的 Bird Buddy 智能喂鸟器。检查喂鸟器状态，查看附带物种名称的最近鸟类访客，并获取目击照片。

## 要求
- `pybirdbuddy` Python 软件包：`pip install pybirdbuddy`
- `BIRDBUDDY_EMAIL` 和 `BIRDBUDDY_PASSWORD` 环境变量（仅支持邮箱/密码登录——不支持 Google SSO）

## 命令

### 检查喂鸟器状态（电池、食物、信号）
```bash
python3 {skillDir}/run.py status
```

### 获取附带物种名称的最近鸟类目击
```bash
python3 {skillDir}/run.py recent [hours=24] [limit=5]
```

### 获取原始明信片信息流
```bash
python3 {skillDir}/run.py feed [hours=24]
```

### 获取特定明信片的完整详情和照片 URL
```bash
python3 {skillDir}/run.py sighting <postcard_id>
```

## 代理交互示例
- "今天有哪些鸟来我的喂鸟器了？" → `recent 24 10`
- "我的 Bird Buddy 状态如何？" → `status`
- "给我看上次访客的照片" → `recent 24 1` 然后 `sighting <id>`
- "我喂鸟器上最后一只鸟是什么？" → `recent 1 1`