mirror of
https://github.com/suyiiyii/nonebot-bison.git
synced 2025-06-02 09:26:12 +08:00
📝 添加cookie模块使用文档
This commit is contained in:
parent
2093622672
commit
b2b20ab7c5
BIN
docs/.vuepress/public/images/add-cookie-target.png
Normal file
BIN
docs/.vuepress/public/images/add-cookie-target.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 74 KiB |
@ -1,6 +1,6 @@
|
||||
---
|
||||
prev: /usage/install
|
||||
next: /usage/easy-use
|
||||
next: /usage/cookie
|
||||
---
|
||||
|
||||
# 全方位了解 Bison 的自行车
|
||||
|
99
docs/usage/cookie.md
Normal file
99
docs/usage/cookie.md
Normal 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 流程。
|
||||

|
||||
|
||||
然后,依次输入平台名称和 Cookie 内容。
|
||||

|
||||
|
||||
看到 Bison 的回复之后,Cookie 就添加成功啦!
|
||||
|
||||
## :children_crossing: 关联 Cookie 到具体的订阅
|
||||
|
||||
接下来要关联 Cookie 到一个具体的订阅。
|
||||
|
||||
输入 `添加关联cookie` 命令,Bison 就会列出当前所有的订阅。
|
||||
|
||||
我们选择一个订阅,Bison 会列出所有的可以选择的 Cookie。
|
||||
|
||||

|
||||
|
||||
再选择需要关联的 Cookie。
|
||||
|
||||
至此,Bison 便会携带我们的 Cookie 去请求订阅目标啦!
|
||||
|
||||
## :stethoscope: 取消关联 Cookie
|
||||
|
||||
如果你想取消关联某个 Cookie,可以发送 `取消关联cookie` 命令,Bison 会列出所有已被关联的订阅和 Cookie。
|
||||
|
||||
选择需要取消关联的 Cookie,Bison 会取消此 Cookie 对该订阅的关联。
|
||||
|
||||
这是 `添加关联cookie` 的逆向操作。
|
||||
|
||||
## :wastebasket: 删除 Cookie
|
||||
|
||||
如果你想删除某个 Cookie,可以发送 `删除cookie` 命令,Bison 会列出所有已添加的 Cookie。
|
||||
|
||||
选择需要删除的 Cookie,Bison 会删除此 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! 🎉
|
@ -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 流程。
|
||||

|
||||
|
||||
然后,依次输入平台名称和 Cookie 内容。
|
||||

|
||||
|
||||
看到 Bison 的回复之后,Cookie 就添加成功啦!
|
||||
|
||||
接下来要关联 Cookie 到一个具体的订阅。
|
||||
|
||||
> 待添加的图片。
|
||||
|
||||
输入 `添加关联cookie` 命令,Bison 就会列出当前所有的订阅。
|
||||
|
||||
我们选择一个订阅,Bison 会列出所有的可以选择的 Cookie。
|
||||
|
||||
> 待添加的图片。
|
||||
|
||||
选择需要关联的 Cookie。
|
||||
|
||||
> 待添加的图片。
|
||||
|
||||
至此,Bison 便会携带我们的 Cookie 去请求订阅目标啦!
|
||||
|
Loading…
x
Reference in New Issue
Block a user