Files
Estrella Pan 396a92787e fix: 回滚后再升级时重新备份 3.x 数据库,单个下载器重命名出错不拖垮其它实例
- version_check: 数据库仍是 3.x 结构(schema ≤ 24)时备份并原子替换 data.db.v3.bak,
  回滚 3.3 后再升级也会刷新备份;只留一份,迁移失败的重启循环不会堆积
- rename_all: 实例内的异常记录后继续下一个实例
- 文档:回滚步骤删除 data.db-wal/-shm、还原编号最大的配置备份;schema v28
- 插件 skill 改用 httpx2、补全示例列表;示例 README 先安装 SDK 轮子再测试
- 准备 4.0.0-beta.9
2026-10-24 11:00:56 +02:00
..

OneBot 通知

通过 OneBot v11 HTTP API 把通知发到 QQ 私聊或群。NapCat、Lagrange.OneBot、LLOneBot 等实现都提供这个接口。

  • @provider(points.NOTIFIER, id="onebot"):返回 NotifierFactory
  • 向 {url}/send_private_msg(user_id)或 {url}/send_group_msg(group_id)POST JSON,消息为消息段数组
  • 填写了 Access Token 时附带 Authorization: Bearer <token>
  • HTTP 2xx 且返回 status == "ok" 或 retcode == 0 才算成功

配置

字段 说明
url OneBot HTTP API 地址,如 http://napcat:3000
access_token 可选:Access Token(秘密字段)
message_type private(私聊)或 group(群聊)
target 私聊填 QQ 号,群聊填群号
send_poster 是否附带海报图片,默认开启

海报

插件只能拿到宿主给出的公开海报地址,拿不到本地海报文件。因此要发送海报,需要在「设置 → 通知」中配置 base_url,并保证 OneBot 实现能访问这个地址;它会自行下载图片。未配置时只发送文字。海报在文字之后作为单独一条消息发送:发送结果只看文字,图片失败(如 OneBot 实现取不到海报)不影响已送达的文字,也不重发。

安装

cp -r examples/plugins/onebot-notifier config/plugins/local/

在「设置 → 插件」中开启「允许未签名插件」,启用并填写 API 地址与目标;再到「设置 → 通知 → 添加渠道」选择类型 onebot。

测试

cd examples/plugins/onebot-notifier
uv add ../autobangumi_sdk-0.6.0-py3-none-any.whl   # SDK 不在 PyPI:换成下载的轮子的实际路径
uv run pytest

基于 @AMYdd00 在 #1033 中的实现