（14784期）Voyagier CLI – 终端直连真实旅行预订

终端直连真实旅行预订 Voyagier CLI 将航班、酒店、活动搜索与价格锁定预订整合进终端工作流，专为 AI Agent 和旅行顾问设计，实现从行程规划到安全支付的全链路自动化。 使用说明 核心用法 Voyagier CLI 是一套面向终端的旅行预订工具链，核心工作流围绕「目标图谱（goal graph）」展开。用户首先通过 plan-trip 创建行程骨架并生成默认目标（航班、酒店、日期、目的地、旅客），随后针对各目标执行搜索、筛选选项、确认选择，最终通过价格门禁完成预订。 完整流程包括：环境检查（doctor）→ 客户建档（clients upsert）→ 行程初始化（plan-trip）→ 添加旅客信息（travellers add，含性别/出生日期以便航班出票）→ 多维度搜索（search flights/hotels/activities）→ 轮询选项（selection-options --wait）→ 确认选择（select）→ 状态诊断（plan-status）→ 价格验证预订（book --expect-total 或 book --max-total）。所有命令均支持 --json 输出，便于程序解析。 特别值得注意的是，CLI 同时充当 Model Context Protocol（MCP）stdio 服务器（voyagier mcp），在无 shell 环境中可直接作为工具集暴露，保持与命令行完全一致的错误码和状态机。此外，quote 命令可生成可复现的报价快照，send 则向客户发送自付邀请（非幂等，需 --yes 确认）。 显著优点 深度自动化集成：从行程规划到支付闭环的全终端操作，配合 JSON 输出和 MCP 协议支持，无缝嵌入 AI Agent 工作流，无需人工介入网页端。 价格锁定安全机制：--expect-total 和 --max-total 门禁强制价格确认，防止价格漂移导致的意外扣款，若价格变动则返回 PRICE_CHANGED 错误而非静默扣款，财务可控性极高。 状态机清晰透明：plan-status 统一暴露 BLOCKED/INPROGRESS/READYTO_BOOK/BOOKED 四态，配合 blockers[] 和 nextSteps[] 字段，Agent 可精确决策下一步动作，避免黑箱猜测。 零安装与多环境适配：npx @voyagier/cli 零依赖运行，配合环境变量 VOYAGIERTOKEN 和可选 VOYAGIERAPI_URL，完美适配 CI/CD 和容器化部署。 旅客数据结构化：支持常旅客号（--frequent-flyer）和酒店会员号（--hotel-loyalty）的声明式绑定，尽管采用「尽力应用」策略（不阻塞预订），但显著提升了高阶用户的体验。 潜在缺点与局限性 酒店预订覆盖不全：文档明确提示「Hotel checkout coverage is partial」，豪华/精品酒店可能仍需人工直订，Agent 需额外检查 isBookable 字段，增加了逻辑分支复杂度。 价格语义易混淆：航班价格为整单总价（非人均），酒店价格为整宿总价（含「from $X total · N nights (~$Y/nt)」格式），但附加处理费（processing fee）在结账时才加入，不在购物车小计中显示，Agent 若未完整解析 book --dry-run 的 chargeableSubtotal 易产生报价偏差。 搜索结果时效性：报价仅保留约 2 小时，超时触发 EXPIREDOFFER/STALEPLAN_STATE，需重新搜索，对长时决策场景不够友好。 预订幂等性陷阱：成功的 book 不可重试（未支付会话对 CLI 不可见，重试会生成第二个付款链接），Agent 必须自行幂等控制；send 命令同样非幂等，需显式 --yes 确认，自动化脚本中需额外防护。 价格锁定非持久：select 成功并不锁定票价，最终价格以 book 时为准，存在时间差风险。 适合的目标群体 AI 旅行顾问 Agent：需要结构化旅行预订能力、价格安全门禁和 MCP 协议原生支持的智能体开发者。 高端旅行规划师/旅行社：面向多旅客家庭出行、企业差旅管理，追求终端效率与批量处理的专业人士。 开发者与 DevOps 团队：希望将旅行预订嵌入内部工具链、自动化审批流或 Slack/Discord 机器人场景的工程团队。 价格敏感型自动化场景：需要精确价格控制、拒绝任何模糊扣款的财务合规场景。 使用风险 财务风险：尽管价格门禁提供了保护，但 --expect-total 要求精确到分（cents-compared），浮点精度或货币转换处理不当可能导致验证失败或意外拒付。建议在正式 book 前始终执行 --dry-run 并交叉验证。 数据隐私与合规：旅客的性别、出生日期等 PII 为航班出票强制字段，Agent 需确保符合 GDPR/CCPA 等数据保护法规的收集、存储和传输要求。PAT（Personal Access Token）需通过 stdin 或环境变量注入，禁止硬编码或日志输出。 供应商依赖与可用性：酒店、航班数据来自第三方，存在供应商 API 故障、库存同步延迟或价格突发变动风险。STALEPLANSTATE 和 EXPIRED_OFFER 错误需纳入重试策略。 并发与状态竞争：并行处理多行程时，必须使用 --plan <id> 显式指定，防止全局状态文件交叉污染。 MCP 宿主兼容性：虽然 MCP 服务器标准化了成功/失败信封，但宿主对超长工具输出、流式响应的处理可能存在差异，需针对性测试。 版本漂移：agent-docs 为「随 CLI 附带」的实时文档，Skill 描述仅为摘要，实际集成需确保 CLI 版本与文档版本一致，建议 CI 中锁定 @voyagier/cli 的精确版本号。 原始说明 Book real travel from your terminal — search flights, hotels & activities, plan trips, and check out with a price-gated booking. For AI agents and travel advisors.