核心功能与用法
Travel Itinerary Builder 是一款面向深度旅行规划者的自动化行程生成工具。用户只需提供目的地与日期，即可一键生成包含天气预报、景点推荐、餐厅指南、交通路线及预算估算的完整多日程计划。核心用法包括：（1）基础模式——直接输入目的地与日期生成行程；（2）智能整合模式——通过可选的 Gmail 插件自动提取航班、酒店、租车等预订确认邮件，避免手动录入；（3）多语言输出——支持中、英、日、韩等语言的地名双语显示。
显著优点
高度自动化：整合 weather、goplaces 等外部数据源，自动填充天气与景点信息，大幅减少人工搜索时间。Gmail 智能解析：可识别 Agoda、Booking.com、新加坡航空、ANA、Klook 等主流平台的确认邮件，自动提取 PNR、时间、价格等关键字段。输出格式专业：基于成熟模板生成深色主题 HTML，可直接打印或分享，视觉呈现优于普通文档。多城市路线规划：自动计算城际交通时间与费用，适合自驾游及多城联游场景。
潜在局限与风险
隐私敏感：Gmail 集成需要 GOG_KEYRING_PASSWORD 环境变量授权，脚本将读取邮件主题、正文及完整内容，虽仅在本地处理，但凭证泄露风险不可忽视。外部依赖复杂：依赖 gog（Google OAuth CLI）、goplaces、curl 等多个二进制工具，任一失效将导致功能中断。API 配额限制：Google Places API 免费版仅 1000 次/月，大规模行程可能触发限制。无实时数据：航班动态、景点实时客流等信息需额外查询，工具本身不提供。安全等级待验证：文档明确提示需审查 scripts/ 目录代码，建议在隔离环境运行。
适合人群
- 计划跨国/多城市长途旅行的中高级旅行者
- 已使用 Gmail 接收预订确认、希望减少手动整理的用户
- 需要向同行伙伴或家人分享专业行程文档的群体
- 对 CLI 工具有一定熟悉度、能接受环境配置的技术型用户
常规风险总结
| 风险类型 | 说明 |
|---------|------|
| 凭证泄露 | GOG_KEYRING_PASSWORD 与 GOOGLE_PLACES_API_KEY 需妥善保管 |
| 数据隐私 | Gmail 解析涉及完整邮件内容读取，敏感信息可能暂存本地 JSON |
| 供应链攻击 | 外部 CLI（gog、goplaces）需独立审计其安全性 |
| 功能失效 | API 超限或外部服务变更可能导致数据获取失败 |