✨ 添加 Cookie 组件 (#633)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

docs/usage/README.md

@@ -1,6 +1,6 @@
 ---
 prev: /usage/install
-next: /usage/easy-use
+next: /usage/cookie
 ---
 
 # 全方位了解 Bison 的自行车
@@ -272,6 +272,21 @@ Bison 在处理每条推送时，会按照以下规则顺序检查推送中的 T
 3. **需订阅 Tag** 列表为空
    - **发送**该推送到群中，检查结束
 
+#### Cookie 功能
+
+Bison 支持携带 Cookie 进行请求。
+
+目前支持的平台有：
+
+- `rss`: RSS
+- `weibo`: 新浪微博
+
+::: warning 使用须知
+Cookie 全局生效，这意味着，通过你的 Cookie 获取到的内容，可能会被发给其他用户。
+:::
+
+管理员可以通过**命令**或**管理后台**给 Bison 设置 Cookie。
+
 <script setup lang="ts">
 import { ref, computed } from 'vue';
 

docs/usage/cookie.md

@@ -0,0 +1,113 @@
+---
+prev: /usage/
+next: /usage/install
+---
+
+# :cookie: 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 透露给其他用户。但是，管理员或其他可以接触的数据库的人员可以看到**所有 Cookie**的内容。所以，在上传 Cookie 之前，请确保管理人员可信。
+:::
+
+## :wheelchair: 我该怎么使用 Cookie？
+
+首先，需要明确的是，因为 Cookie 具有隐私性，所有与 Cookie 相关的操作，仅支持**管理员**通过**私聊**或者通过**WebUI**进行管理。
+
+目前，使用 Cookie 主要有两个步骤：
+
+- **添加 Cookie**: 将 Cookie 发给 Bison
+- **关联 Cookie**: 告诉 Bison，你希望在什么时候使用这个 Cookie
+
+## :nerd_face: 如何获取 Cookie？
+
+对于大部分平台，Bison 支持 JSON 格式的 Cookie，你可以通过浏览器的开发者工具获取。
+
+- RSS: 对于各种 RSS 订阅，你需要自行准备需要的 Cookie，以 JSON 格式添加即可
+- 微博：Bison 兼容 RSSHub 的 Cookie，以下方法引用自[RSSHub 的文档](https://docs.rsshub.app/zh/deploy/config#%E5%BE%AE%E5%8D%9A)
+  > 1. 打开并登录 https://m.weibo.cn（确保打开页面为手机版，如果强制跳转电脑端可尝试使用可更改 UserAgent 的浏览器插件）
+  > 2. 按下 F12 打开控制台，切换至 Network（网络）面板
+  > 3. 在该网页切换至任意关注分组，并在面板打开最先捕获到的请求（该情形下捕获到的请求路径应包含/feed/group）
+  > 4. 查看该请求的 Headers（请求头）, 找到 Cookie 字段并复制内容
+- Bilibili: Bison 兼容 RSSHub 的 Cookie，以下方法引用自[RSSHub 的文档](https://docs.rsshub.app/zh/deploy/config#bilibili)
+  > 1. 打开 https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/dynamic_new?uid=0&type=8
+  > 2. 打开控制台，切换到 Network 面板，刷新
+  > 3. 点击 dynamic_new 请求，找到 Cookie
+  > 4. 视频和专栏，UP 主粉丝及关注只要求 SESSDATA 字段，动态需复制整段 Cookie
+
+## :sparkles: 给 Bison 添加 Cookie
+
+打开 Bison 的私聊，发送 `添加cookie` 命令，Bison 会开始添加 Cookie 流程。
+![add cookie](/images/add-cookie.png)
+
+然后，依次输入平台名称和 Cookie 内容。
+![add cookie 2](/images/add-cookie-2.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。
+
+选择需要取消关联的 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-use#使用网页管理订阅)。
+
+## :tada: 完成！
+
+至此，你已经掌握了使用 Cookie 的方法。
+
+Congratulations! 🎉