4.9 KiB
| prev | next |
|---|---|
| /usage/ | /usage/install |
🍪 Bison 的自行车电助力装置
Bison 支持 Cookie 啦，你可以将 Cookie 关联到订阅以获得更好的体验。
但是，盲目使用 Cookie 功能并不能解决问题，反而可能为你的账号带来风险。请阅读完本文档后再决定是否使用 Cookie 功能。
::: warning 免责声明 Bison 具有良好的风控应对机制，我们会尽力保护你的账户，但是无法保证绝对的安全。
nonebot-bison 开发者及 MountainDash 社区不对因使用 Cookie 导致的任何问题负责。 :::
🧐 什么时候需要 Cookie？
首先，请确认 Cookie 的使用场景，并了解注意事项。
在绝大多数情况下，Bison 不需要 Cookie 即可正常工作。但是，部分平台只能够获取有限的内容，此时，Cookie 就可以帮助 Bison 获取更多的内容。
例如，微博平台可以设置微博为“仅粉丝可见”，正常情况下 Bison 无法获取到这些内容。如果你的账号是该博主的粉丝，那么你可以将你的 Cookie 关联到 Bison，这样 Bison 就可以获取到这些受限内容。
::: warning 使用须知 Cookie 全局生效，这意味着，通过你的 Cookie 获取到的内容，可能会被共享给其他用户。
当然，Bison 不会将你的 Cookie 透露给其他用户。但是，管理员或其他可以接触的数据库的人员可以看到所有 Cookie的内容。所以，在上传 Cookie 之前，请确保管理人员可信。 :::
♿ 我该怎么使用 Cookie？
首先，需要明确的是，因为 Cookie 具有隐私性，所有与 Cookie 相关的操作，仅支持管理员通过私聊或者通过WebUI进行管理。
目前，使用 Cookie 主要有两个步骤：
- 添加 Cookie: 将 Cookie 发给 Bison
- 关联 Cookie: 告诉 Bison，你希望在什么时候使用这个 Cookie
🤓 如何获取 Cookie？
对于大部分平台，Bison支持JSON格式的Cookie，你可以通过浏览器的开发者工具获取。
- RSS: 对于各种RSS订阅，你需要自行准备需要的Cookie，以JSON格式添加即可
- 微博: Bison兼容RSSHub的Cookie，以下方法引用自RSSHub的文档
- 打开并登录 https://m.weibo.cn （确保打开页面为手机版，如果强制跳转电脑端可尝试使用可更改 UserAgent 的浏览器插件）
- 按下F12打开控制台，切换至Network（网络）面板
- 在该网页切换至任意关注分组，并在面板打开最先捕获到的请求 （该情形下捕获到的请求路径应包含/feed/group）
- 查看该请求的Headers（请求头）, 找到Cookie字段并复制内容
- Bilibili: Bison兼容RSSHub的Cookie，以下方法引用自RSSHub的文档
- 打开 https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/dynamic_new?uid=0&type=8
- 打开控制台，切换到 Network 面板，刷新
- 点击 dynamic_new 请求，找到 Cookie
- 视频和专栏，UP 主粉丝及关注只要求 SESSDATA 字段，动态需复制整段 Cookie
✨ 给 Bison 添加 Cookie
打开 Bison 的私聊，发送 添加cookie 命令，Bison 会开始添加 Cookie 流程。
然后，依次输入平台名称和 Cookie 内容。
看到 Bison 的回复之后，Cookie 就添加成功啦！
🚸 关联 Cookie 到具体的订阅
接下来要关联 Cookie 到一个具体的订阅。
输入 添加关联cookie 命令，Bison 就会列出当前所有的订阅。
我们选择一个订阅，Bison 会列出所有的可以选择的 Cookie。
再选择需要关联的 Cookie。
至此，Bison 便会携带我们的 Cookie 去请求订阅目标啦！
🩺 取消关联 Cookie
如果你想取消关联某个 Cookie，可以发送 取消关联cookie 命令，Bison 会列出所有已被关联的订阅和 Cookie。
选择需要取消关联的 Cookie，Bison 会取消此 Cookie 对该订阅的关联。
这是 添加关联cookie 的逆向操作。
🗑️ 删除 Cookie
如果你想删除某个 Cookie，可以发送 删除cookie 命令，Bison 会列出所有已添加的 Cookie。
选择需要删除的 Cookie，Bison 会删除此 Cookie。
::: tip 只能删除未被关联的 Cookie。
也就是说，你需要先取消一个 Cookie 的所有关联，才能删除。 :::
这是 添加cookie 的逆向操作。
🌐 使用 WebUI 管理 Cookie
同样的，Bison 提供了一个网页管理 Cookie 的功能，即 WebUI，你可以在网页上查看、添加、删除 Cookie。
使用方法参见 使用网页管理订阅。
🎉 完成！
至此，你已经掌握了使用 Cookie 的方法。
Congratulations! 🎉