活动策划师

通过搜索场地并生成附带谷歌地图链接的行程来策划活动。

快速开始

策划一次夜生活：

uv run {baseDir}/scripts/plan_event.py "night out" \
  --location "Times Square, NYC" \
  --party-size 4 \
  --budget medium \
  --duration 4h

策划一个周末日：

uv run {baseDir}/scripts/plan_event.py "weekend day" \
  --location "Central Park, NYC" \
  --party-size 2 \
  --budget "$100 per person" \
  --preferences "outdoors, casual dining"

策划一个约会之夜：

uv run {baseDir}/scripts/plan_event.py "date night" \
  --location "SoHo, NYC" \
  --budget high \
  --duration 3h

活动类型

• 夜生活：晚餐 + 1-2家酒吧/酒廊（3-4小时）
• 周末日：早午餐/午餐 + 活动 + 晚餐（6-8小时）
• 约会之夜：浪漫餐厅 + 甜品/饮品店（2-3小时）
• 团队活动：团体活动 + 晚餐场所（3-5小时）
• 午餐：单一餐厅推荐
• 晚餐：单一餐厅推荐
• 旅行：包含每日计划的多日行程

参数

• --location城市、地址或地标（必填）
• --party-size：人数（默认：2）
• --budget："低/中/高" 或 "每人 $X"（默认：中）
• --duration：可用时长（例如："3h"、"全天"）
• --preferences：以逗号分隔的偏好（例如："素食、户外座位、现场音乐"）
• --start-time：开始时间（默认：根据活动类型推断）
• --output：text|json（默认：text）
• --date：用于特定日期检查的目标日期，格式为 YYYY-MM-DD（默认：今天）

输出格式

默认（文本）：包含时间线、地点详情、交通信息和 Google 地图链接的 Markdown 行程

JSON：包含所有地点详情、坐标和解析后元数据的结构化数据

限制

• API限制：Google Places API有使用配额（请检查您的账单）
• 实时数据：场馆营业时间可能变动；前往前请务必确认
• 预算估算：基于Google的价格等级（0-4），非精确成本
• 行程时间：可用时使用Google Directions API；否则回退至基于距离的估算（含30%缓冲时间）
• 营业时间：未经验证营业时间的场所将显示警告；请勿假设其可用性
• 活动场馆：文化中心、剧院和活动场所的营业时间可能因预定活动而变动

API要求

活动规划器使用：

• Google Places API（新版）：场馆搜索必需
• Google Directions API：可选但建议用于获取精确行程时间

两个API可使用相同的GOOGLE_PLACES_API_KEY如果在Google Cloud Console中启用。

错误处理

• 无效位置 → 返回错误并提供建议
• 未找到场所 → 放宽筛选条件并重试
• API故障 → 采用指数退避策略重试（3次尝试）