介绍
# Event Planner
通过搜索场地并生成包含 Google Maps 链接的行程来策划活动。
## 快速开始
策划一次夜出：
```bash uv run {baseDir}/scripts/plan_event.py "night out" \ --location "Times Square, NYC" \ --party-size 4 \ --budget medium \ --duration 4h ```
策划一个周末白天：
```bash uv run {baseDir}/scripts/plan_event.py "weekend day" \ --location "Central Park, NYC" \ --party-size 2 \ --budget "$100 per person" \ --preferences "outdoors, casual dining" ```
策划一个约会之夜：
```bash uv run {baseDir}/scripts/plan_event.py "date night" \ --location "SoHo, NYC" \ --budget high \ --duration 3h ```
## 活动类型
- **night-out**: 晚餐 + 1-2 个酒吧/休息室 (3-4 小时) - **weekend-day**: 早午餐/午餐 + 活动 + 晚餐 (6-8 小时) - **date-night**: 浪漫餐厅 + 甜点/饮品场所 (2-3 小时) - **team-event**: 团体活动 + 晚餐场地 (3-5 小时) - **lunch**: 单一餐厅推荐 - **dinner**: 单一餐厅推荐 - **trip**: 多日行程，包含每日计划
## 参数
- `--location`: 城市、地址或地标 (必需) - `--party-size`: 人数 (默认: 2) - `--budget`: "low/medium/high" 或 "$X per person" (默认: medium) - `--duration`: 可用时长 (例如: "3h", "full day") - `--preferences`: 逗号分隔 (例如: "vegetarian, outdoor seating, live music") - `--start-time`: 开始时间 (默认: 根据活动类型推断) - `--output`: text|json (默认: text) - `--date`: 目标日期，格式为 YYYY-MM-DD，用于特定日期的检查 (默认: 今天)
## 输出格式
**默认 (text)**: 包含时间线、场地详情、出行信息和 Google Maps 链接的 Markdown 行程
**JSON**: 包含所有场地详情、坐标和解析元数据的结构化数据
## 局限性
- **API 限制**: Google Places API 有使用配额 (请检查您的账单) - **实时数据**: 场地营业时间可能会变化；前往前请务必确认 - **预算估算**: 基于 Google 的价格等级 (0-4)，而非确切费用 - **出行时间**: 在可用时使用 Google Directions API；否则回退到基于距离的估算，并增加 30% 的缓冲时间 - **营业时间**: 没有经过验证的营业时间的场所将显示警告；请勿假设有空位 - **活动场地**: 文化中心、剧院和活动空间的营业时间可能会因排期活动而变化
## API 要求
活动策划器使用： - **Google Places API (New)**: 场地搜索所必需 - **Google Directions API**: 可选，但建议使用以获得准确的出行时间
如果在 Google Cloud Console 中已启用，这两个 API 可以使用同一个 `GOOGLE_PLACES_API_KEY`。
## 错误处理
- 无效位置 → 返回带有建议的错误 - 未找到场地 → 放宽过滤器并重试 - API 故障 → 使用指数退避重试 (3 次尝试)