Event Planner

核心用法

Event Planner 是一款基于 Google Places API 的自动化活动策划工具，专为聚会、约会、团建、旅行等场景设计。用户只需指定活动类型、地点、人数、预算和偏好，即可快速生成包含详细时间线的完整行程方案。

关键功能：

• 支持7种预设活动类型（夜生活、周末游、约会、团建、单餐、多日旅行）
• 智能匹配场地：根据人数、预算、偏好自动筛选餐厅、酒吧、娱乐场所
• 自动生成 itinerary：包含精确时间安排、场地详情、预估交通时间
• 一键导航：集成 Google Maps 链接
• 双输出模式：友好文本或结构化 JSON

显著优点

1. 省时高效：将原本需要数十分钟的场地调研压缩至秒级响应
2. 数据权威：依托 Google Places 的海量商户数据库，覆盖全球主要城市
3. 灵活定制：支持预算分级（低/中/高）、特殊偏好（素食、户外座位、现场音乐等）、精确时长控制
4. 容错设计：无结果时自动放宽条件重试，API 失败时指数退避重试
5. 开发者友好：纯命令行工具，uv 一键运行，JSON 输出便于集成

潜在局限

• API 成本依赖：Google Places API 有调用配额和计费，高频使用需关注账单
• 数据时效性：商户营业时间、价格信息可能滞后，需出发前二次确认
• 预算估算粗糙：仅基于 Google 价格等级（0-4 档），非真实消费金额
• 交通时间不确定：无 Directions API 时采用距离估算+30%缓冲，大城市拥堵场景误差较大
• 文化活动盲区：剧院、展览馆等活动型场地的时间依赖具体排期，工具无法感知

适合人群

• 城市居民：快速规划周末约会、朋友聚餐、生日派对
• 商务人士：紧急安排客户接待、团队建设活动
• 游客：陌生城市行程规划，减少决策疲劳
• 开发者：作为活动推荐模块集成至自己的应用

常规风险

• 隐私泄露：位置搜索、人数、预算等偏好数据发送至 Google API
• 计划依赖风险：过度信任 AI 推荐而未人工确认，可能导致场地关闭、预订失败等尴尬
• API 密钥管理：GOOGLE_PLACES_API_KEY 需妥善保管，避免硬编码泄露

核心用法

Event Planner 是一款面向本地生活场景的 AI 活动规划 Skill，通过 Google Places API 实现场所搜索与行程编排。用户仅需提供事件类型、地点、人数、预算等基础参数，即可自动生成包含时间轴、 venue 详情、交通导航的完整 Markdown 行程单。

典型调用场景：

• 个人约会规划（date night）：浪漫餐厅 + 甜点/酒吧组合
• 多人聚餐（night out）：晚餐 + 1-2 家酒吧/酒廊
• 团队建设（team event）：团体活动场地 + 聚餐
• 周末出游（weekend day）：早午餐 + 活动 + 晚餐全天规划
• 短途旅行（trip）：多日跨城行程编排

关键参数设计：支持弹性预算表达（low/medium/high 或 $X per person）、偏好标签（vegetarian, outdoor seating, live music）、起止时间自定义，输出可选文本或 JSON 结构化数据。

显著优点

1. 零配置启动：通过 uv 单命令运行，无需复杂环境搭建
2. 智能行程编排：内置时间预算算法，自动计算场地间移动时长并预留缓冲
3. 多源数据融合：整合 Google Places API（场所信息）与 Directions API（路线规划），提供一站式决策支持
4. 透明成本预估：基于 Google 价格等级（0-4）的预算分级，避免超支风险
5. 容错机制完善：无结果时自动放宽筛选条件，API 故障时指数退避重试（3 次）

潜在局限

• API 依赖与成本：需自行申请 Google Cloud API Key，调用产生费用；免费额度有限，高频使用需监控账单
• 数据实时性：营业时间、价格可能滞后，需出发前二次确认
• 预算精度不足：Google 价格等级为区间估算，实际消费可能偏差
• 交通时间估算：无 Directions API 时采用距离估算 + 30% 缓冲，高峰期误差较大
• 场所覆盖盲区：小众文化场馆、活动型空间（剧院、展览中心）营业时间受具体排期影响，系统提示可能不准确

适合人群

• 都市年轻白领：快速规划下班后聚会、周末约会
• 行政/HR 人员：组织团队聚餐、团建活动
• 旅行者：陌生城市短期行程快速搭建
• 懒人规划者：不愿逐个比价、查营业时间，追求「一键生成」效率

常规风险

1. 隐私数据外传：搜索关键词、精确位置坐标发送至 Google 服务器，虽经 TLS 1.3 加密，但地理位置仍属敏感信息
2. API Key 管理：环境变量配置不当可能导致密钥泄露；建议配合最小权限原则配置 Cloud 项目
3. 消费失控风险：Places API 按请求计费，大规模批量规划可能产生意外费用
4. 信息过时导致行程失败：依赖线上数据而未人工确认，可能出现「到店发现装修/停业」的尴尬场景

---

安全评估：代码无危险函数、无注入漏洞，API Key 通过环境变量安全读取，HTTPS 传输加密，依赖单一且无 CVE。整体风险可控，属日常生产力工具级 Skill。