名称： surfline
描述： 从 Surfline 公共端点（无需登录）获取冲浪预报和当前状况。可用于查询 Surfline 浪点 ID、获取特定浪点的预报/状况，并汇总多个收藏浪点。

Surfline（公共端点，无需登录）

此技能使用 Surfline 的公共端点（无需账户或 cookies）。

快速开始

1) 查找浪点 ID：

python3 scripts/surfline_search.py "Cardiff Reef"
python3 scripts/surfline_search.py "D Street"

2) 获取浪点报告（默认同时输出文本和 JSON）：

python3 scripts/surfline_report.py <spotId>
# 或仅输出一种格式：
python3 scripts/surfline_report.py <spotId> --text
python3 scripts/surfline_report.py <spotId> --json

3) 收藏浪点汇总（多个浪点）（默认同时输出文本和 JSON）：

创建 ~/.config/surfline/favorites.json 文件（参考 references/favorites.json.example）。

python3 scripts/surfline_favorites.py

注意事项

• 请求频率请保持适度：避免频繁调用端点。脚本已包含基础缓存机制。
• 浪点 ID 是稳定的；获取后可存储备用。
• 若 Surfline 更新端点或字段，请相应更新 scripts/surfline_client.py。