mirror of
https://github.com/suyiiyii/nonebot-bison.git
synced 2025-06-07 04:13:00 +08:00
docs:优化用户文档的配置项部分的相关描述
This commit is contained in:
parent
ac505f51d3
commit
0a3171689a
@ -27,7 +27,7 @@ sidebar: auto
|
|||||||
本项目使用了 pre-commit 来进行代码美化和格式化。在`poetry shell`状态下执行`pre-commit install`来安装 git hook,可自动在 commit 时
|
本项目使用了 pre-commit 来进行代码美化和格式化。在`poetry shell`状态下执行`pre-commit install`来安装 git hook,可自动在 commit 时
|
||||||
格式化代码。
|
格式化代码。
|
||||||
|
|
||||||
# 适配新网站
|
## 适配新网站
|
||||||
|
|
||||||
本插件需要你的帮助!只需要会写简单的爬虫,就能给本插件适配新的网站。
|
本插件需要你的帮助!只需要会写简单的爬虫,就能给本插件适配新的网站。
|
||||||
|
|
||||||
@ -41,7 +41,7 @@ Nonebot 项目使用了全异步的处理方式,所以你需要对异步,Pyt
|
|||||||
- `nonebot_bison.post`: 可以理解为推送内容,其中包含需要发送的文字,图片,链接,平台信息等,分为:
|
- `nonebot_bison.post`: 可以理解为推送内容,其中包含需要发送的文字,图片,链接,平台信息等,分为:
|
||||||
- `nonebot_bison.post.Post`: 简单的推送内容格式,需要发送的内容由 bison 处理
|
- `nonebot_bison.post.Post`: 简单的推送内容格式,需要发送的内容由 bison 处理
|
||||||
- `nonebot_bison.post.CustomPost`: 基于 markdown 语法的,自由度较高的推送内容格式
|
- `nonebot_bison.post.CustomPost`: 基于 markdown 语法的,自由度较高的推送内容格式
|
||||||
- 详细的介绍可参见[生成 bison 的推送文本](#生成bison的推送文本)
|
- 详细的介绍可参见[生成 bison 的推送文本](#生成-bison-的推送文本)
|
||||||
- `nonebot_bison.types.RawPost`: 从站点/平台中爬到的单条信息
|
- `nonebot_bison.types.RawPost`: 从站点/平台中爬到的单条信息
|
||||||
- `nonebot_bison.types.Target`: 目标账号,Bilibili,微博等社交媒体中的账号
|
- `nonebot_bison.types.Target`: 目标账号,Bilibili,微博等社交媒体中的账号
|
||||||
- `nonebot_bison.types.Category`: 信息分类,例如视频,动态,图文,文章等
|
- `nonebot_bison.types.Category`: 信息分类,例如视频,动态,图文,文章等
|
||||||
@ -53,7 +53,7 @@ Nonebot 项目使用了全异步的处理方式,所以你需要对异步,Pyt
|
|||||||
|
|
||||||
先明确需要适配的站点类型,先明确两个问题:
|
先明确需要适配的站点类型,先明确两个问题:
|
||||||
|
|
||||||
#### 我要发送什么样的推送
|
### 我要发送什么样的推送
|
||||||
|
|
||||||
- `nonebot_bison.platform.platform.NewMessage` 最常见的类型,每次爬虫向特定接口爬取一个消息列表,
|
- `nonebot_bison.platform.platform.NewMessage` 最常见的类型,每次爬虫向特定接口爬取一个消息列表,
|
||||||
与之前爬取的信息对比,过滤出新的消息,再根据用户自定义的分类和标签进行过滤,最后处理消息,把
|
与之前爬取的信息对比,过滤出新的消息,再根据用户自定义的分类和标签进行过滤,最后处理消息,把
|
||||||
@ -65,7 +65,7 @@ Nonebot 项目使用了全异步的处理方式,所以你需要对异步,Pyt
|
|||||||
,每次发送全部消息
|
,每次发送全部消息
|
||||||
例如:每日榜单定时发送
|
例如:每日榜单定时发送
|
||||||
|
|
||||||
#### 这个平台是否有账号的概念
|
### 这个平台是否有账号的概念
|
||||||
|
|
||||||
- 有账号的概念
|
- 有账号的概念
|
||||||
例如:B 站用户动态,微博用户动态,网易云电台更新
|
例如:B 站用户动态,微博用户动态,网易云电台更新
|
||||||
|
@ -4,7 +4,7 @@ sidebar: auto
|
|||||||
|
|
||||||
# 部署和使用
|
# 部署和使用
|
||||||
|
|
||||||
本节将教你快速部署和使用一个 nonebot-bison,如果你不知道要选择哪种部署方式,推荐使用[docker-compose](#docker-compose部署-推荐)
|
本节将教你快速部署和使用一个 nonebot-bison,如果你不知道要选择哪种部署方式,推荐使用[docker-compose](#docker-compose-部署-推荐)
|
||||||
|
|
||||||
## 部署
|
## 部署
|
||||||
|
|
||||||
@ -14,13 +14,15 @@ sidebar: auto
|
|||||||
|
|
||||||
额外提供自动同意超级用户的好友申请和同意超级用户的加群邀请的功能
|
额外提供自动同意超级用户的好友申请和同意超级用户的加群邀请的功能
|
||||||
|
|
||||||
#### docker-compose 部署(推荐)
|
#### docker-compose 部署 \[推荐\]
|
||||||
|
|
||||||
1. 在一个新的目录中下载[docker-compose.yml](https://raw.githubusercontent.com/felinae98/nonebot-bison/main/docker-compose.yml)
|
1. 在一个新的目录中下载[docker-compose.yml](https://raw.githubusercontent.com/felinae98/nonebot-bison/main/docker-compose.yml)
|
||||||
将其中的`<your QQ>`改成自己的 QQ 号
|
将其中的`<your QQ>`改成自己的 QQ 号
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
wget https://raw.githubusercontent.com/felinae98/nonebot-bison/main/docker-compose.yml
|
wget https://raw.githubusercontent.com/felinae98/nonebot-bison/main/docker-compose.yml
|
||||||
```
|
```
|
||||||
|
|
||||||
2. 运行配置 go-cqhttp
|
2. 运行配置 go-cqhttp
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@ -30,7 +32,7 @@ sidebar: auto
|
|||||||
通信方式选择:`3: 反向 Websocket 通信`
|
通信方式选择:`3: 反向 Websocket 通信`
|
||||||
编辑`bot-data/config.yml`,更改下面字段:
|
编辑`bot-data/config.yml`,更改下面字段:
|
||||||
|
|
||||||
```
|
```yml
|
||||||
account: # 账号相关
|
account: # 账号相关
|
||||||
uin: <QQ号> # QQ账号
|
uin: <QQ号> # QQ账号
|
||||||
password: "<QQ密码>" # 密码为空时使用扫码登录
|
password: "<QQ密码>" # 密码为空时使用扫码登录
|
||||||
@ -47,12 +49,16 @@ sidebar: auto
|
|||||||
|
|
||||||
3. 登录 go-cqhttp
|
3. 登录 go-cqhttp
|
||||||
再次
|
再次
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker-compose run go-cqhttp
|
docker-compose run go-cqhttp
|
||||||
```
|
```
|
||||||
|
|
||||||
参考[go-cqhttp 文档](https://docs.go-cqhttp.org/faq/slider.html#%E6%96%B9%E6%A1%88a-%E8%87%AA%E8%A1%8C%E6%8A%93%E5%8C%85)
|
参考[go-cqhttp 文档](https://docs.go-cqhttp.org/faq/slider.html#%E6%96%B9%E6%A1%88a-%E8%87%AA%E8%A1%8C%E6%8A%93%E5%8C%85)
|
||||||
完成登录
|
完成登录
|
||||||
|
|
||||||
4. 确定完成登录后,启动 bot:
|
4. 确定完成登录后,启动 bot:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker-compose up -d
|
docker-compose up -d
|
||||||
```
|
```
|
||||||
@ -96,8 +102,9 @@ sidebar: auto
|
|||||||
|
|
||||||
::: tip INFO
|
::: tip INFO
|
||||||
|
|
||||||
- 所有配置项可参考[源文件](https://github.com/felinae98/nonebot-bison/blob/main/src/plugins/nonebot_bison/plugin_config.py)
|
- 所有可用配置项可参见[源文件](https://github.com/felinae98/nonebot-bison/blob/main/src/plugins/nonebot_bison/plugin_config.py)
|
||||||
- **配置项的配置方法** 请参考[NoneBot 配置方式](https://v2.nonebot.dev/docs/tutorial/configuration#%E9%85%8D%E7%BD%AE%E6%96%B9%E5%BC%8F),在`.env`/`.env.*`文件中写入希望配置的 Bison 配置项
|
- 如果要在在 nonebot 中配置需要的**Bison 配置项**,请参考[NoneBot 配置方式](https://v2.nonebot.dev/docs/tutorial/configuration#%E9%85%8D%E7%BD%AE%E6%96%B9%E5%BC%8F),在`.env`/`.env.*`文件中写入希望配置的 Bison 配置项
|
||||||
|
- 请注意,在`.env`/`.env.*`中添加的配置项 **不** 需要声明变量类型
|
||||||
:::
|
:::
|
||||||
|
|
||||||
- `BISON_CONFIG_PATH`: 插件存放配置文件的位置,如果不设定默认为项目目录下的`data`目录
|
- `BISON_CONFIG_PATH`: 插件存放配置文件的位置,如果不设定默认为项目目录下的`data`目录
|
||||||
|
Loading…
x
Reference in New Issue
Block a user