D-Tours：AI驱动的攀岩公路旅行伴侣系统

一个为攀岩公路旅行设计的AI伴侣系统，整合实时位置追踪、智能行程推荐、内容管理和主动式通知，打造三位一体的旅行体验。

• 原作者/维护者： dapinitial
• 来源平台： GitHub
• 原始标题： d-tours
• 原始链接： https://github.com/dapinitial/d-tours
• 项目主页： https://spacelabforever.com
• 发布时间： 2026-06-11

---

攀岩是一项高度依赖信息的运动——岩场的路线难度、路况、天气、甚至是"beta"（攀爬技巧提示）都可能决定一次攀爬的成败。传统的攀岩指南通常是静态的印刷品，无法实时更新，也无法根据旅行者的实际位置和行程动态推荐。

D-Tours项目诞生于一次从奥斯汀到斯阔米什的史诗级攀岩公路旅行。开发者希望创造一个"副驾驶"式的AI伴侣，不仅能够提供静态信息，还能根据实时位置主动推荐沿途的攀岩目标，记录旅程点滴，并在关键时刻发送提醒。

这个项目的独特之处在于它不仅仅是一个网站或一个应用，而是一个由三个互补表面组成的完整系统：面向访客的精美展示网站、主动推送的AI消息伴侣、以及方便管理的CMS后台。

---

访客网站采用Astro框架构建，设计理念深受Montoya和Manifesto等精品网站影响，强调视觉叙事和沉浸感：

• 实时地图集成：通过Garmin MapShare KML订阅获取旅行者的实时位置
• 路线时间轴：展示从奥斯汀到斯阔米什的完整行程，支持灵活调整
• 攀岩目标库：所有岩场和目标都带有经纬度坐标，支持按距离排序
• 日志与画廊：旅行日志和照片展示
• 打印行程单：可将完整行程导出为PDF，方便离线查阅

Shotgun是系统的智能核心，一个始终在线的AI助手，通过多种渠道与旅行者保持联系：

• 主动位置感知：系统知道旅行者当前位置，能够计算到各个攀岩目标的距离和预估驾驶时间
• 智能推荐：当旅行者接近某个优质攀岩区域时，自动发送该区域的详细信息
• 多渠道通知：支持邮件、短信、卫星通讯设备（inReach）等多种通知方式
• 自然语言交互：旅行者可以通过自然语言与Shotgun对话，查询信息或调整计划

CMS采用与访客网站相同的技术栈，支持从手机或笔记本管理整个系统：

• 内容编辑器：发布日志、更新攀岩目标、上传照片
• Shotgun控制面板：发送摘要、触发D-Tours扫描、检查MapShare位置
• 统计仪表板：查看访问量、互动数据等关键指标

---

项目采用现代Web技术栈，兼顾开发效率和运行性能：

• Astro 5：静态站点生成与SSR结合，快速构建高性能页面
• Supabase：PostgreSQL数据库、认证、存储一站式解决方案
• Leaflet：开源地图库，展示实时位置和攀岩目标
• Nodemailer：邮件发送，支持运营商邮件转短信网关
• Overpass API / OpenStreetMap：免费获取地理数据

系统的核心功能之一是实时位置感知和智能推荐：

位置获取模块（src/lib/proximity.ts）：

• 解析Garmin MapShare KML订阅源，获取GPS坐标
• 提供模拟位置作为降级方案，确保系统始终可用
• 实现Haversine公式计算球面距离
• 估算驾驶时间（直线距离 × 1.35 ÷ 45mph）

邻近查询API（/api/nearby）：

• 接收当前经纬度作为参数
• 计算所有攀岩目标与当前位置的距离
• 标记在指定驾驶时间范围内的目标
• 按距离排序返回结果