From 93a73a7c707488e5061f2db7c27a9bd6ca6ea369 Mon Sep 17 00:00:00 2001 From: Junyan Qin Date: Mon, 23 Feb 2026 15:26:50 +0800 Subject: [PATCH] Add Satori platform support in documentation, including features and usage instructions for Lucky Lilla Desktop --- docs.json | 12 ++++++++ en/insight/community.mdx | 10 ++++++ en/insight/features.mdx | 1 + en/insight/platform-features.mdx | 30 ++++++++++++++++++ en/plugin/dev/tutor.mdx | 2 ++ en/usage/platforms/satori/llonebot.mdx | 42 ++++++++++++++++++++++++++ ja/insight/community.mdx | 10 ++++++ ja/insight/features.mdx | 1 + ja/insight/platform-features.mdx | 30 ++++++++++++++++++ ja/plugin/dev/tutor.mdx | 2 ++ ja/usage/platforms/satori/llonebot.mdx | 42 ++++++++++++++++++++++++++ 11 files changed, 182 insertions(+) create mode 100644 en/usage/platforms/satori/llonebot.mdx create mode 100644 ja/usage/platforms/satori/llonebot.mdx diff --git a/docs.json b/docs.json index 1394d7dcb..0cd9951fa 100644 --- a/docs.json +++ b/docs.json @@ -316,6 +316,12 @@ "en/usage/platforms/qq/aiocqhttp/llonebot" ] }, + { + "group": "Satori (QQ & Multi-Platform)", + "pages": [ + "en/usage/platforms/satori/llonebot" + ] + }, { "group": "QQ Official Bot", "pages": [ @@ -494,6 +500,12 @@ "ja/usage/platforms/qq/aiocqhttp/llonebot" ] }, + { + "group": "Satori（QQ等マルチプラットフォーム）", + "pages": [ + "ja/usage/platforms/satori/llonebot" + ] + }, { "group": "QQ 公式ボット", "pages": [ diff --git a/en/insight/community.mdx b/en/insight/community.mdx index ee86eae20..774e8e8f5 100644 --- a/en/insight/community.mdx +++ b/en/insight/community.mdx @@ -11,3 +11,13 @@ Collected at: https://blog.thelazy.top/tags/langbot ## 🥰 Community Join our community on Discord: [![Discord](https://img.shields.io/discord/1335141740050649118?logo=discord&labelColor=%20%235462eb&logoColor=%20%23f5f5f5&color=%20%235462eb)](https://discord.gg/wdNEHETs87) + +### ❤ Unofficial Chat Groups + +Chat, discuss, and communicate about plugins and LangBot + + +Members in this group are only interested in casual chatting and will not answer any other questions. Since it is not under official supervision, we cannot guarantee the authenticity or formality of the information. + + +- LangBot Unofficial Chat Group: 472263434 ([Link](https://qm.qq.com/q/c5mH8rHlgQ)) diff --git a/en/insight/features.mdx b/en/insight/features.mdx index 1dcc0a4d1..0193a8172 100644 --- a/en/insight/features.mdx +++ b/en/insight/features.mdx @@ -19,6 +19,7 @@ LangBot is an open-source LLM native instant messaging robot development platfor | Discord | ✅ | | | Telegram | ✅ | Support streaming output | | Slack | ✅ | | +| Satori | ✅ | [Satori](https://satori.chat/zh-CN/introduction.html) is a universal chat protocol that theoretically supports QQ, Zulip, Miyoushe, and 15+ platforms | | LINE | ✅ | | | KOOK | ✅ | | | WhatsApp | 🚧 | | diff --git a/en/insight/platform-features.mdx b/en/insight/platform-features.mdx index a0c9ca95a..560f16aa0 100644 --- a/en/insight/platform-features.mdx +++ b/en/insight/platform-features.mdx @@ -66,6 +66,36 @@ The following is a list of features we have implemented and tested for each plat | Send proactive messages | ✅ | | | Send streaming response | ❌ | | +## Satori + +### Receive + +| Feature | Status | Remarks | +| --- | --- | --- | +| Receive private messages | ✅ | | +| Receive group mention messages | ✅ | | +| Receive group regular messages | ✅ | | +| Receive image messages | ✅ | | +| Receive voice messages | ✅ | | +| Receive file messages | ✅ | | +| Receive rich text messages | ✅ | Text and image combined | +| Get private message event user name | ✅ | | +| Get group message event group name | ✅ | | +| Get group message event sender name | ✅ | | + +### Send + +| Feature | Status | Remarks | +| --- | --- | --- | +| Reply to private messages | ✅ | | +| Reply to group messages | ✅ | | +| Reply with image messages | ✅ | | +| Reply with voice messages | ✅ | | +| Reply with file messages | ✅ | | +| Reply with rich text messages | ✅ | Text and image combined | +| Send proactive messages | ✅ | | +| Send streaming response | ❌ | | + ## WeCom (Customer Service) ## WeCom Intelligent Bot diff --git a/en/plugin/dev/tutor.mdx b/en/plugin/dev/tutor.mdx index dd851ae7a..86aa1af82 100644 --- a/en/plugin/dev/tutor.mdx +++ b/en/plugin/dev/tutor.mdx @@ -53,6 +53,8 @@ Please continue reading this tutorial to understand the plugin development proce ## AI-Assisted Development - [skills-LangBotplugin](https://github.com/TyperBody/skills-LangBotplugin) - Skills contributed by community member [@TyperBody](https://github.com/TyperBody), use AI to quickly develop plugins, welcome to try + - *langbotplugin* This skill provides automated plugin generation tools + - *langbotplugindebug* This skill provides plugin debugging tools ## Installing CLI diff --git a/en/usage/platforms/satori/llonebot.mdx b/en/usage/platforms/satori/llonebot.mdx new file mode 100644 index 000000000..d5fa28b42 --- /dev/null +++ b/en/usage/platforms/satori/llonebot.mdx @@ -0,0 +1,42 @@ +--- +title: "Deploy Message Platform: Lucky Lilla Desktop" +--- + +Connected via the Satori protocol, you need to select ``Satori`` as the adapter. + +# LuckyLillia + +- [LuckyLillia](https://github.com/LLOneBot/LuckyLilliaBot) Install the client to use the Satori protocol + +LuckyLillia installation tutorial: https://luckylillia.com/guide/choice_install + +![Image 1](/images/zh/deploy/bots/satori/llbot_local_setting.png) + +Make sure the IP address in the address field is the address of the host running LangBot (use ```127.0.0.1``` if running on the same network). The default port ``5600`` can be changed as needed. Setting a token is recommended. +> +> ![Image 2](/images/zh/deploy/bots/satori/llbot_open_setting.png) +> +> This image shows the public network configuration. Make sure the IP address is the address of the host running LangBot. In this case, you need to expose the corresponding LangBot port. + +## LangBot Integration + +Next, open the LangBot configuration page. + +Click on Bots, then click Add. + +Select `Satori` for `Platform/Adapter`. + +![Image 3](/images/zh/deploy/bots/satori/llone_langbot_build.png) +> If you use the default configuration (local network), you don't even need to modify any parameters. + +After creation, you can still adjust the parameters. + +![Image 4](/images/zh/deploy/bots/satori/llone_langbot_setting.png) + +Make sure you have enabled this adapter. + +![Image 5](/images/zh/deploy/bots/satori/satori_platform_open.png) + + +Note: If you encounter network connectivity issues between multiple Docker containers, please refer to [Network Configuration Details](/en/workshop/network-details). + diff --git a/ja/insight/community.mdx b/ja/insight/community.mdx index f022d1be8..98a5d69c1 100644 --- a/ja/insight/community.mdx +++ b/ja/insight/community.mdx @@ -11,3 +11,13 @@ title: "コミュニティリソース" ## 🥰 コミュニティ Discordコミュニティに参加してください: [![Discord](https://img.shields.io/discord/1335141740050649118?logo=discord&labelColor=%20%235462eb&logoColor=%20%23f5f5f5&color=%20%235462eb)](https://discord.gg/wdNEHETs87) + +### ❤ 非公式交流グループ + +プラグインとLangBotについてのチャット、ディスカッション、交流 + + +このグループのメンバーは雑談のみに関心があり、その他の質問には回答しません。公式の管理下にないため、情報の真実性や正式性を保証することはできません。 + + +- LangBot 非公式交流グループ: 472263434 ([リンク](https://qm.qq.com/q/c5mH8rHlgQ)) diff --git a/ja/insight/features.mdx b/ja/insight/features.mdx index c95a1598e..d97397d32 100644 --- a/ja/insight/features.mdx +++ b/ja/insight/features.mdx @@ -19,6 +19,7 @@ LangBotは、オープンソースのLLMネイティブインスタントメッ | Discord | ✅ | | | Telegram | ✅ | ストリーミング出力をサポート | | Slack | ✅ | | +| Satori | ✅ | [Satori](https://satori.chat/zh-CN/introduction.html) は汎用チャットプロトコルで、理論的にQQ、Zulip、米游社など15以上のプラットフォームをサポート | | LINE | ✅ | | | KOOK | ✅ | | | WhatsApp | 🚧 | | diff --git a/ja/insight/platform-features.mdx b/ja/insight/platform-features.mdx index e862c3ec2..f483fdded 100644 --- a/ja/insight/platform-features.mdx +++ b/ja/insight/platform-features.mdx @@ -66,6 +66,36 @@ title: "各メッセージプラットフォームの機能サポート" | 能動的メッセージの送信 | ✅ | | | ストリーミングレスポンスの送信 | ❌ | | +## Satori + +### 受信 + +| 機能 | ステータス | 備考 | +| --- | --- | --- | +| プライベートメッセージの受信 | ✅ | | +| グループメンションメッセージの受信 | ✅ | | +| グループ通常メッセージの受信 | ✅ | | +| 画像メッセージの受信 | ✅ | | +| 音声メッセージの受信 | ✅ | | +| ファイルメッセージの受信 | ✅ | | +| リッチテキストメッセージの受信 | ✅ | テキストと画像の組み合わせ | +| プライベートメッセージイベントのユーザー名取得 | ✅ | | +| グループメッセージイベントのグループ名取得 | ✅ | | +| グループメッセージイベントの送信者名取得 | ✅ | | + +### 送信 + +| 機能 | ステータス | 備考 | +| --- | --- | --- | +| プライベートメッセージへの返信 | ✅ | | +| グループメッセージへの返信 | ✅ | | +| 画像メッセージでの返信 | ✅ | | +| 音声メッセージでの返信 | ✅ | | +| ファイルメッセージでの返信 | ✅ | | +| リッチテキストメッセージでの返信 | ✅ | テキストと画像の組み合わせ | +| 能動的メッセージの送信 | ✅ | | +| ストリーミングレスポンスの送信 | ❌ | | + ## 企業微信（カスタマーサービス） ## 企業微信インテリジェントボット diff --git a/ja/plugin/dev/tutor.mdx b/ja/plugin/dev/tutor.mdx index 6490400a0..967efae8c 100644 --- a/ja/plugin/dev/tutor.mdx +++ b/ja/plugin/dev/tutor.mdx @@ -53,6 +53,8 @@ main.pyのプラグインクラスは各プラグインの共通コードで、 ## AI 支援開発 - [skills-LangBotplugin](https://github.com/TyperBody/skills-LangBotplugin) - コミュニティメンバー [@TyperBody](https://github.com/TyperBody) が提供する Skills、AI を使ってプラグインを迅速に開発できます、ぜひお試しください + - *langbotplugin* このSkillはプラグインの自動生成ツールを提供します + - *langbotplugindebug* このSkillはプラグインのデバッグツールを提供します ## CLIのインストール diff --git a/ja/usage/platforms/satori/llonebot.mdx b/ja/usage/platforms/satori/llonebot.mdx new file mode 100644 index 000000000..d6bf6a41c --- /dev/null +++ b/ja/usage/platforms/satori/llonebot.mdx @@ -0,0 +1,42 @@ +--- +title: "メッセージプラットフォームのデプロイ: Lucky Lilla Desktop" +--- + +Satoriプロトコル経由で接続するため、アダプターとして``Satori``を選択する必要があります。 + +# LuckyLillia + +- [LuckyLillia](https://github.com/LLOneBot/LuckyLilliaBot) Satoriプロトコルを使用するためにクライアントをインストールしてください + +LuckyLilliaのインストールチュートリアル: https://luckylillia.com/guide/choice_install + +![画像1](/images/zh/deploy/bots/satori/llbot_local_setting.png) + +アドレスフィールドのIPアドレスがLangBotを実行しているホストのアドレスであることを確認してください（同じネットワーク内で実行している場合は```127.0.0.1```を使用）。デフォルトポート``5600``は必要に応じて変更できます。トークンの設定を推奨します。 +> +> ![画像2](/images/zh/deploy/bots/satori/llbot_open_setting.png) +> +> この画像はパブリックネットワーク設定を示しています。IPアドレスがLangBotを実行しているホストのアドレスであることを確認してください。この場合、LangBotの該当ポートを公開する必要があります。 + +## LangBot 連携 + +次に、LangBotの設定ページを開きます。 + +ボットをクリックし、追加をクリックします。 + +`プラットフォーム/アダプター`で`Satori`を選択します。 + +![画像3](/images/zh/deploy/bots/satori/llone_langbot_build.png) +> デフォルト設定（ローカルネットワーク）を使用する場合、パラメータを変更する必要はありません。 + +作成後もパラメータを調整できます。 + +![画像4](/images/zh/deploy/bots/satori/llone_langbot_setting.png) + +このアダプターが有効になっていることを確認してください。 + +![画像5](/images/zh/deploy/bots/satori/satori_platform_open.png) + + +注意：複数のDockerコンテナ間のネットワーク接続に問題がある場合は、[ネットワーク設定の詳細](/ja/workshop/network-details)を参照してください。 +