核心用法
UBTRIPPIN 是一个个人旅行管理 Skill，通过完整的 REST API 实现行程自动化管理。核心工作流包括：
1. 行程与预订管理
- 自动解析转发至
trips@ubtrippin.xyz的预订确认邮件（航班、酒店、火车、租车等），AI 提取结构化数据 - 手动通过
/api/v1/trips/:id/items端点添加或批量导入预订（最多50条/次） - 支持 CRUD 操作：创建行程、合并行程、添加/更新/删除单个预订项
2. Loyalty 会员中心
- 集中管理航空公司、酒店集团等会员计划（
GET/POST /api/v1/me/loyalty） - 家庭组共享：查询全家某航司的会员号（
GET /api/v1/families/:id/loyalty/lookup）
3. 协作与通知
- 行程共享：邀请他人以 viewer/editor 角色协作（
/api/v1/trips/:id/collaborators） - Webhook 订阅事件（trip.created, item.added 等）
- iCal 订阅链接同步至日历应用
4. 实时状态
- 刷新航班/火车实时状态（延误、登机口变更）
- 附近城市指南查询
---
显著优点
- 零摩擦录入：邮件转发即自动解析，无需手动输入
- 数据结构化完整：confirmation_code、seat、gate、loyalty_number 等均存入
details_json - 家庭场景深度支持：家庭组、共享 loyalty 查询、协作权限分级
- 开放生态：Webhook、iCal、批量导入/导出，易于与其他工具集成
- 多交通类型：flight/hotel/train/car/ferry/activity/restaurant 全覆盖
---
潜在缺点与局限性
| 局限 | 说明 |
|------|------|
| **邮件解析依赖** | 非标准格式或图片 PDF 可能解析失败（`needs_review: true`） |
| **API Key 安全责任** | 用户自行在 ubtrippin.xyz/settings 生成管理，泄露风险需用户承担 |
| **地域覆盖未知** | 火车实时状态、城市指南等功能的全球覆盖范围未明确 |
| **第三方依赖** | Stripe 支付、外部地图服务稳定性影响体验 |
| **无原生移动端** | 纯 API 服务，需用户通过代理或自建前端使用 |
---
适合人群
- 频繁商旅人士：需集中管理多平台预订、loyalty 会员
- 家庭出行组织者：协调多人行程、共享会员权益
- 自动化爱好者：希望通过 webhook/日历同步构建个人旅行工作流
- 开发能力用户：愿意配置 API key、管理 sender 邮箱的技术型用户
---
常规风险
- API Key 泄露：Bearer token 一旦泄露，攻击者可读取全部旅行数据。建议：短期会话存储、及时轮换
- 邮件转发 spoofing：虽然限制 registered sender，但邮箱被盗后转发权限随之失控
- 隐私合规：行程数据含位置、时间、同行人信息，跨境传输需留意 GDPR 等法规
- 服务连续性：初创服务，长期运营与数据迁移策略需关注