event-planner

核心用法

Event Planner 是一款面向社交场景的智能行程规划工具，用户只需通过命令行指定活动类型、地点、人数、预算和偏好，即可自动生成包含时间安排、场地详情和 Google Maps 导航链接的完整行程。支持 night-out（夜生活）、weekend-day（周末一日游）、date-night（约会夜）、team-event（团队活动）、lunch/dinner（单餐推荐）及 trip（多日行程）六大场景，输出格式可选 Markdown 文本或结构化 JSON。

显著优点

1. 零配置上手：基于 uv 运行时，单条命令即可完成环境准备与执行，无需复杂依赖管理。
2. 智能场景模板：内置不同活动类型的默认时长与流程模板（如约会夜自动匹配浪漫餐厅+甜品店），大幅降低决策成本。
3. 实时数据驱动：直接调用 Google Places API 获取最新场地信息、评分与营业时间，避免信息过时。
4. 多维度个性化：支持预算分级（low/medium/high 或具体金额）、人数规模、饮食偏好、户外需求等精细筛选。
5. 端到端体验：自动生成含交通时间的 timeline 和一键导航链接，实现从规划到出行的无缝衔接。

潜在缺点与局限性

• API 成本依赖：Google Places API 存在调用配额与计费门槛，高频使用需关注账单。
• 数据时效性：场地营业时间可能临时变更，工具虽标注警告但无法保证实时准确性。
• 预算估算粗糙：基于 Google 价格等级（0-4 美元符号）而非实际菜单价格，可能与真实消费存在偏差。
• 交通时间近似：未启用 Directions API 时采用距离估算+30% 缓冲，复杂城市交通场景误差较大。
• 文化场所盲区：剧院、展览中心等场地营业时间高度依赖具体排期，自动推荐可能失效。

适合的目标群体

• 都市社交活跃者：频繁组织朋友聚会、约会或团队活动，希望快速获得靠谱方案。
• 差旅/旅行规划者：需要为陌生城市生成结构化行程，减少前期调研时间。
• 行政/运营人员：负责公司团建、客户接待等活动策划，追求效率与专业度平衡。
• 开发者/技术爱好者：偏好命令行工具，希望将行程生成集成到自动化工作流。

使用风险

• 网络稳定性：API 调用失败时虽有 3 次指数退避重试，但极端网络环境下仍可能中断。
• 密钥管理：需自行配置 GOOGLE_PLACES_API_KEY，密钥泄露可能导致配额被盗用。
• 隐私披露：搜索查询会发送至 Google 服务器，敏感位置偏好存在数据留存风险。
• 运行时依赖：依赖 uv 包管理器，部分环境可能需要额外安装步骤。

核心功能

Event Planner 是一款专注于线下活动策划的自动化工具，通过调用 Google Places API 实现智能场地搜索与行程编排。核心用法围绕 plan_event.py 脚本展开，用户只需指定活动类型（如 night-out、date-night、weekend-day）、地点、人数、预算和时长等参数，即可自动生成包含时间线、场地详情、交通信息和 Google Maps 链接的完整行程方案。

显著优点：

1. 场景覆盖全面：支持夜生活、约会、周末出行、团队活动、午餐/晚餐单点推荐及多日程旅行共 7 种预设场景，每种场景内置合理的活动组合逻辑（如 date-night 自动匹配浪漫餐厅+甜品/酒吧）
2. 智能化编排：自动推断开始时间、根据距离估算交通时长（支持 Google Directions API 精准计算，不可用时降级为 Haversine 距离估算+30%缓冲）
3. 输出灵活：提供 Markdown 格式的可读行程（含时间轴、场地详情、导航链接）和 JSON 结构化数据两种输出模式
4. 容错机制完善：位置无效时返回建议、无匹配场地时自动放宽筛选条件、API 失败时指数退避重试

潜在局限：

• 依赖外部 API：核心功能绑定 Google Places API，存在调用配额限制和计费风险
• 数据实时性不足：场地营业时间可能变更，预算估算基于 Google 价格等级（0-4 档）而非实际消费
• 国内使用受限：Google 服务在中国大陆可用性受限，需配合网络环境使用
• 无预订功能：仅提供推荐和导航，不支持直接预订座位或购票

适合人群：城市白领、活动策划者、旅行者、约会场景用户、小型团队负责人

常规风险：API 密钥需妥善保管（当前从环境变量安全读取），Google API 按调用量计费需关注账单，场地信息建议行前二次确认