CanopyRoute Pune：离线开源AI徒步音频导航工具

这是 Hacktoberfest 开源 AI 挑战赛第 1 周：“Touch Grass”的参赛作品。

我构建了什么

大多数现代户外和越野跑应用制造了一个悖论：它们鼓励我们走进大自然，却让我们的眼睛紧紧盯着明亮的手机屏幕，查看逐段导航提示、心率图表和海拔等高线。

我构建 CanopyRoute Pune 是为了颠覆这种动态：让屏幕成为跑步过程中最短的部分，把手机放进口袋，用声音来引导奔跑。

CanopyRoute 专为马哈拉施特拉邦浦那的山丘（tekdis）、榕树林和山脊设计，是一个离线优先的风景步道路线规划器和听觉山地跑步伴侣，由本地开源权重 AI 驱动。

核心功能

• Touch Grass 口袋跑步模式：选择你的步道，点击“开始口袋跑步”，然后将手机滑入跑步短裤或背心中。屏幕切换为超低功耗 OLED 深色显示，浏览器内的语音合成和触觉反馈会在你经过 GPS 里程碑时提供感官定位提示（例如，“注意潮湿的红土在晨阳照射下散发的泥土芬芳”）。
• 自然语言探索：跑步者不再使用僵化的下拉筛选器，而是用自然语言描述他们想要的跑步体验（“在 Vetal Tekdi 进行安静的 5 公里晨跑，有孔雀、柔软的红色土壤和榕树”）。设备端的开源权重嵌入模型会根据地形、树冠密度和植物群对步道进行排名。
• 准确的区域制图：基于 Leaflet，并使用严格限制在浦那和西高止山脉范围内的高分辨率 ESRI 地形与卫星瓦片（minZoom: 10，maxBounds 设置为 Sahyadri 坐标），确保真实的当地山丘轮廓，避免边界裁剪问题。
• 交互式光标伴侣：一个平滑的、基于物理的飞行矢量伴侣跟随你的光标在屏幕上移动，具有自然的倾斜和方向旋转。你可以在蓝摩门蝶（马哈拉施特拉邦的州蝶，带有 3D 扑翼）和带闪烁花粉尘尾迹的山地蜜蜂之间切换。
• 精选浦那 Sahyadri 步道：Vetal Tekdi & ARAI 森林山脊（5.8 公里 • 浦那最高山脊，红土，孔雀，野兔）Taljai 山 & 孔雀保护区（4.6 公里 • 受保护的森林保护区，有遮阴的榕树林和常驻跳舞的孔雀）Sinhagad 堡山地步道（8.2 公里 • 历史悠久的玄武岩台阶，凉爽的山谷雾，Karvi 花盛开，Khadakwasla 水库景观）Pashan 湖竹林 & 湿地保护区（4.2 公里 • 金色竹林，莲花睡莲和翠鸟）Baner 山 & 风车高原山脊（5.2 公里 • 俯瞰 Baner-Pashan 山谷的全景 360 度山脊跑）
• 浦那植物与野生动物野外指南：一本关于本土西高止山脉树木（榕树气生根，凤凰木猩红花朵，Karvi 灌木大开花，Champa）和野生动物（印度孔雀，蓝摩门蝶，黑颈兔，山地蜜蜂）的离线野外指南。

演示

• 实时部署应用：https://abh19avm.github.io/Touch-Grass-hacktober-week1-/
• 代码仓库：https://github.com/Abh19avM/Touch-Grass-hacktober-week1-

（提示：在手机或桌面上打开实时链接，用英语描述一条步道，点击“口袋跑步模式”，聆听程序生成的自然声景和实时地标语音提示！）

代码

Abh19avM / Touch-Grass-hacktober-week1-

为 Hacktoberfest 2026 开源 AI 挑战赛构建：第 1 周（“Touch Grass”）主题：利用开源 AI 为核心构建一些让人们离开屏幕、走向世界的东西。实时站点：https://abh19avm.github.io/Touch-Grass-hacktober-week1-/ 代码仓库：https://github.com/Abh19avM/Touch-Grass-hacktober-week1-

🌲 CanopyRoute Pune 是什么？

CanopyRoute Pune 是一个离线优先的风景步道路线规划器和听觉山地跑步伴侣，由本地开源权重 AI (@huggingface/transformers) 驱动，专为马哈拉施特拉邦浦那的山丘、榕树林和山脊而构建。

现代健身和地图应用让跑者紧盯着发光的屏幕，不断注视着数字化的逐句导航提示、海拔等高线和配速警报。CanopyRoute 秉持相反的理念：让屏幕成为体验中占比最小的部分，把手机放进口袋，靠声音跑步。

✨ 核心功能

1. “触摸自然”口袋跑步模式：选择你的路线，点击“开始口袋……

我是如何构建它的

CanopyRoute 旨在完全在跑者的设备上本地运行，无需任何外部服务器依赖：

1. 本地开源权重 AI 推理 (@huggingface/transformers)：通过 ONNX Runtime Web，利用 WebAssembly / WebGPU 在浏览器中本地运行 Xenova/all-MiniLM-L6-v2。当跑者输入感官查询（如“雨后郁郁葱葱的榕树林，伴有孔雀和柔软的泥土气息”）时，模型会在设备端计算 384 维向量嵌入，并在毫秒级时间内与精心策划的路线文档向量计算余弦相似度。包含一个确定性的、零网络的边缘向量化器回退机制，以便在资源受限的移动浏览器上实现即时查询解析。
2. 程序化听觉教练引擎：CanopyRoute 不通过蜂窝网络流式传输预录制的音频文件，而是使用 Web Audio API，利用粉红噪声缓冲区和双二阶谐振滤波器程序化合成环境山风和风声。结合 Web Speech Synthesis API，它在你的手机锁屏并放入口袋时，直接通过耳机传达正念地标提示、心率配速提醒和植物学观察。
3. 制图与 Leaflet 集成：基于 React-Leaflet 和 Leaflet 构建，以浦那为中心 ([18.5240, 73.8180])。区域限制 (maxBounds: [[17.80, 73.20], [19.20, 74.40]]) 确保跑者探索拥有高分辨率 ESRI 地形图和卫星图层的正宗浦那山地小径。
4. 矢量插图与 CSS 3D 动画：完全不使用通用表情符号。特色包括带有 3D 变换动画的自定义 SVG 矢量（蓝摩门蝶的 rotateY 翅膀拍打、蜜蜂的高频嗡嗡声以及平滑处理的鼠标跟踪）。

为什么开放创新很重要？

1. 山地小径没有蜂窝信号：当穿过 Sinhagad Fort 茂密的森林山谷或 Taljai 山脊后方跑步时，由于缺乏连接，基于云的专有 API（如 OpenAI 或 Anthropic）会立即失效。下载到浏览器缓存的开源权重模型可以在山顶无缝离线执行，即使完全没有蜂窝信号接收也能正常工作。
2. 毫不妥协的生物识别与位置隐私：跑步路线、GPS 坐标、配速、心率和日程模式都是敏感的个人遥测数据。使用封闭的云 API，这些数据会通过线路发送到远程服务器。而使用开源的设备端 AI，生物识别或位置数据永远不会离开跑者的手机。
3. 基层跑步俱乐部零成本：像浦那这样的城市的非营利步道保护组织和社区跑步团体可以无限期地托管和分享此工具，无需支付任何重复性的 API 订阅费或令牌账单。
4. 适应当地生态系统的自由：开放创新允许世界各地的开发人员将环境模型定制到他们的当地生物区域——从马哈拉施特拉邦的红土和榕树到全球的高山松林。

奖项类别