perf: onebot, satori docs improvement

Author: Soulter

docs/.vitepress/config.mjs

@@ -87,13 +87,7 @@ export default defineConfig({
               },
               {
                 text: "OneBot v11",
-                base: "/platform/aiocqhttp",
-                collapsed: true,
-                items: [
-                  { text: "NapCat", link: "/napcat" },
-                  { text: "Lagrange", link: "/lagrange" },
-                  { text: "其他端", link: "/others" },
-                ],
+                link: "/aiocqhttp"
               },
               { text: "企微应用", link: "/wecom" },
               { text: "企微智能机器人", link: "/wecom_ai_bot" },
@@ -111,7 +105,7 @@ export default defineConfig({
                 base: "/platform/satori",
                 collapsed: true,
                 items: [
-                  { text: "使用 LLOneBot", link: "/llonebot" },
+                  { text: "接入 Satori", link: "/guide" },
                   { text: "使用 server-satori", link: "/server-satori" },
                 ],
               },

docs/zh/platform/aiocqhttp.md

@@ -0,0 +1,43 @@
+# 接入 OneBot v11 协议实现
+
+OneBot 是一个聊天机器人应用接口标准，旨在统一不同聊天平台上的机器人应用开发接口，使开发者只需编写一次业务逻辑代码即可应用到多种机器人平台。
+
+AstrBot 支持接入所有适配了 OneBotv11 反向 Websockets（AstrBot 做服务器端）的机器人协议端。
+
+下文给出一些常见的 OneBot v11 协议实现端项目。
+
+- [NapCat](https://github.com/NapNeko/NapCatQQ)
+- [OneDisc](https://github.com/ITCraftDevelopmentTeam/OneDisc)
+- [Tele-KiraLink](https://github.com/Echomirix/Tele-KiraLink)
+
+请参阅对应的协议实现端项目的部署文档。
+
+## 1. 配置 OneBot v11
+
+1. 进入 AstrBot 的 WebUI
+2. 点击左边栏 `机器人`
+3. 然后在右边的界面中，点击 `+ 创建机器人`
+4. 选择 `OneBot v11`
+
+在出现的表单中，填写：
+
+- ID(id)：随意填写，仅用于区分不同的消息平台实例。
+- 启用(enable): 勾选。
+- 反向 WebSocket 主机地址：请填写你的机器的 IP 地址，一般情况下请直接填写 `0.0.0.0`
+- 反向 WebSocket 端口：填写一个端口，默认为 `6199`。
+- 反向 Websocket Token：只有当 NapCat 网络配置中配置了 token 才需填写。
+
+点击 `保存`。
+
+## 2. 配置协议实现端
+
+请参阅对应的协议实现端项目的部署文档。
+
+一些注意点：
+
+1. 协议实现端需要支持 `反向 WebSocket` 实现，及 AstrBot 端作为服务端，实现端作为客户端。
+2. `反向 WebSocket` 的 URL 为 `ws(s)://<your-host>:6199/ws`。
+
+## 3. 验证
+
+前往 AstrBot WebUI `控制台`，如果出现 ` aiocqhttp(OneBot v11) 适配器已连接。` 蓝色的日志，说明连接成功。如果没有，若干秒后出现` aiocqhttp 适配器已被关闭` 则为连接超时（失败），请检查配置是否正确。

docs/zh/platform/aiocqhttp/lagrange.md

@@ -0,0 +1,32 @@
+# 接入 Satori 协议
+
+## Satori 协议简介
+
+> 摘录自：https://satori.chat/zh-CN/introduction.html
+
+Satori 是一个通用的聊天协议。Satori 协议希望能够抹平不同聊天平台之间的差异，让开发者以更低的成本开发出跨平台、可扩展、高性能的聊天应用。
+
+Satori 的名称来源于游戏东方 Project 中的角色 [古明地觉 (Komeiji Satori)](https://zh.touhouwiki.net/wiki/%E5%8F%A4%E6%98%8E%E5%9C%B0%E8%A7%89)。古明地觉能够以心灵感应的方式与各种动物交流，取这个名字是希望 Satori 能够成为各个聊天平台之间的桥梁。
+
+Satori 的开发团队长期从事聊天机器人开发，熟悉各种聊天平台的通信方式。经过长达 4 年的发展，Satori 有了健全的设计和完善的实现。目前，Satori 官方提供了超过 15 个聊天平台的适配器，完全覆盖了世界上主流的聊天平台，如 QQ、Discord、企业微信、KOOK 等等。
+
+## 1. 配置协议实现端
+
+请参阅对应的协议实现端项目的部署文档。
+
+## 2. 配置 Satori 协议
+
+1. 进入 AstrBot 的 WebUI
+2. 点击左边栏 `机器人`
+3. 然后在右边的界面中，点击 `+ 创建机器人`
+4. 选择 `Satori`
+
+弹出的配置项填写：
+
+- 机器人名称 (id): `satori` (随意)
+- 启用 (enable): 勾选
+- Satori API 终结点 (satori_api_base_url)：`http://localhost:5600/v1`（端口和上面配置的协议端端口一致）
+- Satori WebSocket 终结点 (satori_endpoint)：`ws://localhost:5600/v1/events`（端口和上面配置的协议端端口一致）
+- Satori 令牌 (satori_token)：根据协议端配置情况选择填写
+
+点击 `保存`。