felinae98/nonebot-bison Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Bison 通用订阅推送插件

镜像概述

Bison是一款基于NoneBot2开发的通用订阅推送插件（前身为nonebot-hk-reporter，寓意"快速搬运"，后因名称调整为Bison，取自明日方舟角色"拜松"——龙门信使），主要功能是自动爬取各类站点及社交平台的更新动态，并将信息推送至QQ。

主要用途

• 监控社交媒体平台（微博、Bilibili等）的最新动态
• 获取游戏公告（明日方舟、FF14等）及版本更新通知
• 订阅RSS源、网易云音乐专辑/电台更新等内容
• 通过QQ接收定制化的定时推送服务

支持平台

• 微博：图文、视频、纯文字、转发内容
• Bilibili：视频、图文、专栏、转发、纯文字动态
• RSS：富文本转纯文本、提取图片链接
• 明日方舟：塞壬唱片新闻、游戏内公告、版本更新、泰拉记事社漫画
• 网易云音乐：歌手新专辑发布、电台更新
• FF14：游戏官方公告

核心功能与特性

• 定时爬取：自动定时抓取指定平台的最新内容，确保信息时效性
• 防风控机制：通过图片形式发送文本内容，降低QQ风控风险
• 发送频率控制：采用队列机制限制消息发送频率，避免消息拥堵
• 网页后台管理：提供可视化后台界面，便捷管理订阅配置

使用场景与适用范围

• 社交媒体监控：企业或个人需实时跟踪微博/B站账号动态
• 游戏公告推送：游戏玩家获取明日方舟、FF14等游戏的最新公告
• 内容聚合订阅：通过RSS聚合博客、新闻站点更新
• 音乐/视频更新提醒：监控歌手新专辑、UP主视频发布

使用方法与配置说明

部署方式

支持Docker、docker-compose、NoneBot插件集成及源码直接运行等多种部署方式，推荐使用Docker或docker-compose简化部署流程。

Docker部署

bash
docker run -d --name bison -p 8080:8080 felinae98/nonebot-bison

docker-compose部署

创建docker-compose.yml配置文件：

yaml
version: '3'
services:
  bison:
    image: felinae98/nonebot-bison
    ports:
      - "8080:8080"  # 后台管理界面端口
    environment:
      - COMMAND_START=[""]  # 命令前缀配置，默认无前缀（根据需求调整）
    restart: always

启动服务：

bash
docker-compose up -d

后台管理功能说明

若需使用网页后台管理，注意：

• Docker/PyPI版本已内置前端资源，可直接使用
• 源码部署需手动构建前端：

  bash
  cd ./admin-frontend
  yarn && yarn build
  

环境配置注意事项

• Python版本：直接部署需Python 3.9+（项目使用3.9+语法），Docker部署无需额外配置
• 命令前缀：通过COMMAND_START环境变量配置命令前缀（如["/"]时需发送/添加订阅）

常见问题（FAQ）

1. 报错TypeError: 'type' object is not subscriptable
   原因：Python版本低于3.9。解决：升级至Python 3.9+，推荐Docker部署。

2. Bot无响应
   排查：确认发送者为群主/管理员；检查COMMAND_START配置，确保命令前缀正确（如无前缀配置需直接发送指令）。

3. 微博订阅漏推
   原因：微博风控机制更新导致部分内容无法抓取。建议关注项目更新以适配最新风控策略。

鸣谢

• go-cqhttp：CQHTTP协议实现
• NoneBot2：插件开发框架
• HarukaBot：实现思路参考
• rsshub：提供数据源API

许可证

MIT