nonebot-plugin-heweather 0.11.0

Get Heweather information and convert to pictures

nonebot-plugin-heweather

✨ 获取和风天气信息并转换为图片，支持每日定时推送 ✨

使用 html+playwright 来渲染好看的！

功能特性

• 天气查询：输入城市名称获取实时天气信息
• 每日推送：订阅每日定时天气预报，支持群聊和私聊
• 跨平台兼容：基于 nonebot-plugin-alconna，支持多种聊天适配器

依赖

• nonebot-plugin-htmlrender - HTML 渲染
• nonebot-plugin-alconna - 跨适配器命令处理
• nonebot-plugin-apscheduler - 定时任务
• nonebot-plugin-localstore - 数据持久化

需要先保证 playwright 可以正常运行并在系统（或容器中）存在中文字体

安装

直接使用 pip install nonebot-plugin-heweather 进行安装

在 bot.py 中 写入 nonebot.load_plugin("nonebot_plugin_heweather")

指令

天气查询

天气+地区 或 地区+天气
例如：上海天气 或 天气广州

每日推送

指令	说明	示例
天气订阅 城市 HH:MM	订阅每日天气推送	天气订阅 上海 08:30
天气取消订阅	取消当前订阅	天气取消订阅
天气订阅状态	查看当前订阅配置	天气订阅状态

说明：

• 推送时间使用 24 小时制，格式为 HH:MM
• 每个群聊/用户可订阅多个城市
• 群聊中需要管理员权限才能管理订阅
• 订阅数据保存在 NoneBot 数据目录中

配置

JWT 认证配置

参考文档 身份认证 生成 Ed25519 密钥，并且上传公钥

# JWT sub，即控制台中的项目管理的项目ID
QWEATHER_JWT_SUB=

# JWT Key ID，在控制台上传公钥后获取，凭据 ID
QWEATHER_JWT_KID=

# JWT 私钥文本，需要自行生成，需要单行填写，例如
# qweather_jwt_private_key="-----BEGIN PRIVATE KEY-----\n123abc\n-----END PRIVATE KEY-----"
QWEATHER_JWT_PRIVATE_KEY=

API 主机配置

参考文档 API 配置 在 控制台-设置 获取地址。务必添加 scheme https://

# API 主机地址，默认为 https://api.qweather.com
QWEATHER_APIHOST=https://api.qweather.com

天气预报配置

# 每日预报天数，默认 3 天 根据订阅类型可选最多 30 天
QWEATHER_FORECASE_DAYS=3

# 逐小时预报类型
# 1 = 未来12小时 (默认值)
# 2 = 未来24小时
QWEATHER_HOURLYTYPE=1

调试配置

# 是否开启调试模式，默认为 false
DEBUG=false

配置获取方式

1. 进入控制台
2. 项目管理 -> 创建项目
3. 创建凭据
4. 选择 JWT 类型，并按照文档创建公钥和私钥
5. 上传公钥并保存提交
6. 设置 -> 开发者信息 -> API Host 获取地址
7. 填写 .env 文件

参考文档

和风天气文档-订阅