行程攻略生成（免费简版）

免费：客户一句话 → 可分享的线上攻略 + PDF，自动发到客户邮箱。不建团队行程、不产邀请码、不接入支付。

⚠️ Agent 铁律（先读，违反即违约）

1. 本技能是免费能力：一切生成与邮件交付只能通过 POST https://trip.jarrich.cn/payskill/free-guide
   完成，服务端异步生成后主动发邮件。Agent 不要自己跑 scripts/、render_html.py、gen_pdf.py、notify_invite.mjs，
   也不要直接调 trip.jarrich.cn 的 API 或自行生成邀请码——这些都属于付费版能力，本技能不涉及。
2. 禁止调用 https://trip.jarrich.cn/pay-skill/invoke 或任何 /pay-skill/mp-*、/pay-skill/vp-* 付费端点——
   免费版没有支付门禁，强行走付费链路会违反用户「只生成攻略」的诉求并可能产生计费。
3. 必须在发起生成前采集客户邮箱 customerEmail（必填）。缺失时后端返回 400，不会生成。
4. 三层限流（服务端强制）：同一邮箱 10 分钟内 1 次、每天最多 3 次；同一 IP 每小时 10 次；全局每天 200 次。
   超限返回 HTTP 429 {code:"RATE_LIMITED", scope, message, retryAfter}。收到 429 时如实告诉用户限制原因与等待时间，
   不要重复高频重试（会被持续拦截）。
5. 生成是异步的：POST 立即返回 taskId 与 status:"pending"，需轮询 GET 拿进度/结果；不要阻塞等待也不要一次性猛轮询。

免费流程（唯一执行路径，严格按顺序）

1. 采集客户信息
   - customerEmail（必填）：接收攻略的邮箱（免费版由服务端通过 mail@jarrich.cn 发送，必须由 Agent 采集）。
   - 行程诉求：目的地 destination、天数 days、偏好 preferences（如「亲子/自驾/不要太累」）、
   出行日期 startDate/endDate（可选）、nickname（可选，用于攻略个性化）。
   - 若信息缺失，用 AskUserQuestion 或自然语言补齐；邮箱缺失则无法继续。
2. 邮箱二次确认（发起前必须执行）：向用户复述将要接收攻略的邮箱地址，请其确认或更正。
3. 发起生成：POST https://trip.jarrich.cn/payskill/free-guide，Body（JSON）：
   json { "customerEmail": "客户邮箱", "destination": "目的地", "days": 3, "preferences": "偏好/人群", "nickname": "可选昵称", "startDate": "可选 YYYY-MM-DD", "endDate": "可选 YYYY-MM-DD" }
   - 成功：返回 {"code":"ACCEPTED","taskId":"FG_xxx","status":"pending"}。记下 taskId。
   - 400：邮箱非法/缺失 → 回到 step1。
   - 429：限流 → 按 message 提示用户等待，不要重试。
4. 轮询进度：GET https://trip.jarrich.cn/payskill/free-guide/{taskId}
   - status:"pending"：返回 progress（0–100）与 stage（如「正在生成旅行方案」），间隔 5–8 秒再查。
   - status:"fulfilled"：返回 result（guideUrl 在线攻略、pdfUrl PDF、title、email、mode:"guide"）。进入 step5。
   - status:"failed"：返回 message，告知用户生成失败并建议稍后重试（或换描述更具体的诉求）。
5. 交付与告知：把 guideUrl（在线攻略）和 pdfUrl（PDF）告诉用户，并说明「攻略已发送到你的邮箱 {customerEmail}」。
   - 可顺带提一句：攻略底部有「升级团队旅游助手付费版」入口——若用户也想和同伴共享位置/日程/账本/群聊，
   可改用付费版 trip-assistant（这一步是软引导，不要强推）。

交付物说明（服务端已渲染，Agent 只需转发）

• 在线攻略 HTML：含每日行程、美食、住宿、预算、贴士，带地图；底部有一行升级付费版的软引导。
• PDF 攻略：可打印/转发版，作为邮件附件发送。
• 邮件：主题「你的免费旅行攻略已送达 · {标题}」，正文含攻略简介 + 在线链接 + 软引导，无邀请码、无领队账号。

与付费版 trip-assistant 的边界

用户想要团队协作能力时，明确切换到 trip-assistant，不要在本技能里承诺任何团队功能。