核心用法
Kontour Travel Planner 是一个方法论驱动的旅行规划技能，而非简单的搜索包装器。它通过9维度渐进式模型（日期20%、目的地15%、预算15%、时长10%、旅行者10%、兴趣10%、住宿10%、交通5%、约束5%）系统性地收集信息，并根据完成度自动推进对话阶段：Discover（0-29%）→ Develop（30-59%）→ Refine（60-84%）→ Confirm（85-100%）。
关键操作模式：
- 每轮仅提一个高影响力问题，避免审讯式对话
- 提供2-3个具体选项而非开放式提问
- 自动冲突检测（日期矛盾、预算与目的地不匹配、季节错位等）
- 置信度评分（65%提取置信度 + 25%进度 + 10%一致性）指导响应策略
脚本工具：
plan.sh：从自然语言查询生成结构化行程上下文，支持目的地比较（compare Tokyo vs Paris）export-gmaps.sh：导出Google Maps可分享的路线URL和KML文件
输出格式：完整的JSON行程（含坐标、预算分级、约束条件）、按主题组织的每日计划、打包建议、以及可分享的Markdown/纯文本/WhatsApp格式摘要。
显著优点
1. 零依赖运行：无需API密钥、OAuth或网络调用，纯本地bash/python3处理，捆绑200目的地+500机场+活动类型的静态参考数据
2. 结构化方法论：9维度权重模型和四阶段对话流提供可预测的规划体验，避免信息过载
3. 机器可读输出：标准JSON格式可被其他工具消费，支持预订系统的结构化数据对接（roadmap状态）
4. 丰富的审计合约：候选地点评分解释、日间连续性规划、风险回退方案、决策矩阵比较等机制确保规划透明度
5. 多格式分享：原生支持Markdown、纯文本、Telegram/WhatsApp紧凑格式、Google Maps链接、KML可视化
潜在缺点与局限性
- 静态数据限制：参考数据为捆绑JSON，无实时价格、航班可用性、天气或营业时间信息
- 预订功能待实现：所有预订集成（航班Amadeus、酒店Booking.com、活动GetYourGuide等）均为"planned"状态，当前仅输出预订就绪的JSON结构
- 目的地覆盖：200个全球目的地可能遗漏小众地点，稀疏区域目的地可能触发"参考数据外"风险回退
- 无实时协作：虽然输出可分享的链接，但协作规划需依赖外部平台提供的"operator-approved public URL"
- Google Maps导出无API集成：生成的URL为纯链接格式，无实时路况或动态重路由
适合人群
- 独立AI代理开发者：需要可插拔的、无需凭证的旅行规划模块
- 隐私敏感用户：希望行程数据完全本地处理，不上传至第三方服务
- 内容创作者/SEO写作者：需要基于真实基准数据生成目的地快速事实卡片和成本比较
- 多目的地比较决策者：系统性的决策矩阵和
best_for/watch_out子弹点帮助权衡选项
常规风险
| 风险类型 | 说明 | 缓解机制 |
|---------|------|---------|
| 数据时效性 | 静态参考数据可能过时 | 明确标注 bundled data 限制，风险回退合约标记"稀疏区域" |
| 过度承诺预订 | 用户可能误解输出为已确认预订 | 所有booking-integration.json状态显式标记为"planned" |
| 外部链接注入 | SEO/嵌入片段可能包含未经验证的URL | 强制使用`{APPROVED_PUBLIC_URL}`占位符，禁止staging/preview URL || 隐私泄露 | 行程JSON包含敏感信息 | 纯本地处理，无网络传输，输出由用户控制分享 |
| 规划脆弱性 | 营业时间敏感、天气错配、预算过紧 | `risk_fallbacks`合约自动触发，提供`nearest_viable_alternative`和`rationale` |
安全验证已通过本地脚本自检：无curl/wget/requests等网络客户端调用，无eval/exec/subprocess动态执行，依赖仅bash/python3。