和风天气-hefengweather_生活服务 skill-PHP中文网

和风天气-hefengweather

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

提供基于和风天气API的全面气象数据查询服务,包括实时天气、多天预报、逐小时预报、空气质量、生活指数、气象预警、天文数据、分钟级降水预报、格点天气和地理信息查询。当用户需要查询天气信息、空气质量、气象预警或天文数据时触发此技能。

和风天气查询 Skill

功能概述

和风天气查询 Skill是一项面向实际任务的技能，主要用于基于和风天气API的气象数据查询服务,提供全面的天气相关数据查询功能,支持实时天气、天气预报、空气质量、生活指数等多种气象数据查询；1. 获取和风天气API；

核心要点

访问和风天气开发者平台注册账号并获取API密钥；
2. 配置认证信息；
使用以下 Python 脚本配置API认证；

使用与执行

或手动创建配置文件 ~/.config/qweather/.env。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

结果检查与注意事项

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

和风天气查询 Skill

概述

基于和风天气API的气象数据查询服务,提供全面的天气相关数据查询功能,支持实时天气、天气预报、空气质量、生活指数等多种气象数据查询。

前置配置

1. 获取和风天气API

访问和风天气开发者平台注册账号并获取API密钥。

2. 配置认证信息

使用以下 Python 脚本配置API认证:

python scripts/configure.py --api-host "your-domain.qweatherapi.com" --api-key "your_api_key"

或手动创建配置文件 ~/.config/qweather/.env:

HEFENG_API_HOST=your-domain.qweatherapi.com
HEFENG_API_KEY=your_api_key_here

核心功能

1. 基础天气查询

实时天气

查询指定城市的当前天气状况。

触发场景: 用户询问"今天天气怎么样"、"北京现在天气"、"当前气温"等

执行脚本:

python scripts/weather_now.py --city "北京"

参数:

--city: 城市名称(如"北京"、"上海")
--location: LocationID或经纬度(可选,与city二选一)
--lang: 语言(默认"zh")
--unit: 单位"m"公制或"i"英制(默认"m")

返回示例:

{
  "now": {
    "temp": "18",
    "text": "晴",
    "windDir": "东北风",
    "windScale": "3",
    "humidity": "45"
  }
}

天气预报

查询未来3-30天的天气预报。

触发场景: 用户询问"明天天气"、"未来一周天气"、"北京7天预报"等

执行脚本:

python scripts/weather.py --city "上海" --days "3d"

参数:

--city: 城市名称(必需)
--days: 预报天数,支持"3d"(默认)、"7d"、"10d"、"15d"、"30d"

逐小时预报

查询未来24/72/168小时的逐小时天气预报。

触发场景: 用户询问"今天下午天气"、"未来24小时天气"、"每小时预报"等

执行脚本:

python scripts/weather_hourly.py --city "北京" --hours "24h"

参数:

--city: 城市名称
--location: 经纬度坐标(与city二选一)
--hours: 预报小时数,"24h"(默认)、"72h"、"168h"

历史天气

查询最近10天的历史天气数据。

执行脚本:

python scripts/weather_history.py --city "北京" --days 7

2. 空气质量查询

实时空气质量

查询指定城市的实时空气质量指数(AQI)。

触发场景: 用户询问"空气质量怎么样"、"AQI多少"、"PM2.5"等

执行脚本:

python scripts/air_quality.py --city "北京"

参数:

--city: 城市名称(必需)

空气质量预报

查询逐小时或逐日的空气质量预报。

执行脚本:

# 逐小时预报
python scripts/air_quality_hourly.py --location "39.90,116.40" --hours "24h"

# 逐日预报
python scripts/air_quality_daily.py --location "39.90,116.40" --days "3d"

历史空气质量

查询最近10天的历史空气质量数据。

执行脚本:

python scripts/air_quality_history.py --city "北京" --days 7

3. 生活指数查询

查询天气生活指数,包括运动、洗车、穿衣、感冒、紫外线等16种指数。

触发场景: 用户询问"适合运动吗"、"要不要洗车"、"穿什么衣服"等

执行脚本:

python scripts/indices.py --city "上海" --days "1d"

参数:

--city: 城市名称(必需)
--days: 预报天数,"1d"(默认)或"3d"
--types: 指数类型ID(可选,默认全部16种)

指数类型:

1:运动指数, 2:洗车指数, 3:穿衣指数, 4:感冒指数, 5:紫外线指数
6:旅游指数, 7:花粉过敏指数, 8:舒适度指数, 9:交通指数, 10:防晒指数
11:化妆指数, 12:空调开启指数, 13:晾晒指数, 14:钓鱼指数, 15:太阳镜指数
16:空气污染扩散条件指数

4. 气象预警查询

查询气象灾害预警信息,包括台风、暴雨、高温等预警。

触发场景: 用户询问"有预警吗"、"天气预警"、"暴雨预警"等

执行脚本:

python scripts/warning.py --city "杭州"

5. 天文数据查询

日出日落时间

查询指定地点和日期的日出日落时间。

触发场景: 用户询问"几点日出"、"日落时间"、"今天太阳几点下山"等

执行脚本:

python scripts/astronomy_sun.py --location "北京" --date "20251029"

参数:

--location: 城市名、LocationID或经纬度(必需)
--date: 日期,格式yyyyMMdd(今天到未来60天)

月相数据

查询月升月落时间和24小时月相数据。

执行脚本:

python scripts/astronomy_moon.py --location "上海" --date "20251101"

6. 分钟级降水预报

查询未来2小时5分钟级的降水预报。

触发场景: 用户询问"会下雨吗"、"什么时候下雨"、"接下来两小时天气"等

执行脚本:

python scripts/minutely_5m.py --location "116.38,39.91"

7. 格点天气查询

提供高分辨率数值模式的格点天气数据(3-5公里分辨率)。

格点实时天气

python scripts/grid_weather_now.py --location "116.41,39.92"

格点每日预报

python scripts/grid_weather_daily.py --location "116.41,39.92" --days "3d"

格点逐小时预报

python scripts/grid_weather_hourly.py --location "116.41,39.92" --hours "24h"

8. 地理信息查询

POI搜索

搜索兴趣点(景点、潮汐站点等)。

执行脚本:

# 关键词搜索
python scripts/search_poi.py --location "北京" --keyword "故宫" --poi-type "scenic"

# 范围搜索
python scripts/search_poi_range.py --location "116.38,39.91" --poi-type "scenic" --radius 5

POI类型: