--- prev: /usage/install next: /usage/ --- # :package: Bison 的第一个包裹 本节将教你如何开始使用 Bison 进行基础的使用， 默认你已经完成了[**安装**](/usage/install.md)并且已经成功启动了 Bison 如果你想要了解更详细的内容，请前往[详细配置](/usage) ## :wrench: 骑行前检查 首先，我们需要检查一下 Bison 的配置是否正确 在最基础的使用情况下，我们只需要关注少数几个配置的内容： 1. `COMMAND_START` 这个配置是 Bison 的命令前缀，如果你的配置中没有设置，那么默认是`''`，也就是没有前缀 在本节中，我们假设`COMMAND_START`设置中包含`'/'`，也就是说，我们的命令前缀是`/` 例如：`COMMAND_START=['', '/']` 2. `BISON_TO_ME` 是否需要 @Bot 或使用 Bot 的 Nickname 来触发 Bison，默认为`True` 例如： - `BISON_TO_ME=True` `@Bot /help` - `BISON_TO_ME=False` `/help` 3. `BISON_USE_PIC` 将文字渲染成图片后进行发送，多用于规避风控，默认为`False` 4. `BISON_USE_PIC_MERGE`: 是否启用多图片时合并转发（仅限群） - `0`: 不启用 (默认) - `1`: 首条消息单独发送，剩余图片合并转发 - `2`: 所有消息全部合并转发 ::: details BISON_USE_PIC_MERGE 配置项示例 - 当`BISON_USE_PIC_MERGE=1`时： ![simple1](/images/forward-msg-simple1.png) - 当`BISON_USE_PIC_MERGE=2`时： ![simple1](/images/forward-msg-simple2.png) ::: ::: warning 选择模式`1`时，可能会因为待推送图片过大/过多而导致文字消息与合并转发图片消息推送间隔过大，请谨慎考虑开启。 可以考虑选择模式`2`，使图文消息一同合并转发，但可能会使消息推送延迟过长 ::: --- ::: tip 如何进行合理的配置？ - 如果要在在 nonebot 中配置需要的**Bison 配置项**，请参考[NoneBot 配置方式](https://v2.nonebot.dev/docs/appendices/config#dotenv-%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6)，在`.env`/`.env.*`文件中写入希望配置的 Bison 配置项 - 请注意，在`.env`/`.env.*`中添加的配置项 **不** 需要声明变量类型 ::: ## :bike: 上车！ 首先，我们需要给 Bison 指定一份"订单"，让他知道我们想要订阅什么，去哪里获取包裹 ::: tip 不想在群里添加订阅？ 可以，但下述操作要求你是`SUPERUSERS`中的一员 - 个人订阅 支持私聊添加仅对自己推送的订阅，流程同下 - 群组订阅 支持私聊给某个群聊添加订阅，请私聊 Bison 发送`群管理`命令，Bison 会给你发送一个群列表，你可以选择你想要添加订阅的群聊以及执行的命令，之后的流程同下 ::: ::: warning Bison 不理我？ 在本段中`COMMAND_START`设置中包含了`'/'`，Bot 的`NICKNAME="bison"` - 如果出现 bot 不响应的问题，请先排查这个配置 - 尝试在命令前添加设置了的命令前缀，如`COMMAND_START=['!']`，则尝试使用`!添加订阅` - `BISON_TO_ME`默认为`True`, 请在命令前 @Bot 或者添加 Bot 的 Nickname : `@Bot 添加订阅` - Bison 只会响应群主/群管理/SUPERUSERS 的命令，请检查你的群权限等级 ::: ## :memo: 添加订阅 选择一个群聊作为 Bison 的客户，发送`添加订阅`命令，Bison 会开始订阅流程 ![add sub](/images/add-sub.png) ## :card_file_box: 选择订阅的平台 Bison 会列出所支持的常用平台，你可以选择你想要订阅的平台，也可以回复`全部`来查看所有 Bison 支持的平台 在这里，我们选择`weibo`作为我们的订阅平台 ![choose platform](/images/choose-platform.png) ## :pushpin: 给出需要订阅的目标 Bison 会要求你给出你想要订阅的目标，这个目标可以是一个 uid，也可以是特定格式的包含 uid 的链接 ![uid parse](/images/uid-parse.png) 这里发送了包含有 uid 的链接 :::tip 在`weibo`中该链接必须符合`https://weibo.com/u/`格式 具体请以[各个平台的支持情况](/usage/#所支持平台的-uid)为准 ::: 当然，你也可以直接向 Bison 发送 uid:`6279793937` ## :label: 选择需要订阅的类别 在给出需要订阅的目标后，Bison 会告诉你该 uid 所对应的用户名，你可以借此确认订阅是否正确。 接着，如果该平台支持多个类别，Bison 会要求你选择你想要订阅的类别 ![choose category](/images/choose-category.png) 这里选择订阅明日方舟微博的`视频 图文 文字`类别，当该账号在微博发送了视频、图文、文字时，Bison 会将其派送到你的群聊中 ## :bookmark: 选择需要特定订阅/屏蔽的话题 (tag) ::: tip 什么是话题 (tag)？ Tag 是社交平台中一种常见的功能，它用井号 (#) 作为前缀，标记关键词，方便用户搜索相关内容。 例如：`#明日方舟# #每日打卡#（微博、哔哩哔哩） #baracamp（推特）` 具体的过滤规则参见[Tag 的推送规则](/usage/#tag-的推送规则) ::: ![choose tag](/images/choose-tag.png) 这里选择不特定订阅也不屏蔽话题，即`全部标签` ## :tada: 订阅成功，开始派送！ 订阅流程结束后，Bison 会告诉你订阅成功，并且会在群聊中发送一条订阅成功的消息（如上图） 至此，你已经成功订阅了一个明日方舟微博账号，Bison 会在该账号发布新内容时将其派送到你的群聊中 ## :mag: 查询订阅 你可以在任意时刻查询该群的订阅情况，只需要在群里向 Bison 发送`查询订阅`命令即可 ![query sub](/images/list-sub.png) ## :wastebasket: 删除订阅 你可以在任意时刻删除该群的订阅，只需要在群里向 Bison 发送`删除订阅`命令即可 ![delete sub](/images/del-sub.png) ## :globe_with_meridians: 使用网页管理订阅 Bison 提供了一个网页管理订阅的功能，即 WebUI，你可以在网页上查看、添加、删除订阅 如果需要使用，请 **私聊** Bison 发送`后台管理`命令，Bison 会给你发送一个网页链接，在浏览器打开即可进入网页管理订阅的界面 ::: tip 该命令无效？ `后台管理`命令仅对`SUPERUSERS`的私聊有效 ::: ::: tip Bison 给出的链接无效？ Bison 所给的链接中的 ip 和 port 是`BISON_OUTER_URL`配置决定的，也就是说 Bison 本身不能获取服务器的 ip 与自身的 port，所以 Bison 给出的链接可能是无效的。你可以在`BISON_OUTER_URL`中设置你的服务器 ip 与 port，或者直接修改 Bison 给出的链接为正确的`http://:/bison/...`来进入网页管理订阅的界面。 参见[详细介绍 - 配置](/usage/#配置)的`BISON_OUTER_URL`部分 ::: ::: tip 认证失败？ :bug: 在浏览器输入网址进入网页时，第一次进入可能会出现 unauthorized，请再输入网址重新进入一次，而**不能**简单的刷新页面 :::