Fishing Hotspot Push - 钓鱼热点推送 v1.0

Overview

主动发现式钓鱼助手。不需要用户指定目的地——系统自动从多渠道聚合钓鱼情报，结合用户位置、天气条件、钓鱼指数，推送"哪里正在出鱼"。与 fishing-trip-planner 形成互补：热点推送告诉你「去哪钓」，行程规划帮你「怎么去」。

核心能力:

• 🌐 多源数据聚合: 搜索引擎 + 钓鱼社区 + 和风天气 + 高德POI
• 🧠 NLP信息提取: 从非结构化文本中提取钓点、鱼种、鱼获
• 📊 智能排序: 距离 × 鱼获质量 × 天气 × 时效性
• 📱 可视化报告: 交互式HTML，支持一键跳转行程规划
• 📋 历史归档: 每次推送自动存档，可回溯对比

When to Use

触发词: 钓鱼热点、今日鱼情、附近钓点、哪里出鱼、钓鱼推送、钓鱼情报、fishing hotspot、查鱼情、最新钓况

Workflow

Step 0: 首次配置（仅一次）

python scripts/hotspot_push.py --setup

交互式输入:

1. 高德地图 API Key（与 fishing-trip-planner 共用）
2. 和风天气 API Key（与 fishing-trip-planner 共用）
3. 默认城市/位置
4. 搜索半径（默认 50km）
5. 偏好鱼种（淡水/海水/不限）

配置存储于 ~/.fishing-hotspot/config.json。

快捷方式: 如果已配置过 fishing-trip-planner，本技能自动读取其 API Key。

Step 1: 数据采集（Agent 辅助）

Agent 使用 WebSearch 工具搜索目标城市的钓鱼情报：

搜索关键词模板:
- "{城市} 钓鱼 出鱼 钓点 {日期}"
- "{城市} 野钓 爆护 鱼获"
- "{城市} 钓鱼 最新 钓况"

同时调用和风天气钓鱼指数 API、高德周边水域 POI 搜索。

Step 2: 运行热点分析

方式A — Agent 搜索 + 脚本分析（推荐）: Agent 先执行 WebSearch，将搜索结果文本通过 --input 传入脚本：

python scripts/hotspot_push.py --run --input "搜索结果的原始文本..."

方式B — 脚本独立运行:

python scripts/hotspot_push.py --run

仅使用 API 数据（天气+POI），不含社交媒体情报。

方式C — 指定城市:

python scripts/hotspot_push.py --run --city "深圳"

脚本自动完成:

1. 城市坐标定位 → 高德地图
2. 周边水域/钓场 POI 搜索 → 高德地图
3. 钓鱼指数 + 天气预报 → 和风天气
4. 文本情报 NLP 提取（如有 --input）
5. 综合排序评分
6. 生成 HTML 报告并自动存档

Step 3: 展示报告

脚本输出 HTML 报告路径，使用 preview_url 展示。

Step 4: 查看历史

python scripts/hotspot_push.py --history    # 列表
python scripts/hotspot_push.py --view 1     # 按序号打开

与 fishing-trip-planner 联动

热点推送报告中每个钓点都带有「🗺️ 生成行程」链接。Agent 看到用户点击后，自动调用 fishing-trip-planner 的规划流程。

数据存储结构

~/.fishing-hotspot/
├── config.json              # 配置（权限 600）
├── push_index.json          # 推送历史索引
└── reports/
    ├── 20260613_083000.html # HTML报告
    └── ...

命令行参考

python hotspot_push.py --setup              # 配置向导
python hotspot_push.py --run                # 执行热点分析（仅API数据）
python hotspot_push.py --run --city "深圳"   # 指定城市
python hotspot_push.py --run --input "..."   # 传入外部文本情报
python hotspot_push.py --history             # 查看历史
python hotspot_push.py --view \x3CID>           # 查看历史报告

Resources

scripts/hotspot_push.py

核心脚本。包含配置管理、API调用、NLP提取、排序算法、HTML生成、历史存档。

references/api_guide.md

API 密钥获取指南（与 fishing-trip-planner 共用路径）。