mirror of https://github.com/suyiiyii/nonebot-bison.git synced 2025-06-05 19:36:43 +08:00

Sherkey 0e6dfffee8 📝 fix nonebot2 docs url

2023-04-03 18:20:39 +08:00

11 KiB

Raw Blame History

sidebar
auto

部署和使用

本节将教你快速部署和使用一个 nonebot-bison，如果你不知道要选择哪种部署方式，推荐使用docker-compose

部署

本项目可以作为单独的 Bot 使用，可以作为 nonebot2 的插件使用

作为 Bot 使用

额外提供自动同意超级用户的好友申请和同意超级用户的加群邀请的功能

docker-compose 部署 [推荐]

在一个新的目录中下载docker-compose.yml
将其中的<your QQ>改成自己的 QQ 号
```
wget https://raw.githubusercontent.com/felinae98/nonebot-bison/main/docker-compose.yml
```

运行配置 go-cqhttp

docker-compose run go-cqhttp

通信方式选择：3: 反向 Websocket 通信
编辑bot-data/config.yml，更改下面字段：

account: # 账号相关
  uin: <QQ号> # QQ账号
  password: "<QQ密码>" # 密码为空时使用扫码登录

message:
  post-format: array

............

servers:
  - ws-reverse:
      universal: ws://nonebot:8080/onebot/v11/ws/ # 将这个字段写为这个值

登录 go-cqhttp 再次
```
docker-compose run go-cqhttp
```
参考go-cqhttp 文档完成登录
确定完成登录后，启动 bot：
```
docker-compose up -d
```

docker 部署

本项目的 docker 镜像为felinae98/nonebot-bison，可以直接 pull 后 run 进行使用，相关配置参数可以使用-e作为环境变量传入

直接运行（不推荐）

可以参考nonebot 的运行方法 ::: danger 直接克隆源代码需要自行编译前端，否则会出现无法使用管理后台等情况。 ::: ::: danger 本项目中使用了 Python 3.9 的语法，如果出现问题，请检查 Python 版本 :::

首先安装 poetry：安装方法
clone 本项目，在项目中poetry install安装依赖
安装 yarn，配置 yarn 源（推荐）
在admin-fronted中运行yarn && yarn build编译前端
编辑.env.prod配置各种环境变量，见Nonebot2 配置
运行poetry run python bot.py启动机器人

作为插件使用

本部分假设大家会部署 nonebot2

手动安装

安装 pip 包nonebot-bison
在bot.py中导入插件nonebot_bison

使用 nb-cli 安装

使用nb-cli执行：nb plugin install nonebot_bison

配置

::: tip INFO

如果要在在 nonebot 中配置需要的Bison 配置项，请参考NoneBot 配置方式，在.env/.env.*文件中写入希望配置的 Bison 配置项
请注意，在.env/.env.*中添加的配置项不需要声明变量类型 :::
BISON_CONFIG_PATH: 插件存放配置文件的位置，如果不设定默认为项目目录下的data目录
BISON_USE_PIC: 将文字渲染成图片后进行发送，多用于规避风控
BISON_BROWSER: 本插件使用 Chrome 来渲染图片
- 如果不进行配置，那么会在启动时候自动进行安装，在官方的 docker 镜像中已经安装了浏览器
- 使用本地安装的 Chrome，设置为local:<chrome path>，例如local:/usr/bin/google-chrome-stable
- 使用 cdp 连接相关服务，设置为wsc://xxxxxxxxx
- 使用 browserless 提供的 Chrome 管理服务，设置为ws://xxxxxxxx，值为 Chrome Endpoint ::: warning 截止发布时，本项目尚不能完全与 browserless 兼容，目前建议使用镜像内自带的浏览器，即不要配置这个变量 :::
BISON_SKIP_BROWSER_CHECK: 是否在启动时自动下载浏览器，如果选择False会在用到浏览器时自动下载，默认True
BISON_OUTER_URL: 从外部访问服务器的地址，默认为http://localhost:8080/bison/，如果你的插件部署在服务器上，建议配置为http://<你的服务器ip>:8080/bison/ ::: warning 如果需要从外网或者 Docker 容器外访问后台页面，请确保HOST=0.0.0.0 :::
BISON_FILTER_LOG: 是否过滤来自nonebot的 warning 级以下的 log，如果你的 bot 只运行了这个插件可以考虑开启，默认关
BISON_USE_QUEUE: 是否用队列的方式发送消息，降低发送频率，默认开
BISON_RESEND_TIMES: 最大重发次数，默认 0
BISON_USE_PIC_MERGE: 是否启用多图片时合并转发（仅限群）
- 0: 不启用(默认)
- 1: 首条消息单独发送，剩余图片合并转发
- 2: 所有消息全部合并转发
::: details BISON_USE_PIC_MERGE 配置项示例
- 当BISON_USE_PIC_MERGE=1时:
- 当BISON_USE_PIC_MERGE=2时:
::: ::: warning 启用此功能时，可能会因为待推送图片过大/过多而导致文字消息与合并转发图片消息推送间隔过大(选择模式1时)，请谨慎考虑开启。或者选择模式2，使图文消息一同合并转发(可能会使消息推送延迟过长) :::
BISON_PROXY: 使用的代理连接，形如http://<ip>:<port>（可选）
BISON_UA: 使用的 User-Agent，默认为 Chrome
BISON_SHOW_NETWORK_WARNING: 是否在日志中输出网络异常，默认开启

使用

::: warning 本节假设COMMAND_START设置中包含''

如果出现 bot 不响应的问题，请先排查这个设置
尝试在命令前添加设置的命令前缀，如COMMAND_START=['/']，则尝试使用/添加订阅 :::

命令

在本群中进行配置

所有命令都需要@bot 触发

添加订阅（仅管理员和群主和 SUPERUSER）：添加订阅 ::: details 关于中止添加订阅对于v0.5.1及以上的版本中，已经为添加订阅命令添加了中止添加功能。
在添加订阅命令的几乎各个阶段，都可以向 Bot 发送取消消息来中止订阅过程(需要发起者本人发送) :::
查询订阅：查询订阅
删除订阅（仅管理员和群主和 SUPERUSER）：删除订阅 ::: details 关于中止删除订阅对于v0.5.3及以上的版本中，已经为删除订阅命令添加了中止删除功能。在删除订阅命令的几乎各个阶段，都可以向 Bot 发送取消消息来中止订阅过程(需要发起者本人发送) :::

私聊机器人获取后台地址

后台管理，之后点击返回的链接
如果你是 superuser，那么你可以管理所有群的订阅；
如果你是 bot 所在的群的其中部分群的管理，你可以管理你管理的群里的订阅；
如果你不是任意一个群的管理，那么 bot 将会报错。 ::: tip 可以和 bot 通过临时聊天触发 ::: ::: warning 网页的身份鉴别机制全部由 bot 返回的链接确定，所以这个链接并不能透露给别人。
并且链接会过期，所以一段时间后需要重新私聊 bot 获取新的链接。 :::

私聊机器人进行配置（需要 SUPERUER 权限）

请私聊 bot群管理 ::: details 关于中止订阅与普通的添加订阅/删除订阅命令一样，在群管理命令中使用的添加订阅/删除订阅命令也可以使用取消来中止订阅过程 :::

命令行命令(CLI)

Nonebot Bison CLI, 目前用于实现Bison订阅的导入导出功能

用法:
  nb bison COMMAND [OPTIONS] [ARGS]

Command(命令):

  export:
  导出Nonebot Bison Exchangable Subcribes File
      Options(选项):
        -p, --path TEXT           导出路径, 如果不指定，则默认为工作目录
        --format [json|yaml|yml]  指定导出格式[json, yaml]，默认为 json
        --help                    显示帮助

  import:
  从Nonebot Biosn Exchangable Subscribes File导入订阅
      Options(选项):
        -p, --path TEXT           导入文件名  [必须]
        --format [json|yaml|yml]  指定导入格式[json, yaml]，默认为 json
        --help                    显示帮助

所支持平台的 uid

Weibo

对于一般用户主页https://weibo.com/u/6441489862?xxxxxxxxxxxxxxx，/u/后面的数字即为 uid
对于有个性域名的用户如：https://weibo.com/arknights，需要点击左侧信息标签下“更多”，链接为https://weibo.com/6279793937/about，其中中间数字即为 uid

Bilibili

主页链接一般为https://space.bilibili.com/161775300?xxxxxxxxxx，数字即为 uid

RSS

RSS 链接即为 uid

网易云音乐-歌手

在网易云网页上歌手的链接一般为https://music.163.com/#/artist?id=32540734，id= 后面的数字即为 uid

网易云音乐-电台

在网易云网页上电台的链接一般为https://music.163.com/#/djradio?id=793745436，id= 后面的数字即为 uid

平台订阅标签（Tag）

社交平台中的 Tag 一般指使用井号(#)作为前缀，将关键词进行标记，方便用户进行搜索的功能。
例子：#明日方舟# #每日打卡#（weibo、bilibili） #baracamp（Twitter）

在 Bison 中，用户在添加平台账号订阅时（如果该平台提供有 hashtag 功能），
会进行输入需要订阅/屏蔽tag的步骤。

如果需要订阅某些 tag，需要直接向 bison 发送需要订阅的一系列 tag，并使用空格进行分隔。
例：A1行动预备组罗德厨房——回甘

如果需要屏蔽某些 tag，需要在需要屏蔽的 tag 前加上前缀~，对于复数的 tag，使用空格进行分隔。
例：~123罗德岛 ~莱茵生命漫画

可以综合运用以上规则进行同时订阅/屏蔽。
例：A1行动预备组 ~123罗德岛罗德厨房——回甘 ~莱茵生命漫画

Tag 的推送规则

每当 Bison 抓取到一条推送，推送中的 Tag 会经过一下检查：

Bison 会对需屏蔽 Tag进行最优先检查，只要检测到本次推送中存在任一已记录的需屏蔽 tag，Bison 便会将该推送丢弃。
上一个检查通过后，Bison 会对需订阅 tag进行检查，如果本次推送中存在任一已记录的需订阅 tag，Bison 便会将该推送发送到群中。
当已记录的需订阅 tag为空时，只要通过了第一条规则的检查，Bison 就会将该推送发送到群中。
当已记录的需订阅 tag不为空时，即使通过了第一条规则的检查，若本次推送不含任何已记录的需订阅 tag，Bison 也会将该推送丢弃。

11 KiB Raw Blame History Unescape Escape