AstrBot 4.23.2__tar.gz → 4.23.5__tar.gz

astrbot-4.23.5/PKG-INFO

@@ -0,0 +1,353 @@
+Metadata-Version: 2.4
+Name: AstrBot
+Version: 4.23.5
+Summary: Easy-to-use multi-platform LLM chatbot and development framework
+Project-URL: Repository, https://github.com/AstrBotDevs/AstrBot
+License: AGPL-3.0-or-later
+License-File: LICENSE
+Keywords: Agent,AstrBot,Chatbot,IM
+Requires-Python: >=3.12
+Requires-Dist: aiocqhttp>=1.4.4
+Requires-Dist: aiodocker>=0.24.0
+Requires-Dist: aiofiles>=25.1.0
+Requires-Dist: aiohttp>=3.11.18
+Requires-Dist: aiosqlite>=0.21.0
+Requires-Dist: anthropic>=0.51.0
+Requires-Dist: apscheduler>=3.11.0
+Requires-Dist: audioop-lts; python_full_version >= '3.13'
+Requires-Dist: certifi>=2025.4.26
+Requires-Dist: chardet~=5.1.0
+Requires-Dist: click>=8.2.1
+Requires-Dist: cryptography>=44.0.3
+Requires-Dist: dashscope>=1.23.2
+Requires-Dist: deprecated>=1.2.18
+Requires-Dist: dingtalk-stream>=0.22.1
+Requires-Dist: docstring-parser>=0.16
+Requires-Dist: faiss-cpu>=1.12.0
+Requires-Dist: filelock>=3.18.0
+Requires-Dist: google-genai>=1.56.0
+Requires-Dist: httpx[socks]>=0.28.1
+Requires-Dist: jieba>=0.42.1
+Requires-Dist: lark-oapi>=1.4.15
+Requires-Dist: loguru>=0.7.2
+Requires-Dist: markitdown-no-magika[docx,xls,xlsx]>=0.1.2
+Requires-Dist: mcp>=1.8.0
+Requires-Dist: openai>=1.78.0
+Requires-Dist: ormsgpack>=1.9.1
+Requires-Dist: packaging>=24.2
+Requires-Dist: pillow>=11.2.1
+Requires-Dist: pip>=25.1.1
+Requires-Dist: psutil<7.2.0,>=5.8.0
+Requires-Dist: py-cord>=2.6.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pydub>=0.25.1
+Requires-Dist: pyjwt>=2.10.1
+Requires-Dist: pypdf>=6.1.1
+Requires-Dist: pysocks>=1.7.1
+Requires-Dist: python-ripgrep==0.0.8
+Requires-Dist: python-socks>=2.8.0
+Requires-Dist: python-telegram-bot>=22.6
+Requires-Dist: qq-botpy>=1.2.1
+Requires-Dist: qrcode>=8.2
+Requires-Dist: quart>=0.20.0
+Requires-Dist: rank-bm25>=0.2.2
+Requires-Dist: shipyard-neo-sdk>=0.2.0
+Requires-Dist: shipyard-python-sdk>=0.2.4
+Requires-Dist: silk-python>=0.2.6
+Requires-Dist: slack-sdk>=3.35.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.41
+Requires-Dist: sqlmodel>=0.0.24
+Requires-Dist: telegramify-markdown>=1.0.0
+Requires-Dist: tenacity>=9.1.2
+Requires-Dist: watchfiles>=1.0.5
+Requires-Dist: websockets>=15.0.1
+Requires-Dist: wechatpy>=1.8.18
+Requires-Dist: xinference-client
+Description-Content-Type: text/markdown
+
+![astrbot-github-banner-v2-light-0405_副本](https://github.com/user-attachments/assets/36fb04e4-cc75-4454-bd8b-049d11aa86f9)
+
+
+<div align="center">
+
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh.md">简体中文</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_zh-TW.md">繁體中文</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.md">日本語</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_fr.md">Français</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ru.md">Русский</a>
+
+<br>
+
+<div>
+<a href="https://trendshift.io/repositories/12875" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12875" alt="Soulter%2FAstrBot | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+<a href="https://hellogithub.com/repository/AstrBotDevs/AstrBot" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=d127d50cd5e54c5382328acc3bb25483&claim_uid=ZO9by7qCXgSd6Lp&t=2" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
+</div>
+
+<br>
+
+<div>
+<img src="https://img.shields.io/github/v/release/AstrBotDevs/AstrBot?color=76bad9" href="https://github.com/AstrBotDevs/AstrBot/releases/latest">
+<img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="python">
+<img src="https://deepwiki.com/badge.svg" href="https://deepwiki.com/AstrBotDevs/AstrBot">
+<a href="https://zread.ai/AstrBotDevs/AstrBot" target="_blank"><img src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" alt="zread"/></a>
+<a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?color=76bad9"/></a>
+<img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.soulter.top%2Fastrbot%2Fplugin-num&query=%24.result&suffix=%20plugins&label=Marketplace&cacheSeconds=3600">
+<img src="https://gitcode.com/Soulter/AstrBot/star/badge.svg" href="https://gitcode.com/Soulter/AstrBot">
+</div>
+
+<br>
+
+<a href="https://astrbot.app/">Documentation</a> ｜
+<a href="https://blog.astrbot.app/">Blog</a> ｜
+<a href="https://astrbot.featurebase.app/roadmap">Roadmap</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/issues">Issue Tracker</a> ｜
+<a href="mailto:community@astrbot.app">Email Support</a>
+</div>
+
+AstrBot is an open-source all-in-one Agent chatbot platform that integrates with mainstream instant messaging apps. It provides reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether you're building a personal AI companion, intelligent customer service, automation assistant, or enterprise knowledge base, AstrBot enables you to quickly build production-ready AI applications within your IM platform workflows.
+
+![screenshot_1 5x_postspark_2026-02-27_22-37-45](https://github.com/user-attachments/assets/f17cdb90-52d7-4773-be2e-ff64b566af6b)
+
+## Key Features
+
+1. 💯 Free & Open Source.
+2. ✨ AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression.
+3. 🤖 Supports integration with Dify, Alibaba Cloud Bailian, Coze, and other agent platforms.
+4. 🌐 Multi-Platform: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and [more](#supported-messaging-platforms).
+5. 📦 Plugin Extensions with 1000+ plugins available for one-click installation.
+6. 🛡️ [Agent Sandbox](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) for isolated, safe execution of code, shell calls, and session-level resource reuse.
+7. 💻 WebUI Support.
+8. 🌈 Web ChatUI Support with built-in agent sandbox and web search.
+9. 🌐 Internationalization (i18n) Support.
+
+<br>
+
+<table align="center">
+  <tr align="center">
+    <th>💙 Role-playing & Emotional Companionship</th>
+    <th>✨ Proactive Agent</th>
+    <th>🚀 General Agentic Capabilities</th>
+    <th>🧩 1000+ Community Plugins</th>
+  </tr>
+  <tr>
+    <td align="center"><p align="center"><img width="984" height="1746" alt="99b587c5d35eea09d84f33e6cf6cfd4f" src="https://github.com/user-attachments/assets/89196061-3290-458d-b51f-afa178049f84" /></p></td>
+    <td align="center"><p align="center"><img width="976" height="1612" alt="c449acd838c41d0915cc08a3824025b1" src="https://github.com/user-attachments/assets/f75368b4-e022-41dc-a9e0-131c3e73e32e" /></p></td>
+    <td align="center"><p align="center"><img width="974" height="1732" alt="image" src="https://github.com/user-attachments/assets/e22a3968-87d7-4708-a7cd-e7f198c7c32e" /></p></td>
+    <td align="center"><p align="center"><img width="976" height="1734" alt="image" src="https://github.com/user-attachments/assets/0952b395-6b4a-432a-8a50-c294b7f89750" /></p></td>
+  </tr>
+</table>
+
+## Quick Start
+
+### One-Click Deployment
+
+For users who want to quickly experience AstrBot, are familiar with command-line usage, and can install a `uv` environment on their own, we recommend the `uv` one-click deployment method ⚡️:
+
+```bash
+uv tool install astrbot --python 3.12
+astrbot init # Only execute this command for the first time to initialize the environment
+astrbot run
+```
+
+> Requires [uv](https://docs.astral.sh/uv/) to be installed.
+> AstrBot requires Python 3.12 or later. The `--python 3.12` option ensures that `uv` creates the tool environment with Python 3.12.
+
+> [!NOTE]
+> For macOS users: due to macOS security checks, the first run of the `astrbot` command may take longer (about 10-20s).
+
+Update `astrbot`:
+
+```bash
+uv tool upgrade astrbot --python 3.12
+```
+
+> [!WARNING]
+> AstrBot deployed via `uv` **does not support upgrading through the WebUI**. To update, please run the command above from the command line.
+
+### Docker Deployment
+
+For users familiar with containers and looking for a more stable, production-ready deployment method, we recommend deploying AstrBot with Docker / Docker Compose.
+
+Please refer to the official documentation: [Deploy AstrBot with Docker](https://docs.astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
+
+### Deploy on RainYun
+
+For users who want one-click deployment and do not want to manage servers themselves, we recommend RainYun's one-click cloud deployment service ☁️:
+
+[![Deploy on RainYun](https://rainyun-apps.cn-nb1.rains3.com/materials/deploy-on-rainyun-en.svg)](https://app.rainyun.com/apps/rca/store/5994?ref=NjU1ODg0)
+
+### Desktop Application Deployment
+
+For users who want to use AstrBot on desktop and mainly use ChatUI, we recommend AstrBot App.
+
+Visit [AstrBot-desktop](https://github.com/AstrBotDevs/AstrBot-desktop) to download and install; this method is designed for desktop usage and is not recommended for server scenarios.
+
+### Launcher Deployment
+
+For desktop users who also want fast deployment and isolated multi-instance usage, we recommend AstrBot Launcher.
+
+Visit [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) to download and install.
+
+### Deploy on Replit
+
+Replit deployment is maintained by the community and is suitable for online demos and lightweight trials.
+
+[![Run on Repl.it](https://repl.it/badge/github/AstrBotDevs/AstrBot)](https://repl.it/github/AstrBotDevs/AstrBot)
+
+### AUR
+
+AUR deployment targets Arch Linux users who prefer installing AstrBot through the system package workflow.
+
+Run the command below to install `astrbot-git`, then start AstrBot in your local environment.
+
+```bash
+yay -S astrbot-git
+```
+
+**More deployment methods**
+
+If you need panel-based management or deeper customization, see [BT-Panel Deployment](https://docs.astrbot.app/deploy/astrbot/btpanel.html) for BT Panel app-store setup, [1Panel Deployment](https://docs.astrbot.app/deploy/astrbot/1panel.html) for 1Panel app-market deployment, [CasaOS Deployment](https://docs.astrbot.app/deploy/astrbot/casaos.html) for NAS/home-server visual deployment, and [Manual Deployment](https://docs.astrbot.app/deploy/astrbot/cli.html) for fully custom source-based installation with `uv`.
+
+## Supported Messaging Platforms
+
+Connect AstrBot to your favorite chat platform.
+
+| Platform | Maintainer |
+|---------|---------------|
+| QQ | Official |
+| OneBot v11 protocol implementation | Official |
+| Telegram | Official |
+| Wecom & Wecom AI Bot | Official |
+| WeChat Official Accounts | Official |
+| Feishu (Lark) | Official |
+| DingTalk | Official |
+| Slack | Official |
+| Discord | Official |
+| LINE | Official |
+| Satori | Official |
+| KOOK | Official |
+| Misskey | Official |
+| Mattermost | Official |
+| WhatsApp (Coming Soon) | Official |
+| [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter) | Community |
+| [Rocket.Chat](https://github.com/NET-Homeless/astrbot_plugin_rocket_chat_adapter) | Community |
+| [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat) | Community |
+
+## Supported Model Services
+
+| Service | Type |
+|---------|---------------|
+| OpenAI and Compatible Services | LLM Services |
+| Anthropic | LLM Services |
+| Google Gemini | LLM Services |
+| Moonshot AI | LLM Services |
+| Zhipu AI | LLM Services |
+| DeepSeek | LLM Services |
+| Ollama (Self-hosted) | LLM Services |
+| LM Studio (Self-hosted) | LLM Services |
+| [AIHubMix](https://aihubmix.com/?aff=4bfH) | LLM Services (API Gateway, supports all models) |
+| [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74) | LLM Services |
+| [302.AI](https://share.302.ai/rr1M3l) | LLM Services |
+| [TokenPony](https://www.tokenpony.cn/3YPyf) | LLM Services |
+| [SiliconFlow](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot) | LLM Services |
+| [PPIO Cloud](https://ppio.com/user/register?invited_by=AIOONE) | LLM Services |
+| ModelScope | LLM Services |
+| OneAPI | LLM Services |
+| Dify | LLMOps Platforms |
+| Alibaba Cloud Bailian Applications | LLMOps Platforms |
+| Coze | LLMOps Platforms |
+| OpenAI Whisper | Speech-to-Text Services |
+| SenseVoice | Speech-to-Text Services |
+| Xiaomi MiMo Omni | Speech-to-Text Services |
+| OpenAI TTS | Text-to-Speech Services |
+| Gemini TTS | Text-to-Speech Services |
+| GPT-Sovits-Inference | Text-to-Speech Services |
+| GPT-Sovits | Text-to-Speech Services |
+| FishAudio | Text-to-Speech Services |
+| Edge TTS | Text-to-Speech Services |
+| Alibaba Cloud Bailian TTS | Text-to-Speech Services |
+| Azure TTS | Text-to-Speech Services |
+| Minimax TTS | Text-to-Speech Services |
+| Xiaomi MiMo TTS | Text-to-Speech Services |
+| Volcano Engine TTS | Text-to-Speech Services |
+
+## ❤️ Sponsors
+
+<p align="center">
+  <img alt="sponsors" src="https://sponsors.astrbot.app/?v=1">
+</p>
+
+
+## ❤️ Contributing
+
+Issues and Pull Requests are always welcome! Feel free to submit your changes to this project :)
+
+### How to Contribute
+
+You can contribute by reviewing issues or helping with pull request reviews. Any issues or PRs are welcome to encourage community participation. Of course, these are just suggestions—you can contribute in any way you like. For adding new features, please discuss through an Issue first.
+
+### Development Environment
+
+AstrBot uses `ruff` for code formatting and linting.
+
+```bash
+git clone https://github.com/AstrBotDevs/AstrBot
+pip install pre-commit
+pre-commit install
+```
+
+
+## 🌍 Community
+
+### QQ Groups
+
+- Group 12: 916228568 (New)
+- Group 9: 1076659624 (Full)
+- Group 10: 1078079676 (Full)
+- Group 11: 704659519 (Full)
+- Group 1: 322154837 (Full)
+- Group 3: 630166526 (Full)
+- Group 4: 1077826412 (Full)
+- Group 5: 822130018 (Full)
+- Group 6: 753075035 (Full)
+- Group 7: 743746109 (Full)
+- Group 8: 1030353265 (Full)
+
+- Developer Group(Chit-chat): 975206796
+- Developer Group(Formal): 1039761811
+
+### Discord Server
+
+<a href="https://discord.gg/hAVk6tgV36"><img alt="Discord_community" src="https://img.shields.io/badge/Discord-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
+
+## ❤️ Special Thanks
+
+Special thanks to all Contributors and plugin developers for their contributions to AstrBot ❤️
+
+<a href="https://github.com/AstrBotDevs/AstrBot/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=AstrBotDevs/AstrBot&max=200&columns=14" />
+</a>
+
+Additionally, the birth of this project would not have been possible without the help of the following open-source projects:
+
+- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - The amazing cat framework
+
+## ⭐ Star History
+
+> [!TIP]
+> If this project has helped you in your life or work, or if you're interested in its future development, please give the project a Star. It's the driving force behind maintaining this open-source project <3
+
+<div align="center">
+
+[![Star History Chart](https://api.star-history.com/svg?repos=astrbotdevs/astrbot&type=Date)](https://star-history.com/#astrbotdevs/astrbot&Date)
+
+</div>
+
+<div align="center">
+
+_Companionship and capability should never be at odds. What we aim to create is a robot that can understand emotions, provide genuine companionship, and reliably accomplish tasks._
+
+_私は、高性能ですから!_
+
+<img src="https://files.astrbot.app/watashiwa-koseino-desukara.gif" width="100"/>
+</div>

astrbot-4.23.5/astrbot/builtin_stars/builtin_commands/commands/__init__.py

@@ -0,0 +1,17 @@
+# Commands module
+
+from .admin import AdminCommands
+from .conversation import ConversationCommands
+from .help import HelpCommand
+from .provider import ProviderCommands
+from .setunset import SetUnsetCommands
+from .sid import SIDCommand
+
+__all__ = [
+    "AdminCommands",
+    "ConversationCommands",
+    "HelpCommand",
+    "ProviderCommands",
+    "SetUnsetCommands",
+    "SIDCommand",
+]

astrbot-4.23.5/astrbot/builtin_stars/builtin_commands/commands/provider.py

@@ -0,0 +1,248 @@
+from __future__ import annotations
+
+import asyncio
+
+from astrbot import logger
+from astrbot.api import star
+from astrbot.api.event import AstrMessageEvent, MessageEventResult
+from astrbot.core.provider.entities import ProviderType
+from astrbot.core.utils.error_redaction import safe_error
+
+
+class ProviderCommands:
+    def __init__(self, context: star.Context) -> None:
+        self.context = context
+
+    def _log_reachability_failure(
+        self,
+        provider,
+        provider_capability_type: ProviderType | None,
+        err_code: str,
+        err_reason: str,
+    ) -> None:
+        meta = provider.meta()
+        logger.warning(
+            "Provider reachability check failed: id=%s type=%s code=%s reason=%s",
+            meta.id,
+            provider_capability_type.name if provider_capability_type else "unknown",
+            err_code,
+            err_reason,
+        )
+
+    async def _test_provider_capability(self, provider):
+        meta = provider.meta()
+        provider_capability_type = meta.provider_type
+
+        try:
+            await provider.test()
+            return True, None, None
+        except Exception as e:
+            err_code = "TEST_FAILED"
+            err_reason = safe_error("", e)
+            self._log_reachability_failure(
+                provider, provider_capability_type, err_code, err_reason
+            )
+            return False, err_code, err_reason
+
+    async def _build_provider_display_data(
+        self,
+        providers,
+        provider_type: str,
+        reachability_check_enabled: bool,
+    ) -> list[dict]:
+        if not providers:
+            return []
+
+        if reachability_check_enabled:
+            check_results = await asyncio.gather(
+                *[self._test_provider_capability(provider) for provider in providers],
+                return_exceptions=True,
+            )
+        else:
+            check_results = [None for _ in providers]
+
+        display_data = []
+        for provider, reachable in zip(providers, check_results):
+            meta = provider.meta()
+            id_ = meta.id
+            error_code = None
+
+            if isinstance(reachable, asyncio.CancelledError):
+                raise reachable
+            if isinstance(reachable, Exception):
+                self._log_reachability_failure(
+                    provider,
+                    None,
+                    reachable.__class__.__name__,
+                    safe_error("", reachable),
+                )
+                reachable_flag = False
+                error_code = reachable.__class__.__name__
+            elif isinstance(reachable, tuple):
+                reachable_flag, error_code, _ = reachable
+            else:
+                reachable_flag = reachable
+
+            if provider_type == "llm":
+                info = f"{id_} ({meta.model})"
+            else:
+                info = f"{id_}"
+
+            if reachable_flag is True:
+                mark = " ✅"
+            elif reachable_flag is False:
+                if error_code:
+                    mark = f" ❌(errcode: {error_code})"
+                else:
+                    mark = " ❌"
+            else:
+                mark = ""
+
+            display_data.append(
+                {
+                    "info": info,
+                    "mark": mark,
+                    "provider": provider,
+                }
+            )
+
+        return display_data
+
+    async def provider(
+        self,
+        event: AstrMessageEvent,
+        idx: str | int | None = None,
+        idx2: int | None = None,
+    ) -> None:
+        """查看或者切换 LLM Provider"""
+        umo = event.unified_msg_origin
+        cfg = self.context.get_config(umo).get("provider_settings", {})
+        reachability_check_enabled = cfg.get("reachability_check", True)
+
+        if idx is None:
+            parts = ["## LLM Providers\n"]
+
+            llms = list(self.context.get_all_providers())
+            ttss = self.context.get_all_tts_providers()
+            stts = self.context.get_all_stt_providers()
+
+            if reachability_check_enabled and (llms or ttss or stts):
+                await event.send(
+                    MessageEventResult().message("👀 Testing provider reachability...")
+                )
+
+            llm_data, tts_data, stt_data = await asyncio.gather(
+                self._build_provider_display_data(
+                    llms,
+                    "llm",
+                    reachability_check_enabled,
+                ),
+                self._build_provider_display_data(
+                    ttss,
+                    "tts",
+                    reachability_check_enabled,
+                ),
+                self._build_provider_display_data(
+                    stts,
+                    "stt",
+                    reachability_check_enabled,
+                ),
+            )
+
+            provider_using = self.context.get_using_provider(umo=umo)
+            for i, d in enumerate(llm_data):
+                line = f"{i + 1}. {d['info']}{d['mark']}"
+                if (
+                    provider_using
+                    and provider_using.meta().id == d["provider"].meta().id
+                ):
+                    line += " 👈"
+                parts.append(line + "\n")
+
+            if tts_data:
+                parts.append("\n## TTS Providers\n")
+                tts_using = self.context.get_using_tts_provider(umo=umo)
+                for i, d in enumerate(tts_data):
+                    line = f"{i + 1}. {d['info']}{d['mark']}"
+                    if tts_using and tts_using.meta().id == d["provider"].meta().id:
+                        line += " 👈"
+                    parts.append(line + "\n")
+
+            if stt_data:
+                parts.append("\n## STT Providers\n")
+                stt_using = self.context.get_using_stt_provider(umo=umo)
+                for i, d in enumerate(stt_data):
+                    line = f"{i + 1}. {d['info']}{d['mark']}"
+                    if stt_using and stt_using.meta().id == d["provider"].meta().id:
+                        line += " 👈"
+                    parts.append(line + "\n")
+
+            parts.append("\nUse /provider <idx> to switch LLM providers.")
+            ret = "".join(parts)
+
+            if ttss:
+                ret += "\nUse /provider tts <idx> to switch TTS providers."
+            if stts:
+                ret += "\nUse /provider stt <idx> to switch STT providers."
+
+            event.set_result(MessageEventResult().message(ret))
+        elif idx == "tts":
+            if idx2 is None:
+                event.set_result(
+                    MessageEventResult().message("Please enter the index.")
+                )
+                return
+            if idx2 > len(self.context.get_all_tts_providers()) or idx2 < 1:
+                event.set_result(
+                    MessageEventResult().message("❌ Invalid provider index.")
+                )
+                return
+            provider = self.context.get_all_tts_providers()[idx2 - 1]
+            id_ = provider.meta().id
+            await self.context.provider_manager.set_provider(
+                provider_id=id_,
+                provider_type=ProviderType.TEXT_TO_SPEECH,
+                umo=umo,
+            )
+            event.set_result(
+                MessageEventResult().message(f"✅ Successfully switched to {id_}.")
+            )
+        elif idx == "stt":
+            if idx2 is None:
+                event.set_result(
+                    MessageEventResult().message("Please enter the index.")
+                )
+                return
+            if idx2 > len(self.context.get_all_stt_providers()) or idx2 < 1:
+                event.set_result(
+                    MessageEventResult().message("❌ Invalid provider index.")
+                )
+                return
+            provider = self.context.get_all_stt_providers()[idx2 - 1]
+            id_ = provider.meta().id
+            await self.context.provider_manager.set_provider(
+                provider_id=id_,
+                provider_type=ProviderType.SPEECH_TO_TEXT,
+                umo=umo,
+            )
+            event.set_result(
+                MessageEventResult().message(f"✅ Successfully switched to {id_}.")
+            )
+        elif isinstance(idx, int):
+            if idx > len(self.context.get_all_providers()) or idx < 1:
+                event.set_result(
+                    MessageEventResult().message("❌ Invalid provider index.")
+                )
+                return
+            provider = self.context.get_all_providers()[idx - 1]
+            id_ = provider.meta().id
+            await self.context.provider_manager.set_provider(
+                provider_id=id_,
+                provider_type=ProviderType.CHAT_COMPLETION,
+                umo=umo,
+            )
+            event.set_result(
+                MessageEventResult().message(f"✅ Successfully switched to {id_}.")
+            )
+        else:
+            event.set_result(MessageEventResult().message("❌ Invalid parameter."))