📝 添加cookie模块使用文档

This commit is contained in:
suyiiyii 2024-10-14 01:08:11 +08:00
parent 2093622672
commit b2b20ab7c5
Signed by: suyiiyii
GPG Key ID: 044704CB29B8AD85
4 changed files with 100 additions and 33 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

View File

@ -1,6 +1,6 @@
---
prev: /usage/install
next: /usage/easy-use
next: /usage/cookie
---
# 全方位了解 Bison 的自行车

99
docs/usage/cookie.md Normal file
View File

@ -0,0 +1,99 @@
---
prev: /usage/
next: /usage/install
---
# 🍪 Bison 的自行车电助力装置
Bison 支持 Cookie 啦,你可以将 Cookie 关联到订阅以获得更好的体验。
但是,盲目使用 Cookie 功能并不能解决问题,反而可能为你的账号带来风险。请阅读完本文档后再决定是否使用 Cookie 功能。
::: warning 免责声明
Bison 具有良好的风控应对机制,我们会尽力保护你的账户,但是无法保证绝对的安全。
nonebot-bison 开发者及 MountainDash 社区不对因使用 Cookie 导致的任何问题负责。
:::
## :monocle_face: 什么时候需要 Cookie
首先,请确认 Cookie 的使用场景,并了解注意事项。
在绝大多数情况下Bison 不需要 Cookie 即可正常工作。但是部分平台只能够获取有限的内容此时Cookie 就可以帮助 Bison 获取更多的内容。
例如,微博平台可以设置微博为“仅粉丝可见”,正常情况下 Bison 无法获取到这些内容。如果你的账号是该博主的粉丝,那么你可以将你的 Cookie 关联到 Bison这样 Bison 就可以获取到这些受限内容。
::: warning 使用须知
Cookie 全局生效,这意味着,通过你的 Cookie 获取到的内容,可能会被共享给其他用户。
当然Bison 不会将你的 Cookie 透露给其他用户,包括管理员。
:::
## :wheelchair: 我该怎么使用 Cookie
首先,需要明确的是,因为 Cookie 具有隐私性,所有与 Cookie 相关的操作,仅支持**管理员**通过**私聊**或者通过**WebUI**进行管理。
同时为确保安全Cookie 在被添加到 Bison 之后,内容便**不会**再被展示,如有其他需要请提前保存。
目前,使用 Cookie 主要有两个步骤:
- **添加 Cookie**: 将 Cookie 发给 Bison
- **关联 Cookie**: 告诉 Bison你希望在什么时候使用这个 Cookie
## :sparkles: 给 Bison 添加 Cookie
打开 Bison 的私聊,发送 `添加cookie` 命令Bison 会开始添加 Cookie 流程。
![add cookie](/images/add-cookie.png)
然后,依次输入平台名称和 Cookie 内容。
![add cookie 2](/images/add-cookie.png)
看到 Bison 的回复之后Cookie 就添加成功啦!
## :children_crossing: 关联 Cookie 到具体的订阅
接下来要关联 Cookie 到一个具体的订阅。
输入 `添加关联cookie` 命令Bison 就会列出当前所有的订阅。
我们选择一个订阅Bison 会列出所有的可以选择的 Cookie。
![add-cookie-target.png](/images/add-cookie-target.png)
再选择需要关联的 Cookie。
至此Bison 便会携带我们的 Cookie 去请求订阅目标啦!
## :stethoscope: 取消关联 Cookie
如果你想取消关联某个 Cookie可以发送 `取消关联cookie` 命令Bison 会列出所有已被关联的订阅和 Cookie。
选择需要取消关联的 CookieBison 会取消此 Cookie 对该订阅的关联。
这是 `添加关联cookie` 的逆向操作。
## :wastebasket: 删除 Cookie
如果你想删除某个 Cookie可以发送 `删除cookie` 命令Bison 会列出所有已添加的 Cookie。
选择需要删除的 CookieBison 会删除此 Cookie。
::: tip
只能删除未被关联的 Cookie。
也就是说,你需要先取消一个 Cookie 的所有关联,才能删除。
:::
这是 `添加cookie` 的逆向操作。
## globe_with_meridians: 使用 WebUI 管理 Cookie
同样的Bison 提供了一个网页管理 Cookie 的功能,即 WebUI你可以在网页上查看、添加、删除 Cookie。
使用方法参见 [使用网页管理订阅](/usage/easy-usage#:globe_with_meridians: \u4f7f\u7528\u7f51\u9875\u7ba1\u7406\u8ba2\u9605)。
## :tada: 完成!
至此,你已经掌握了使用 Cookie 的方法。
Congratulations! 🎉

View File

@ -149,35 +149,3 @@ Bison 所给的链接中的 ip 和 port 是`BISON_OUTER_URL`配置决定的,
:bug:
在浏览器输入网址进入网页时,第一次进入可能会出现 unauthorized请再输入网址重新进入一次而**不能**简单的刷新页面
:::
## :children_crossing: 魔法饼干
Bison 支持携带 Cookie 进行请求。
如果需要让 Bison 携带 Cookie 进行请求,需要先使用 `添加cookie` 命令添加 Cookie然后使用 `添加关联cookie` 命令将 Cookie 关联到订阅上。
只有 `superuser` 可以管理 Cookie只支持私聊。
打开 Bison 的私聊,发送 `添加cookie` 命令Bison 会开始添加 Cookie 流程。
![add cookie](/images/add-cookie.png)
然后,依次输入平台名称和 Cookie 内容。
![add cookie 2](/images/add-cookie.png)
看到 Bison 的回复之后Cookie 就添加成功啦!
接下来要关联 Cookie 到一个具体的订阅。
> 待添加的图片。
输入 `添加关联cookie` 命令Bison 就会列出当前所有的订阅。
我们选择一个订阅Bison 会列出所有的可以选择的 Cookie。
> 待添加的图片。
选择需要关联的 Cookie。
> 待添加的图片。
至此Bison 便会携带我们的 Cookie 去请求订阅目标啦!