Skip to content

Last-emo-boy/astrbot_plugin_weather

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Weather Plugin

基于 心知天气(Seniverse) 的免费 API,为 AstrBot 提供 /weather 指令,支持查询当前天气、未来 3 天预报和生活指数(可选)等功能。

功能特性

  1. 当前天气:输入 /weather current <城市> 即可查询该城市的实时天气信息(气温、湿度、风速、天气现象等)。
  2. 未来预报:输入 /weather forecast <城市> 可查看未来 3 天的天气预报,可选集成 6 项生活指数(穿衣、雨伞、洗车、感冒、运动、紫外线)。
  3. 可配置:通过管理面板或配置文件修改 Seniverse API Key、默认城市等。
  4. 可选 LLM Function-Calling:在开启 function-calling 的情况下,LLM 可自动调用插件提供的天气查询工具函数,实现自动获取天气结果。

安装与配置

  1. 将插件文件夹(包含 main.py, _conf_schema.json, plugin.yaml 等)放入 AstrBot 的插件目录。
  2. 重启 AstrBot,进入管理面板找到本插件,在“配置”中填写你的 Seniverse API Key(免费版可用,但接口及字段有限)。
  3. 如需修改默认城市或其他选项,可在管理面板的插件配置处,或在 config 文件中进行更改。

使用示例

  • 查询当前天气:

    /weather current 北京

    插件返回一个图文卡片,展示温度、湿度、风速等信息。

  • 查询未来 3 天预报:

    /weather forecast 上海

    插件返回一张包含未来 3 天天气情况(以及可选生活指数)的图片。

  • 查看插件帮助:

    /weather help

注意事项

  • 心知天气免费版仅能返回 3 天预报6 项基础生活指数,以及当前天气的部分字段。若需更多高级功能或更长预报天数,请参考官方文档并升级套餐。
  • 如果使用中遇到 超时无结果,请先检查日志,确认网络可访问 www.seniverse.com,以及你的 API Key 填写是否正确。
  • 生活指数、体感温度等字段可能在免费版部分城市缺失,如果接口未返回相应字段,插件将留空显示。

开源协议

本插件的源码位于 GitHub。欢迎提出 Issue 或 PR 来帮助我们改进插件。

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages