TravelSmart

自驾出行决策助手 - 高速出口推荐、途中住宿、打车点推荐三大场景。 高德地图 Web API + 多因子评分算法，支持 CLI / Web / 飞书三种使用方式。 必填环境变量：AMAP_KEY（高德地图）；可选：MINIMAX_API_KEY、FEISHU_APP_ID、FEISHU_APP_SECRET。

TravelSmart - 智能出行决策助手

自驾途中的「第二大脑」——不只告诉你哪里近，而是告诉你综合最优的决策点在哪里。

核心能力

• 🚗 高速出口推荐：堵车时推荐最佳下高速出口，综合考虑餐饮评分+绕行距离
• 🏨 途中住宿推荐：找停车场充足+次日行程顺路的酒店
• 🚕 景点打车点推荐：告知最佳停车候车位置

环境准备

必填

变量	说明
AMAP_KEY	高德地图 Web API Key（申请地址）

可选

变量	说明
MINIMAX_API_KEY	MiniMax LLM（自然语言路由）
FEISHU_APP_ID	飞书推送 App ID
FEISHU_APP_SECRET	飞书推送 App Secret

.env.example 文件中有配置模板，复制为 .env 后填入即可。

快速开始

方式一：Python CLI

cd skills/travel-smart
pip install -r requirements.txt
cp .env.example .env  # 填入 AMAP_KEY
python src/main.py --scene highway --highway G4 --lng 116.397 --lat 39.909 --destination 北京

方式二：Web 演示页面

pip install -r requirements.txt
python server.py
# 访问 http://localhost:5188

方式三：飞书对话集成

集成到大管家，通过自然语言使用。

项目结构

skills/travel-smart/
├── src/
│   ├── main.py           # CLI 入口
│   ├── agents/           # Agent（路由 + 格式化）
│   ├── clients/          # 高德地图 API 客户端
│   ├── scenes/           # 三大场景逻辑
│   └── scoring/          # 多因子评分引擎
├── server.py             # Web 服务入口
├── requirements.txt      # Python 依赖
├── .env.example          # 环境变量模板
└── references/
    ├── scoring-algorithm.md   # 评分算法详解
    ├── api-reference.md       # API 接口文档
    └── PRD.md                 # 产品需求文档

技术架构

用户自然语言
    ↓
OpenClaw Agent（意图理解 + 编排）
    ↓
┌── 高德地图 Web API（地理编码/POI/路径规划）
├── MiniMax LLM（自然语言路由 + 决策建议，可选）
└── 评分引擎（多因子加权评分）
    ↓
结构化输出 + 飞书推送（可选）