travel planner amap

智能旅行攻略规划师。根据用户提供的出行信息（人数、男女比例、关系、出发地、目的地、日期、天数）， 直接调用高德地图 REST API 获取实时路线、POI、距离等数据，生成完整的个性化旅行攻略。 攻略包含：创意名称、出行方式建议（含当地租车判断）、分时段行程（早午晚三餐均有具体推荐）、 景点推荐（含高铁站→景点距...

Security Scan

The skill mostly does what it says (calls Amap REST APIs using an API key), but there are mismatches between its declared metadata and its runtime instructions and a few small inconsistencies you should review before installing.

Purpose & Capability

The skill's stated purpose (calling 高德/AMap REST APIs to build travel plans) aligns with the runtime instructions which repeatedly call AMap endpoints and require an AMAP_KEY. However the registry metadata provided earlier claimed 'Required env vars: none' while the SKILL.md declares AMAP_KEY as required — this mismatch is unexpected and should be resolved.

Instruction Scope

SKILL.md stays within its stated purpose: it collects travel details from the user, constructs URL-encoded queries, and calls AMap REST APIs via short Python snippets. It explicitly avoids shell concatenation for user inputs and recommends IP whitelisting and limiting service permissions for the API key. The instructions do not attempt to read unrelated files or other credentials.

Install Mechanism

This is an instruction-only skill with no install spec and no code files, so nothing is written to disk by the skill itself. That is the lowest-risk install model.

Credentials

The runtime requires an AMAP_KEY (appropriate for AMap API usage), which is reasonable. But the registry-level metadata omitted required env vars while SKILL.md marks AMAP_KEY required — this inconsistency is concerning. Also the SKILL.md lists 'requires: curl' alongside python3, yet the shown runtime snippets use python urllib.request rather than curl; 'curl' may be an unnecessary or incorrect requirement.

Persistence & Privilege

The skill does not request always:true and contains no instructions to modify other skills or system-wide configs. It uses ephemeral environment variables in one-off commands and recommends not persisting the API key in shell configs.

What to consider before installing

This skill appears to implement a legitimate AMap-based travel planner, but check two things before installing: (1) confirm the skill actually requires and will use an AMAP_KEY — the registry metadata and SKILL.md disagree (registry shows no env, SKILL.md requires AMAP_KEY). Do not proceed until you see the manifest updated or the publisher explains the discrepancy. (2) Ensure the runtime environment has python3 and that you create an AMap Web Service key with restrictive permissions and IP whitelist as the instructions recommend; avoid storing the key in shell rc files — use temporary exports or a short-lived credential. Also ask the publisher why 'curl' is listed as a requirement when the examples use python; unused requirements may indicate sloppy packaging. If you need to limit blast radius further, create an API key scoped only to the minimal AMap endpoints the skill needs, and test the skill in a restricted sandbox first.

Travel Planner — 智能旅行攻略规划师

直接调用高德地图 REST API 获取实时数据，无需 GUI 容器。

Step 0：检查 API Key

[ -n "$AMAP_KEY" ] && echo "AMAP_KEY: configured" || echo "AMAP_KEY: not set"

• 输出 configured → 配置成功，跳到 Step 1

• 输出 not set → 提示用户：

  需要配置高德地图 API Key 才能获取实时数据：

  1. 前往 https://lbs.amap.com 注册并创建应用
  2. 添加 Key，平台选择「Web服务」（不是 JS API）
  3. 在高德控制台为该 Key 设置「IP 白名单」和「服务权限」（仅开启本技能需要的接口），限制 Key 的使用范围
  4. 在当前终端执行：export AMAP_KEY=你的ApiKey

  安全提示：不建议将 API Key 写入 ~/.zshrc 明文保存，建议每次使用前在终端临时 export，用完后关闭终端即失效。

---

Step 1：收集信息（生成攻略前必须完成）

如果用户未提供以下信息，一次性把缺少的问题打包问完，不要多轮反复追问：

必需信息：

• 出行人数、男女比例、同行关系（情侣 / 同性朋友 / 混合朋友 / 亲子家庭 / 其他）
• 出发地（具体城市或地址）
• 目的地（城市 / 景区 / 区域）
• 出行日期及天数

开场四问（收集到基本信息后，一条消息问完，不要分多次问）：

还有四个小问题帮我规划得更好：

1. 你希望行程紧凑一些（多逛景点）还是轻松一些（慢慢玩）？
2. 这次大概的预算是多少（人均或总预算均可）？
3. 有没有一定要去的景点，或者非吃不可的东西？
4. 到了目的地打算自驾还是坐公共交通出行？

预算处理规则：若用户报的预算明显偏低，直接给出性价比最优方案，备注"这是最合适的方案了"，不必纠结预算准确性。

---

Step 2：数据收集（调用高德 REST API）

所有用户输入（地址、城市名等文本）通过环境变量传入 Python，由 urllib.parse.urlencode 统一编码后发起 HTTP 请求，不经过 shell 拼接，避免命令注入风险。坐标由 API 返回（格式固定为 经度,纬度），可直接使用。

2.1 地理编码（获取坐标）

先获取出发地、目的地、目的地高铁站的坐标，后续所有 API 都依赖这些坐标：

# 出发地坐标
ADDR="{出发地}" python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({'address': os.environ['ADDR'], 'key': os.environ['AMAP_KEY']})
with urllib.request.urlopen('https://restapi.amap.com/v3/geocode/geo?' + params) as r:
    d = json.load(r)
g = d.get('geocodes', [])
print(g[0]['location'] if g else 'NOT_FOUND')
EOF

# 目的地坐标
ADDR="{目的地}" python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({'address': os.environ['ADDR'], 'key': os.environ['AMAP_KEY']})
with urllib.request.urlopen('https://restapi.amap.com/v3/geocode/geo?' + params) as r:
    d = json.load(r)
g = d.get('geocodes', [])
print(g[0]['location'] if g else 'NOT_FOUND')
EOF

# 目的地高铁站坐标
ADDR="{目的地}高铁站" python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({'address': os.environ['ADDR'], 'key': os.environ['AMAP_KEY']})
with urllib.request.urlopen('https://restapi.amap.com/v3/geocode/geo?' + params) as r:
    d = json.load(r)
g = d.get('geocodes', [])
print(g[0]['location'] if g else 'NOT_FOUND')
EOF

记录三组坐标（格式：经度,纬度），供后续步骤使用。

2.2 出发地→目的地路线

坐标为 API 返回值，格式固定（\d+\.\d+,\d+\.\d+），直接传参安全：

# 驾车路线
python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({
    'origin': '{出发地坐标}', 'destination': '{目的地坐标}', 'key': os.environ['AMAP_KEY']
})
with urllib.request.urlopen('https://restapi.amap.com/v3/direction/driving?' + params) as r:
    d = json.load(r)
paths = d.get('route', {}).get('paths', [])
if paths:
    p = paths[0]
    print(f"驾车: {int(p['distance'])//1000}km / {int(p['duration'])//60}分钟 / 过路费¥{p.get('tolls',0)}")
EOF

# 公共交通路线（含高铁）
CITY="{目的地城市}" python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({
    'origin': '{出发地坐标}', 'destination': '{目的地坐标}',
    'city': os.environ['CITY'], 'key': os.environ['AMAP_KEY']
})
with urllib.request.urlopen('https://restapi.amap.com/v3/direction/transit/integrated?' + params) as r:
    d = json.load(r)
transits = d.get('route', {}).get('transits', [])
if transits:
    t = transits[0]
    print(f"公交/高铁: {int(t['duration'])//60}分钟 / ¥{t.get('cost',0)}")
EOF

2.3 景点搜索

KW="{目的地}景点" CITY="{目的城市}" python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({
    'keywords': os.environ['KW'], 'city': os.environ['CITY'],
    'citylimit': 'true', 'pageSize': '15', 'key': os.environ['AMAP_KEY']
})
with urllib.request.urlopen('https://restapi.amap.com/v3/place/text?' + params) as r:
    d = json.load(r)
for p in d.get('pois', []):
    rating = p.get('biz_ext', {}).get('rating', '无')
    print(f"{p['name']} | {p['address']} | 评分:{rating} | 坐标:{p['location']}")
EOF

根据行程节奏（紧凑/轻松）选 3-6 个景点，记录每个景点坐标，按地理位置聚合排序避免折返。

2.4 高铁站→各景点距离

对每个主要景点，分别查询高铁站到该景点的驾车距离与时间：

# 对每个景点执行（替换坐标，坐标为 API 返回值，格式固定安全）
python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({
    'origin': '{高铁站坐标}', 'destination': '{景点坐标}', 'key': os.environ['AMAP_KEY']
})
with urllib.request.urlopen('https://restapi.amap.com/v3/direction/driving?' + params) as r:
    d = json.load(r)
paths = d.get('route', {}).get('paths', [])
if paths:
    p = paths[0]
    print(f"驾车约{int(p['distance'])//1000}km / {int(p['duration'])//60}分钟")
EOF

汇总结果，用于后续「出行方式建议」判断是否推荐当地租车。

2.5 餐厅搜索

分三餐分别搜索，优先评分高、距景点近的：

# 早餐：当地特色早点
KW="{目的地}特色早餐 早点" CITY="{目的城市}" python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({
    'keywords': os.environ['KW'], 'city': os.environ['CITY'],
    'citylimit': 'true', 'pageSize': '10', 'key': os.environ['AMAP_KEY']
})
with urllib.request.urlopen('https://restapi.amap.com/v3/place/text?' + params) as r:
    d = json.load(r)
for p in d.get('pois', [])[:5]:
    print(f"{p['name']} | {p['address']} | 评分:{p.get('biz_ext',{}).get('rating','无')}")
EOF

# 午餐：主要景点周边（使用第一个景点坐标，坐标为 API 返回值安全）
KW="餐厅 午餐" python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({
    'location': '{主要景点坐标}', 'keywords': os.environ['KW'],
    'radius': '1500', 'pageSize': '10', 'key': os.environ['AMAP_KEY']
})
with urllib.request.urlopen('https://restapi.amap.com/v3/place/around?' + params) as r:
    d = json.load(r)
for p in d.get('pois', [])[:5]:
    print(f"{p['name']} | {p['address']} | 评分:{p.get('biz_ext',{}).get('rating','无')}")
EOF

# 晚餐：当地特色菜/口碑餐厅
KW="{目的地}特色菜 晚餐 人气" CITY="{目的城市}" python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({
    'keywords': os.environ['KW'], 'city': os.environ['CITY'],
    'citylimit': 'true', 'pageSize': '10', 'key': os.environ['AMAP_KEY']
})
with urllib.request.urlopen('https://restapi.amap.com/v3/place/text?' + params) as r:
    d = json.load(r)
for p in d.get('pois', [])[:5]:
    print(f"{p['name']} | {p['address']} | 评分:{p.get('biz_ext',{}).get('rating','无')}")
EOF

每餐各选 1-2 家推荐，写明地址、推荐菜品和人均价格。

2.6 住宿搜索

KW="酒店 宾馆" python3 - << 'EOF'
import urllib.request, urllib.parse, json, os
params = urllib.parse.urlencode({
    'location': '{主要景区坐标}', 'keywords': os.environ['KW'],
    'radius': '2000', 'pageSize': '15', 'key': os.environ['AMAP_KEY']
})
with urllib.request.urlopen('https://restapi.amap.com/v3/place/around?' + params) as r:
    d = json.load(r)
for p in d.get('pois', [])[:10]:
    rating = p.get('biz_ext', {}).get('rating', '无')
    price = p.get('biz_ext', {}).get('avg_price', '无')
    print(f"{p['name']} | {p['address']} | 评分:{rating} | 均价:¥{price}")
EOF

根据预算和评分，选出 1-2 家性价比最优酒店（评分高且价格与预算相符），按同行关系决定房型：

• 情侣 → 大床房
• 同性朋友 → 标间
• 亲子 → 亲子房 / 大床
• 混合多人 → 多间标间

2.7 天气查询

使用 WebSearch 搜索：{目的地} {出行日期} 天气预报，获取天气状况、气温范围、风力、降水概率。

---

Step 3：生成攻略

出行方式建议逻辑（必须在攻略开头体现）

结合用户选择（自驾/公共交通）+ 景点距离数据，决定是否建议当地租车：

用户选自驾： 正常规划驾车路线，标注主要停车场。

用户选公共交通：

• 统计各景点间的距离

• 若任意两景点之间距离 > 15km，或高铁站到最远景点 > 20km，在攻略开头加提示：

  💡 出行建议：行程中 {景点A} 与 {景点B} 相距约 {X} km，公交换乘需 {X} 次约 {X} 分钟。建议考虑在当地租一天车（约 ¥150-300/天），时间更自由，整体性价比更高。

攻略命名规则

根据人数 + 地点 + 关系 + 男女比例组合创意名称，要有趣、押韵或谐音，禁止起"XX之旅"这类通用名：

场景	名称思路	示例
4人出行	谐音流行词	宝宝巴4（宝宝巴士）、四叶草小队
情侣2人	浪漫+地点	西湖·两人世界、成都恋爱进行时
纯男生团	硬核/兄弟风	兄弟的远征、XY染色体旅行团
纯女生团	甜美/闺蜜风	姐妹花漫游记、女子图鉴·{城市}
亲子家庭	温馨+人数	三口之家的{城市}奇遇
6人及以上	大部队风格	{N}人帮出没、乌合之众·{目的地}

路线规划原则

1. 按地理位置聚合景点，同一区域安排在同一时段
2. 上午精力好 → 安排体力消耗大或热门景点
3. 午饭选景点内或步行 10 分钟内的餐厅
4. 晚上轻松收尾，避免长途折返

时间段划分

• 1-3 天行程：每天细化到 早上 / 上午 / 中午 / 下午 / 晚上（五段，含早餐）
• 4 天及以上行程：只展示 Day 1 / Day 2 / Day N，不细化时间段，相邻景点聚合同一天减少折返

注意事项生成逻辑

• 天气晴热 → 防晒霜、帽子、墨镜、遮阳伞
• 雨天 → 雨伞、防滑鞋
• 带孩子 → 儿童防晒、备零食、注意落水/走失
• 户外徒步 → 运动鞋、充电宝
• 热门景区 → 提前预约/购票提醒

---

攻略输出模板

# 🗺️ {攻略名称}

**出行人数**：{N} 人｜**出行关系**：{情侣/朋友/家庭等}｜**目的地**：{城市/地区}
**日期**：{YYYY年MM月DD日}｜**出行方式**：{自驾 / 公共交通 / 公共交通+当地租车}

---

## 📍 行程路线总览

{出发地} → {目的地}

| 区段 | 距离 | 出行方式 | 预计耗时 | 预计花费 |
|------|------|---------|---------|---------|
| {起点} → {终点} | {X} km | {高铁/驾车} | {X} 小时 | ¥{X}/人 |

### 🚉 高铁站→景点距离参考

| 景点 | 距{XX}站距离 | 建议通行方式 |
|------|------------|------------|
| {景点A} | 约 {X} km / {X} 分钟 | {打车约¥X / 公交X路 / 步行} |
| {景点B} | 约 {X} km / {X} 分钟 | {打车约¥X / 公交X路} |

> 💡 {若景点间距 >15km，在此插入当地租车建议；否则省略此行}

---

## ⛅ 天气预报

{天气描述，包含：天气状况、气温范围、风力风向、降水概率}

---

## 🗓️ 详细行程

### 早上（07:30 - 09:00）
- 🥣 **早餐**：{餐厅名称}（{地址}）
  - 推荐：{当地特色早餐品类，如：豆浆油条+鲜肉包 / 肠粉+猪杂粥 / 牛肉面+小菜}
  - 预计人均：¥{X}

### 上午（09:00 - 12:00）
- **{景点名称}**｜建议游玩：{X} 小时
  - 📍 必打卡：{具体地点/项目}
  - 🎫 门票：¥{X}（{提前预约/无需预约}）

### 中午（12:00 - 14:00）
- 🍜 **午餐**：{餐厅名称}（{地址}）
  - 推荐菜品：{菜品1}、{菜品2}
  - 预计人均：¥{X}

### 下午（14:00 - 18:00）
- **{景点名称}**｜建议游玩：{X} 小时
  - 📍 必打卡：{具体地点/项目}
  - 🎫 门票：¥{X}

### 晚上（18:00 起）
- 🍽️ **晚餐**：{餐厅名称}（{地址}）
  - 推荐菜品：{菜品1}、{菜品2}（{推荐理由，如：本地人气老店 / 必吃当地菜}）
  - 预计人均：¥{X}
- 🌙 **夜游**：{夜市/夜景/特色街区}（可选）

---

## 🏨 住宿推荐

根据预算，推荐以下 {1-2} 家性价比酒店（距主要景区约 {X} 分钟）：

**方案一：{酒店名称}** ⭐ 首选
- 地址：{地址}
- 房型：{大床房/标间} × {X} 间
- 预计价格：¥{X}/晚
- 推荐理由：{评分高/近景区/含早餐/性价比首选，具体说明}

**方案二：{酒店名称}**（备选）
- 地址：{地址}
- 房型：{大床房/标间}
- 预计价格：¥{X}/晚
- 推荐理由：{价格更低/环境干净/适合预算有限，具体说明}

---

## 🎒 出行物资清单

**穿搭建议**：{根据气温给出具体穿搭，如"长袖+薄外套+运动鞋"，不要模糊描述}

**必备物品**：
- {物品1}（{原因}）
- {物品2}（{原因}）

---

## ⚠️ 注意事项

- {注意事项1}
- {注意事项2}

---

## 💰 费用预估汇总（人均）

| 类别 | 预估花费 |
|------|---------|
| 往返交通 | ¥{X} |
| 当地交通（打车/租车/公交） | ¥{X} |
| 景点门票 | ¥{X} |
| 早餐（{X}天） | ¥{X} |
| 午餐（{X}天） | ¥{X} |
| 晚餐（{X}天） | ¥{X} |
| 住宿（{X}晚，分摊） | ¥{X} |
| **合计** | **¥{X}** |