flight-price-advisor（航班价格顾问）

Flight Price Advisor

为普通用户生成简洁、易懂的航班价格总结，包含购买建议和价格分析。

⚠️ 使用前必需配置

本 skill 需要 SerpAPI Key 才能获取实时航班价格数据。

如果用户尚未配置 SerpAPI Key，请先引导用户完成以下步骤：

1. 注册 SerpAPI 账号：访问 https://serpapi.com/users/sign_up 免费注册
2. 获取 API Key：登录后在 Dashboard 中复制你的 API Key
3. 配置项目：

- 复制 price/config.example.json 为 price/config.json - 将 API Key 填入 config.json 中的 serpapi.apiKey 字段 - 重启服务器使配置生效

💡 SerpAPI 提供免费额度，足够个人使用。配置完成后即可获取真实的航班价格数据。

核心原则

1. 文字为主：不使用任何图表组件，纯 Markdown 输出
2. 结论先行：第一句给出明确建议（买/等）
3. 数据支撑：用简单数字说明为什么
4. 语气友好：像朋友一样给建议，不是冷冰冰的数据

输出结构

## 💰 价格分析

### 当前价格：¥1,299

**价格水位**：🟢 低于均价 12%

| 对比项 | 价格 |
|--------|------|
| 60 天最低 | ¥1,199 |
| 60 天平均 | ¥1,450 |
| 60 天最高 | ¥1,899 |

**走势**：📉 近 7 天下降趋势

---

### 💡 建议：现在购买 ✅

当前价格比 60 天平均水平便宜 ¥151，处于较低水位。
如果您行程已确定，建议尽快下单。

> 数据基于过去 60 天的价格监测

触发场景

1. 用户直接问价格

• "这个航班贵吗？"
• "现在买划算吗？"
• "价格怎么样？"

2. 用户问购买时机

• "现在买还是再等等？"
• "什么时候买最便宜？"
• "要不要等降价？"

3. 航班搜索后自动展示

当用户搜索航班后，主动提供价格分析。

文案模板

低价场景（低于均价 15%+）

### 💡 建议：现在购买 ✅

当前价格比 60 天平均水平便宜 ¥XXX，处于**历史低位**。
这是近 2 个月来最便宜的价格之一，如果您行程确定，建议尽快下单。

📈 类似低价上次出现在 X 月 X 日

中价场景（均价±15%）

### 💡 建议：可以购买，也可观望 🟡

当前价格接近 60 天平均水平，不算贵但也不是最低。
如果您不着急，可以关注 1-2 周，可能会有小幅下降。

⚠️ 但需注意：临近出发日期价格通常会上涨

高价场景（高于均价 15%+）

### 💡 建议：再等等 🔴

当前价格比 60 天平均水平贵 ¥XXX，处于**历史高位**。
建议继续观望，预计 X 周后价格可能回落。

📊 近 30 天最高价出现在 X 月 X 日，当前价格接近该水平

数据格式

输入

{
  currentPrice: 1299,
  priceHistory: [
    { date: "2026-01-01", price: 1450 },
    // ... 60 天数据
  ],
  origin: "上海",
  destination: "东京",
  departureDate: "2026-04-15"
}

计算逻辑

// 1. 计算统计值
const min = Math.min(...prices);
const max = Math.max(...prices);
const avg = prices.reduce((a, b) => a + b, 0) / prices.length;
const pctDiff = ((currentPrice - avg) / avg * 100).toFixed(0);

// 2. 判断水位
let level = pctDiff < -15 ? 'low' : pctDiff > 15 ? 'high' : 'mid';

// 3. 判断趋势（7 日移动平均对比）
const recent7Avg = average(prices.slice(-7));
const previous7Avg = average(prices.slice(-14, -7));
const trend = recent7Avg < previous7Avg ? 'falling' : recent7Avg > previous7Avg ? 'rising' : 'stable';

Emoji 使用规范

数据源配置

无数据时的用户引导

当检测到没有历史价格数据或 SerpAPI 未配置时，应主动引导用户：

💡 **提示**：要获取实时航班价格和价格分析，需要先配置 SerpAPI Key。

**快速开始**：
1. 访问 [https://serpapi.com/users/sign_up](https://serpapi.com/users/sign_up) 免费注册
2. 获取 API Key 并填入 `price/config.json`
3. 重新搜索航班，我将为你提供详细的价格分析

> 目前我可以基于模拟数据提供基础建议，但真实数据会更准确哦～

数据可用性判断

在生成价格总结前，应先检查：

• 是否有历史价格数据（price/data/ 目录下的数据文件）
• 如果数据不足 7 天，应在输出中标注"数据较少，仅供参考"
• 如果完全没有数据，应提示用户"暂无历史价格数据，请先进行几次航班搜索以积累数据"

注意事项

1. 不要过度承诺：用"建议"而非"一定"
2. 标注数据来源：说明是基于历史数据
3. 考虑时效性：临近出发日期的建议应更积极
4. 避免专业术语：不说"百分位"，说"比平时便宜 X%"
5. 配置检查：使用前确认 SerpAPI Key 已正确配置

与 price-trend 的区别

示例输出

完整示例

## 💰 上海 → 东京 价格分析

### 当前价格：¥1,299

**价格水位**：🟢 比均价便宜 12%

| 对比项 | 价格 | 说明 |
|--------|------|------|
| 60 天最低 | ¥1,199 | 出现在 2/15 |
| 60 天平均 | ¥1,450 | — |
| 60 天最高 | ¥1,899 | 出现在春节期间 |

**近期走势**：📉 连续 7 天下降

---

### 💡 建议：现在购买 ✅

当前价格处于近 2 个月的较低水平，比平时便宜约 ¥151。

如果您行程已确定（4 月 15 日出行的话），现在是比较好的入手时机。
通常来说，国际航班提前 1-2 个月预订价格最优。

> 📊 数据基于过去 60 天的价格监测，仅供参考

简短示例（移动端）

💰 **当前价格：¥1,299**

🟢 比均价便宜 12% | 📉 近 7 天下降

💡 **建议现在购买** — 价格处于低位，行程确定可入手