chore: bump version to 4.8.0

fix: not invoke on_llm_response hook when LLM request has error (#3871 )
* fix: handle on_agent_done in error responses - Introduced an LLMResponse for error messages to be processed by agent hooks, ensuring better error reporting and handling. * fix: improve error logging in on_agent_done hook --------- Co-authored-by: Soulter <37870767+Soulter@users.noreply.github.com>
2025-12-05 19:09:56 +08:00 · 2025-12-05 16:13:46 +08:00 · 2025-12-05 16:02:20 +08:00 · 2025-12-05 15:59:18 +08:00 · 2025-12-05 15:41:37 +08:00 · 2025-12-04 20:36:35 +08:00
108 changed files with 4630 additions and 1113 deletions
@@ -34,6 +34,7 @@ dashboard/node_modules/
 dashboard/dist/
 package-lock.json
 package.json
+yarn.lock

 # Operating System
 **/.DS_Store
@@ -47,3 +48,5 @@ astrbot.lock
 chroma
 venv/*
 pytest.ini
+AGENTS.md
+IFLOW.md
@@ -0,0 +1,65 @@
+# CONTRIBUTING
+
+## 贡献指南
+
+首先，感谢您花时间做出贡献！❤️
+
+所有类型的贡献都受到鼓励和重视。有关不同的帮助方式和处理方式的详细信息，请参阅[目录](#目录)。在做出贡献之前，请确保阅读相关部分。这将使我们维护人员的工作变得更加容易，并为所有参与者带来顺畅的体验。社区期待您的贡献。🎉
+
+### 目录
+
+- [报告问题](#报告问题)
+- [提交代码更改](#提交代码更改)
+
+### 报告问题
+
+如果您在使用 AstrBot 时遇到任何问题，请按照以下步骤报告：
+
+1. **检查现有问题**：在提交新问题之前，请先检查 [Issues](https://github.com/AstrBotDevs/AstrBot/issues) 中是否已经存在类似的问题。
+2. **创建新问题**：如果没有类似的问题，请创建一个新问题。请确保提供以下信息：
+   - 问题的简要描述
+   - 重现问题的步骤
+   - 预期结果和实际结果
+   - 相关日志或错误消息
+
+### 提交代码更改
+
+#### 分支命名
+
+我们使用 `fix/` 前缀来修复错误，使用 `feat/` 前缀来添加新功能。对于 `fix/` 分支，请使用简短的描述，或者直接使用 Issue 编号。例如：`fix/1234` 或者 `fix/1234-login-typo`。对于 `feat/` 分支，请使用简短的描述，例如：`feat/add-user-profile`。
+
+#### PR 描述
+
+- 请使用英文描述您的 PR。
+- 标题请使用 `fix: `, `feat: `, `docs: `, `style: `, `refactor: `, `test: `, `chore: ` 等语义化前缀，并简要描述更改内容。如：`fix: correct login page typo`。
+
+## Contributing Guide
+
+First off, thanks for taking the time to contribute! ❤️
+
+All types of contributions are encouraged and valued. See the [Table of Contents](#table-of-contents) for different ways to help and details about how this project handles them. Please make sure to read the relevant section before making your contribution. It will make it a lot easier for us maintainers and smooth out the experience for all involved. The community looks forward to your contributions. 🎉
+
+### Table of Contents
+
+- [Reporting Issues](#reporting-issues)
+- [Pull Requests](#pull-requests)
+
+### Reporting Issues
+
+If you encounter any issues while using AstrBot, please follow these steps to report them:
+1. **Check Existing Issues**: Before submitting a new issue, please check if a similar issue already exists in the [Issues](https://github.com/AstrBotDevs/AstrBot/issues) section of the repository.
+2. **Create a New Issue**: If no similar issue exists, please create a new issue. Make sure to provide the following information:
+   - A brief description of the issue
+   - Steps to reproduce the issue
+   - Expected and actual results
+   - Relevant logs or error messages
+
+### Pull Requests
+
+#### Branch Naming
+
+We use the `fix/` prefix for bug fixes and the `feat/` prefix for new features. For `fix/` branches, please use a short description or directly use the Issue number, e.g., `fix/1234` or `fix/1234-login-typo`. For `feat/` branches, please use a short description, e.g., `feat/add-user-profile`.
+
+#### PR Description
+- Please use English to describe your PR.
+- Use semantic prefixes like `fix: `, `feat: `, `docs: `, `style: `, `refactor: `, `test: `, `chore: ` in the title, followed by a brief description of the changes, e.g., `fix: correct login page typo`.
@@ -1,10 +1,13 @@
 ![AstrBot-Logo-Simplified](https://github.com/user-attachments/assets/ffd99b6b-3272-4682-beaa-6fe74250f7d9)

-</p>
-
 <div align="center">

-<br>
+
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_en.md">English</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.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_fr.md">Français</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ru.md">Русский</a>

 <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>
@@ -14,35 +17,37 @@
 <br>

 <div>
-<img src="https://img.shields.io/github/v/release/AstrBotDevs/AstrBot?style=for-the-badge&color=76bad9" href="https://github.com/AstrBotDevs/AstrBot/releases/latest">
-<img src="https://img.shields.io/badge/python-3.10+-blue.svg?style=for-the-badge&color=76bad9" alt="python">
-<a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?style=for-the-badge&color=76bad9"/></a>
-<a href="https://qm.qq.com/cgi-bin/qm/qr?k=wtbaNx7EioxeaqS9z7RQWVXPIxg2zYr7&jump_from=webapi&authKey=vlqnv/AV2DbJEvGIcxdlNSpfxVy+8vVqijgreRdnVKOaydpc+YSw4MctmEbr0k5"><img alt="QQ_community" src="https://img.shields.io/badge/QQ群-775869627-purple?style=for-the-badge&color=76bad9"></a>
-<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&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=%E4%B8%AA&style=for-the-badge&label=%E6%8F%92%E4%BB%B6%E5%B8%82%E5%9C%BA&cacheSeconds=3600">
+<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://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=%E4%B8%AA&label=%E6%8F%92%E4%BB%B6%E5%B8%82%E5%9C%BA&cacheSeconds=3600">
+<img src="https://gitcode.com/Soulter/AstrBot/star/badge.svg" href="https://gitcode.com/Soulter/AstrBot">
 </div>

 <br>

-<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_en.md">English</a> ｜
-<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.md">日本語</a> ｜
 <a href="https://astrbot.app/">文档</a> ｜
 <a href="https://blog.astrbot.app/">Blog</a> ｜
 <a href="https://astrbot.featurebase.app/roadmap">路线图</a> ｜
 <a href="https://github.com/AstrBotDevs/AstrBot/issues">问题提交</a>
 </div>

-AstrBot 是一个开源的一站式 Agent 聊天机器人平台，可无缝接入主流即时通讯软件，为个人、开发者和团队打造可靠、可扩展的对话式智能基础设施。无论是个人 AI 伙伴、智能客服、自动化助手，还是企业知识库，AstrBot 都能在你的即时通讯软件平台的工作流中快速构建生产可用的 AI 应用。
+AstrBot 是一个开源的一站式 Agent 聊天机器人平台，可接入主流即时通讯软件，为个人、开发者和团队打造可靠、可扩展的对话式智能基础设施。无论是个人 AI 伙伴、智能客服、自动化助手，还是企业知识库，AstrBot 都能在你的即时通讯软件平台的工作流中快速构建生产可用的 AI 应用。
+
+<img width="1776" height="1080" alt="image" src="https://github.com/user-attachments/assets/00782c4c-4437-4d97-aabc-605e3738da5c" />

 ## 主要功能

-1. **大模型对话**。支持接入多种大模型服务。支持多模态、工具调用、MCP、原生知识库、人设等功能。
-2. **多消息平台支持**。支持接入 QQ、企业微信、微信公众号、飞书、Telegram、钉钉、Discord、KOOK 等平台。支持速率限制、白名单、百度内容审核。
-3. **Agent**。完善适配的 Agentic 能力。支持多轮工具调用、内置沙盒代码执行器、网页搜索等功能。
-4. **插件扩展**。深度优化的插件机制，支持[开发插件](https://astrbot.app/dev/plugin.html)扩展功能，社区插件生态丰富。
-5. **WebUI**。可视化配置和管理机器人，功能齐全。
+1. 💯 免费 & 开源。
+1. ✨ AI 大模型对话，多模态，Agent，MCP，知识库，人格设定。
+2. 🤖 支持接入 Dify、阿里云百炼、Coze 等智能体平台。
+2. 🌐 多平台，支持 QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 以及[更多](#支持的消息平台)。
+3. 📦 插件扩展，已有近 800 个插件可一键安装。
+5. 💻 WebUI 支持。
+6. 🌐 国际化（i18n）支持。

-## 部署方式 
+## 快速开始

 #### Docker 部署(推荐 🥳)

@@ -50,6 +55,12 @@ AstrBot 是一个开源的一站式 Agent 聊天机器人平台，可无缝接

 请参阅官方文档 [使用 Docker 部署 AstrBot](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot) 。

+#### uv 部署
+
+```bash
+uvx astrbot
+```
+
 #### 宝塔面板部署

 AstrBot 与宝塔面板合作，已上架至宝塔面板。
@@ -101,24 +112,6 @@ uv run main.py

 或者请参阅官方文档 [通过源码部署 AstrBot](https://astrbot.app/deploy/astrbot/cli.html) 。

-## 🌍 社区
-
-### QQ 群组
-
- 1 群：322154837
- 3 群：630166526
- 5 群：822130018
- 6 群：753075035
- 开发者群：975206796
-
-### Telegram 群组
-
-<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
-
-### Discord 群组
-
-<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>
-
 ## 支持的消息平台

 **官方维护**
@@ -205,6 +198,24 @@ pip install pre-commit
 pre-commit install
 ```

+## 🌍 社区
+
+### QQ 群组
+
+- 1 群：322154837
+- 3 群：630166526
+- 5 群：822130018
+- 6 群：753075035
+- 开发者群：975206796
+
+### Telegram 群组
+
+<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
+
+### Discord 群组
+
+<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

 特别感谢所有 Contributors 和插件开发者对 AstrBot 的贡献 ❤️
@@ -19,30 +19,38 @@
 <a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?style=for-the-badge&color=76bad9"/></a>
 <a href="https://qm.qq.com/cgi-bin/qm/qr?k=wtbaNx7EioxeaqS9z7RQWVXPIxg2zYr7&jump_from=webapi&authKey=vlqnv/AV2DbJEvGIcxdlNSpfxVy+8vVqijgreRdnVKOaydpc+YSw4MctmEbr0k5"><img alt="QQ_community" src="https://img.shields.io/badge/QQ群-775869627-purple?style=for-the-badge&color=76bad9"></a>
 <a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&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=%E4%B8%AA&style=for-the-badge&label=%E6%8F%92%E4%BB%B6%E5%B8%82%E5%9C%BA&cacheSeconds=3600">
+<img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.soulter.top%2Fastrbot%2Fplugin-num&query=%24.result&suffix=%20plugins&style=for-the-badge&label=Marketplace&cacheSeconds=3600">
 </div>

 <br>

 <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README.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_zh-TW.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>
+
 <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>
 </div>

-AstrBot is an open-source all-in-one Agent chatbot platform and development framework.
+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.
+
+<img width="1776" height="1080" alt="image" src="https://github.com/user-attachments/assets/00782c4c-4437-4d97-aabc-605e3738da5c" />

 ## Key Features

-1. **LLM Conversations**. Supports integration with various large language model services. Features include multimodal capabilities, tool calling, MCP, native knowledge base, character personas, and more.
-2. **Multi-Platform Support**. Integrates with QQ, WeChat Work, WeChat Official Accounts, Feishu, Telegram, DingTalk, Discord, KOOK, and other platforms. Supports rate limiting, whitelisting, and Baidu content moderation.
-3. **Agent Capabilities**. Fully optimized agentic features including multi-turn tool calling, built-in sandboxed code executor, web search, and more.
-4. **Plugin Extensions**. Deeply optimized plugin mechanism supporting [plugin development](https://astrbot.app/dev/plugin.html) to extend functionality, with a rich community plugin ecosystem.
-5. **Web UI**. Visual configuration and management of your bot with comprehensive features.
+1. 💯 Free & Open Source.
+2. ✨ AI LLM Conversations, Multimodal, Agent, MCP, Knowledge Base, Persona Settings.
+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 nearly 800 plugins available for one-click installation.
+6. 💻 WebUI Support.
+7. 🌐 Internationalization (i18n) Support.

-## Deployment Methods
+## Quick Start

 #### Docker Deployment (Recommended 🥳)

@@ -50,6 +58,12 @@ We recommend deploying AstrBot using Docker or Docker Compose.

 Please refer to the official documentation: [Deploy AstrBot with Docker](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).

+#### uv Deployment
+
+```bash
+uvx astrbot
+```
+
 #### BT-Panel Deployment

 AstrBot has partnered with BT-Panel and is now available in their marketplace.
@@ -101,24 +115,6 @@ uv run main.py

 Or refer to the official documentation: [Deploy AstrBot from Source](https://astrbot.app/deploy/astrbot/cli.html).

-## 🌍 Community
-
-### QQ Groups
-
- Group 1: 322154837
- Group 3: 630166526
- Group 5: 822130018
- Group 6: 753075035
- Developer Group: 975206796
-
-### Telegram Group
-
-<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
-
-### 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>
-
 ## Supported Messaging Platforms

 **Officially Maintained**
@@ -205,6 +201,24 @@ pip install pre-commit
 pre-commit install
 ```

+## 🌍 Community
+
+### QQ Groups
+
+- Group 1: 322154837
+- Group 3: 630166526
+- Group 5: 822130018
+- Group 6: 753075035
+- Developer Group: 975206796
+
+### Telegram Group
+
+<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
+
+### 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 ❤️
@@ -0,0 +1,248 @@
+![AstrBot-Logo-Simplified](https://github.com/user-attachments/assets/ffd99b6b-3272-4682-beaa-6fe74250f7d9)
+
+</p>
+
+<div align="center">
+
+<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?style=for-the-badge&color=76bad9" href="https://github.com/AstrBotDevs/AstrBot/releases/latest">
+<img src="https://img.shields.io/badge/python-3.10+-blue.svg?style=for-the-badge&color=76bad9" alt="python">
+<a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?style=for-the-badge&color=76bad9"/></a>
+<a href="https://qm.qq.com/cgi-bin/qm/qr?k=wtbaNx7EioxeaqS9z7RQWVXPIxg2zYr7&jump_from=webapi&authKey=vlqnv/AV2DbJEvGIcxdlNSpfxVy+8vVqijgreRdnVKOaydpc+YSw4MctmEbr0k5"><img alt="QQ_community" src="https://img.shields.io/badge/QQ群-775869627-purple?style=for-the-badge&color=76bad9"></a>
+<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&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&style=for-the-badge&label=Marketplace&cacheSeconds=3600">
+</div>
+
+<br>
+
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README.md">中文</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_en.md">English</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.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_ru.md">Русский</a>
+
+<a href="https://astrbot.app/">Documentation</a> ｜
+<a href="https://blog.astrbot.app/">Blog</a> ｜
+<a href="https://astrbot.featurebase.app/roadmap">Feuille de route</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/issues">Signaler un problème</a>
+</div>
+
+AstrBot est une plateforme de chatbot Agent tout-en-un open source qui s'intègre aux principales applications de messagerie instantanée. Elle fournit une infrastructure d'IA conversationnelle fiable et évolutive pour les particuliers, les développeurs et les équipes. Que vous construisiez un compagnon IA personnel, un service client intelligent, un assistant d'automatisation ou une base de connaissances d'entreprise, AstrBot vous permet de créer rapidement des applications d'IA prêtes pour la production dans les flux de travail de votre plateforme de messagerie.
+
+<img width="1776" height="1080" alt="image" src="https://github.com/user-attachments/assets/00782c4c-4437-4d97-aabc-605e3738da5c" />
+
+## Fonctionnalités principales
+
+1. 💯 Gratuit & Open Source.
+2. ✨ Conversations avec LLM IA, Multimodal, Agent, MCP, Base de connaissances, Paramètres de personnalité.
+3. 🤖 Prise en charge de l'intégration avec Dify, Alibaba Cloud Bailian, Coze et autres plateformes d'agents.
+4. 🌐 Multi-plateforme : QQ, WeChat Work, Feishu, DingTalk, Comptes officiels WeChat, Telegram, Slack, et [plus encore](#plateformes-de-messagerie-prises-en-charge).
+5. 📦 Extensions de plugins avec près de 800 plugins disponibles pour une installation en un clic.
+6. 💻 Support WebUI.
+7. 🌐 Support de l'internationalisation (i18n).
+
+## Démarrage rapide
+
+#### Déploiement Docker (Recommandé 🥳)
+
+Nous recommandons de déployer AstrBot en utilisant Docker ou Docker Compose.
+
+Veuillez consulter la documentation officielle : [Déployer AstrBot avec Docker](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
+
+#### Déploiement uv
+
+```bash
+uvx astrbot
+```
+
+#### Déploiement BT-Panel
+
+AstrBot s'est associé à BT-Panel et est maintenant disponible sur leur marketplace.
+
+Veuillez consulter la documentation officielle : [Déploiement BT-Panel](https://astrbot.app/deploy/astrbot/btpanel.html).
+
+#### Déploiement 1Panel
+
+AstrBot a été officiellement listé sur le marketplace 1Panel.
+
+Veuillez consulter la documentation officielle : [Déploiement 1Panel](https://astrbot.app/deploy/astrbot/1panel.html).
+
+#### Déployer sur RainYun
+
+AstrBot a été officiellement listé sur la plateforme d'applications cloud de RainYun avec un déploiement en un clic.
+
+[![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)
+
+#### Déployer sur Replit
+
+Méthode de déploiement contribuée par la communauté.
+
+[![Run on Repl.it](https://repl.it/badge/github/AstrBotDevs/AstrBot)](https://repl.it/github/AstrBotDevs/AstrBot)
+
+#### Installateur Windows en un clic
+
+Veuillez consulter la documentation officielle : [Déployer AstrBot avec l'installateur Windows en un clic](https://astrbot.app/deploy/astrbot/windows.html).
+
+#### Déploiement CasaOS
+
+Méthode de déploiement contribuée par la communauté.
+
+Veuillez consulter la documentation officielle : [Déploiement CasaOS](https://astrbot.app/deploy/astrbot/casaos.html).
+
+#### Déploiement manuel
+
+Tout d'abord, installez uv :
+
+```bash
+pip install uv
+```
+
+Installez AstrBot via Git Clone :
+
+```bash
+git clone https://github.com/AstrBotDevs/AstrBot && cd AstrBot
+uv run main.py
+```
+
+Ou consultez la documentation officielle : [Déployer AstrBot depuis les sources](https://astrbot.app/deploy/astrbot/cli.html).
+
+## Plateformes de messagerie prises en charge
+
+**Maintenues officiellement**
+
+- QQ (Plateforme officielle & OneBot)
+- Telegram
+- Application WeChat Work & Bot intelligent WeChat Work
+- Service client WeChat & Comptes officiels WeChat
+- Feishu (Lark)
+- DingTalk
+- Slack
+- Discord
+- Satori
+- Misskey
+- WhatsApp (Bientôt disponible)
+- LINE (Bientôt disponible)
+
+**Maintenues par la communauté**
+
+- [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
+- [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
+- [Messages directs Bilibili](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
+- [wxauto](https://github.com/luosheng520qaq/wxauto-repost-onebotv11)
+
+## Services de modèles pris en charge
+
+**Services LLM**
+
+- OpenAI et services compatibles
+- Anthropic
+- Google Gemini
+- Moonshot AI
+- Zhipu AI
+- DeepSeek
+- Ollama (Auto-hébergé)
+- LM Studio (Auto-hébergé)
+- [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74)
+- [302.AI](https://share.302.ai/rr1M3l)
+- [TokenPony](https://www.tokenpony.cn/3YPyf)
+- [SiliconFlow](https://docs.siliconflow.cn/cn/usecases/use-siliconcloud-in-astrbot)
+- [PPIO Cloud](https://ppio.com/user/register?invited_by=AIOONE)
+- ModelScope
+- OneAPI
+
+**Plateformes LLMOps**
+
+- Dify
+- Applications Alibaba Cloud Bailian
+- Coze
+
+**Services de reconnaissance vocale**
+
+- OpenAI Whisper
+- SenseVoice
+
+**Services de synthèse vocale**
+
+- OpenAI TTS
+- Gemini TTS
+- GPT-Sovits-Inference
+- GPT-Sovits
+- FishAudio
+- Edge TTS
+- Alibaba Cloud Bailian TTS
+- Azure TTS
+- Minimax TTS
+- Volcano Engine TTS
+
+## ❤️ Contribuer
+
+Les Issues et Pull Requests sont toujours les bienvenues ! N'hésitez pas à soumettre vos modifications à ce projet :)
+
+### Comment contribuer
+
+Vous pouvez contribuer en examinant les issues ou en aidant à la revue des pull requests. Toutes les issues ou PRs sont les bienvenues pour encourager la participation de la communauté. Bien sûr, ce ne sont que des suggestions - vous pouvez contribuer de la manière que vous souhaitez. Pour l'ajout de nouvelles fonctionnalités, veuillez d'abord en discuter via une Issue.
+
+### Environnement de développement
+
+AstrBot utilise `ruff` pour le formatage et le linting du code.
+
+```bash
+git clone https://github.com/AstrBotDevs/AstrBot
+pip install pre-commit
+pre-commit install
+```
+
+## 🌍 Communauté
+
+### Groupes QQ
+
+- Groupe 1 : 322154837
+- Groupe 3 : 630166526
+- Groupe 5 : 822130018
+- Groupe 6 : 753075035
+- Groupe développeurs : 975206796
+
+### Groupe Telegram
+
+<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
+
+### Serveur Discord
+
+<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>
+
+## ❤️ Remerciements spéciaux
+
+Un grand merci à tous les contributeurs et développeurs de plugins pour leurs contributions à AstrBot ❤️
+
+<a href="https://github.com/AstrBotDevs/AstrBot/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=AstrBotDevs/AstrBot" />
+</a>
+
+De plus, la naissance de ce projet n'aurait pas été possible sans l'aide des projets open source suivants :
+
+- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - L'incroyable framework chat
+
+## ⭐ Historique des étoiles
+
+> [!TIP]
+> Si ce projet vous a aidé dans votre vie ou votre travail, ou si vous êtes intéressé par son développement futur, veuillez donner une étoile au projet. C'est la force motrice derrière la maintenance de ce projet open source <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>
+
+</details>
+
+_私は、高性能ですから!_
+
@@ -19,30 +19,38 @@
 <a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?style=for-the-badge&color=76bad9"/></a>
 <a href="https://qm.qq.com/cgi-bin/qm/qr?k=wtbaNx7EioxeaqS9z7RQWVXPIxg2zYr7&jump_from=webapi&authKey=vlqnv/AV2DbJEvGIcxdlNSpfxVy+8vVqijgreRdnVKOaydpc+YSw4MctmEbr0k5"><img alt="QQ_community" src="https://img.shields.io/badge/QQ群-775869627-purple?style=for-the-badge&color=76bad9"></a>
 <a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&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=%E4%B8%AA&style=for-the-badge&label=%E6%8F%92%E4%BB%B6%E5%B8%82%E5%9C%BA&cacheSeconds=3600">
+<img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.soulter.top%2Fastrbot%2Fplugin-num&query=%24.result&suffix=%E5%80%8B&style=for-the-badge&label=%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3&cacheSeconds=3600">
 </div>

 <br>

 <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README.md">中文</a> ｜
 <a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_en.md">English</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_fr.md">Français</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ru.md">Русский</a>
+
 <a href="https://astrbot.app/">ドキュメント</a> ｜
 <a href="https://blog.astrbot.app/">Blog</a> ｜
 <a href="https://astrbot.featurebase.app/roadmap">ロードマップ</a> ｜
 <a href="https://github.com/AstrBotDevs/AstrBot/issues">Issue</a>
 </div>

-AstrBot は、オープンソースのオールインワン Agent チャットボットプラットフォーム及び開発フレームワークです。
+AstrBot は、主要なインスタントメッセージングアプリと統合できるオープンソースのオールインワン Agent チャットボットプラットフォームです。個人、開発者、チームに信頼性が高くスケーラブルな会話型 AI インフラストラクチャを提供します。パーソナル AI コンパニオン、インテリジェントカスタマーサービス、オートメーションアシスタント、エンタープライズナレッジベースなど、AstrBot を使用すると、IM プラットフォームのワークフロー内で本番環境対応の AI アプリケーションを迅速に構築できます。
+
+<img width="1776" height="1080" alt="image" src="https://github.com/user-attachments/assets/00782c4c-4437-4d97-aabc-605e3738da5c" />

 ## 主な機能

-1. **大規模言語モデル対話**。多様な大規模言語モデルサービスとの統合をサポート。マルチモーダル、ツール呼び出し、MCP、ネイティブナレッジベース、キャラクター設定などの機能を搭載。
-2. **マルチメッセージプラットフォームサポート**。QQ、WeChat Work、WeChat公式アカウント、Feishu、Telegram、DingTalk、Discord、KOOK などのプラットフォームと統合可能。レート制限、ホワイトリスト、Baidu コンテンツ審査をサポート。
-3. **Agent**。完全に最適化された Agentic 機能。マルチターンツール呼び出し、内蔵サンドボックスコード実行環境、Web 検索などの機能をサポート。
-4. **プラグイン拡張**。深く最適化されたプラグインメカニズムで、[プラグイン開発](https://astrbot.app/dev/plugin.html)による機能拡張をサポート。豊富なコミュニティプラグインエコシステム。
-5. **WebUI**。ビジュアル設定とボット管理、充実した機能。
+1. 💯 無料 & オープンソース。
+2. ✨ AI 大規模言語モデル対話、マルチモーダル、Agent、MCP、ナレッジベース、ペルソナ設定。
+3. 🤖 Dify、Alibaba Cloud 百炼、Coze などの Agent プラットフォームとの統合をサポート。
+4. 🌐 マルチプラットフォーム：QQ、WeChat Work、Feishu、DingTalk、WeChat 公式アカウント、Telegram、Slack、[その他](#サポートされているメッセージプラットフォーム)。
+5. 📦 約800個のプラグインをワンクリックでインストール可能なプラグイン拡張機能。
+6. 💻 WebUI サポート。
+7. 🌐 国際化（i18n）サポート。

-## デプロイ方法
+## クイックスタート

 #### Docker デプロイ（推奨 🥳）

@@ -50,6 +58,12 @@ Docker / Docker Compose を使用した AstrBot のデプロイを推奨しま

 公式ドキュメント [Docker を使用した AstrBot のデプロイ](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot) をご参照ください。

+#### uv デプロイ
+
+```bash
+uvx astrbot
+```
+
 #### 宝塔パネルデプロイ

 AstrBot は宝塔パネルと提携し、宝塔パネルに公開されています。
@@ -101,24 +115,6 @@ uv run main.py

 または、公式ドキュメント [ソースコードから AstrBot をデプロイ](https://astrbot.app/deploy/astrbot/cli.html) をご参照ください。

-## 🌍 コミュニティ
-
-### QQ グループ
-
- 1群:322154837
- 3群:630166526
- 5群:822130018
- 6群:753075035
- 開発者群:975206796
-
-### Telegram グループ
-
-<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
-
-### Discord サーバー
-
-<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>
-
 ## サポートされているメッセージプラットフォーム

 **公式メンテナンス**
@@ -205,6 +201,24 @@ pip install pre-commit
 pre-commit install
 ```

+## 🌍 コミュニティ
+
+### QQ グループ
+
+- 1群: 322154837
+- 3群: 630166526
+- 5群: 822130018
+- 6群: 753075035
+- 開発者群: 975206796
+
+### Telegram グループ
+
+<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
+
+### Discord サーバー
+
+<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

 AstrBot への貢献をしていただいたすべてのコントリビューターとプラグイン開発者に特別な感謝を ❤️
@@ -0,0 +1,248 @@
+![AstrBot-Logo-Simplified](https://github.com/user-attachments/assets/ffd99b6b-3272-4682-beaa-6fe74250f7d9)
+
+</p>
+
+<div align="center">
+
+<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?style=for-the-badge&color=76bad9" href="https://github.com/AstrBotDevs/AstrBot/releases/latest">
+<img src="https://img.shields.io/badge/python-3.10+-blue.svg?style=for-the-badge&color=76bad9" alt="python">
+<a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?style=for-the-badge&color=76bad9"/></a>
+<a href="https://qm.qq.com/cgi-bin/qm/qr?k=wtbaNx7EioxeaqS9z7RQWVXPIxg2zYr7&jump_from=webapi&authKey=vlqnv/AV2DbJEvGIcxdlNSpfxVy+8vVqijgreRdnVKOaydpc+YSw4MctmEbr0k5"><img alt="QQ_community" src="https://img.shields.io/badge/QQ群-775869627-purple?style=for-the-badge&color=76bad9"></a>
+<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&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=%20%D0%BF%D0%BB%D0%B0%D0%B3%D0%B8%D0%BD%D0%BE%D0%B2&style=for-the-badge&label=%D0%9C%D0%B0%D0%B3%D0%B0%D0%B7%D0%B8%D0%BD&cacheSeconds=3600">
+</div>
+
+<br>
+
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README.md">中文</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_en.md">English</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_ja.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_fr.md">Français</a>
+
+<a href="https://astrbot.app/">Документация</a> ｜
+<a href="https://blog.astrbot.app/">Блог</a> ｜
+<a href="https://astrbot.featurebase.app/roadmap">Дорожная карта</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/issues">Сообщить о проблеме</a>
+</div>
+
+AstrBot — это универсальная платформа Agent-чатботов с открытым исходным кодом, которая интегрируется с основными приложениями для обмена мгновенными сообщениями. Она предоставляет надёжную и масштабируемую инфраструктуру разговорного ИИ для частных лиц, разработчиков и команд. Будь то персональный ИИ-компаньон, интеллектуальная служба поддержки, автоматизированный помощник или корпоративная база знаний — AstrBot позволяет быстро создавать готовые к использованию ИИ-приложения в рабочих процессах вашей платформы обмена сообщениями.
+
+<img width="1776" height="1080" alt="image" src="https://github.com/user-attachments/assets/00782c4c-4437-4d97-aabc-605e3738da5c" />
+
+## Основные возможности
+
+1. 💯 Бесплатно и с открытым исходным кодом.
+2. ✨ ИИ-диалоги с LLM, мультимодальность, Agent, MCP, база знаний, настройки личности.
+3. 🤖 Поддержка интеграции с Dify, Alibaba Cloud Bailian, Coze и другими платформами агентов.
+4. 🌐 Мультиплатформенность: QQ, WeChat Work, Feishu, DingTalk, официальные аккаунты WeChat, Telegram, Slack и [другие](#поддерживаемые-платформы-обмена-сообщениями).
+5. 📦 Расширения плагинов с почти 800 плагинами, доступными для установки в один клик.
+6. 💻 Поддержка WebUI.
+7. 🌐 Поддержка интернационализации (i18n).
+
+## Быстрый старт
+
+#### Развёртывание Docker (Рекомендуется 🥳)
+
+Мы рекомендуем развёртывать AstrBot с помощью Docker или Docker Compose.
+
+См. официальную документацию: [Развёртывание AstrBot с Docker](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot).
+
+#### Развёртывание uv
+
+```bash
+uvx astrbot
+```
+
+#### Развёртывание BT-Panel
+
+AstrBot в партнёрстве с BT-Panel теперь доступен на их маркетплейсе.
+
+См. официальную документацию: [Развёртывание BT-Panel](https://astrbot.app/deploy/astrbot/btpanel.html).
+
+#### Развёртывание 1Panel
+
+AstrBot официально размещён на маркетплейсе 1Panel.
+
+См. официальную документацию: [Развёртывание 1Panel](https://astrbot.app/deploy/astrbot/1panel.html).
+
+#### Развёртывание на RainYun
+
+AstrBot официально размещён на облачной платформе приложений RainYun с развёртыванием в один клик.
+
+[![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)
+
+#### Развёртывание на Replit
+
+Метод развёртывания от сообщества.
+
+[![Run on Repl.it](https://repl.it/badge/github/AstrBotDevs/AstrBot)](https://repl.it/github/AstrBotDevs/AstrBot)
+
+#### Установщик Windows в один клик
+
+См. официальную документацию: [Развёртывание AstrBot с установщиком Windows в один клик](https://astrbot.app/deploy/astrbot/windows.html).
+
+#### Развёртывание CasaOS
+
+Метод развёртывания от сообщества.
+
+См. официальную документацию: [Развёртывание CasaOS](https://astrbot.app/deploy/astrbot/casaos.html).
+
+#### Ручное развёртывание
+
+Сначала установите uv:
+
+```bash
+pip install uv
+```
+
+Установите AstrBot через Git Clone:
+
+```bash
+git clone https://github.com/AstrBotDevs/AstrBot && cd AstrBot
+uv run main.py
+```
+
+Или см. официальную документацию: [Развёртывание AstrBot из исходного кода](https://astrbot.app/deploy/astrbot/cli.html).
+
+## Поддерживаемые платформы обмена сообщениями
+
+**Официально поддерживаемые**
+
+- QQ (Официальная платформа и OneBot)
+- Telegram
+- Приложение WeChat Work и интеллектуальный бот WeChat Work
+- Служба поддержки WeChat и официальные аккаунты WeChat
+- Feishu (Lark)
+- DingTalk
+- Slack
+- Discord
+- Satori
+- Misskey
+- WhatsApp (Скоро)
+- LINE (Скоро)
+
+**Поддерживаемые сообществом**
+
+- [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
+- [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
+- [Личные сообщения Bilibili](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
+- [wxauto](https://github.com/luosheng520qaq/wxauto-repost-onebotv11)
+
+## Поддерживаемые сервисы моделей
+
+**Сервисы LLM**
+
+- OpenAI и совместимые сервисы
+- Anthropic
+- Google Gemini
+- Moonshot AI
+- Zhipu AI
+- DeepSeek
+- Ollama (Самостоятельное размещение)
+- LM Studio (Самостоятельное размещение)
+- [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74)
+- [302.AI](https://share.302.ai/rr1M3l)
+- [TokenPony](https://www.tokenpony.cn/3YPyf)
+- [SiliconFlow](https://docs.siliconflow.cn/cn/usecases/use-siliconcloud-in-astrbot)
+- [PPIO Cloud](https://ppio.com/user/register?invited_by=AIOONE)
+- ModelScope
+- OneAPI
+
+**Платформы LLMOps**
+
+- Dify
+- Приложения Alibaba Cloud Bailian
+- Coze
+
+**Сервисы распознавания речи**
+
+- OpenAI Whisper
+- SenseVoice
+
+**Сервисы синтеза речи**
+
+- OpenAI TTS
+- Gemini TTS
+- GPT-Sovits-Inference
+- GPT-Sovits
+- FishAudio
+- Edge TTS
+- Alibaba Cloud Bailian TTS
+- Azure TTS
+- Minimax TTS
+- Volcano Engine TTS
+
+## ❤️ Вклад в проект
+
+Issues и Pull Request всегда приветствуются! Не стесняйтесь отправлять свои изменения в этот проект :)
+
+### Как внести вклад
+
+Вы можете внести вклад, просматривая issues или помогая с ревью pull request. Любые issues или PR приветствуются для поощрения участия сообщества. Конечно, это лишь предложения — вы можете вносить вклад любым удобным для вас способом. Для добавления новых функций сначала обсудите это через Issue.
+
+### Среда разработки
+
+AstrBot использует `ruff` для форматирования и линтинга кода.
+
+```bash
+git clone https://github.com/AstrBotDevs/AstrBot
+pip install pre-commit
+pre-commit install
+```
+
+## 🌍 Сообщество
+
+### Группы QQ
+
+- Группа 1: 322154837
+- Группа 3: 630166526
+- Группа 5: 822130018
+- Группа 6: 753075035
+- Группа разработчиков: 975206796
+
+### Группа Telegram
+
+<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
+
+### Сервер Discord
+
+<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>
+
+## ❤️ Особая благодарность
+
+Особая благодарность всем контрибьюторам и разработчикам плагинов за их вклад в AstrBot ❤️
+
+<a href="https://github.com/AstrBotDevs/AstrBot/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=AstrBotDevs/AstrBot" />
+</a>
+
+Кроме того, рождение этого проекта было бы невозможно без помощи следующих проектов с открытым исходным кодом:
+
+- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - Замечательный кошачий фреймворк
+
+## ⭐ История звёзд
+
+> [!TIP]
+> Если этот проект помог вам в жизни или работе, или если вас интересует его будущее развитие, пожалуйста, поставьте проекту звезду. Это движущая сила поддержки этого проекта с открытым исходным кодом <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>
+
+</details>
+
+_私は、高性能ですから!_
+
@@ -0,0 +1,248 @@
+![AstrBot-Logo-Simplified](https://github.com/user-attachments/assets/ffd99b6b-3272-4682-beaa-6fe74250f7d9)
+
+</p>
+
+<div align="center">
+
+<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?style=for-the-badge&color=76bad9" href="https://github.com/AstrBotDevs/AstrBot/releases/latest">
+<img src="https://img.shields.io/badge/python-3.10+-blue.svg?style=for-the-badge&color=76bad9" alt="python">
+<a href="https://hub.docker.com/r/soulter/astrbot"><img alt="Docker pull" src="https://img.shields.io/docker/pulls/soulter/astrbot.svg?style=for-the-badge&color=76bad9"/></a>
+<a href="https://qm.qq.com/cgi-bin/qm/qr?k=wtbaNx7EioxeaqS9z7RQWVXPIxg2zYr7&jump_from=webapi&authKey=vlqnv/AV2DbJEvGIcxdlNSpfxVy+8vVqijgreRdnVKOaydpc+YSw4MctmEbr0k5"><img alt="QQ_community" src="https://img.shields.io/badge/QQ群-775869627-purple?style=for-the-badge&color=76bad9"></a>
+<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&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=%E5%80%8B&style=for-the-badge&label=%E6%8F%92%E4%BB%B6%E5%B8%82%E5%A0%B4&cacheSeconds=3600">
+</div>
+
+<br>
+
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README.md">简体中文</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/blob/master/README_en.md">English</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>
+
+<a href="https://astrbot.app/">文件</a> ｜
+<a href="https://blog.astrbot.app/">Blog</a> ｜
+<a href="https://astrbot.featurebase.app/roadmap">路線圖</a> ｜
+<a href="https://github.com/AstrBotDevs/AstrBot/issues">問題回報</a>
+</div>
+
+AstrBot 是一個開源的一站式 Agent 聊天機器人平台，可接入主流即時通訊軟體，為個人、開發者和團隊打造可靠、可擴展的對話式智慧基礎設施。無論是個人 AI 夥伴、智慧客服、自動化助手，還是企業知識庫，AstrBot 都能在您的即時通訊軟體平台的工作流程中快速構建生產可用的 AI 應用程式。
+
+<img width="1776" height="1080" alt="image" src="https://github.com/user-attachments/assets/00782c4c-4437-4d97-aabc-605e3738da5c" />
+
+## 主要功能
+
+1. 💯 免費 & 開源。
+2. ✨ AI 大型模型對話，多模態，Agent，MCP，知識庫，人格設定。
+3. 🤖 支援接入 Dify、阿里雲百煉、Coze 等智慧體平台。
+4. 🌐 多平台：QQ、企業微信、飛書、釘釘、微信公眾號、Telegram、Slack 以及[更多](#支援的訊息平台)。
+5. 📦 外掛擴充，已有近 800 個外掛可一鍵安裝。
+6. 💻 WebUI 支援。
+7. 🌐 國際化（i18n）支援。
+
+## 快速開始
+
+#### Docker 部署（推薦 🥳）
+
+推薦使用 Docker / Docker Compose 方式部署 AstrBot。
+
+請參閱官方文件 [使用 Docker 部署 AstrBot](https://astrbot.app/deploy/astrbot/docker.html#%E4%BD%BF%E7%94%A8-docker-%E9%83%A8%E7%BD%B2-astrbot)。
+
+#### uv 部署
+
+```bash
+uvx astrbot
+```
+
+#### 寶塔面板部署
+
+AstrBot 與寶塔面板合作，已上架至寶塔面板。
+
+請參閱官方文件 [寶塔面板部署](https://astrbot.app/deploy/astrbot/btpanel.html)。
+
+#### 1Panel 部署
+
+AstrBot 已由 1Panel 官方上架至 1Panel 面板。
+
+請參閱官方文件 [1Panel 部署](https://astrbot.app/deploy/astrbot/1panel.html)。
+
+#### 在雨雲上部署
+
+AstrBot 已由雨雲官方上架至雲端應用程式平台，可一鍵部署。
+
+[![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)
+
+#### 在 Replit 上部署
+
+社群貢獻的部署方式。
+
+[![Run on Repl.it](https://repl.it/badge/github/AstrBotDevs/AstrBot)](https://repl.it/github/AstrBotDevs/AstrBot)
+
+#### Windows 一鍵安裝器部署
+
+請參閱官方文件 [使用 Windows 一鍵安裝器部署 AstrBot](https://astrbot.app/deploy/astrbot/windows.html)。
+
+#### CasaOS 部署
+
+社群貢獻的部署方式。
+
+請參閱官方文件 [CasaOS 部署](https://astrbot.app/deploy/astrbot/casaos.html)。
+
+#### 手動部署
+
+首先安裝 uv：
+
+```bash
+pip install uv
+```
+
+透過 Git Clone 安裝 AstrBot：
+
+```bash
+git clone https://github.com/AstrBotDevs/AstrBot && cd AstrBot
+uv run main.py
+```
+
+或者請參閱官方文件 [透過原始碼部署 AstrBot](https://astrbot.app/deploy/astrbot/cli.html)。
+
+## 支援的訊息平台
+
+**官方維護**
+
+- QQ（官方平台 & OneBot）
+- Telegram
+- 企微應用 & 企微智慧機器人
+- 微信客服 & 微信公眾號
+- 飛書
+- 釘釘
+- Slack
+- Discord
+- Satori
+- Misskey
+- Whatsapp（即將支援）
+- LINE（即將支援）
+
+**社群維護**
+
+- [KOOK](https://github.com/wuyan1003/astrbot_plugin_kook_adapter)
+- [VoceChat](https://github.com/HikariFroya/astrbot_plugin_vocechat)
+- [Bilibili 私訊](https://github.com/Hina-Chat/astrbot_plugin_bilibili_adapter)
+- [wxauto](https://github.com/luosheng520qaq/wxauto-repost-onebotv11)
+
+## 支援的模型服務
+
+**大型模型服務**
+
+- OpenAI 及相容服務
+- Anthropic
+- Google Gemini
+- Moonshot AI
+- 智譜 AI
+- DeepSeek
+- Ollama（本機部署）
+- LM Studio（本機部署）
+- [優雲智算](https://www.compshare.cn/?ytag=GPU_YY-gh_astrbot&referral_code=FV7DcGowN4hB5UuXKgpE74)
+- [302.AI](https://share.302.ai/rr1M3l)
+- [小馬算力](https://www.tokenpony.cn/3YPyf)
+- [矽基流動](https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-astrbot)
+- [PPIO 派歐雲](https://ppio.com/user/register?invited_by=AIOONE)
+- ModelScope
+- OneAPI
+
+**LLMOps 平台**
+
+- Dify
+- 阿里雲百煉應用
+- Coze
+
+**語音轉文字服務**
+
+- OpenAI Whisper
+- SenseVoice
+
+**文字轉語音服務**
+
+- OpenAI TTS
+- Gemini TTS
+- GPT-Sovits-Inference
+- GPT-Sovits
+- FishAudio
+- Edge TTS
+- 阿里雲百煉 TTS
+- Azure TTS
+- Minimax TTS
+- 火山引擎 TTS
+
+## ❤️ 貢獻
+
+歡迎任何 Issues/Pull Requests！只需要將您的變更提交到此專案 ：)
+
+### 如何貢獻
+
+您可以透過檢視問題或協助審核 PR（拉取請求）來貢獻。任何問題或 PR 都歡迎參與，以促進社群貢獻。當然，這些只是建議，您可以以任何方式進行貢獻。對於新功能的新增，請先透過 Issue 討論。
+
+### 開發環境
+
+AstrBot 使用 `ruff` 進行程式碼格式化和檢查。
+
+```bash
+git clone https://github.com/AstrBotDevs/AstrBot
+pip install pre-commit
+pre-commit install
+```
+
+## 🌍 社群
+
+### QQ 群組
+
+- 1 群：322154837
+- 3 群：630166526
+- 5 群：822130018
+- 6 群：753075035
+- 開發者群：975206796
+
+### Telegram 群組
+
+<a href="https://t.me/+hAsD2Ebl5as3NmY1"><img alt="Telegram_community" src="https://img.shields.io/badge/Telegram-AstrBot-purple?style=for-the-badge&color=76bad9"></a>
+
+### Discord 群組
+
+<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
+
+特別感謝所有 Contributors 和外掛開發者對 AstrBot 的貢獻 ❤️
+
+<a href="https://github.com/AstrBotDevs/AstrBot/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=AstrBotDevs/AstrBot" />
+</a>
+
+此外，本專案的誕生離不開以下開源專案的幫助：
+
+- [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) - 偉大的貓貓框架
+
+## ⭐ Star History
+
+> [!TIP]
+> 如果本專案對您的生活 / 工作產生了幫助，或者您關注本專案的未來發展，請給專案 Star，這是我們維護這個開源專案的動力 <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>
+
+</details>
+
+_私は、高性能ですから!_
+
@@ -1 +1 @@
-__version__ = "3.5.23"
+__version__ = "4.8.0"
@@ -3,7 +3,7 @@

 from typing import Any, ClassVar, Literal, cast

-from pydantic import BaseModel, GetCoreSchemaHandler
+from pydantic import BaseModel, GetCoreSchemaHandler, model_validator
 from pydantic_core import core_schema


@@ -145,22 +145,39 @@ class Message(BaseModel):
        "tool",
    ]

-    content: str | list[ContentPart]
+    content: str | list[ContentPart] | None = None
    """The content of the message."""

+    tool_calls: list[ToolCall] | list[dict] | None = None
+    """The tool calls of the message."""
+
+    tool_call_id: str | None = None
+    """The ID of the tool call."""
+
+    @model_validator(mode="after")
+    def check_content_required(self):
+        # assistant + tool_calls is not None: allow content to be None
+        if self.role == "assistant" and self.tool_calls is not None:
+            return self
+
+        # other all cases: content is required
+        if self.content is None:
+            raise ValueError(
+                "content is required unless role='assistant' and tool_calls is not None"
+            )
+        return self
+

 class AssistantMessageSegment(Message):
    """A message segment from the assistant."""

    role: Literal["assistant"] = "assistant"
-    tool_calls: list[ToolCall] | list[dict] | None = None


 class ToolCallMessageSegment(Message):
    """A message segment representing a tool call."""

    role: Literal["tool"] = "tool"
-    tool_call_id: str


 class UserMessageSegment(Message):
@@ -9,6 +9,7 @@ from astrbot.core.message.message_event_result import (
    MessageEventResult,
    ResultContentType,
 )
+from astrbot.core.provider.entities import LLMResponse

 AgentRunner = ToolLoopAgentRunner[AstrAgentContext]

@@ -72,7 +73,20 @@ async def run_agent(

        except Exception as e:
            logger.error(traceback.format_exc())
-            err_msg = f"\n\nAstrBot 请求失败。\n错误类型: {type(e).__name__}\n错误信息: {e!s}\n\n请在控制台查看和分享错误详情。\n"
+
+            err_msg = f"\n\nAstrBot 请求失败。\n错误类型: {type(e).__name__}\n错误信息: {e!s}\n\n请在平台日志查看和分享错误详情。\n"
+
+            error_llm_response = LLMResponse(
+                role="err",
+                completion_text=err_msg,
+            )
+            try:
+                await agent_runner.agent_hooks.on_agent_done(
+                    agent_runner.run_context, error_llm_response
+                )
+            except Exception:
+                logger.exception("Error in on_agent_done hook")
+
            if agent_runner.streaming:
                yield MessageChain().message(err_msg)
            else:
@@ -4,9 +4,17 @@ import os

 from astrbot.core.utils.astrbot_path import get_astrbot_data_path

-VERSION = "4.7.0"
+VERSION = "4.8.0"
 DB_PATH = os.path.join(get_astrbot_data_path(), "data_v4.db")

+WEBHOOK_SUPPORTED_PLATFORMS = [
+    "qq_official_webhook",
+    "weixin_official_account",
+    "wecom",
+    "wecom_ai_bot",
+    "slack",
+]
+
 # 默认配置
 DEFAULT_CONFIG = {
    "config_version": 2,
@@ -73,8 +81,14 @@ DEFAULT_CONFIG = {
        "coze_agent_runner_provider_id": "",
        "dashscope_agent_runner_provider_id": "",
        "unsupported_streaming_strategy": "realtime_segmenting",
+        "reachability_check": False,
        "max_agent_step": 30,
        "tool_call_timeout": 60,
+        "file_extract": {
+            "enable": False,
+            "provider": "moonshotai",
+            "moonshotai_api_key": "",
+        },
    },
    "provider_stt_settings": {
        "enable": False,
@@ -90,6 +104,7 @@ DEFAULT_CONFIG = {
        "group_icl_enable": False,
        "group_message_max_cnt": 300,
        "image_caption": False,
+        "image_caption_provider_id": "",
        "active_reply": {
            "enable": False,
            "method": "possibility_reply",
@@ -178,6 +193,8 @@ CONFIG_METADATA_2 = {
                        "appid": "",
                        "secret": "",
                        "is_sandbox": False,
+                        "unified_webhook_mode": True,
+                        "webhook_uuid": "",
                        "callback_server_host": "0.0.0.0",
                        "port": 6196,
                    },
@@ -208,6 +225,8 @@ CONFIG_METADATA_2 = {
                        "token": "",
                        "encoding_aes_key": "",
                        "api_base_url": "https://api.weixin.qq.com/cgi-bin/",
+                        "unified_webhook_mode": True,
+                        "webhook_uuid": "",
                        "callback_server_host": "0.0.0.0",
                        "port": 6194,
                        "active_send_mode": False,
@@ -222,6 +241,8 @@ CONFIG_METADATA_2 = {
                        "encoding_aes_key": "",
                        "kf_name": "",
                        "api_base_url": "https://qyapi.weixin.qq.com/cgi-bin/",
+                        "unified_webhook_mode": True,
+                        "webhook_uuid": "",
                        "callback_server_host": "0.0.0.0",
                        "port": 6195,
                    },
@@ -234,6 +255,8 @@ CONFIG_METADATA_2 = {
                        "wecom_ai_bot_name": "",
                        "token": "",
                        "encoding_aes_key": "",
+                        "unified_webhook_mode": True,
+                        "webhook_uuid": "",
                        "callback_server_host": "0.0.0.0",
                        "port": 6198,
                    },
@@ -301,6 +324,8 @@ CONFIG_METADATA_2 = {
                        "app_token": "",
                        "signing_secret": "",
                        "slack_connection_mode": "socket",  # webhook, socket
+                        "unified_webhook_mode": True,
+                        "webhook_uuid": "",
                        "slack_webhook_host": "0.0.0.0",
                        "slack_webhook_port": 6197,
                        "slack_webhook_path": "/astrbot-slack-webhook/callback",
@@ -380,16 +405,28 @@ CONFIG_METADATA_2 = {
                        "description": "Slack Webhook Host",
                        "type": "string",
                        "hint": "Only valid when Slack connection mode is `webhook`.",
+                        "condition": {
+                            "slack_connection_mode": "webhook",
+                            "unified_webhook_mode": False,
+                        },
                    },
                    "slack_webhook_port": {
                        "description": "Slack Webhook Port",
                        "type": "int",
                        "hint": "Only valid when Slack connection mode is `webhook`.",
+                        "condition": {
+                            "slack_connection_mode": "webhook",
+                            "unified_webhook_mode": False,
+                        },
                    },
                    "slack_webhook_path": {
                        "description": "Slack Webhook Path",
                        "type": "string",
                        "hint": "Only valid when Slack connection mode is `webhook`.",
+                        "condition": {
+                            "slack_connection_mode": "webhook",
+                            "unified_webhook_mode": False,
+                        },
                    },
                    "active_send_mode": {
                        "description": "是否换用主动发送接口",
@@ -580,6 +617,33 @@ CONFIG_METADATA_2 = {
                        "type": "string",
                        "hint": "可选的 Discord 活动名称。留空则不设置活动。",
                    },
+                    "port": {
+                        "description": "回调服务器端口",
+                        "type": "int",
+                        "hint": "回调服务器端口。留空则不启用回调服务器。",
+                        "condition": {
+                            "unified_webhook_mode": False,
+                        },
+                    },
+                    "callback_server_host": {
+                        "description": "回调服务器主机",
+                        "type": "string",
+                        "hint": "回调服务器主机。留空则不启用回调服务器。",
+                        "condition": {
+                            "unified_webhook_mode": False,
+                        },
+                    },
+                    "unified_webhook_mode": {
+                        "description": "统一 Webhook 模式",
+                        "type": "bool",
+                        "hint": "启用后，将使用 AstrBot 统一 Webhook 入口，无需单独开启端口。回调地址为 /api/platform/webhook/{webhook_uuid}。",
+                    },
+                    "webhook_uuid": {
+                        "invisible": True,
+                        "description": "Webhook UUID",
+                        "type": "string",
+                        "hint": "统一 Webhook 模式下的唯一标识符，创建平台时自动生成。",
+                    },
                },
            },
            "platform_settings": {
@@ -2067,6 +2131,20 @@ CONFIG_METADATA_2 = {
                    "tool_call_timeout": {
                        "type": "int",
                    },
+                    "file_extract": {
+                        "type": "object",
+                        "items": {
+                            "enable": {
+                                "type": "bool",
+                            },
+                            "provider": {
+                                "type": "string",
+                            },
+                            "moonshotai_api_key": {
+                                "type": "string",
+                            },
+                        },
+                    },
                },
            },
            "provider_stt_settings": {
@@ -2109,6 +2187,9 @@ CONFIG_METADATA_2 = {
                    "image_caption": {
                        "type": "bool",
                    },
+                    "image_caption_provider_id": {
+                        "type": "string",
+                    },
                    "image_caption_prompt": {
                        "type": "string",
                    },
@@ -2398,6 +2479,36 @@ CONFIG_METADATA_3 = {
                    "provider_settings.enable": True,
                },
            },
+            # "file_extract": {
+            #     "description": "文档解析能力 [beta]",
+            #     "type": "object",
+            #     "items": {
+            #         "provider_settings.file_extract.enable": {
+            #             "description": "启用文档解析能力",
+            #             "type": "bool",
+            #         },
+            #         "provider_settings.file_extract.provider": {
+            #             "description": "文档解析提供商",
+            #             "type": "string",
+            #             "options": ["moonshotai"],
+            #             "condition": {
+            #                 "provider_settings.file_extract.enable": True,
+            #             },
+            #         },
+            #         "provider_settings.file_extract.moonshotai_api_key": {
+            #             "description": "Moonshot AI API Key",
+            #             "type": "string",
+            #             "condition": {
+            #                 "provider_settings.file_extract.provider": "moonshotai",
+            #                 "provider_settings.file_extract.enable": True,
+            #             },
+            #         },
+            #     },
+            #     "condition": {
+            #         "provider_settings.agent_runner_type": "local",
+            #         "provider_settings.enable": True,
+            #     },
+            # },
            "others": {
                "description": "其他配置",
                "type": "object",
@@ -2492,6 +2603,11 @@ CONFIG_METADATA_3 = {
                        "description": "开启 TTS 时同时输出语音和文字内容",
                        "type": "bool",
                    },
+                    "provider_settings.reachability_check": {
+                        "description": "提供商可达性检测",
+                        "type": "bool",
+                        "hint": "/provider 命令列出模型时是否并发检测连通性。开启后会主动调用模型测试连通性，可能产生额外 token 消耗。",
+                    },
                },
                "condition": {
                    "provider_settings.enable": True,
@@ -2785,7 +2901,16 @@ CONFIG_METADATA_3 = {
                    "provider_ltm_settings.image_caption": {
                        "description": "自动理解图片",
                        "type": "bool",
-                        "hint": "需要设置默认图片转述模型。",
+                        "hint": "需要设置群聊图片转述模型。",
+                    },
+                    "provider_ltm_settings.image_caption_provider_id": {
+                        "description": "群聊图片转述模型",
+                        "type": "string",
+                        "_special": "select_provider",
+                        "hint": "用于群聊上下文感知的图片理解，与默认图片转述模型分开配置。",
+                        "condition": {
+                            "provider_ltm_settings.image_caption": True,
+                        },
                    },
                    "provider_ltm_settings.active_reply.enable": {
                        "description": "主动回复",
@@ -173,7 +173,7 @@ class BaseDatabase(abc.ABC):
        content: dict,
        sender_id: str | None = None,
        sender_name: str | None = None,
-    ) -> None:
+    ) -> PlatformMessageHistory:
        """Insert a new platform message history record."""
        ...

@@ -198,6 +198,14 @@ class BaseDatabase(abc.ABC):
        """Get platform message history for a specific user."""
        ...

+    @abc.abstractmethod
+    async def get_platform_message_history_by_id(
+        self,
+        message_id: int,
+    ) -> PlatformMessageHistory | None:
+        """Get a platform message history record by its ID."""
+        ...
+
    @abc.abstractmethod
    async def insert_attachment(
        self,
@@ -213,6 +221,27 @@ class BaseDatabase(abc.ABC):
        """Get an attachment by its ID."""
        ...

+    @abc.abstractmethod
+    async def get_attachments(self, attachment_ids: list[str]) -> list[Attachment]:
+        """Get multiple attachments by their IDs."""
+        ...
+
+    @abc.abstractmethod
+    async def delete_attachment(self, attachment_id: str) -> bool:
+        """Delete an attachment by its ID.
+
+        Returns True if the attachment was deleted, False if it was not found.
+        """
+        ...
+
+    @abc.abstractmethod
+    async def delete_attachments(self, attachment_ids: list[str]) -> int:
+        """Delete multiple attachments by their IDs.
+
+        Returns the number of attachments deleted.
+        """
+        ...
+
    @abc.abstractmethod
    async def insert_persona(
        self,
@@ -105,8 +105,8 @@ class SQLiteDatabase(BaseDatabase):
                text("""
                SELECT * FROM platform_stats
                WHERE timestamp >= :start_time
-                ORDER BY timestamp DESC
                GROUP BY platform_id
+                ORDER BY timestamp DESC
                """),
                {"start_time": start_time},
            )
@@ -449,6 +449,18 @@ class SQLiteDatabase(BaseDatabase):
            result = await session.execute(query.offset(offset).limit(page_size))
            return result.scalars().all()

+    async def get_platform_message_history_by_id(
+        self, message_id: int
+    ) -> PlatformMessageHistory | None:
+        """Get a platform message history record by its ID."""
+        async with self.get_db() as session:
+            session: AsyncSession
+            query = select(PlatformMessageHistory).where(
+                PlatformMessageHistory.id == message_id
+            )
+            result = await session.execute(query)
+            return result.scalar_one_or_none()
+
    async def insert_attachment(self, path, type, mime_type):
        """Insert a new attachment record."""
        async with self.get_db() as session:
@@ -470,6 +482,48 @@ class SQLiteDatabase(BaseDatabase):
            result = await session.execute(query)
            return result.scalar_one_or_none()

+    async def get_attachments(self, attachment_ids: list[str]) -> list:
+        """Get multiple attachments by their IDs."""
+        if not attachment_ids:
+            return []
+        async with self.get_db() as session:
+            session: AsyncSession
+            query = select(Attachment).where(
+                Attachment.attachment_id.in_(attachment_ids)
+            )
+            result = await session.execute(query)
+            return list(result.scalars().all())
+
+    async def delete_attachment(self, attachment_id: str) -> bool:
+        """Delete an attachment by its ID.
+
+        Returns True if the attachment was deleted, False if it was not found.
+        """
+        async with self.get_db() as session:
+            session: AsyncSession
+            async with session.begin():
+                query = delete(Attachment).where(
+                    col(Attachment.attachment_id) == attachment_id
+                )
+                result = await session.execute(query)
+                return result.rowcount > 0
+
+    async def delete_attachments(self, attachment_ids: list[str]) -> int:
+        """Delete multiple attachments by their IDs.
+
+        Returns the number of attachments deleted.
+        """
+        if not attachment_ids:
+            return 0
+        async with self.get_db() as session:
+            session: AsyncSession
+            async with session.begin():
+                query = delete(Attachment).where(
+                    col(Attachment.attachment_id).in_(attachment_ids)
+                )
+                result = await session.execute(query)
+                return result.rowcount
+
    async def insert_persona(
        self,
        persona_id,
@@ -722,7 +722,12 @@ class File(BaseMessageComponent):
        """下载文件"""
        download_dir = os.path.join(get_astrbot_data_path(), "temp")
        os.makedirs(download_dir, exist_ok=True)
-        file_path = os.path.join(download_dir, f"{uuid.uuid4().hex}")
+        if self.name:
+            name, ext = os.path.splitext(self.name)
+            filename = f"{name}_{uuid.uuid4().hex[:8]}{ext}"
+        else:
+            filename = f"{uuid.uuid4().hex}"
+        file_path = os.path.join(download_dir, filename)
        await download_file(self.url, file_path)
        self.file_ = os.path.abspath(file_path)

@@ -9,7 +9,7 @@ from astrbot.core import logger
 from astrbot.core.agent.tool import ToolSet
 from astrbot.core.astr_agent_context import AstrAgentContext
 from astrbot.core.conversation_mgr import Conversation
-from astrbot.core.message.components import Image
+from astrbot.core.message.components import File, Image, Reply
 from astrbot.core.message.message_event_result import (
    MessageChain,
    MessageEventResult,
@@ -22,6 +22,7 @@ from astrbot.core.provider.entities import (
    ProviderRequest,
 )
 from astrbot.core.star.star_handler import EventType, star_map
+from astrbot.core.utils.file_extract import extract_file_moonshotai
 from astrbot.core.utils.metrics import Metric
 from astrbot.core.utils.session_lock import session_lock_manager

@@ -56,6 +57,13 @@ class InternalAgentSubStage(Stage):
        self.show_reasoning = settings.get("display_reasoning_text", False)
        self.kb_agentic_mode: bool = conf.get("kb_agentic_mode", False)

+        file_extract_conf: dict = settings.get("file_extract", {})
+        self.file_extract_enabled: bool = file_extract_conf.get("enable", False)
+        self.file_extract_prov: str = file_extract_conf.get("provider", "moonshotai")
+        self.file_extract_msh_api_key: str = file_extract_conf.get(
+            "moonshotai_api_key", ""
+        )
+
        self.conv_manager = ctx.plugin_manager.context.conversation_manager

    def _select_provider(self, event: AstrMessageEvent):
@@ -114,6 +122,50 @@ class InternalAgentSubStage(Stage):
                req.func_tool = ToolSet()
            req.func_tool.add_tool(KNOWLEDGE_BASE_QUERY_TOOL)

+    async def _apply_file_extract(
+        self,
+        event: AstrMessageEvent,
+        req: ProviderRequest,
+    ):
+        """Apply file extract to the provider request"""
+        file_paths = []
+        file_names = []
+        for comp in event.message_obj.message:
+            if isinstance(comp, File):
+                file_paths.append(await comp.get_file())
+                file_names.append(comp.name)
+            elif isinstance(comp, Reply) and comp.chain:
+                for reply_comp in comp.chain:
+                    if isinstance(reply_comp, File):
+                        file_paths.append(await reply_comp.get_file())
+                        file_names.append(reply_comp.name)
+        if not file_paths:
+            return
+        if not req.prompt:
+            req.prompt = "总结一下文件里面讲了什么？"
+        if self.file_extract_prov == "moonshotai":
+            if not self.file_extract_msh_api_key:
+                logger.error("Moonshot AI API key for file extract is not set")
+                return
+            file_contents = await asyncio.gather(
+                *[
+                    extract_file_moonshotai(file_path, self.file_extract_msh_api_key)
+                    for file_path in file_paths
+                ]
+            )
+        else:
+            logger.error(f"Unsupported file extract provider: {self.file_extract_prov}")
+            return
+
+        # add file extract results to contexts
+        for file_content, file_name in zip(file_contents, file_names):
+            req.contexts.append(
+                {
+                    "role": "system",
+                    "content": f"File Extract Results of user uploaded files:\n{file_content}\nFile Name: {file_name or 'Unknown'}",
+                },
+            )
+
    def _truncate_contexts(
        self,
        contexts: list[dict],
@@ -346,6 +398,17 @@ class InternalAgentSubStage(Stage):

                event.set_extra("provider_request", req)

+            # fix contexts json str
+            if isinstance(req.contexts, str):
+                req.contexts = json.loads(req.contexts)
+
+            # apply file extract
+            if self.file_extract_enabled:
+                try:
+                    await self._apply_file_extract(event, req)
+                except Exception as e:
+                    logger.error(f"Error occurred while applying file extract: {e}")
+
            if not req.prompt and not req.image_urls:
                return

@@ -356,10 +419,6 @@ class InternalAgentSubStage(Stage):
            # apply knowledge base feature
            await self._apply_kb(event, req)

-            # fix contexts json str
-            if isinstance(req.contexts, str):
-                req.contexts = json.loads(req.contexts)
-
            # truncate contexts to fit max length
            if req.contexts:
                req.contexts = self._truncate_contexts(req.contexts)
@@ -2,7 +2,7 @@ import asyncio
 from collections.abc import AsyncGenerator
 from typing import TYPE_CHECKING

-from astrbot.core import logger
+from astrbot.core import astrbot_config, logger
 from astrbot.core.agent.runners.coze.coze_agent_runner import CozeAgentRunner
 from astrbot.core.agent.runners.dashscope.dashscope_agent_runner import (
    DashscopeAgentRunner,
@@ -57,7 +57,7 @@ async def run_third_party_agent(
        logger.error(f"Third party agent runner error: {e}")
        err_msg = (
            f"\nAstrBot 请求失败。\n错误类型: {type(e).__name__}\n"
-            f"错误信息: {e!s}\n\n请在控制台查看和分享错误详情。\n"
+            f"错误信息: {e!s}\n\n请在平台日志查看和分享错误详情。\n"
        )
        yield MessageChain().message(err_msg)

@@ -88,12 +88,15 @@ class ThirdPartyAgentSubStage(Stage):
            return

        self.prov_cfg: dict = next(
-            (p for p in self.conf["provider"] if p["id"] == self.prov_id),
+            (p for p in astrbot_config["provider"] if p["id"] == self.prov_id),
            {},
        )
-        if not self.prov_id or not self.prov_cfg:
+        if not self.prov_id:
+            logger.error("没有填写 Agent Runner 提供商 ID，请前往配置页面配置。")
+            return
+        if not self.prov_cfg:
            logger.error(
-                "Third Party Agent Runner provider ID is not configured properly."
+                f"Agent Runner 提供商 {self.prov_id} 配置不存在，请前往配置页面修改配置。"
            )
            return

@@ -1,6 +1,5 @@
 from collections.abc import AsyncGenerator

-from astrbot.core import logger
 from astrbot.core.platform.astr_message_event import AstrMessageEvent
 from astrbot.core.provider.entities import ProviderRequest
 from astrbot.core.star.star_handler import StarHandlerMetadata
@@ -63,12 +62,5 @@ class ProcessStage(Stage):
            if (
                event.get_result() and not event.get_result().is_stopped()
            ) or not event.get_result():
-                # 事件没有终止传播
-                provider = self.ctx.plugin_manager.context.get_using_provider()
-
-                if not provider:
-                    logger.info("未找到可用的 LLM 提供商，请先前往配置服务提供商。")
-                    return
-
                async for _ in self.agent_sub_stage.process(event):
                    yield
@@ -6,7 +6,7 @@ from astrbot.core import logger
 from astrbot.core.config.astrbot_config import AstrBotConfig
 from astrbot.core.star.star_handler import EventType, star_handlers_registry, star_map

-from .platform import Platform
+from .platform import Platform, PlatformStatus
 from .register import platform_cls_map
 from .sources.webchat.webchat_adapter import WebChatAdapter

@@ -16,7 +16,7 @@ class PlatformManager:
        self.platform_insts: list[Platform] = []
        """加载的 Platform 的实例"""

-        self._inst_map = {}
+        self._inst_map: dict[str, dict] = {}

        self.platforms_config = config["platform"]
        self.settings = config["platform_settings"]
@@ -37,7 +37,10 @@ class PlatformManager:
        webchat_inst = WebChatAdapter({}, self.settings, self.event_queue)
        self.platform_insts.append(webchat_inst)
        asyncio.create_task(
-            self._task_wrapper(asyncio.create_task(webchat_inst.run(), name="webchat")),
+            self._task_wrapper(
+                asyncio.create_task(webchat_inst.run(), name="webchat"),
+                platform=webchat_inst,
+            ),
        )

    async def load_platform(self, platform_config: dict):
@@ -107,7 +110,7 @@ class PlatformManager:
                    )
        except (ImportError, ModuleNotFoundError) as e:
            logger.error(
-                f"加载平台适配器 {platform_config['type']} 失败，原因：{e}。请检查依赖库是否安装。提示：可以在 管理面板->控制台->安装Pip库 中安装依赖库。",
+                f"加载平台适配器 {platform_config['type']} 失败，原因：{e}。请检查依赖库是否安装。提示：可以在 管理面板->平台日志->安装Pip库 中安装依赖库。",
            )
        except Exception as e:
            logger.error(f"加载平台适配器 {platform_config['type']} 失败，原因：{e}。")
@@ -131,6 +134,7 @@ class PlatformManager:
                    inst.run(),
                    name=f"platform_{platform_config['type']}_{platform_config['id']}",
                ),
+                platform=inst,
            ),
        )
        handlers = star_handlers_registry.get_handlers_by_event_type(
@@ -145,17 +149,28 @@ class PlatformManager:
            except Exception:
                logger.error(traceback.format_exc())

-    async def _task_wrapper(self, task: asyncio.Task):
+    async def _task_wrapper(self, task: asyncio.Task, platform: Platform | None = None):
+        # 设置平台状态为运行中
+        if platform:
+            platform.status = PlatformStatus.RUNNING
+
        try:
            await task
        except asyncio.CancelledError:
-            pass
+            if platform:
+                platform.status = PlatformStatus.STOPPED
        except Exception as e:
+            error_msg = str(e)
+            tb_str = traceback.format_exc()
            logger.error(f"------- 任务 {task.get_name()} 发生错误: {e}")
-            for line in traceback.format_exc().split("\n"):
+            for line in tb_str.split("\n"):
                logger.error(f"|    {line}")
            logger.error("-------")

+            # 记录错误到平台实例
+            if platform:
+                platform.record_error(error_msg, tb_str)
+
    async def reload(self, platform_config: dict):
        await self.terminate_platform(platform_config["id"])
        if platform_config["enable"]:
@@ -172,9 +187,9 @@ class PlatformManager:
            logger.info(f"正在尝试终止 {platform_id} 平台适配器 ...")

            # client_id = self._inst_map.pop(platform_id, None)
-            info = self._inst_map.pop(platform_id, None)
+            info = self._inst_map.pop(platform_id)
            client_id = info["client_id"]
-            inst = info["inst"]
+            inst: Platform = info["inst"]
            try:
                self.platform_insts.remove(
                    next(
@@ -196,3 +211,46 @@ class PlatformManager:

    def get_insts(self):
        return self.platform_insts
+
+    def get_all_stats(self) -> dict:
+        """获取所有平台的统计信息
+
+        Returns:
+            包含所有平台统计信息的字典
+        """
+        stats_list = []
+        total_errors = 0
+        running_count = 0
+        error_count = 0
+
+        for inst in self.platform_insts:
+            try:
+                stat = inst.get_stats()
+                stats_list.append(stat)
+                total_errors += stat.get("error_count", 0)
+                if stat.get("status") == PlatformStatus.RUNNING.value:
+                    running_count += 1
+                elif stat.get("status") == PlatformStatus.ERROR.value:
+                    error_count += 1
+            except Exception as e:
+                # 如果获取统计信息失败，记录基本信息
+                logger.warning(f"获取平台统计信息失败: {e}")
+                stats_list.append(
+                    {
+                        "id": getattr(inst, "config", {}).get("id", "unknown"),
+                        "type": "unknown",
+                        "status": "unknown",
+                        "error_count": 0,
+                        "last_error": None,
+                    }
+                )
+
+        return {
+            "platforms": stats_list,
+            "summary": {
+                "total": len(stats_list),
+                "running": running_count,
+                "error": error_count,
+                "total_errors": total_errors,
+            },
+        }
@@ -2,6 +2,9 @@ import abc
 import uuid
 from asyncio import Queue
 from collections.abc import Awaitable
+from dataclasses import dataclass, field
+from datetime import datetime
+from enum import Enum
 from typing import Any

 from astrbot.core.message.message_event_result import MessageChain
@@ -12,13 +15,90 @@ from .message_session import MessageSesion
 from .platform_metadata import PlatformMetadata


+class PlatformStatus(Enum):
+    """平台运行状态"""
+
+    PENDING = "pending"  # 待启动
+    RUNNING = "running"  # 运行中
+    ERROR = "error"  # 发生错误
+    STOPPED = "stopped"  # 已停止
+
+
+@dataclass
+class PlatformError:
+    """平台错误信息"""
+
+    message: str
+    timestamp: datetime = field(default_factory=datetime.now)
+    traceback: str | None = None
+
+
 class Platform(abc.ABC):
-    def __init__(self, event_queue: Queue):
+    def __init__(self, config: dict, event_queue: Queue):
        super().__init__()
+        # 平台配置
+        self.config = config
        # 维护了消息平台的事件队列，EventBus 会从这里取出事件并处理。
        self._event_queue = event_queue
        self.client_self_id = uuid.uuid4().hex

+        # 平台运行状态
+        self._status: PlatformStatus = PlatformStatus.PENDING
+        self._errors: list[PlatformError] = []
+        self._started_at: datetime | None = None
+
+    @property
+    def status(self) -> PlatformStatus:
+        """获取平台运行状态"""
+        return self._status
+
+    @status.setter
+    def status(self, value: PlatformStatus):
+        """设置平台运行状态"""
+        self._status = value
+        if value == PlatformStatus.RUNNING and self._started_at is None:
+            self._started_at = datetime.now()
+
+    @property
+    def errors(self) -> list[PlatformError]:
+        """获取错误列表"""
+        return self._errors
+
+    @property
+    def last_error(self) -> PlatformError | None:
+        """获取最近的错误"""
+        return self._errors[-1] if self._errors else None
+
+    def record_error(self, message: str, traceback_str: str | None = None):
+        """记录一个错误"""
+        self._errors.append(PlatformError(message=message, traceback=traceback_str))
+        self._status = PlatformStatus.ERROR
+
+    def clear_errors(self):
+        """清除错误记录"""
+        self._errors.clear()
+        if self._status == PlatformStatus.ERROR:
+            self._status = PlatformStatus.RUNNING
+
+    def get_stats(self) -> dict:
+        """获取平台统计信息"""
+        meta = self.meta()
+        return {
+            "id": meta.id or self.config.get("id"),
+            "type": meta.name,
+            "display_name": meta.adapter_display_name or meta.name,
+            "status": self._status.value,
+            "started_at": self._started_at.isoformat() if self._started_at else None,
+            "error_count": len(self._errors),
+            "last_error": {
+                "message": self.last_error.message,
+                "timestamp": self.last_error.timestamp.isoformat(),
+                "traceback": self.last_error.traceback,
+            }
+            if self.last_error
+            else None,
+        }
+
    @abc.abstractmethod
    def run(self) -> Awaitable[Any]:
        """得到一个平台的运行实例，需要返回一个协程对象。"""
@@ -36,7 +116,7 @@ class Platform(abc.ABC):
        self,
        session: MessageSesion,
        message_chain: MessageChain,
-    ) -> Awaitable[Any]:
+    ):
        """通过会话发送消息。该方法旨在让插件能够直接通过**可持久化的会话数据**发送消息，而不需要保存 event 对象。

        异步方法。
@@ -49,3 +129,20 @@ class Platform(abc.ABC):

    def get_client(self):
        """获取平台的客户端对象。"""
+
+    async def webhook_callback(self, request: Any) -> Any:
+        """统一 Webhook 回调入口。
+
+        支持统一 Webhook 模式的平台需要实现此方法。
+        当 Dashboard 收到 /api/platform/webhook/{uuid} 请求时，会调用此方法。
+
+        Args:
+            request: Quart 请求对象
+
+        Returns:
+            响应内容，格式取决于具体平台的要求
+
+        Raises:
+            NotImplementedError: 平台未实现统一 Webhook 模式
+        """
+        raise NotImplementedError(f"平台 {self.meta().name} 未实现统一 Webhook 模式")
@@ -38,9 +38,8 @@ class AiocqhttpAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
+        super().__init__(platform_config, event_queue)

-        self.config = platform_config
        self.settings = platform_settings
        self.unique_session = platform_settings["unique_session"]
        self.host = platform_config["ws_reverse_host"]
@@ -154,7 +153,9 @@ class AiocqhttpAdapter(Platform):
        """OneBot V11 通知类事件"""
        abm = AstrBotMessage()
        abm.self_id = str(event.self_id)
-        abm.sender = MessageMember(user_id=str(event.user_id), nickname=event.user_id)
+        abm.sender = MessageMember(
+            user_id=str(event.user_id), nickname=str(event.user_id)
+        )
        abm.type = MessageType.OTHER_MESSAGE
        if event.get("group_id"):
            abm.group_id = str(event.group_id)
@@ -246,7 +247,13 @@ class AiocqhttpAdapter(Platform):
                    if m["data"].get("url") and m["data"].get("url").startswith("http"):
                        # Lagrange
                        logger.info("guessing lagrange")
-                        file_name = m["data"].get("file_name", "file")
+                        # 检查多个可能的文件名字段
+                        file_name = (
+                            m["data"].get("file_name", "")
+                            or m["data"].get("name", "")
+                            or m["data"].get("file", "")
+                            or "file"
+                        )
                        abm.message.append(File(name=file_name, url=m["data"]["url"]))
                    else:
                        try:
@@ -265,7 +272,14 @@ class AiocqhttpAdapter(Platform):
                                )
                            if ret and "url" in ret:
                                file_url = ret["url"]  # https
-                                a = File(name="", url=file_url)
+                                # 优先从 API 返回值获取文件名，其次从原始消息数据获取
+                                file_name = (
+                                    ret.get("file_name", "")
+                                    or ret.get("name", "")
+                                    or m["data"].get("file", "")
+                                    or m["data"].get("file_name", "")
+                                )
+                                a = File(name=file_name, url=file_url)
                                abm.message.append(a)
                            else:
                                logger.error(f"获取文件失败: {ret}")
@@ -47,9 +47,7 @@ class DingtalkPlatformAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)

        self.unique_session = platform_settings["unique_session"]

@@ -76,13 +74,13 @@ class DingtalkPlatformAdapter(Platform):
        )
        self.client_ = client  # 用于 websockets 的 client

-    def _id_to_sid(self, dingtalk_id: str | None) -> str | None:
+    def _id_to_sid(self, dingtalk_id: str | None) -> str:
        if not dingtalk_id:
-            return dingtalk_id
+            return dingtalk_id or "unknown"
        prefix = "$:LWCP_v1:$"
        if dingtalk_id.startswith(prefix):
            return dingtalk_id[len(prefix) :]
-        return dingtalk_id
+        return dingtalk_id or "unknown"

    async def send_by_session(
        self,
@@ -250,7 +248,7 @@ class DingtalkPlatformAdapter(Platform):

    async def terminate(self):
        def monkey_patch_close():
-            raise Exception("Graceful shutdown")
+            raise KeyboardInterrupt("Graceful shutdown")

        self.client_.open_connection = monkey_patch_close
        await self.client_.websocket.close(code=1000, reason="Graceful shutdown")
@@ -44,8 +44,7 @@ class DiscordPlatformAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)
        self.settings = platform_settings
        self.client_self_id = None
        self.registered_handlers = []
@@ -33,9 +33,7 @@ class LarkPlatformAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)

        self.unique_session = platform_settings["unique_session"]

@@ -55,8 +55,7 @@ class MisskeyPlatformAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-        self.config = platform_config or {}
+        super().__init__(platform_config or {}, event_queue)
        self.settings = platform_settings or {}
        self.instance_url = self.config.get("misskey_instance_url", "")
        self.access_token = self.config.get("misskey_token", "")
@@ -69,6 +69,8 @@ class QQOfficialMessageEvent(AstrMessageEvent):
                # 结束流式对话，并且传输 buffer 中剩余的消息
                stream_payload["state"] = 10
                ret = await self._post_send(stream=stream_payload)
+            else:
+                ret = await self._post_send()

        except Exception as e:
            logger.error(f"发送流式消息时出错: {e}", exc_info=True)
@@ -97,9 +97,7 @@ class QQOfficialPlatformAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)

        self.appid = platform_config["appid"]
        self.secret = platform_config["secret"]
@@ -1,5 +1,6 @@
 import asyncio
 import logging
+from typing import Any

 import botpy
 import botpy.message
@@ -11,6 +12,7 @@ from astrbot import logger
 from astrbot.api.event import MessageChain
 from astrbot.api.platform import AstrBotMessage, MessageType, Platform, PlatformMetadata
 from astrbot.core.platform.astr_message_event import MessageSesion
+from astrbot.core.utils.webhook_utils import log_webhook_info

 from ...register import register_platform_adapter
 from ..qqofficial.qqofficial_platform_adapter import QQOfficialPlatformAdapter
@@ -87,13 +89,12 @@ class QQOfficialWebhookPlatformAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)

        self.appid = platform_config["appid"]
        self.secret = platform_config["secret"]
        self.unique_session = platform_settings["unique_session"]
+        self.unified_webhook_mode = platform_config.get("unified_webhook_mode", False)

        intents = botpy.Intents(
            public_messages=True,
@@ -106,6 +107,7 @@ class QQOfficialWebhookPlatformAdapter(Platform):
            timeout=20,
        )
        self.client.set_platform(self)
+        self.webhook_helper = None

    async def send_by_session(
        self,
@@ -128,16 +130,37 @@ class QQOfficialWebhookPlatformAdapter(Platform):
            self.client,
        )
        await self.webhook_helper.initialize()
-        await self.webhook_helper.start_polling()
+
+        # 如果启用统一 webhook 模式，则不启动独立服务器
+        webhook_uuid = self.config.get("webhook_uuid")
+        if self.unified_webhook_mode and webhook_uuid:
+            log_webhook_info(f"{self.meta().id}(QQ 官方机器人 Webhook)", webhook_uuid)
+            # 保持运行状态，等待 shutdown
+            await self.webhook_helper.shutdown_event.wait()
+        else:
+            await self.webhook_helper.start_polling()

    def get_client(self) -> botClient:
        return self.client

+    async def webhook_callback(self, request: Any) -> Any:
+        """统一 Webhook 回调入口"""
+        if not self.webhook_helper:
+            return {"error": "Webhook helper not initialized"}, 500
+
+        # 复用 webhook_helper 的回调处理逻辑
+        return await self.webhook_helper.handle_callback(request)
+
    async def terminate(self):
-        self.webhook_helper.shutdown_event.set()
+        if self.webhook_helper:
+            self.webhook_helper.shutdown_event.set()
        await self.client.close()
-        try:
-            await self.webhook_helper.server.shutdown()
-        except Exception as _:
-            pass
+        if self.webhook_helper and not self.unified_webhook_mode:
+            try:
+                await self.webhook_helper.server.shutdown()
+            except Exception as exc:
+                logger.warning(
+                    f"Exception occurred during QQOfficialWebhook server shutdown: {exc}",
+                    exc_info=True,
+                )
        logger.info("QQ 机器人官方 API 适配器已经被优雅地关闭")
@@ -78,7 +78,19 @@ class QQOfficialWebhook:
        return response

    async def callback(self):
-        msg: dict = await quart.request.json
+        """内部服务器的回调入口"""
+        return await self.handle_callback(quart.request)
+
+    async def handle_callback(self, request) -> dict:
+        """处理 webhook 回调，可被统一 webhook 入口复用
+
+        Args:
+            request: Quart 请求对象
+
+        Returns:
+            响应数据
+        """
+        msg: dict = await request.json
        logger.debug(f"收到 qq_official_webhook 回调: {msg}")

        event = msg.get("t")
@@ -38,8 +38,7 @@ class SatoriPlatformAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)
        self.settings = platform_settings

        self.api_base_url = self.config.get(
@@ -47,51 +47,62 @@ class SlackWebhookClient:

        @self.app.route(self.path, methods=["POST"])
        async def slack_events():
-            """处理 Slack 事件"""
-            try:
-                # 获取请求体和头部
-                body = await request.get_data()
-                event_data = json.loads(body.decode("utf-8"))
-
-                # Verify Slack request signature
-                timestamp = request.headers.get("X-Slack-Request-Timestamp")
-                signature = request.headers.get("X-Slack-Signature")
-                if not timestamp or not signature:
-                    return Response("Missing headers", status=400)
-                # Calculate the HMAC signature
-                sig_basestring = f"v0:{timestamp}:{body.decode('utf-8')}"
-                my_signature = (
-                    "v0="
-                    + hmac.new(
-                        self.signing_secret.encode("utf-8"),
-                        sig_basestring.encode("utf-8"),
-                        hashlib.sha256,
-                    ).hexdigest()
-                )
-                # Verify the signature
-                if not hmac.compare_digest(my_signature, signature):
-                    logger.warning("Slack request signature verification failed")
-                    return Response("Invalid signature", status=400)
-                logger.info(f"Received Slack event: {event_data}")
-
-                # 处理 URL 验证事件
-                if event_data.get("type") == "url_verification":
-                    return {"challenge": event_data.get("challenge")}
-                # 处理事件
-                if self.event_handler and event_data.get("type") == "event_callback":
-                    await self.event_handler(event_data)
-
-                return Response("", status=200)
-
-            except Exception as e:
-                logger.error(f"处理 Slack 事件时出错: {e}")
-                return Response("Internal Server Error", status=500)
+            """内部服务器的 POST 回调入口"""
+            return await self.handle_callback(request)

        @self.app.route("/health", methods=["GET"])
        async def health_check():
            """健康检查端点"""
            return {"status": "ok", "service": "slack-webhook"}

+    async def handle_callback(self, req):
+        """处理 Slack 回调请求，可被统一 webhook 入口复用
+
+        Args:
+            req: Quart 请求对象
+
+        Returns:
+            Response 对象或字典
+        """
+        try:
+            # 获取请求体和头部
+            body = await req.get_data()
+            event_data = json.loads(body.decode("utf-8"))
+
+            # Verify Slack request signature
+            timestamp = req.headers.get("X-Slack-Request-Timestamp")
+            signature = req.headers.get("X-Slack-Signature")
+            if not timestamp or not signature:
+                return Response("Missing headers", status=400)
+            # Calculate the HMAC signature
+            sig_basestring = f"v0:{timestamp}:{body.decode('utf-8')}"
+            my_signature = (
+                "v0="
+                + hmac.new(
+                    self.signing_secret.encode("utf-8"),
+                    sig_basestring.encode("utf-8"),
+                    hashlib.sha256,
+                ).hexdigest()
+            )
+            # Verify the signature
+            if not hmac.compare_digest(my_signature, signature):
+                logger.warning("Slack request signature verification failed")
+                return Response("Invalid signature", status=400)
+            logger.info(f"Received Slack event: {event_data}")
+
+            # 处理 URL 验证事件
+            if event_data.get("type") == "url_verification":
+                return {"challenge": event_data.get("challenge")}
+            # 处理事件
+            if self.event_handler and event_data.get("type") == "event_callback":
+                await self.event_handler(event_data)
+
+            return Response("", status=200)
+
+        except Exception as e:
+            logger.error(f"处理 Slack 事件时出错: {e}")
+            return Response("Internal Server Error", status=500)
+
    async def start(self):
        """启动 Webhook 服务器"""
        logger.info(
@@ -21,6 +21,7 @@ from astrbot.api.platform import (
    PlatformMetadata,
 )
 from astrbot.core.platform.astr_message_event import MessageSesion
+from astrbot.core.utils.webhook_utils import log_webhook_info

 from ...register import register_platform_adapter
 from .client import SlackSocketClient, SlackWebhookClient
@@ -39,9 +40,7 @@ class SlackAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)
        self.settings = platform_settings
        self.unique_session = platform_settings.get("unique_session", False)

@@ -49,6 +48,7 @@ class SlackAdapter(Platform):
        self.app_token = platform_config.get("app_token")
        self.signing_secret = platform_config.get("signing_secret")
        self.connection_mode = platform_config.get("slack_connection_mode", "socket")
+        self.unified_webhook_mode = platform_config.get("unified_webhook_mode", False)
        self.webhook_host = platform_config.get("slack_webhook_host", "0.0.0.0")
        self.webhook_port = platform_config.get("slack_webhook_port", 3000)
        self.webhook_path = platform_config.get(
@@ -361,10 +361,17 @@ class SlackAdapter(Platform):
                self._handle_webhook_event,
            )

-            logger.info(
-                f"Slack 适配器 (Webhook Mode) 启动中，监听 {self.webhook_host}:{self.webhook_port}{self.webhook_path}...",
-            )
-            await self.webhook_client.start()
+            # 如果启用统一 webhook 模式，则不启动独立服务器
+            webhook_uuid = self.config.get("webhook_uuid")
+            if self.unified_webhook_mode and webhook_uuid:
+                log_webhook_info(f"{self.meta().id}(Slack)", webhook_uuid)
+                # 保持运行状态，等待 shutdown
+                await self.webhook_client.shutdown_event.wait()
+            else:
+                logger.info(
+                    f"Slack 适配器 (Webhook Mode) 启动中，监听 {self.webhook_host}:{self.webhook_port}{self.webhook_path}...",
+                )
+                await self.webhook_client.start()

        else:
            raise ValueError(
@@ -391,6 +398,13 @@ class SlackAdapter(Platform):
            if abm:
                await self.handle_msg(abm)

+    async def webhook_callback(self, request: Any) -> Any:
+        """统一 Webhook 回调入口"""
+        if self.connection_mode != "webhook" or not self.webhook_client:
+            return {"error": "Slack adapter is not in webhook mode"}, 400
+
+        return await self.webhook_client.handle_callback(request)
+
    async def terminate(self):
        if self.socket_client:
            await self.socket_client.stop()
@@ -31,7 +31,7 @@ class SlackMessageEvent(AstrMessageEvent):
    async def _from_segment_to_slack_block(
        segment: BaseMessageComponent,
        web_client: AsyncWebClient,
-    ) -> dict:
+    ) -> dict | None:
        """将消息段转换为 Slack 块格式"""
        if isinstance(segment, Plain):
            return {"type": "section", "text": {"type": "mrkdwn", "text": segment.text}}
@@ -85,7 +85,6 @@ class SlackMessageEvent(AstrMessageEvent):
                    "text": f"文件: <{file_url}|{segment.name or '文件'}>",
                },
            }
-        return {"type": "section", "text": {"type": "mrkdwn", "text": str(segment)}}

    @staticmethod
    async def _parse_slack_blocks(
@@ -115,7 +114,8 @@ class SlackMessageEvent(AstrMessageEvent):
                    segment,
                    web_client,
                )
-                blocks.append(block)
+                if block:
+                    blocks.append(block)

        # 如果最后还有文本内容
        if text_content.strip():
@@ -42,8 +42,7 @@ class TelegramPlatformAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)
        self.settings = platform_settings
        self.client_self_id = uuid.uuid4().hex[:8]

@@ -381,7 +380,9 @@ class TelegramPlatformAdapter(Platform):
                    f"Telegram document file_path is None, cannot save the file {file_name}.",
                )
            else:
-                message.message.append(Comp.File(file=file_path, name=file_name))
+                message.message.append(
+                    Comp.File(file=file_path, name=file_name, url=file_path)
+                )

        elif update.message.video:
            file = await update.message.video.get_file()
@@ -6,7 +6,9 @@ from collections.abc import Awaitable, Callable
 from typing import Any

 from astrbot import logger
-from astrbot.core.message.components import Image, Plain, Record
+from astrbot.core import db_helper
+from astrbot.core.db.po import PlatformMessageHistory
+from astrbot.core.message.components import File, Image, Plain, Record, Reply, Video
 from astrbot.core.message.message_event_result import MessageChain
 from astrbot.core.platform import (
    AstrBotMessage,
@@ -74,9 +76,8 @@ class WebChatAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
+        super().__init__(platform_config, event_queue)

-        self.config = platform_config
        self.settings = platform_settings
        self.unique_session = platform_settings["unique_session"]
        self.imgs_dir = os.path.join(get_astrbot_data_path(), "webchat", "imgs")
@@ -96,6 +97,92 @@ class WebChatAdapter(Platform):
        await WebChatMessageEvent._send(message_chain, session.session_id)
        await super().send_by_session(session, message_chain)

+    async def _get_message_history(
+        self, message_id: int
+    ) -> PlatformMessageHistory | None:
+        return await db_helper.get_platform_message_history_by_id(message_id)
+
+    async def _parse_message_parts(
+        self,
+        message_parts: list,
+        depth: int = 0,
+        max_depth: int = 1,
+    ) -> tuple[list, list[str]]:
+        """解析消息段列表，返回消息组件列表和纯文本列表
+
+        Args:
+            message_parts: 消息段列表
+            depth: 当前递归深度
+            max_depth: 最大递归深度（用于处理 reply）
+
+        Returns:
+            tuple[list, list[str]]: (消息组件列表, 纯文本列表)
+        """
+        components = []
+        text_parts = []
+
+        for part in message_parts:
+            part_type = part.get("type")
+            if part_type == "plain":
+                text = part.get("text", "")
+                components.append(Plain(text))
+                text_parts.append(text)
+            elif part_type == "reply":
+                message_id = part.get("message_id")
+                reply_chain = []
+                reply_message_str = ""
+                sender_id = None
+                sender_name = None
+
+                # recursively get the content of the referenced message
+                if depth < max_depth and message_id:
+                    history = await self._get_message_history(message_id)
+                    if history and history.content:
+                        reply_parts = history.content.get("message", [])
+                        if isinstance(reply_parts, list):
+                            (
+                                reply_chain,
+                                reply_text_parts,
+                            ) = await self._parse_message_parts(
+                                reply_parts,
+                                depth=depth + 1,
+                                max_depth=max_depth,
+                            )
+                            reply_message_str = "".join(reply_text_parts)
+                        sender_id = history.sender_id
+                        sender_name = history.sender_name
+
+                components.append(
+                    Reply(
+                        id=message_id,
+                        chain=reply_chain,
+                        message_str=reply_message_str,
+                        sender_id=sender_id,
+                        sender_nickname=sender_name,
+                    )
+                )
+            elif part_type == "image":
+                path = part.get("path")
+                if path:
+                    components.append(Image.fromFileSystem(path))
+            elif part_type == "record":
+                path = part.get("path")
+                if path:
+                    components.append(Record.fromFileSystem(path))
+            elif part_type == "file":
+                path = part.get("path")
+                if path:
+                    filename = part.get("filename") or (
+                        os.path.basename(path) if path else "file"
+                    )
+                    components.append(File(name=filename, file=path))
+            elif part_type == "video":
+                path = part.get("path")
+                if path:
+                    components.append(Video.fromFileSystem(path))
+
+        return components, text_parts
+
    async def convert_message(self, data: tuple) -> AstrBotMessage:
        username, cid, payload = data

@@ -108,36 +195,15 @@ class WebChatAdapter(Platform):
        abm.session_id = f"webchat!{username}!{cid}"

        abm.message_id = str(uuid.uuid4())
-        abm.message = []

-        if payload["message"]:
-            abm.message.append(Plain(payload["message"]))
-        if payload["image_url"]:
-            if isinstance(payload["image_url"], list):
-                for img in payload["image_url"]:
-                    abm.message.append(
-                        Image.fromFileSystem(os.path.join(self.imgs_dir, img)),
-                    )
-            else:
-                abm.message.append(
-                    Image.fromFileSystem(
-                        os.path.join(self.imgs_dir, payload["image_url"]),
-                    ),
-                )
-        if payload["audio_url"]:
-            if isinstance(payload["audio_url"], list):
-                for audio in payload["audio_url"]:
-                    path = os.path.join(self.imgs_dir, audio)
-                    abm.message.append(Record(file=path, path=path))
-            else:
-                path = os.path.join(self.imgs_dir, payload["audio_url"])
-                abm.message.append(Record(file=path, path=path))
+        # 处理消息段列表
+        message_parts = payload.get("message", [])
+        abm.message, message_str_parts = await self._parse_message_parts(message_parts)

        logger.debug(f"WebChatAdapter: {abm.message}")

-        message_str = payload["message"]
        abm.timestamp = int(time.time())
-        abm.message_str = message_str
+        abm.message_str = "".join(message_str_parts)
        abm.raw_message = data
        return abm

@@ -1,12 +1,12 @@
 import base64
 import os
+import shutil
 import uuid

 from astrbot.api import logger
 from astrbot.api.event import AstrMessageEvent, MessageChain
-from astrbot.api.message_components import Image, Plain, Record
+from astrbot.api.message_components import File, Image, Plain, Record
 from astrbot.core.utils.astrbot_path import get_astrbot_data_path
-from astrbot.core.utils.io import download_image_by_url

 from .webchat_queue_mgr import webchat_queue_mgr

@@ -19,7 +19,9 @@ class WebChatMessageEvent(AstrMessageEvent):
        os.makedirs(imgs_dir, exist_ok=True)

    @staticmethod
-    async def _send(message: MessageChain, session_id: str, streaming: bool = False):
+    async def _send(
+        message: MessageChain | None, session_id: str, streaming: bool = False
+    ) -> str | None:
        cid = session_id.split("!")[-1]
        web_chat_back_queue = webchat_queue_mgr.get_or_create_back_queue(cid)
        if not message:
@@ -30,7 +32,7 @@ class WebChatMessageEvent(AstrMessageEvent):
                    "streaming": False,
                },  # end means this request is finished
            )
-            return ""
+            return

        data = ""
        for comp in message.chain:
@@ -47,24 +49,11 @@ class WebChatMessageEvent(AstrMessageEvent):
                )
            elif isinstance(comp, Image):
                # save image to local
-                filename = str(uuid.uuid4()) + ".jpg"
+                filename = f"{str(uuid.uuid4())}.jpg"
                path = os.path.join(imgs_dir, filename)
-                if comp.file and comp.file.startswith("file:///"):
-                    ph = comp.file[8:]
-                    with open(path, "wb") as f:
-                        with open(ph, "rb") as f2:
-                            f.write(f2.read())
-                elif comp.file.startswith("base64://"):
-                    base64_str = comp.file[9:]
-                    image_data = base64.b64decode(base64_str)
-                    with open(path, "wb") as f:
-                        f.write(image_data)
-                elif comp.file and comp.file.startswith("http"):
-                    await download_image_by_url(comp.file, path=path)
-                else:
-                    with open(path, "wb") as f:
-                        with open(comp.file, "rb") as f2:
-                            f.write(f2.read())
+                image_base64 = await comp.convert_to_base64()
+                with open(path, "wb") as f:
+                    f.write(base64.b64decode(image_base64))
                data = f"[IMAGE]{filename}"
                await web_chat_back_queue.put(
                    {
@@ -76,19 +65,11 @@ class WebChatMessageEvent(AstrMessageEvent):
                )
            elif isinstance(comp, Record):
                # save record to local
-                filename = str(uuid.uuid4()) + ".wav"
+                filename = f"{str(uuid.uuid4())}.wav"
                path = os.path.join(imgs_dir, filename)
-                if comp.file and comp.file.startswith("file:///"):
-                    ph = comp.file[8:]
-                    with open(path, "wb") as f:
-                        with open(ph, "rb") as f2:
-                            f.write(f2.read())
-                elif comp.file and comp.file.startswith("http"):
-                    await download_image_by_url(comp.file, path=path)
-                else:
-                    with open(path, "wb") as f:
-                        with open(comp.file, "rb") as f2:
-                            f.write(f2.read())
+                record_base64 = await comp.convert_to_base64()
+                with open(path, "wb") as f:
+                    f.write(base64.b64decode(record_base64))
                data = f"[RECORD]{filename}"
                await web_chat_back_queue.put(
                    {
@@ -98,6 +79,23 @@ class WebChatMessageEvent(AstrMessageEvent):
                        "streaming": streaming,
                    },
                )
+            elif isinstance(comp, File):
+                # save file to local
+                file_path = await comp.get_file()
+                original_name = comp.name or os.path.basename(file_path)
+                ext = os.path.splitext(original_name)[1] or ""
+                filename = f"{uuid.uuid4()!s}{ext}"
+                dest_path = os.path.join(imgs_dir, filename)
+                shutil.copy2(file_path, dest_path)
+                data = f"[FILE]{filename}|{original_name}"
+                await web_chat_back_queue.put(
+                    {
+                        "type": "file",
+                        "cid": cid,
+                        "data": data,
+                        "streaming": streaming,
+                    },
+                )
            else:
                logger.debug(f"webchat 忽略: {comp.type}")

@@ -131,6 +129,8 @@ class WebChatMessageEvent(AstrMessageEvent):
                session_id=self.session_id,
                streaming=True,
            )
+            if not r:
+                continue
            if chain.type == "reasoning":
                reasoning_content += chain.get_plain_text()
            else:
@@ -42,10 +42,9 @@ class WeChatPadProAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
+        super().__init__(platform_config, event_queue)
        self._shutdown_event = None
        self.wxnewpass = None
-        self.config = platform_config
        self.settings = platform_settings
        self.unique_session = platform_settings.get("unique_session", False)

@@ -2,6 +2,7 @@ import asyncio
 import os
 import sys
 import uuid
+from typing import Any

 import quart
 from requests import Response
@@ -24,6 +25,7 @@ from astrbot.api.platform import (
 from astrbot.core import logger
 from astrbot.core.platform.astr_message_event import MessageSesion
 from astrbot.core.utils.astrbot_path import get_astrbot_data_path
+from astrbot.core.utils.webhook_utils import log_webhook_info

 from .wecom_event import WecomPlatformEvent
 from .wecom_kf import WeChatKF
@@ -62,8 +64,20 @@ class WecomServer:
        self.shutdown_event = asyncio.Event()

    async def verify(self):
-        logger.info(f"验证请求有效性: {quart.request.args}")
-        args = quart.request.args
+        """内部服务器的 GET 验证入口"""
+        return await self.handle_verify(quart.request)
+
+    async def handle_verify(self, request) -> str:
+        """处理验证请求，可被统一 webhook 入口复用
+
+        Args:
+            request: Quart 请求对象
+
+        Returns:
+            验证响应
+        """
+        logger.info(f"验证请求有效性: {request.args}")
+        args = request.args
        try:
            echo_str = self.crypto.check_signature(
                args.get("msg_signature"),
@@ -78,10 +92,22 @@ class WecomServer:
            raise

    async def callback_command(self):
-        data = await quart.request.get_data()
-        msg_signature = quart.request.args.get("msg_signature")
-        timestamp = quart.request.args.get("timestamp")
-        nonce = quart.request.args.get("nonce")
+        """内部服务器的 POST 回调入口"""
+        return await self.handle_callback(quart.request)
+
+    async def handle_callback(self, request) -> str:
+        """处理回调请求，可被统一 webhook 入口复用
+
+        Args:
+            request: Quart 请求对象
+
+        Returns:
+            响应内容
+        """
+        data = await request.get_data()
+        msg_signature = request.args.get("msg_signature")
+        timestamp = request.args.get("timestamp")
+        nonce = request.args.get("nonce")
        try:
            xml = self.crypto.decrypt_message(data, msg_signature, timestamp, nonce)
        except InvalidSignatureException:
@@ -118,14 +144,14 @@ class WecomPlatformAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)
        self.settingss = platform_settings
        self.client_self_id = uuid.uuid4().hex[:8]
        self.api_base_url = platform_config.get(
            "api_base_url",
            "https://qyapi.weixin.qq.com/cgi-bin/",
        )
+        self.unified_webhook_mode = platform_config.get("unified_webhook_mode", False)

        if not self.api_base_url:
            self.api_base_url = "https://qyapi.weixin.qq.com/cgi-bin/"
@@ -232,7 +258,23 @@ class WecomPlatformAdapter(Platform):
                    )
            except Exception as e:
                logger.error(e)
-        await self.server.start_polling()
+
+        # 如果启用统一 webhook 模式，则不启动独立服务器
+        webhook_uuid = self.config.get("webhook_uuid")
+        if self.unified_webhook_mode and webhook_uuid:
+            log_webhook_info(f"{self.meta().id}(企业微信)", webhook_uuid)
+            # 保持运行状态，等待 shutdown
+            await self.server.shutdown_event.wait()
+        else:
+            await self.server.start_polling()
+
+    async def webhook_callback(self, request: Any) -> Any:
+        """统一 Webhook 回调入口"""
+        # 根据请求方法分发到不同的处理函数
+        if request.method == "GET":
+            return await self.server.handle_verify(request)
+        else:
+            return await self.server.handle_callback(request)

    async def convert_message(self, msg: BaseMessage) -> AstrBotMessage | None:
        abm = AstrBotMessage()
@@ -16,7 +16,7 @@ try:
    import pydub
 except Exception:
    logger.warning(
-        "检测到 pydub 库未安装，企业微信将无法语音收发。如需使用语音，请前往管理面板 -> 控制台 -> 安装 Pip 库安装 pydub。",
+        "检测到 pydub 库未安装，企业微信将无法语音收发。如需使用语音，请前往管理面板 -> 平台日志 -> 安装 Pip 库安装 pydub。",
    )


@@ -22,6 +22,7 @@ from astrbot.api.platform import (
    PlatformMetadata,
 )
 from astrbot.core.platform.astr_message_event import MessageSesion
+from astrbot.core.utils.webhook_utils import log_webhook_info

 from ...register import register_platform_adapter
 from .wecomai_api import (
@@ -103,9 +104,7 @@ class WecomAIBotAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)
        self.settings = platform_settings

        # 初始化配置参数
@@ -122,6 +121,7 @@ class WecomAIBotAdapter(Platform):
            "wecomaibot_friend_message_welcome_text",
            "",
        )
+        self.unified_webhook_mode = self.config.get("unified_webhook_mode", False)

        # 平台元数据
        self.metadata = PlatformMetadata(
@@ -425,17 +425,34 @@ class WecomAIBotAdapter(Platform):

    def run(self) -> Awaitable[Any]:
        """运行适配器，同时启动HTTP服务器和队列监听器"""
-        logger.info("启动企业微信智能机器人适配器，监听 %s:%d", self.host, self.port)

        async def run_both():
-            # 同时运行HTTP服务器和队列监听器
-            await asyncio.gather(
-                self.server.start_server(),
-                self.queue_listener.run(),
-            )
+            # 如果启用统一 webhook 模式，则不启动独立服务器
+            webhook_uuid = self.config.get("webhook_uuid")
+            if self.unified_webhook_mode and webhook_uuid:
+                log_webhook_info(f"{self.meta().id}(企业微信智能机器人)", webhook_uuid)
+                # 只运行队列监听器
+                await self.queue_listener.run()
+            else:
+                logger.info(
+                    "启动企业微信智能机器人适配器，监听 %s:%d", self.host, self.port
+                )
+                # 同时运行HTTP服务器和队列监听器
+                await asyncio.gather(
+                    self.server.start_server(),
+                    self.queue_listener.run(),
+                )

        return run_both()

+    async def webhook_callback(self, request: Any) -> Any:
+        """统一 Webhook 回调入口"""
+        # 根据请求方法分发到不同的处理函数
+        if request.method == "GET":
+            return await self.server.handle_verify(request)
+        else:
+            return await self.server.handle_callback(request)
+
    async def terminate(self):
        """终止适配器"""
        logger.info("企业微信智能机器人适配器正在关闭...")
@@ -59,8 +59,19 @@ class WecomAIBotServer:
        )

    async def verify_url(self):
-        """验证回调 URL"""
-        args = quart.request.args
+        """内部服务器的 GET 验证入口"""
+        return await self.handle_verify(quart.request)
+
+    async def handle_verify(self, request):
+        """处理 URL 验证请求，可被统一 webhook 入口复用
+
+        Args:
+            request: Quart 请求对象
+
+        Returns:
+            验证响应元组 (content, status_code, headers)
+        """
+        args = request.args
        msg_signature = args.get("msg_signature")
        timestamp = args.get("timestamp")
        nonce = args.get("nonce")
@@ -81,8 +92,19 @@ class WecomAIBotServer:
        return result, 200, {"Content-Type": "text/plain"}

    async def handle_message(self):
-        """处理消息回调"""
-        args = quart.request.args
+        """内部服务器的 POST 消息回调入口"""
+        return await self.handle_callback(quart.request)
+
+    async def handle_callback(self, request):
+        """处理消息回调，可被统一 webhook 入口复用
+
+        Args:
+            request: Quart 请求对象
+
+        Returns:
+            响应元组 (content, status_code, headers)
+        """
+        args = request.args
        msg_signature = args.get("msg_signature")
        timestamp = args.get("timestamp")
        nonce = args.get("nonce")
@@ -102,7 +124,7 @@ class WecomAIBotServer:

        try:
            # 获取请求体
-            post_data = await quart.request.get_data()
+            post_data = await request.get_data()

            # 确保 post_data 是 bytes 类型
            if isinstance(post_data, str):
@@ -1,6 +1,7 @@
 import asyncio
 import sys
 import uuid
+from typing import Any

 import quart
 from requests import Response
@@ -22,6 +23,7 @@ from astrbot.api.platform import (
 )
 from astrbot.core import logger
 from astrbot.core.platform.astr_message_event import MessageSesion
+from astrbot.core.utils.webhook_utils import log_webhook_info

 from .weixin_offacc_event import WeixinOfficialAccountPlatformEvent

@@ -31,7 +33,7 @@ else:
    from typing_extensions import override


-class WecomServer:
+class WeixinOfficialAccountServer:
    def __init__(self, event_queue: asyncio.Queue, config: dict):
        self.server = quart.Quart(__name__)
        self.port = int(config.get("port"))
@@ -57,9 +59,21 @@ class WecomServer:
        self.shutdown_event = asyncio.Event()

    async def verify(self):
-        logger.info(f"验证请求有效性: {quart.request.args}")
+        """内部服务器的 GET 验证入口"""
+        return await self.handle_verify(quart.request)

-        args = quart.request.args
+    async def handle_verify(self, request) -> str:
+        """处理验证请求，可被统一 webhook 入口复用
+
+        Args:
+            request: Quart 请求对象
+
+        Returns:
+            验证响应
+        """
+        logger.info(f"验证请求有效性: {request.args}")
+
+        args = request.args
        if not args.get("signature", None):
            logger.error("未知的响应，请检查回调地址是否填写正确。")
            return "err"
@@ -77,10 +91,22 @@ class WecomServer:
            return "err"

    async def callback_command(self):
-        data = await quart.request.get_data()
-        msg_signature = quart.request.args.get("msg_signature")
-        timestamp = quart.request.args.get("timestamp")
-        nonce = quart.request.args.get("nonce")
+        """内部服务器的 POST 回调入口"""
+        return await self.handle_callback(quart.request)
+
+    async def handle_callback(self, request) -> str:
+        """处理回调请求，可被统一 webhook 入口复用
+
+        Args:
+            request: Quart 请求对象
+
+        Returns:
+            响应内容
+        """
+        data = await request.get_data()
+        msg_signature = request.args.get("msg_signature")
+        timestamp = request.args.get("timestamp")
+        nonce = request.args.get("nonce")
        try:
            xml = self.crypto.decrypt_message(data, msg_signature, timestamp, nonce)
        except InvalidSignatureException:
@@ -123,8 +149,7 @@ class WeixinOfficialAccountPlatformAdapter(Platform):
        platform_settings: dict,
        event_queue: asyncio.Queue,
    ) -> None:
-        super().__init__(event_queue)
-        self.config = platform_config
+        super().__init__(platform_config, event_queue)
        self.settingss = platform_settings
        self.client_self_id = uuid.uuid4().hex[:8]
        self.api_base_url = platform_config.get(
@@ -132,6 +157,7 @@ class WeixinOfficialAccountPlatformAdapter(Platform):
            "https://api.weixin.qq.com/cgi-bin/",
        )
        self.active_send_mode = self.config.get("active_send_mode", False)
+        self.unified_webhook_mode = platform_config.get("unified_webhook_mode", False)

        if not self.api_base_url:
            self.api_base_url = "https://api.weixin.qq.com/cgi-bin/"
@@ -143,7 +169,7 @@ class WeixinOfficialAccountPlatformAdapter(Platform):
        if not self.api_base_url.endswith("/"):
            self.api_base_url += "/"

-        self.server = WecomServer(self._event_queue, self.config)
+        self.server = WeixinOfficialAccountServer(self._event_queue, self.config)

        self.client = WeChatClient(
            self.config["appid"].strip(),
@@ -202,7 +228,22 @@ class WeixinOfficialAccountPlatformAdapter(Platform):

    @override
    async def run(self):
-        await self.server.start_polling()
+        # 如果启用统一 webhook 模式，则不启动独立服务器
+        webhook_uuid = self.config.get("webhook_uuid")
+        if self.unified_webhook_mode and webhook_uuid:
+            log_webhook_info(f"{self.meta().id}(微信公众平台)", webhook_uuid)
+            # 保持运行状态，等待 shutdown
+            await self.server.shutdown_event.wait()
+        else:
+            await self.server.start_polling()
+
+    async def webhook_callback(self, request: Any) -> Any:
+        """统一 Webhook 回调入口"""
+        # 根据请求方法分发到不同的处理函数
+        if request.method == "GET":
+            return await self.server.handle_verify(request)
+        else:
+            return await self.server.handle_callback(request)

    async def convert_message(
        self,
@@ -13,7 +13,7 @@ try:
    import pydub
 except Exception:
    logger.warning(
-        "检测到 pydub 库未安装，微信公众平台将无法语音收发。如需使用语音，请前往管理面板 -> 控制台 -> 安装 Pip 库安装 pydub。",
+        "检测到 pydub 库未安装，微信公众平台将无法语音收发。如需使用语音，请前往管理面板 -> 平台日志 -> 安装 Pip 库安装 pydub。",
    )


@@ -10,12 +10,12 @@ class PlatformMessageHistoryManager:
        self,
        platform_id: str,
        user_id: str,
-        content: list[dict],  # TODO: parse from message chain
+        content: dict,  # TODO: parse from message chain
        sender_id: str | None = None,
        sender_name: str | None = None,
-    ):
+    ) -> PlatformMessageHistory:
        """Insert a new platform message history record."""
-        await self.db.insert_platform_message_history(
+        return await self.db.insert_platform_message_history(
            platform_id=platform_id,
            user_id=user_id,
            content=content,
@@ -1,5 +1,6 @@
 import abc
 import asyncio
+import os
 from collections.abc import AsyncGenerator

 from astrbot.core.agent.message import Message
@@ -11,6 +12,7 @@ from astrbot.core.provider.entities import (
    ToolCallsResult,
 )
 from astrbot.core.provider.register import provider_cls_map
+from astrbot.core.utils.astrbot_path import get_astrbot_path


 class AbstractProvider(abc.ABC):
@@ -43,6 +45,14 @@ class AbstractProvider(abc.ABC):
        )
        return meta

+    async def test(self):
+        """test the provider is a
+
+        raises:
+            Exception: if the provider is not available
+        """
+        ...
+

 class Provider(AbstractProvider):
    """Chat Provider"""
@@ -165,6 +175,12 @@ class Provider(AbstractProvider):

        return dicts

+    async def test(self, timeout: float = 45.0):
+        await asyncio.wait_for(
+            self.text_chat(prompt="REPLY `PONG` ONLY"),
+            timeout=timeout,
+        )
+

 class STTProvider(AbstractProvider):
    def __init__(self, provider_config: dict, provider_settings: dict) -> None:
@@ -177,6 +193,14 @@ class STTProvider(AbstractProvider):
        """获取音频的文本"""
        raise NotImplementedError

+    async def test(self):
+        sample_audio_path = os.path.join(
+            get_astrbot_path(),
+            "samples",
+            "stt_health_check.wav",
+        )
+        await self.get_text(sample_audio_path)
+

 class TTSProvider(AbstractProvider):
    def __init__(self, provider_config: dict, provider_settings: dict) -> None:
@@ -189,6 +213,9 @@ class TTSProvider(AbstractProvider):
        """获取文本的音频，返回音频文件路径"""
        raise NotImplementedError

+    async def test(self):
+        await self.get_audio("hi")
+

 class EmbeddingProvider(AbstractProvider):
    def __init__(self, provider_config: dict, provider_settings: dict) -> None:
@@ -211,6 +238,9 @@ class EmbeddingProvider(AbstractProvider):
        """获取向量的维度"""
        ...

+    async def test(self):
+        await self.get_embedding("astrbot")
+
    async def get_embeddings_batch(
        self,
        texts: list[str],
@@ -294,3 +324,8 @@ class RerankProvider(AbstractProvider):
    ) -> list[RerankResult]:
        """获取查询和文档的重排序分数"""
        ...
+
+    async def test(self):
+        result = await self.rerank("Apple", documents=["apple", "banana"])
+        if not result:
+            raise Exception("Rerank provider test failed, no results returned")
@@ -290,7 +290,7 @@ class ProviderAnthropic(Provider):
        try:
            llm_response = await self._query(payloads, func_tool)
        except Exception as e:
-            logger.error(f"发生了错误。Provider 配置如下: {model_config}")
+            # logger.error(f"发生了错误。Provider 配置如下: {model_config}")
            raise e

        return llm_response
@@ -111,9 +111,9 @@ class ProviderGoogleGenAI(Provider):
                f"检测到 Key 异常({e.message})，且已没有可用的 Key。 当前 Key: {self.chosen_api_key[:12]}...",
            )
            raise Exception("达到了 Gemini 速率限制, 请稍后再试...")
-        logger.error(
-            f"发生了错误(gemini_source)。Provider 配置如下: {self.provider_config}",
-        )
+        # logger.error(
+        #     f"发生了错误(gemini_source)。Provider 配置如下: {self.provider_config}",
+        # )
        raise e

    async def _prepare_query_config(
@@ -433,7 +433,7 @@ class ProviderOpenAIOfficial(Provider):
            )
            payloads.pop("tools", None)
            return False, chosen_key, available_api_keys, payloads, context_query, None
-        logger.error(f"发生了错误。Provider 配置如下: {self.provider_config}")
+        # logger.error(f"发生了错误。Provider 配置如下: {self.provider_config}")

        if "tool" in str(e).lower() and "support" in str(e).lower():
            logger.error("疑似该模型不支持函数调用工具调用。请输入 /tool off_all")
@@ -6,7 +6,10 @@ from openai import NOT_GIVEN, AsyncOpenAI
 from astrbot.core import logger
 from astrbot.core.utils.astrbot_path import get_astrbot_data_path
 from astrbot.core.utils.io import download_file
-from astrbot.core.utils.tencent_record_helper import tencent_silk_to_wav
+from astrbot.core.utils.tencent_record_helper import (
+    convert_to_pcm_wav,
+    tencent_silk_to_wav,
+)

 from ..entities import ProviderType
 from ..provider import STTProvider
@@ -35,18 +38,28 @@ class ProviderOpenAIWhisperAPI(STTProvider):

        self.set_model(provider_config.get("model"))

-    async def _is_silk_file(self, file_path):
+    async def _get_audio_format(self, file_path):
+        # 定义要检测的头部字节
        silk_header = b"SILK"
-        with open(file_path, "rb") as f:
-            file_header = f.read(8)
+        amr_header = b"#!AMR"
+
+        try:
+            with open(file_path, "rb") as f:
+                file_header = f.read(8)
+        except FileNotFoundError:
+            return None

        if silk_header in file_header:
-            return True
-        return False
+            return "silk"
+
+        if amr_header in file_header:
+            return "amr"
+        return None

    async def get_text(self, audio_url: str) -> str:
        """Only supports mp3, mp4, mpeg, m4a, wav, webm"""
        is_tencent = False
+        output_path = None

        if audio_url.startswith("http"):
            if "multimedia.nt.qq.com.cn" in audio_url:
@@ -62,16 +75,35 @@ class ProviderOpenAIWhisperAPI(STTProvider):
            raise FileNotFoundError(f"文件不存在: {audio_url}")

        if audio_url.endswith(".amr") or audio_url.endswith(".silk") or is_tencent:
-            is_silk = await self._is_silk_file(audio_url)
-            if is_silk:
-                logger.info("Converting silk file to wav ...")
+            file_format = await self._get_audio_format(audio_url)
+
+            # 判断是否需要转换
+            if file_format in ["silk", "amr"]:
                temp_dir = os.path.join(get_astrbot_data_path(), "temp")
                output_path = os.path.join(temp_dir, str(uuid.uuid4()) + ".wav")
-                await tencent_silk_to_wav(audio_url, output_path)
+
+                if file_format == "silk":
+                    logger.info(
+                        "Converting silk file to wav using tencent_silk_to_wav..."
+                    )
+                    await tencent_silk_to_wav(audio_url, output_path)
+                elif file_format == "amr":
+                    logger.info(
+                        "Converting amr file to wav using convert_to_pcm_wav..."
+                    )
+                    await convert_to_pcm_wav(audio_url, output_path)
+
                audio_url = output_path

        result = await self.client.audio.transcriptions.create(
            model=self.model_name,
-            file=open(audio_url, "rb"),
+            file=("audio.wav", open(audio_url, "rb")),
        )
+
+        # remove temp file
+        if output_path and os.path.exists(output_path):
+            try:
+                os.remove(audio_url)
+            except Exception as e:
+                logger.error(f"Failed to remove temp file {audio_url}: {e}")
        return result.text
@@ -171,110 +171,3 @@ class SessionServiceManager:

        # 如果没有配置，默认为启用（兼容性考虑）
        return True
-
-    @staticmethod
-    def set_session_status(session_id: str, enabled: bool) -> None:
-        """设置会话的整体启停状态
-
-        Args:
-            session_id: 会话ID (unified_msg_origin)
-            enabled: True表示启用，False表示禁用
-
-        """
-        session_config = (
-            sp.get("session_service_config", {}, scope="umo", scope_id=session_id) or {}
-        )
-        session_config["session_enabled"] = enabled
-        sp.put(
-            "session_service_config",
-            session_config,
-            scope="umo",
-            scope_id=session_id,
-        )
-
-        logger.info(
-            f"会话 {session_id} 的整体状态已更新为: {'启用' if enabled else '禁用'}",
-        )
-
-    @staticmethod
-    def should_process_session_request(event: AstrMessageEvent) -> bool:
-        """检查是否应该处理会话请求（会话整体启停检查）
-
-        Args:
-            event: 消息事件
-
-        Returns:
-            bool: True表示应该处理，False表示跳过
-
-        """
-        session_id = event.unified_msg_origin
-        return SessionServiceManager.is_session_enabled(session_id)
-
-    # =============================================================================
-    # 会话命名相关方法
-    # =============================================================================
-
-    @staticmethod
-    def get_session_custom_name(session_id: str) -> str | None:
-        """获取会话的自定义名称
-
-        Args:
-            session_id: 会话ID (unified_msg_origin)
-
-        Returns:
-            str: 自定义名称，如果没有设置则返回None
-
-        """
-        session_services = sp.get(
-            "session_service_config",
-            {},
-            scope="umo",
-            scope_id=session_id,
-        )
-        return session_services.get("custom_name")
-
-    @staticmethod
-    def set_session_custom_name(session_id: str, custom_name: str) -> None:
-        """设置会话的自定义名称
-
-        Args:
-            session_id: 会话ID (unified_msg_origin)
-            custom_name: 自定义名称，可以为空字符串来清除名称
-
-        """
-        session_config = (
-            sp.get("session_service_config", {}, scope="umo", scope_id=session_id) or {}
-        )
-        if custom_name and custom_name.strip():
-            session_config["custom_name"] = custom_name.strip()
-        else:
-            # 如果传入空名称，则删除自定义名称
-            session_config.pop("custom_name", None)
-        sp.put(
-            "session_service_config",
-            session_config,
-            scope="umo",
-            scope_id=session_id,
-        )
-
-        logger.info(
-            f"会话 {session_id} 的自定义名称已更新为: {custom_name.strip() if custom_name and custom_name.strip() else '已清除'}",
-        )
-
-    @staticmethod
-    def get_session_display_name(session_id: str) -> str:
-        """获取会话的显示名称（优先显示自定义名称，否则显示原始session_id的最后一段）
-
-        Args:
-            session_id: 会话ID (unified_msg_origin)
-
-        Returns:
-            str: 显示名称
-
-        """
-        custom_name = SessionServiceManager.get_session_custom_name(session_id)
-        if custom_name:
-            return custom_name
-
-        # 如果没有自定义名称，返回session_id的最后一段
-        return session_id.split(":")[2] if session_id.count(":") >= 2 else session_id
@@ -42,87 +42,6 @@ class SessionPluginManager:
        # 如果都没有配置，默认为启用（兼容性考虑）
        return True

-    @staticmethod
-    def set_plugin_status_for_session(
-        session_id: str,
-        plugin_name: str,
-        enabled: bool,
-    ) -> None:
-        """设置插件在指定会话中的启停状态
-
-        Args:
-            session_id: 会话ID (unified_msg_origin)
-            plugin_name: 插件名称
-            enabled: True表示启用，False表示禁用
-
-        """
-        # 获取当前配置
-        session_plugin_config = sp.get(
-            "session_plugin_config",
-            {},
-            scope="umo",
-            scope_id=session_id,
-        )
-        if session_id not in session_plugin_config:
-            session_plugin_config[session_id] = {
-                "enabled_plugins": [],
-                "disabled_plugins": [],
-            }
-
-        session_config = session_plugin_config[session_id]
-        enabled_plugins = session_config.get("enabled_plugins", [])
-        disabled_plugins = session_config.get("disabled_plugins", [])
-
-        if enabled:
-            # 启用插件
-            if plugin_name in disabled_plugins:
-                disabled_plugins.remove(plugin_name)
-            if plugin_name not in enabled_plugins:
-                enabled_plugins.append(plugin_name)
-        else:
-            # 禁用插件
-            if plugin_name in enabled_plugins:
-                enabled_plugins.remove(plugin_name)
-            if plugin_name not in disabled_plugins:
-                disabled_plugins.append(plugin_name)
-
-        # 保存配置
-        session_config["enabled_plugins"] = enabled_plugins
-        session_config["disabled_plugins"] = disabled_plugins
-        session_plugin_config[session_id] = session_config
-        sp.put(
-            "session_plugin_config",
-            session_plugin_config,
-            scope="umo",
-            scope_id=session_id,
-        )
-
-        logger.info(
-            f"会话 {session_id} 的插件 {plugin_name} 状态已更新为: {'启用' if enabled else '禁用'}",
-        )
-
-    @staticmethod
-    def get_session_plugin_config(session_id: str) -> dict[str, list[str]]:
-        """获取指定会话的插件配置
-
-        Args:
-            session_id: 会话ID (unified_msg_origin)
-
-        Returns:
-            Dict[str, List[str]]: 包含enabled_plugins和disabled_plugins的字典
-
-        """
-        session_plugin_config = sp.get(
-            "session_plugin_config",
-            {},
-            scope="umo",
-            scope_id=session_id,
-        )
-        return session_plugin_config.get(
-            session_id,
-            {"enabled_plugins": [], "disabled_plugins": []},
-        )
-
    @staticmethod
    def filter_handlers_by_session(event: AstrMessageEvent, handlers: list) -> list:
        """根据会话配置过滤处理器列表
@@ -0,0 +1,23 @@
+from pathlib import Path
+
+from openai import AsyncOpenAI
+
+
+async def extract_file_moonshotai(file_path: str, api_key: str) -> str:
+    """Extract text from a file using Moonshot AI API"""
+    """
+    Args:
+        file_path: The path to the file to extract text from
+        api_key: The API key to use to extract text from the file
+    Returns:
+        The text extracted from the file
+    """
+    client = AsyncOpenAI(
+        api_key=api_key,
+        base_url="https://api.moonshot.cn/v1",
+    )
+    file_object = await client.files.create(
+        file=Path(file_path),
+        purpose="file-extract",  # type: ignore
+    )
+    return (await client.files.content(file_id=file_object.id)).text
@@ -36,7 +36,7 @@ async def wav_to_tencent_silk(wav_path: str, output_path: str) -> int:
        import pilk
    except (ImportError, ModuleNotFoundError) as _:
        raise Exception(
-            "pilk 模块未安装，请前往管理面板->控制台->安装pip库 安装 pilk 这个库",
+            "pilk 模块未安装，请前往管理面板->平台日志->安装pip库 安装 pilk 这个库",
        )
    # with wave.open(wav_path, 'rb') as wav:
    #     wav_data = wav.readframes(wav.getnframes())
@@ -0,0 +1,47 @@
+from astrbot.core import astrbot_config, logger
+
+
+def _get_callback_api_base() -> str:
+    try:
+        return astrbot_config.get("callback_api_base", "").rstrip("/")
+    except Exception as e:
+        logger.error(f"获取 callback_api_base 失败: {e!s}")
+        return ""
+
+
+def _get_dashboard_port() -> int:
+    try:
+        return astrbot_config.get("dashboard", {}).get("port", 6185)
+    except Exception as e:
+        logger.error(f"获取 dashboard 端口失败: {e!s}")
+        return 6185
+
+
+def log_webhook_info(platform_name: str, webhook_uuid: str):
+    """打印美观的 webhook 信息日志
+
+    Args:
+        platform_name: 平台名称
+        webhook_uuid: webhook 的 UUID
+    """
+
+    callback_base = _get_callback_api_base()
+
+    if not callback_base:
+        callback_base = "http(s)://<your-astrbot-domain>"
+
+    if not callback_base.startswith("http"):
+        callback_base = f"http(s)://{callback_base}"
+
+    callback_base = callback_base.rstrip("/")
+    webhook_url = f"{callback_base}/api/platform/webhook/{webhook_uuid}"
+
+    display_log = (
+        "\n====================\n"
+        f"🔗 机器人平台 {platform_name} 已启用统一 Webhook 模式\n"
+        f"📍 Webhook 回调地址: \n"
+        f"   ➜  http://<your-ip>:{_get_dashboard_port()}/api/platform/webhook/{webhook_uuid}\n"
+        f"   ➜  {webhook_url}\n"
+        "====================\n"
+    )
+    logger.info(display_log)
@@ -6,6 +6,7 @@ from .file import FileRoute
 from .knowledge_base import KnowledgeBaseRoute
 from .log import LogRoute
 from .persona import PersonaRoute
+from .platform import PlatformRoute
 from .plugin import PluginRoute
 from .session_management import SessionManagementRoute
 from .stat import StatRoute
@@ -22,6 +23,7 @@ __all__ = [
    "KnowledgeBaseRoute",
    "LogRoute",
    "PersonaRoute",
+    "PlatformRoute",
    "PluginRoute",
    "SessionManagementRoute",
    "StatRoute",
@@ -1,11 +1,11 @@
 import asyncio
 import json
+import mimetypes
 import os
 import uuid
 from contextlib import asynccontextmanager

-from quart import Response as QuartResponse
-from quart import g, make_response, request
+from quart import g, make_response, request, send_file

 from astrbot.core import logger
 from astrbot.core.core_lifecycle import AstrBotCoreLifecycle
@@ -44,7 +44,7 @@ class ChatRoute(Route):
                self.update_session_display_name,
            ),
            "/chat/get_file": ("GET", self.get_file),
-            "/chat/post_image": ("POST", self.post_image),
+            "/chat/get_attachment": ("GET", self.get_attachment),
            "/chat/post_file": ("POST", self.post_file),
        }
        self.core_lifecycle = core_lifecycle
@@ -73,52 +73,184 @@ class ChatRoute(Route):
            if not real_file_path.startswith(real_imgs_dir):
                return Response().error("Invalid file path").__dict__

-            with open(real_file_path, "rb") as f:
-                filename_ext = os.path.splitext(filename)[1].lower()
-
-                if filename_ext == ".wav":
-                    return QuartResponse(f.read(), mimetype="audio/wav")
-                if filename_ext[1:] in self.supported_imgs:
-                    return QuartResponse(f.read(), mimetype="image/jpeg")
-                return QuartResponse(f.read())
+            filename_ext = os.path.splitext(filename)[1].lower()
+            if filename_ext == ".wav":
+                return await send_file(real_file_path, mimetype="audio/wav")
+            if filename_ext[1:] in self.supported_imgs:
+                return await send_file(real_file_path, mimetype="image/jpeg")
+            return await send_file(real_file_path)

        except (FileNotFoundError, OSError):
            return Response().error("File access error").__dict__

-    async def post_image(self):
-        post_data = await request.files
-        if "file" not in post_data:
-            return Response().error("Missing key: file").__dict__
+    async def get_attachment(self):
+        """Get attachment file by attachment_id."""
+        attachment_id = request.args.get("attachment_id")
+        if not attachment_id:
+            return Response().error("Missing key: attachment_id").__dict__

-        file = post_data["file"]
-        filename = str(uuid.uuid4()) + ".jpg"
-        path = os.path.join(self.imgs_dir, filename)
-        await file.save(path)
+        try:
+            attachment = await self.db.get_attachment_by_id(attachment_id)
+            if not attachment:
+                return Response().error("Attachment not found").__dict__

-        return Response().ok(data={"filename": filename}).__dict__
+            file_path = attachment.path
+            real_file_path = os.path.realpath(file_path)
+
+            return await send_file(real_file_path, mimetype=attachment.mime_type)
+
+        except (FileNotFoundError, OSError):
+            return Response().error("File access error").__dict__

    async def post_file(self):
+        """Upload a file and create an attachment record, return attachment_id."""
        post_data = await request.files
        if "file" not in post_data:
            return Response().error("Missing key: file").__dict__

        file = post_data["file"]
-        filename = f"{uuid.uuid4()!s}"
-        # 通过文件格式判断文件类型
-        if file.content_type.startswith("audio"):
-            filename += ".wav"
+        filename = file.filename or f"{uuid.uuid4()!s}"
+        content_type = file.content_type or "application/octet-stream"
+
+        # 根据 content_type 判断文件类型并添加扩展名
+        if content_type.startswith("image"):
+            attach_type = "image"
+        elif content_type.startswith("audio"):
+            attach_type = "record"
+        elif content_type.startswith("video"):
+            attach_type = "video"
+        else:
+            attach_type = "file"

        path = os.path.join(self.imgs_dir, filename)
        await file.save(path)

-        return Response().ok(data={"filename": filename}).__dict__
+        # 创建 attachment 记录
+        attachment = await self.db.insert_attachment(
+            path=path,
+            type=attach_type,
+            mime_type=content_type,
+        )
+
+        if not attachment:
+            return Response().error("Failed to create attachment").__dict__
+
+        filename = os.path.basename(attachment.path)
+
+        return (
+            Response()
+            .ok(
+                data={
+                    "attachment_id": attachment.attachment_id,
+                    "filename": filename,
+                    "type": attach_type,
+                }
+            )
+            .__dict__
+        )
+
+    async def _build_user_message_parts(self, message: str | list) -> list[dict]:
+        """构建用户消息的部分列表
+
+        Args:
+            message: 文本消息 (str) 或消息段列表 (list)
+        """
+        parts = []
+
+        if isinstance(message, list):
+            for part in message:
+                part_type = part.get("type")
+                if part_type == "plain":
+                    parts.append({"type": "plain", "text": part.get("text", "")})
+                elif part_type == "reply":
+                    parts.append(
+                        {"type": "reply", "message_id": part.get("message_id")}
+                    )
+                elif attachment_id := part.get("attachment_id"):
+                    attachment = await self.db.get_attachment_by_id(attachment_id)
+                    if attachment:
+                        parts.append(
+                            {
+                                "type": attachment.type,
+                                "attachment_id": attachment.attachment_id,
+                                "filename": os.path.basename(attachment.path),
+                                "path": attachment.path,  # will be deleted
+                            }
+                        )
+            return parts
+
+        if message:
+            parts.append({"type": "plain", "text": message})
+
+        return parts
+
+    async def _create_attachment_from_file(
+        self, filename: str, attach_type: str
+    ) -> dict | None:
+        """从本地文件创建 attachment 并返回消息部分
+
+        用于处理 bot 回复中的媒体文件
+
+        Args:
+            filename: 存储的文件名
+            attach_type: 附件类型 (image, record, file, video)
+        """
+        file_path = os.path.join(self.imgs_dir, os.path.basename(filename))
+        if not os.path.exists(file_path):
+            return None
+
+        # guess mime type
+        mime_type, _ = mimetypes.guess_type(filename)
+        if not mime_type:
+            mime_type = "application/octet-stream"
+
+        # insert attachment
+        attachment = await self.db.insert_attachment(
+            path=file_path,
+            type=attach_type,
+            mime_type=mime_type,
+        )
+        if not attachment:
+            return None
+
+        return {
+            "type": attach_type,
+            "attachment_id": attachment.attachment_id,
+            "filename": os.path.basename(file_path),
+        }
+
+    async def _save_bot_message(
+        self,
+        webchat_conv_id: str,
+        text: str,
+        media_parts: list,
+        reasoning: str,
+    ):
+        """保存 bot 消息到历史记录，返回保存的记录"""
+        bot_message_parts = []
+        if text:
+            bot_message_parts.append({"type": "plain", "text": text})
+        bot_message_parts.extend(media_parts)
+
+        new_his = {"type": "bot", "message": bot_message_parts}
+        if reasoning:
+            new_his["reasoning"] = reasoning
+
+        record = await self.platform_history_mgr.insert(
+            platform_id="webchat",
+            user_id=webchat_conv_id,
+            content=new_his,
+            sender_id="bot",
+            sender_name="bot",
+        )
+        return record

    async def chat(self):
        username = g.get("username", "guest")

        post_data = await request.json
-        if "message" not in post_data and "image_url" not in post_data:
-            return Response().error("Missing key: message or image_url").__dict__
+        if "message" not in post_data and "files" not in post_data:
+            return Response().error("Missing key: message or files").__dict__

        if "session_id" not in post_data and "conversation_id" not in post_data:
            return (
@@ -126,44 +258,40 @@ class ChatRoute(Route):
            )

        message = post_data["message"]
-        # conversation_id = post_data["conversation_id"]
        session_id = post_data.get("session_id", post_data.get("conversation_id"))
-        image_url = post_data.get("image_url")
-        audio_url = post_data.get("audio_url")
        selected_provider = post_data.get("selected_provider")
        selected_model = post_data.get("selected_model")
-        enable_streaming = post_data.get("enable_streaming", True)  # 默认为 True
+        enable_streaming = post_data.get("enable_streaming", True)

-        if not message and not image_url and not audio_url:
-            return (
-                Response()
-                .error("Message and image_url and audio_url are empty")
-                .__dict__
+        # 检查消息是否为空
+        if isinstance(message, list):
+            has_content = any(
+                part.get("type") in ("plain", "image", "record", "file", "video")
+                for part in message
            )
+            if not has_content:
+                return (
+                    Response()
+                    .error("Message content is empty (reply only is not allowed)")
+                    .__dict__
+                )
+        elif not message:
+            return Response().error("Message are both empty").__dict__
+
        if not session_id:
            return Response().error("session_id is empty").__dict__

-        # 追加用户消息
        webchat_conv_id = session_id
-
-        # 获取会话特定的队列
        back_queue = webchat_queue_mgr.get_or_create_back_queue(webchat_conv_id)

-        new_his = {"type": "user", "message": message}
-        if image_url:
-            new_his["image_url"] = image_url
-        if audio_url:
-            new_his["audio_url"] = audio_url
-        await self.platform_history_mgr.insert(
-            platform_id="webchat",
-            user_id=webchat_conv_id,
-            content=new_his,
-            sender_id=username,
-            sender_name=username,
-        )
+        # 构建用户消息段（包含 path 用于传递给 adapter）
+        message_parts = await self._build_user_message_parts(message)

        async def stream():
            client_disconnected = False
+            accumulated_parts = []
+            accumulated_text = ""
+            accumulated_reasoning = ""

            try:
                async with track_conversation(self.running_convs, webchat_conv_id):
@@ -182,16 +310,17 @@ class ChatRoute(Route):
                            continue

                        result_text = result["data"]
-                        type = result.get("type")
+                        msg_type = result.get("type")
                        streaming = result.get("streaming", False)

+                        # 发送 SSE 数据
                        try:
                            if not client_disconnected:
                                yield f"data: {json.dumps(result, ensure_ascii=False)}\n\n"
                        except Exception as e:
                            if not client_disconnected:
                                logger.debug(
-                                    f"[WebChat] 用户 {username} 断开聊天长连接。 {e}",
+                                    f"[WebChat] 用户 {username} 断开聊天长连接。 {e}"
                                )
                            client_disconnected = True

@@ -202,24 +331,68 @@ class ChatRoute(Route):
                            logger.debug(f"[WebChat] 用户 {username} 断开聊天长连接。")
                            client_disconnected = True

-                        if type == "end":
+                        # 累积消息部分
+                        if msg_type == "plain":
+                            chain_type = result.get("chain_type", "normal")
+                            if chain_type == "reasoning":
+                                accumulated_reasoning += result_text
+                            else:
+                                accumulated_text += result_text
+                        elif msg_type == "image":
+                            filename = result_text.replace("[IMAGE]", "")
+                            part = await self._create_attachment_from_file(
+                                filename, "image"
+                            )
+                            if part:
+                                accumulated_parts.append(part)
+                        elif msg_type == "record":
+                            filename = result_text.replace("[RECORD]", "")
+                            part = await self._create_attachment_from_file(
+                                filename, "record"
+                            )
+                            if part:
+                                accumulated_parts.append(part)
+                        elif msg_type == "file":
+                            # 格式: [FILE]filename
+                            filename = result_text.replace("[FILE]", "")
+                            part = await self._create_attachment_from_file(
+                                filename, "file"
+                            )
+                            if part:
+                                accumulated_parts.append(part)
+
+                        # 消息结束处理
+                        if msg_type == "end":
                            break
                        elif (
-                            (streaming and type == "complete")
+                            (streaming and msg_type == "complete")
                            or not streaming
-                            or type == "break"
+                            or msg_type == "break"
                        ):
-                            # 追加机器人消息
-                            new_his = {"type": "bot", "message": result_text}
-                            if "reasoning" in result:
-                                new_his["reasoning"] = result["reasoning"]
-                            await self.platform_history_mgr.insert(
-                                platform_id="webchat",
-                                user_id=webchat_conv_id,
-                                content=new_his,
-                                sender_id="bot",
-                                sender_name="bot",
+                            saved_record = await self._save_bot_message(
+                                webchat_conv_id,
+                                accumulated_text,
+                                accumulated_parts,
+                                accumulated_reasoning,
                            )
+                            # 发送保存的消息信息给前端
+                            if saved_record and not client_disconnected:
+                                saved_info = {
+                                    "type": "message_saved",
+                                    "data": {
+                                        "id": saved_record.id,
+                                        "created_at": saved_record.created_at.astimezone().isoformat(),
+                                    },
+                                }
+                                try:
+                                    yield f"data: {json.dumps(saved_info, ensure_ascii=False)}\n\n"
+                                except Exception:
+                                    pass
+                            # 重置累积变量 (对于 break 后的下一段消息)
+                            if msg_type == "break":
+                                accumulated_parts = []
+                                accumulated_text = ""
+                                accumulated_reasoning = ""
            except BaseException as e:
                logger.exception(f"WebChat stream unexpected error: {e}", exc_info=True)

@@ -230,9 +403,7 @@ class ChatRoute(Route):
                username,
                webchat_conv_id,
                {
-                    "message": message,
-                    "image_url": image_url,  # list
-                    "audio_url": audio_url,
+                    "message": message_parts,
                    "selected_provider": selected_provider,
                    "selected_model": selected_model,
                    "enable_streaming": enable_streaming,
@@ -240,6 +411,19 @@ class ChatRoute(Route):
            ),
        )

+        message_parts_for_storage = []
+        for part in message_parts:
+            part_copy = {k: v for k, v in part.items() if k != "path"}
+            message_parts_for_storage.append(part_copy)
+
+        await self.platform_history_mgr.insert(
+            platform_id="webchat",
+            user_id=webchat_conv_id,
+            content={"type": "user", "message": message_parts_for_storage},
+            sender_id=username,
+            sender_name=username,
+        )
+
        response = await make_response(
            stream(),
            {
@@ -249,7 +433,7 @@ class ChatRoute(Route):
                "Connection": "keep-alive",
            },
        )
-        response.timeout = None  # fix SSE auto disconnect issue
+        response.timeout = None  # fix SSE auto disconnect issue  # pyright: ignore[reportAttributeAccessIssue]
        return response

    async def delete_webchat_session(self):
@@ -271,6 +455,17 @@ class ChatRoute(Route):
        unified_msg_origin = f"{session.platform_id}:{message_type}:{session.platform_id}!{username}!{session_id}"
        await self.conv_mgr.delete_conversations_by_user_id(unified_msg_origin)

+        # 获取消息历史中的所有附件 ID 并删除附件
+        history_list = await self.platform_history_mgr.get(
+            platform_id=session.platform_id,
+            user_id=session_id,
+            page=1,
+            page_size=100000,  # 获取足够多的记录
+        )
+        attachment_ids = self._extract_attachment_ids(history_list)
+        if attachment_ids:
+            await self._delete_attachments(attachment_ids)
+
        # 删除消息历史
        await self.platform_history_mgr.delete(
            platform_id=session.platform_id,
@@ -297,6 +492,41 @@ class ChatRoute(Route):

        return Response().ok().__dict__

+    def _extract_attachment_ids(self, history_list) -> list[str]:
+        """从消息历史中提取所有 attachment_id"""
+        attachment_ids = []
+        for history in history_list:
+            content = history.content
+            if not content or "message" not in content:
+                continue
+            message_parts = content.get("message", [])
+            for part in message_parts:
+                if isinstance(part, dict) and "attachment_id" in part:
+                    attachment_ids.append(part["attachment_id"])
+        return attachment_ids
+
+    async def _delete_attachments(self, attachment_ids: list[str]):
+        """删除附件（包括数据库记录和磁盘文件）"""
+        try:
+            attachments = await self.db.get_attachments(attachment_ids)
+            for attachment in attachments:
+                if not os.path.exists(attachment.path):
+                    continue
+                try:
+                    os.remove(attachment.path)
+                except OSError as e:
+                    logger.warning(
+                        f"Failed to delete attachment file {attachment.path}: {e}"
+                    )
+        except Exception as e:
+            logger.warning(f"Failed to get attachments: {e}")
+
+        # 批量删除数据库记录
+        try:
+            await self.db.delete_attachments(attachment_ids)
+        except Exception as e:
+            logger.warning(f"Failed to delete attachments: {e}")
+
    async def new_session(self):
        """Create a new Platform session (default: webchat)."""
        username = g.get("username", "guest")
@@ -2,6 +2,7 @@ import asyncio
 import inspect
 import os
 import traceback
+import uuid

 from quart import request

@@ -13,16 +14,14 @@ from astrbot.core.config.default import (
    CONFIG_METADATA_3_SYSTEM,
    DEFAULT_CONFIG,
    DEFAULT_VALUE_MAP,
+    WEBHOOK_SUPPORTED_PLATFORMS,
 )
 from astrbot.core.config.i18n_utils import ConfigMetadataI18n
 from astrbot.core.core_lifecycle import AstrBotCoreLifecycle
 from astrbot.core.platform.register import platform_cls_map, platform_registry
 from astrbot.core.provider import Provider
-from astrbot.core.provider.entities import ProviderType
-from astrbot.core.provider.provider import RerankProvider
 from astrbot.core.provider.register import provider_registry
 from astrbot.core.star.star import star_registry
-from astrbot.core.utils.astrbot_path import get_astrbot_path

 from .route import Response, Route, RouteContext

@@ -356,169 +355,20 @@ class ConfigRoute(Route):
            f"Attempting to check provider: {status_info['name']} (ID: {status_info['id']}, Type: {status_info['type']}, Model: {status_info['model']})",
        )

-        if provider_capability_type == ProviderType.CHAT_COMPLETION:
-            try:
-                logger.debug(f"Sending 'Ping' to provider: {status_info['name']}")
-                response = await asyncio.wait_for(
-                    provider.text_chat(prompt="REPLY `PONG` ONLY"),
-                    timeout=45.0,
-                )
-                logger.debug(
-                    f"Received response from {status_info['name']}: {response}",
-                )
-                if response is not None:
-                    status_info["status"] = "available"
-                    response_text_snippet = ""
-                    if (
-                        hasattr(response, "completion_text")
-                        and response.completion_text
-                    ):
-                        response_text_snippet = (
-                            response.completion_text[:70] + "..."
-                            if len(response.completion_text) > 70
-                            else response.completion_text
-                        )
-                    elif hasattr(response, "result_chain") and response.result_chain:
-                        try:
-                            response_text_snippet = (
-                                response.result_chain.get_plain_text()[:70] + "..."
-                                if len(response.result_chain.get_plain_text()) > 70
-                                else response.result_chain.get_plain_text()
-                            )
-                        except Exception as _:
-                            pass
-                    logger.info(
-                        f"Provider {status_info['name']} (ID: {status_info['id']}) is available. Response snippet: '{response_text_snippet}'",
-                    )
-                else:
-                    status_info["error"] = (
-                        "Test call returned None, but expected an LLMResponse object."
-                    )
-                    logger.warning(
-                        f"Provider {status_info['name']} (ID: {status_info['id']}) test call returned None.",
-                    )
-
-            except asyncio.TimeoutError:
-                status_info["error"] = (
-                    "Connection timed out after 45 seconds during test call."
-                )
-                logger.warning(
-                    f"Provider {status_info['name']} (ID: {status_info['id']}) timed out.",
-                )
-            except Exception as e:
-                error_message = str(e)
-                status_info["error"] = error_message
-                logger.warning(
-                    f"Provider {status_info['name']} (ID: {status_info['id']}) is unavailable. Error: {error_message}",
-                )
-                logger.debug(
-                    f"Traceback for {status_info['name']}:\n{traceback.format_exc()}",
-                )
-
-        elif provider_capability_type == ProviderType.EMBEDDING:
-            try:
-                # For embedding, we can call the get_embedding method with a short prompt.
-                embedding_result = await provider.get_embedding("health_check")
-                if isinstance(embedding_result, list) and (
-                    not embedding_result or isinstance(embedding_result[0], float)
-                ):
-                    status_info["status"] = "available"
-                else:
-                    status_info["status"] = "unavailable"
-                    status_info["error"] = (
-                        f"Embedding test failed: unexpected result type {type(embedding_result)}"
-                    )
-            except Exception as e:
-                logger.error(
-                    f"Error testing embedding provider {provider_name}: {e}",
-                    exc_info=True,
-                )
-                status_info["status"] = "unavailable"
-                status_info["error"] = f"Embedding test failed: {e!s}"
-
-        elif provider_capability_type == ProviderType.TEXT_TO_SPEECH:
-            try:
-                # For TTS, we can call the get_audio method with a short prompt.
-                audio_result = await provider.get_audio("你好")
-                if isinstance(audio_result, str) and audio_result:
-                    status_info["status"] = "available"
-                else:
-                    status_info["status"] = "unavailable"
-                    status_info["error"] = (
-                        f"TTS test failed: unexpected result type {type(audio_result)}"
-                    )
-            except Exception as e:
-                logger.error(
-                    f"Error testing TTS provider {provider_name}: {e}",
-                    exc_info=True,
-                )
-                status_info["status"] = "unavailable"
-                status_info["error"] = f"TTS test failed: {e!s}"
-        elif provider_capability_type == ProviderType.SPEECH_TO_TEXT:
-            try:
-                logger.debug(
-                    f"Sending health check audio to provider: {status_info['name']}",
-                )
-                sample_audio_path = os.path.join(
-                    get_astrbot_path(),
-                    "samples",
-                    "stt_health_check.wav",
-                )
-                if not os.path.exists(sample_audio_path):
-                    status_info["status"] = "unavailable"
-                    status_info["error"] = (
-                        "STT test failed: sample audio file not found."
-                    )
-                    logger.warning(
-                        f"STT test for {status_info['name']} failed: sample audio file not found at {sample_audio_path}",
-                    )
-                else:
-                    text_result = await provider.get_text(sample_audio_path)
-                    if isinstance(text_result, str) and text_result:
-                        status_info["status"] = "available"
-                        snippet = (
-                            text_result[:70] + "..."
-                            if len(text_result) > 70
-                            else text_result
-                        )
-                        logger.info(
-                            f"Provider {status_info['name']} (ID: {status_info['id']}) is available. Response snippet: '{snippet}'",
-                        )
-                    else:
-                        status_info["status"] = "unavailable"
-                        status_info["error"] = (
-                            f"STT test failed: unexpected result type {type(text_result)}"
-                        )
-                        logger.warning(
-                            f"STT test for {status_info['name']} failed: unexpected result type {type(text_result)}",
-                        )
-            except Exception as e:
-                logger.error(
-                    f"Error testing STT provider {provider_name}: {e}",
-                    exc_info=True,
-                )
-                status_info["status"] = "unavailable"
-                status_info["error"] = f"STT test failed: {e!s}"
-        elif provider_capability_type == ProviderType.RERANK:
-            try:
-                assert isinstance(provider, RerankProvider)
-                await provider.rerank("Apple", documents=["apple", "banana"])
-                status_info["status"] = "available"
-            except Exception as e:
-                logger.error(
-                    f"Error testing rerank provider {provider_name}: {e}",
-                    exc_info=True,
-                )
-                status_info["status"] = "unavailable"
-                status_info["error"] = f"Rerank test failed: {e!s}"
-
-        else:
-            logger.debug(
-                f"Provider {provider_name} is not a Chat Completion or Embedding provider. Marking as available without test. Meta: {meta}",
-            )
+        try:
+            await provider.test()
            status_info["status"] = "available"
-            status_info["error"] = (
-                "This provider type is not tested and is assumed to be available."
+            logger.info(
+                f"Provider {status_info['name']} (ID: {status_info['id']}) is available.",
+            )
+        except Exception as e:
+            error_message = str(e)
+            status_info["error"] = error_message
+            logger.warning(
+                f"Provider {status_info['name']} (ID: {status_info['id']}) is unavailable. Error: {error_message}",
+            )
+            logger.debug(
+                f"Traceback for {status_info['name']}:\n{traceback.format_exc()}",
            )

        return status_info
@@ -707,6 +557,15 @@ class ConfigRoute(Route):

    async def post_new_platform(self):
        new_platform_config = await request.json
+
+        # 如果是支持统一 webhook 模式的平台，且启用了统一 webhook 模式，自动生成 webhook_uuid
+        platform_type = new_platform_config.get("type", "")
+        if platform_type in WEBHOOK_SUPPORTED_PLATFORMS:
+            if new_platform_config.get("unified_webhook_mode", False):
+                # 如果没有 webhook_uuid 或为空，自动生成
+                if not new_platform_config.get("webhook_uuid"):
+                    new_platform_config["webhook_uuid"] = uuid.uuid4().hex[:16]
+
        self.config["platform"].append(new_platform_config)
        try:
            save_config(self.config, self.config, is_core=True)
@@ -736,6 +595,14 @@ class ConfigRoute(Route):
        if not platform_id or not new_config:
            return Response().error("参数错误").__dict__

+        # 如果是支持统一 webhook 模式的平台，且启用了统一 webhook 模式，确保有 webhook_uuid
+        platform_type = new_config.get("type", "")
+        if platform_type in WEBHOOK_SUPPORTED_PLATFORMS:
+            if new_config.get("unified_webhook_mode", False):
+                # 如果没有 webhook_uuid 或为空，自动生成
+                if not new_config.get("webhook_uuid"):
+                    new_config["webhook_uuid"] = uuid.uuid4().hex
+
        for i, platform in enumerate(self.config["platform"]):
            if platform["id"] == platform_id:
                self.config["platform"][i] = new_config
@@ -60,10 +60,6 @@ class KnowledgeBaseRoute(Route):
            # "/kb/media/delete": ("POST", self.delete_media),
            # 检索
            "/kb/retrieve": ("POST", self.retrieve),
-            # 会话知识库配置
-            "/kb/session/config/get": ("GET", self.get_session_kb_config),
-            "/kb/session/config/set": ("POST", self.set_session_kb_config),
-            "/kb/session/config/delete": ("POST", self.delete_session_kb_config),
        }
        self.register_routes()

@@ -278,7 +274,7 @@ class KnowledgeBaseRoute(Route):
                except Exception as e:
                    return (
                        Response()
-                        .error(f"测试重排序模型失败: {e!s}，请检查控制台日志输出。")
+                        .error(f"测试重排序模型失败: {e!s}，请检查平台日志输出。")
                        .__dict__
                    )

@@ -920,158 +916,6 @@ class KnowledgeBaseRoute(Route):
            logger.error(traceback.format_exc())
            return Response().error(f"检索失败: {e!s}").__dict__

-    # ===== 会话知识库配置 API =====
-
-    async def get_session_kb_config(self):
-        """获取会话的知识库配置
-
-        Query 参数:
-        - session_id: 会话 ID (必填)
-
-        返回:
-        - kb_ids: 知识库 ID 列表
-        - top_k: 返回结果数量
-        - enable_rerank: 是否启用重排序
-        """
-        try:
-            from astrbot.core import sp
-
-            session_id = request.args.get("session_id")
-
-            if not session_id:
-                return Response().error("缺少参数 session_id").__dict__
-
-            # 从 SharedPreferences 获取配置
-            config = await sp.session_get(session_id, "kb_config", default={})
-
-            logger.debug(f"[KB配置] 读取到配置: session_id={session_id}")
-
-            # 如果没有配置，返回默认值
-            if not config:
-                config = {"kb_ids": [], "top_k": 5, "enable_rerank": True}
-
-            return Response().ok(config).__dict__
-
-        except Exception as e:
-            logger.error(f"[KB配置] 获取配置时出错: {e}", exc_info=True)
-            return Response().error(f"获取会话知识库配置失败: {e!s}").__dict__
-
-    async def set_session_kb_config(self):
-        """设置会话的知识库配置
-
-        Body:
-        - scope: 配置范围 (目前只支持 "session")
-        - scope_id: 会话 ID (必填)
-        - kb_ids: 知识库 ID 列表 (必填)
-        - top_k: 返回结果数量 (可选, 默认 5)
-        - enable_rerank: 是否启用重排序 (可选, 默认 true)
-        """
-        try:
-            from astrbot.core import sp
-
-            data = await request.json
-
-            scope = data.get("scope")
-            scope_id = data.get("scope_id")
-            kb_ids = data.get("kb_ids", [])
-            top_k = data.get("top_k", 5)
-            enable_rerank = data.get("enable_rerank", True)
-
-            # 验证参数
-            if scope != "session":
-                return Response().error("目前仅支持 session 范围的配置").__dict__
-
-            if not scope_id:
-                return Response().error("缺少参数 scope_id").__dict__
-
-            if not isinstance(kb_ids, list):
-                return Response().error("kb_ids 必须是列表").__dict__
-
-            # 验证知识库是否存在
-            kb_mgr = self._get_kb_manager()
-            invalid_ids = []
-            valid_ids = []
-            for kb_id in kb_ids:
-                kb_helper = await kb_mgr.get_kb(kb_id)
-                if kb_helper:
-                    valid_ids.append(kb_id)
-                else:
-                    invalid_ids.append(kb_id)
-                    logger.warning(f"[KB配置] 知识库不存在: {kb_id}")
-
-            if invalid_ids:
-                logger.warning(f"[KB配置] 以下知识库ID无效: {invalid_ids}")
-
-            # 允许保存空列表，表示明确不使用任何知识库
-            if kb_ids and not valid_ids:
-                # 只有当用户提供了 kb_ids 但全部无效时才报错
-                return Response().error(f"所有提供的知识库ID都无效: {kb_ids}").__dict__
-
-            # 如果 kb_ids 为空列表，表示用户想清空配置
-            if not kb_ids:
-                valid_ids = []
-
-            # 构建配置对象（只保存有效的ID）
-            config = {
-                "kb_ids": valid_ids,
-                "top_k": top_k,
-                "enable_rerank": enable_rerank,
-            }
-
-            # 保存到 SharedPreferences
-            await sp.session_put(scope_id, "kb_config", config)
-
-            # 立即验证是否保存成功
-            verify_config = await sp.session_get(scope_id, "kb_config", default={})
-
-            if verify_config == config:
-                return (
-                    Response()
-                    .ok(
-                        {"valid_ids": valid_ids, "invalid_ids": invalid_ids},
-                        "保存知识库配置成功",
-                    )
-                    .__dict__
-                )
-            logger.error("[KB配置] 配置保存失败，验证不匹配")
-            return Response().error("配置保存失败").__dict__
-
-        except Exception as e:
-            logger.error(f"[KB配置] 设置配置时出错: {e}", exc_info=True)
-            return Response().error(f"设置会话知识库配置失败: {e!s}").__dict__
-
-    async def delete_session_kb_config(self):
-        """删除会话的知识库配置
-
-        Body:
-        - scope: 配置范围 (目前只支持 "session")
-        - scope_id: 会话 ID (必填)
-        """
-        try:
-            from astrbot.core import sp
-
-            data = await request.json
-
-            scope = data.get("scope")
-            scope_id = data.get("scope_id")
-
-            # 验证参数
-            if scope != "session":
-                return Response().error("目前仅支持 session 范围的配置").__dict__
-
-            if not scope_id:
-                return Response().error("缺少参数 scope_id").__dict__
-
-            # 从 SharedPreferences 删除配置
-            await sp.session_remove(scope_id, "kb_config")
-
-            return Response().ok(message="删除知识库配置成功").__dict__
-
-        except Exception as e:
-            logger.error(f"删除会话知识库配置失败: {e}")
-            logger.error(traceback.format_exc())
-            return Response().error(f"删除会话知识库配置失败: {e!s}").__dict__
-
    async def upload_document_from_url(self):
        """从 URL 上传文档

@@ -0,0 +1,100 @@
+"""统一 Webhook 路由
+
+提供统一的 webhook 回调入口，支持多个平台使用同一端口接收回调。
+"""
+
+from quart import request
+
+from astrbot.core import logger
+from astrbot.core.core_lifecycle import AstrBotCoreLifecycle
+from astrbot.core.platform import Platform
+
+from .route import Response, Route, RouteContext
+
+
+class PlatformRoute(Route):
+    """统一 Webhook 路由"""
+
+    def __init__(
+        self,
+        context: RouteContext,
+        core_lifecycle: AstrBotCoreLifecycle,
+    ) -> None:
+        super().__init__(context)
+        self.core_lifecycle = core_lifecycle
+        self.platform_manager = core_lifecycle.platform_manager
+
+        self._register_webhook_routes()
+
+    def _register_webhook_routes(self):
+        """注册 webhook 路由"""
+        # 统一 webhook 入口，支持 GET 和 POST
+        self.app.add_url_rule(
+            "/api/platform/webhook/<webhook_uuid>",
+            view_func=self.unified_webhook_callback,
+            methods=["GET", "POST"],
+        )
+
+        # 平台统计信息接口
+        self.app.add_url_rule(
+            "/api/platform/stats",
+            view_func=self.get_platform_stats,
+            methods=["GET"],
+        )
+
+    async def unified_webhook_callback(self, webhook_uuid: str):
+        """统一 webhook 回调入口
+
+        Args:
+            webhook_uuid: 平台配置中的 webhook_uuid
+
+        Returns:
+            根据平台适配器返回相应的响应
+        """
+        # 根据 webhook_uuid 查找对应的平台
+        platform_adapter = self._find_platform_by_uuid(webhook_uuid)
+
+        if not platform_adapter:
+            logger.warning(f"未找到 webhook_uuid 为 {webhook_uuid} 的平台")
+            return Response().error("未找到对应平台").__dict__, 404
+
+        # 调用平台适配器的 webhook_callback 方法
+        try:
+            result = await platform_adapter.webhook_callback(request)
+            return result
+        except NotImplementedError:
+            logger.error(
+                f"平台 {platform_adapter.meta().name} 未实现 webhook_callback 方法"
+            )
+            return Response().error("平台未支持统一 Webhook 模式").__dict__, 500
+        except Exception as e:
+            logger.error(f"处理 webhook 回调时发生错误: {e}", exc_info=True)
+            return Response().error("处理回调失败").__dict__, 500
+
+    def _find_platform_by_uuid(self, webhook_uuid: str) -> Platform | None:
+        """根据 webhook_uuid 查找对应的平台适配器
+
+        Args:
+            webhook_uuid: webhook UUID
+
+        Returns:
+            平台适配器实例，未找到则返回 None
+        """
+        for platform in self.platform_manager.platform_insts:
+            if platform.config.get("webhook_uuid") == webhook_uuid:
+                if platform.config.get("unified_webhook_mode", False):
+                    return platform
+        return None
+
+    async def get_platform_stats(self):
+        """获取所有平台的统计信息
+
+        Returns:
+            包含平台统计信息的响应
+        """
+        try:
+            stats = self.platform_manager.get_all_stats()
+            return Response().ok(stats).__dict__
+        except Exception as e:
+            logger.error(f"获取平台统计信息失败: {e}", exc_info=True)
+            return Response().error(f"获取统计信息失败: {e}").__dict__, 500
@@ -1,3 +1,4 @@
+import asyncio
 import json
 import os
 import ssl
@@ -19,6 +20,10 @@ from astrbot.core.star.star_manager import PluginManager

 from .route import Response, Route, RouteContext

+PLUGIN_UPDATE_CONCURRENCY = (
+    3  # limit concurrent updates to avoid overwhelming plugin sources
+)
+

 class PluginRoute(Route):
    def __init__(
@@ -33,6 +38,7 @@ class PluginRoute(Route):
            "/plugin/install": ("POST", self.install_plugin),
            "/plugin/install-upload": ("POST", self.install_plugin_upload),
            "/plugin/update": ("POST", self.update_plugin),
+            "/plugin/update-all": ("POST", self.update_all_plugins),
            "/plugin/uninstall": ("POST", self.uninstall_plugin),
            "/plugin/market_list": ("GET", self.get_online_plugins),
            "/plugin/off": ("POST", self.off_plugin),
@@ -63,7 +69,7 @@ class PluginRoute(Route):
                .__dict__
            )

-        data = await request.json
+        data = await request.get_json()
        plugin_name = data.get("name", None)
        try:
            success, message = await self.plugin_manager.reload(plugin_name)
@@ -346,7 +352,7 @@ class PluginRoute(Route):
                .__dict__
            )

-        post_data = await request.json
+        post_data = await request.get_json()
        repo_url = post_data["url"]

        proxy: str = post_data.get("proxy", None)
@@ -393,7 +399,7 @@ class PluginRoute(Route):
                .__dict__
            )

-        post_data = await request.json
+        post_data = await request.get_json()
        plugin_name = post_data["name"]
        delete_config = post_data.get("delete_config", False)
        delete_data = post_data.get("delete_data", False)
@@ -418,7 +424,7 @@ class PluginRoute(Route):
                .__dict__
            )

-        post_data = await request.json
+        post_data = await request.get_json()
        plugin_name = post_data["name"]
        proxy: str = post_data.get("proxy", None)
        try:
@@ -432,6 +438,59 @@ class PluginRoute(Route):
            logger.error(f"/api/plugin/update: {traceback.format_exc()}")
            return Response().error(str(e)).__dict__

+    async def update_all_plugins(self):
+        if DEMO_MODE:
+            return (
+                Response()
+                .error("You are not permitted to do this operation in demo mode")
+                .__dict__
+            )
+
+        post_data = await request.get_json()
+        plugin_names: list[str] = post_data.get("names") or []
+        proxy: str = post_data.get("proxy", "")
+
+        if not isinstance(plugin_names, list) or not plugin_names:
+            return Response().error("插件列表不能为空").__dict__
+
+        results = []
+        sem = asyncio.Semaphore(PLUGIN_UPDATE_CONCURRENCY)
+
+        async def _update_one(name: str):
+            async with sem:
+                try:
+                    logger.info(f"批量更新插件 {name}")
+                    await self.plugin_manager.update_plugin(name, proxy)
+                    return {"name": name, "status": "ok", "message": "更新成功"}
+                except Exception as e:
+                    logger.error(
+                        f"/api/plugin/update-all: 更新插件 {name} 失败: {traceback.format_exc()}",
+                    )
+                    return {"name": name, "status": "error", "message": str(e)}
+
+        raw_results = await asyncio.gather(
+            *(_update_one(name) for name in plugin_names),
+            return_exceptions=True,
+        )
+        for name, result in zip(plugin_names, raw_results):
+            if isinstance(result, asyncio.CancelledError):
+                raise result
+            if isinstance(result, BaseException):
+                results.append(
+                    {"name": name, "status": "error", "message": str(result)}
+                )
+            else:
+                results.append(result)
+
+        failed = [r for r in results if r["status"] == "error"]
+        message = (
+            "批量更新完成，全部成功。"
+            if not failed
+            else f"批量更新完成，其中 {len(failed)}/{len(results)} 个插件失败。"
+        )
+
+        return Response().ok({"results": results}, message).__dict__
+
    async def off_plugin(self):
        if DEMO_MODE:
            return (
@@ -440,7 +499,7 @@ class PluginRoute(Route):
                .__dict__
            )

-        post_data = await request.json
+        post_data = await request.get_json()
        plugin_name = post_data["name"]
        try:
            await self.plugin_manager.turn_off_plugin(plugin_name)
@@ -458,7 +517,7 @@ class PluginRoute(Route):
                .__dict__
            )

-        post_data = await request.json
+        post_data = await request.get_json()
        plugin_name = post_data["name"]
        try:
            await self.plugin_manager.turn_on_plugin(plugin_name)
@@ -74,7 +74,10 @@ class SessionManagementRoute(Route):
                umo_id = pref.scope_id
                if umo_id not in umo_rules:
                    umo_rules[umo_id] = {}
-                umo_rules[umo_id][pref.key] = pref.value["val"]
+                if pref.key == "session_plugin_config" and umo_id in pref.value["val"]:
+                    umo_rules[umo_id][pref.key] = pref.value["val"][umo_id]
+                else:
+                    umo_rules[umo_id][pref.key] = pref.value["val"]

        # 搜索过滤
        if search:
@@ -185,6 +188,35 @@ class SessionManagementRoute(Route):
                for p in provider_manager.tts_provider_insts
            ]

+            # 获取可用的插件列表（排除 reserved 的系统插件）
+            plugin_manager = self.core_lifecycle.plugin_manager
+            available_plugins = [
+                {
+                    "name": p.name,
+                    "display_name": p.display_name or p.name,
+                    "desc": p.desc,
+                }
+                for p in plugin_manager.context.get_all_stars()
+                if not p.reserved and p.name
+            ]
+
+            # 获取可用的知识库列表
+            available_kbs = []
+            kb_manager = self.core_lifecycle.kb_manager
+            if kb_manager:
+                try:
+                    kbs = await kb_manager.list_kbs()
+                    available_kbs = [
+                        {
+                            "kb_id": kb.kb_id,
+                            "kb_name": kb.kb_name,
+                            "emoji": kb.emoji,
+                        }
+                        for kb in kbs
+                    ]
+                except Exception as e:
+                    logger.warning(f"获取知识库列表失败: {e!s}")
+
            return (
                Response()
                .ok(
@@ -197,6 +229,8 @@ class SessionManagementRoute(Route):
                        "available_chat_providers": available_chat_providers,
                        "available_stt_providers": available_stt_providers,
                        "available_tts_providers": available_tts_providers,
+                        "available_plugins": available_plugins,
+                        "available_kbs": available_kbs,
                        "available_rule_keys": AVAILABLE_SESSION_RULE_KEYS,
                    }
                )
@@ -229,6 +263,11 @@ class SessionManagementRoute(Route):
            if rule_key not in AVAILABLE_SESSION_RULE_KEYS:
                return Response().error(f"不支持的规则键: {rule_key}").__dict__

+            if rule_key == "session_plugin_config":
+                rule_value = {
+                    umo: rule_value,
+                }
+
            # 使用 shared preferences 更新规则
            await sp.session_put(umo, rule_key, rule_value)

@@ -16,6 +16,7 @@ from astrbot.core.utils.astrbot_path import get_astrbot_data_path
 from astrbot.core.utils.io import get_local_ip_addresses

 from .routes import *
+from .routes.platform import PlatformRoute
 from .routes.route import Response, RouteContext
 from .routes.session_management import SessionManagementRoute
 from .routes.t2i import T2iRoute
@@ -79,6 +80,7 @@ class AstrBotDashboard:
        self.persona_route = PersonaRoute(self.context, db, core_lifecycle)
        self.t2i_route = T2iRoute(self.context, core_lifecycle)
        self.kb_route = KnowledgeBaseRoute(self.context, core_lifecycle)
+        self.platform_route = PlatformRoute(self.context, core_lifecycle)

        self.app.add_url_rule(
            "/api/plug/<path:subpath>",
@@ -102,7 +104,7 @@ class AstrBotDashboard:
    async def auth_middleware(self):
        if not request.path.startswith("/api"):
            return None
-        allowed_endpoints = ["/api/auth/login", "/api/file"]
+        allowed_endpoints = ["/api/auth/login", "/api/file", "/api/platform/webhook"]
        if any(request.path.startswith(prefix) for prefix in allowed_endpoints):
            return None
        # 声明 JWT
@@ -0,0 +1,22 @@
+## What's Changed
+
+### 修复了自定义规则页面无法设置插件和知识库的规则的问题
+
+---
+
+重构：
+- 将 Dify、Coze、阿里云百炼应用等 LLMOps 提供商迁移到 Agent 执行器层，理清和本地 Agent 执行器的边界。详见：[Agent 执行器](https://docs.astrbot.app/use/agent-runner.html)
+- 将「会话管理」功能重构为「自定义规则」功能，理清和多配置文件功能的边界。详见：[自定义规则](https://docs.astrbot.app/use/custom-rules.html)
+
+优化：
+- Dify、阿里云百炼应用支持流式输出
+- 防止分段回复正则表达式解析错误导致消息不发送
+- 群聊上下文感知记录 At 信息
+- 优化模型提供商页面的测试提供商功能
+
+新增：
+- 支持在配置文件页面快速测试对话
+- 为配置文件配置项内容添加国际化支持
+
+修复：
+- 在更新 MCP Server 配置后，MCP 无法正常重启的问题
@@ -0,0 +1,25 @@
+## What's Changed
+
+1. 修复使用非默认配置文件情况下时，第三方 Agent Runner (Dify、Coze、阿里云百炼应用等)无法正常工作的问题
+2. 修复当“聊天模型”未设置，并且模型提供商中仅有 Agent Runner 时，无法正常使用 Agent Runner 的问题
+3. 修复部分情况下报错 `pydantic_core._pydantic_core.ValidationError: 1 validation error for Message content` 的问题
+4. 新增群聊模式下的专用图片转述模型配置 ([#3822](https://github.com/AstrBotDevs/AstrBot/issues/3822))
+
+---
+
+重构：
+- 将 Dify、Coze、阿里云百炼应用等 LLMOps 提供商迁移到 Agent 执行器层，理清和本地 Agent 执行器的边界。详见：[Agent 执行器](https://docs.astrbot.app/use/agent-runner.html)
+- 将「会话管理」功能重构为「自定义规则」功能，理清和多配置文件功能的边界。详见：[自定义规则](https://docs.astrbot.app/use/custom-rules.html)
+
+优化：
+- Dify、阿里云百炼应用支持流式输出
+- 防止分段回复正则表达式解析错误导致消息不发送
+- 群聊上下文感知记录 At 信息
+- 优化模型提供商页面的测试提供商功能
+
+新增：
+- 支持在配置文件页面快速测试对话
+- 为配置文件配置项内容添加国际化支持
+
+修复：
+- 在更新 MCP Server 配置后，MCP 无法正常重启的问题
@@ -0,0 +1,7 @@
+## What's Changed
+
+1. 修复：assistant message 中 tool_call 存在但 content 不存在时，导致验证错误的问题 ([#3862](https://github.com/AstrBotDevs/AstrBot/issues/3862))
+2. 修复：fix: aiocqhttp 适配器 NapCat 文件名获取为空 ([#3853](https://github.com/AstrBotDevs/AstrBot/issues/3853))
+3. 新增：升级所有插件按钮
+4. 新增：/provider 指令支持同时测试提供商可用性
+5. 优化：主动回复的 prompt
@@ -0,0 +1,15 @@
+## What's Changed
+
+**新增：**
+- 对部分需要 Webhook 的适配器（QQ 官方机器人、Slack、企业微信、微信客服、企业微信智能机器人、微信公众号）支持统一的 Webhook 链接模式，避免开多个端口。并支持在 WebUI 机器人卡片中查看和复制 Webhook 链接。详情请看：[统一 Webhook 模式](https://docs.astrbot.app/use/unified-webhook.html)
+- 新增 Kubernetes 部署文档。
+
+**修复：**
+- 修复：Telegram 和 QQ 场景下，使用 Whisper API 报错。
+- 修复：部分情况下 Slack 输出消息段代码的问题。
+- 修复：当启动了流式输出时，QQ 官方机器人适配器无法正常回复消息。
+- 修复：对话数据页的对话详情在暗夜模式下显示异常的问题。
+
+**优化：**
+- 重构：WebChat 的消息数据结构，支持引用回复、文件发送、时间显示等功能，优化思考内容显示的部分 Bug。
+- 优化：机器人页面支持显示报错信息，方便排查问题。
@@ -9,10 +9,9 @@ services:
    restart: always
    ports: # mappings description: https://github.com/AstrBotDevs/AstrBot/issues/497
      - "6185:6185" # 必选，AstrBot WebUI 端口
-      - "6195:6195" # 可选, 企业微信 Webhook 端口
      - "6199:6199" # 可选, QQ 个人号 WebSocket 端口
-      - "6196:6196" # 可选, QQ 官方接口 Webhook 端口
-      - "11451:11451" # 可选, 微信个人号 Webhook 端口
+      # - "6195:6195" # 可选, 企业微信 Webhook 端口
+      # - "6196:6196" # 可选, QQ 官方接口 Webhook 端口
    environment:
      - TZ=Asia/Shanghai
    volumes:
@@ -71,6 +71,7 @@

                    <MessageList v-if="messages && messages.length > 0" :messages="messages" :isDark="isDark"
                        :isStreaming="isStreaming || isConvRunning" @openImagePreview="openImagePreview"
+                        @replyMessage="handleReplyMessage"
                        ref="messageList" />
                    <div class="welcome-container fade-in" v-else>
                        <div class="welcome-title">
@@ -84,19 +85,23 @@
                        v-model:prompt="prompt"
                        :stagedImagesUrl="stagedImagesUrl"
                        :stagedAudioUrl="stagedAudioUrl"
+                        :stagedFiles="stagedNonImageFiles"
                        :disabled="isStreaming"
                        :enableStreaming="enableStreaming"
                        :isRecording="isRecording"
                        :session-id="currSessionId || null"
                        :current-session="getCurrentSession"
+                        :replyTo="replyTo"
                        @send="handleSendMessage"
                        @toggleStreaming="toggleStreaming"
                        @removeImage="removeImage"
                        @removeAudio="removeAudio"
+                        @removeFile="removeFile"
                        @startRecording="handleStartRecording"
                        @stopRecording="handleStopRecording"
                        @pasteImage="handlePaste"
                        @fileSelect="handleFileSelect"
+                        @clearReply="clearReply"
                        ref="chatInputRef"
                    />
                </div>
@@ -189,14 +194,17 @@ const {
 } = useSessions(props.chatboxMode);

 const {
-    stagedImagesName,
    stagedImagesUrl,
    stagedAudioUrl,
+    stagedFiles,
+    stagedNonImageFiles,
    getMediaFile,
    processAndUploadImage,
+    processAndUploadFile,
    handlePaste,
    removeImage,
    removeAudio,
+    removeFile,
    clearStaged,
    cleanupMediaCache
 } = useMediaHandling();
@@ -220,6 +228,13 @@ const chatInputRef = ref<InstanceType<typeof ChatInput> | null>(null);
 // 输入状态
 const prompt = ref('');

+// 引用消息状态
+interface ReplyInfo {
+    messageId: number;  // PlatformSessionHistoryMessage 的 id
+    messageContent: string;  // 用于显示的消息内容
+}
+const replyTo = ref<ReplyInfo | null>(null);
+
 const isDark = computed(() => useCustomizerStore().uiTheme === 'PurpleThemeDark');

 // 检测是否为手机端
@@ -250,6 +265,41 @@ function openImagePreview(imageUrl: string) {
    imagePreviewDialog.value = true;
 }

+function handleReplyMessage(msg: any, index: number) {
+    // 从消息中获取 id (PlatformSessionHistoryMessage 的 id)
+    const messageId = msg.id;
+    if (!messageId) {
+        console.warn('Message does not have an id');
+        return;
+    }
+    
+    // 获取消息内容用于显示
+    let messageContent = '';
+    if (typeof msg.content.message === 'string') {
+        messageContent = msg.content.message;
+    } else if (Array.isArray(msg.content.message)) {
+        // 从消息段数组中提取纯文本
+        const textParts = msg.content.message
+            .filter((part: any) => part.type === 'plain' && part.text)
+            .map((part: any) => part.text);
+        messageContent = textParts.join('');
+    }
+    
+    // 截断过长的内容
+    if (messageContent.length > 100) {
+        messageContent = messageContent.substring(0, 100) + '...';
+    }
+    
+    replyTo.value = {
+        messageId,
+        messageContent: messageContent || '[媒体内容]'
+    };
+}
+
+function clearReply() {
+    replyTo.value = null;
+}
+
 async function handleSelectConversation(sessionIds: string[]) {
    if (!sessionIds[0]) return;

@@ -265,6 +315,9 @@ async function handleSelectConversation(sessionIds: string[]) {
        closeMobileSidebar();
    }

+    // 清除引用状态
+    clearReply();
+
    currSessionId.value = sessionIds[0];
    selectedSessions.value = [sessionIds[0]];
    
@@ -278,6 +331,7 @@ async function handleSelectConversation(sessionIds: string[]) {
 function handleNewChat() {
    newChat(closeMobileSidebar);
    messages.value = [];
+    clearReply();
 }

 async function handleDeleteConversation(sessionId: string) {
@@ -295,13 +349,19 @@ async function handleStopRecording() {
 }

 async function handleFileSelect(files: FileList) {
+    const imageTypes = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
    for (const file of files) {
-        await processAndUploadImage(file);
+        if (imageTypes.includes(file.type)) {
+            await processAndUploadImage(file);
+        } else {
+            await processAndUploadFile(file);
+        }
    }
 }

 async function handleSendMessage() {
-    if (!prompt.value.trim() && stagedImagesName.value.length === 0 && !stagedAudioUrl.value) {
+    // 只有引用不能发送，必须有输入内容
+    if (!prompt.value.trim() && stagedFiles.value.length === 0 && !stagedAudioUrl.value) {
        return;
    }

@@ -310,12 +370,19 @@ async function handleSendMessage() {
    }

    const promptToSend = prompt.value.trim();
-    const imageNamesToSend = [...stagedImagesName.value];
    const audioNameToSend = stagedAudioUrl.value;
+    const filesToSend = stagedFiles.value.map(f => ({
+        attachment_id: f.attachment_id,
+        url: f.url,
+        original_name: f.original_name,
+        type: f.type
+    }));
+    const replyToSend = replyTo.value ? { ...replyTo.value } : null;

-    // 清空输入和附件
+    // 清空输入和附件和引用
    prompt.value = '';
    clearStaged();
+    clearReply();

    // 获取选择的提供商和模型
    const selection = chatInputRef.value?.getCurrentSelection();
@@ -324,10 +391,11 @@ async function handleSendMessage() {

    await sendMsg(
        promptToSend,
-        imageNamesToSend,
+        filesToSend,
        audioNameToSend,
        selectedProviderId,
-        selectedModelName
+        selectedModelName,
+        replyToSend
    );
 }

@@ -2,6 +2,14 @@
    <div class="input-area fade-in">
        <div class="input-container"
            style="width: 85%; max-width: 900px; margin: 0 auto; border: 1px solid #e0e0e0; border-radius: 24px;">
+            <!-- 引用预览区 -->
+            <div class="reply-preview" v-if="props.replyTo">
+                <div class="reply-content">
+                    <v-icon size="small" class="reply-icon">mdi-reply</v-icon>
+                    "<span class="reply-text">{{ props.replyTo.messageContent }}</span>"
+                </div>
+                <v-btn @click="$emit('clearReply')" class="remove-reply-btn" icon="mdi-close" size="x-small" color="grey" variant="text" />
+            </div>
            <textarea 
                ref="inputField"
                v-model="localPrompt" 
@@ -30,7 +38,7 @@
                    </v-tooltip>
                </div>
                <div style="display: flex; justify-content: flex-end; margin-top: 8px; align-items: center;">
-                    <input type="file" ref="imageInputRef" @change="handleFileSelect" accept="image/*"
+                    <input type="file" ref="imageInputRef" @change="handleFileSelect"
                        style="display: none" multiple />
                    <v-progress-circular v-if="disabled" indeterminate size="16" class="mr-1" width="1.5" />
                    <v-btn @click="triggerImageInput" icon="mdi-plus" variant="text" color="deep-purple"
@@ -45,8 +53,8 @@
        </div>

        <!-- 附件预览区 -->
-        <div class="attachments-preview" v-if="stagedImagesUrl.length > 0 || stagedAudioUrl">
-            <div v-for="(img, index) in stagedImagesUrl" :key="index" class="image-preview">
+        <div class="attachments-preview" v-if="stagedImagesUrl.length > 0 || stagedAudioUrl || (stagedFiles && stagedFiles.length > 0)">
+            <div v-for="(img, index) in stagedImagesUrl" :key="'img-' + index" class="image-preview">
                <img :src="img" class="preview-image" />
                <v-btn @click="$emit('removeImage', index)" class="remove-attachment-btn" icon="mdi-close"
                    size="small" color="error" variant="text" />
@@ -60,6 +68,15 @@
                <v-btn @click="$emit('removeAudio')" class="remove-attachment-btn" icon="mdi-close" size="small"
                    color="error" variant="text" />
            </div>
+
+            <div v-for="(file, index) in stagedFiles" :key="'file-' + index" class="file-preview">
+                <v-chip color="blue-grey-lighten-4" class="file-chip">
+                    <v-icon start icon="mdi-file-document-outline" size="small"></v-icon>
+                    <span class="file-name-preview">{{ file.original_name }}</span>
+                </v-chip>
+                <v-btn @click="$emit('removeFile', index)" class="remove-attachment-btn" icon="mdi-close" size="small"
+                    color="error" variant="text" />
+            </div>
        </div>
    </div>
 </template>
@@ -71,22 +88,39 @@ import ProviderModelSelector from './ProviderModelSelector.vue';
 import ConfigSelector from './ConfigSelector.vue';
 import type { Session } from '@/composables/useSessions';

+interface StagedFileInfo {
+    attachment_id: string;
+    filename: string;
+    original_name: string;
+    url: string;
+    type: string;
+}
+
+interface ReplyInfo {
+    messageId: number;
+    messageContent: string;
+}
+
 interface Props {
    prompt: string;
    stagedImagesUrl: string[];
    stagedAudioUrl: string;
+    stagedFiles?: StagedFileInfo[];
    disabled: boolean;
    enableStreaming: boolean;
    isRecording: boolean;
    sessionId?: string | null;
    currentSession?: Session | null;
    configId?: string | null;
+    replyTo?: ReplyInfo | null;
 }

 const props = withDefaults(defineProps<Props>(), {
    sessionId: null,
    currentSession: null,
-    configId: null
+    configId: null,
+    stagedFiles: () => [],
+    replyTo: null
 });

 const emit = defineEmits<{
@@ -95,10 +129,12 @@ const emit = defineEmits<{
    toggleStreaming: [];
    removeImage: [index: number];
    removeAudio: [];
+    removeFile: [index: number];
    startRecording: [];
    stopRecording: [];
    pasteImage: [event: ClipboardEvent];
    fileSelect: [files: FileList];
+    clearReply: [];
 }>();

 const { tm } = useModuleI18n('features/chat');
@@ -117,7 +153,7 @@ const sessionPlatformId = computed(() => props.currentSession?.platform_id || 'w
 const sessionIsGroup = computed(() => Boolean(props.currentSession?.is_group));

 const canSend = computed(() => {
-    return (props.prompt && props.prompt.trim()) || props.stagedImagesUrl.length > 0 || props.stagedAudioUrl;
+    return (props.prompt && props.prompt.trim()) || props.stagedImagesUrl.length > 0 || props.stagedAudioUrl || (props.stagedFiles && props.stagedFiles.length > 0);
 });

 // Ctrl+B 长按录音相关
@@ -229,6 +265,46 @@ defineExpose({
    flex-shrink: 0;
 }

+.reply-preview {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 8px 16px;
+    margin: 8px 8px 0 8px;
+    background-color: rgba(103, 58, 183, 0.06);
+    border-radius: 12px;
+    gap: 8px;
+}
+
+.reply-content {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    flex: 1;
+    min-width: 0;
+    overflow: hidden;
+}
+
+.reply-icon {
+    color: var(--v-theme-secondary);
+    flex-shrink: 0;
+}
+
+.reply-text {
+    font-size: 13px;
+    color: var(--v-theme-secondaryText);
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    flex: 1;
+    min-width: 0;
+}
+
+.remove-reply-btn {
+    flex-shrink: 0;
+    opacity: 0.6;
+}
+
 .attachments-preview {
    display: flex;
    gap: 8px;
@@ -239,7 +315,8 @@ defineExpose({
 }

 .image-preview,
-.audio-preview {
+.audio-preview,
+.file-preview {
    position: relative;
    display: inline-flex;
 }
@@ -252,11 +329,19 @@ defineExpose({
    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
 }

-.audio-chip {
+.audio-chip,
+.file-chip {
    height: 36px;
    border-radius: 18px;
 }

+.file-name-preview {
+    max-width: 120px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
 .remove-attachment-btn {
    position: absolute;
    top: -8px;
@@ -7,6 +7,11 @@
                <div v-if="msg.content.type == 'user'" class="user-message">
                    <div class="message-bubble user-bubble" :class="{ 'has-audio': msg.content.audio_url }"
                        :style="{ backgroundColor: isDark ? '#2d2e30' : '#e7ebf4' }">
+                        <!-- 引用消息 -->
+                        <div v-if="msg.content.reply_to" class="reply-quote" @click="scrollToMessage(msg.content.reply_to.message_id)">
+                            <v-icon size="small" class="reply-quote-icon">mdi-reply</v-icon>
+                            <span class="reply-quote-text">{{ getReplyContent(msg.content.reply_to.message_id) }}</span>
+                        </div>
                        <pre
                            style="font-family: inherit; white-space: pre-wrap; word-wrap: break-word;">{{ msg.content.message }}</pre>

@@ -24,6 +29,22 @@
                                {{ t('messages.errors.browser.audioNotSupported') }}
                            </audio>
                        </div>
+
+                        <!-- 文件附件 -->
+                        <div class="file-attachments" v-if="msg.content.file_url && msg.content.file_url.length > 0">
+                            <div v-for="(file, fileIdx) in msg.content.file_url" :key="fileIdx" class="file-attachment">
+                                <a v-if="file.url" :href="file.url" :download="file.filename" class="file-link">
+                                    <v-icon size="small" class="file-icon">mdi-file-document-outline</v-icon>
+                                    <span class="file-name">{{ file.filename }}</span>
+                                </a>
+                                <a v-else @click="downloadFile(file)" class="file-link file-link-download">
+                                    <v-icon size="small" class="file-icon">mdi-file-document-outline</v-icon>
+                                    <span class="file-name">{{ file.filename }}</span>
+                                    <v-icon v-if="downloadingFiles.has(file.attachment_id)" size="small" class="download-icon">mdi-loading mdi-spin</v-icon>
+                                    <v-icon v-else size="small" class="download-icon">mdi-download</v-icon>
+                                </a>
+                            </div>
+                        </div>
                    </div>
                </div>

@@ -77,12 +98,33 @@
                                        {{ t('messages.errors.browser.audioNotSupported') }}
                                    </audio>
                                </div>
+
+                                <!-- Files -->
+                                <div class="embedded-files"
+                                    v-if="msg.content.embedded_files && msg.content.embedded_files.length > 0">
+                                    <div v-for="(file, fileIndex) in msg.content.embedded_files" :key="fileIndex"
+                                        class="embedded-file">
+                                        <a v-if="file.url" :href="file.url" :download="file.filename" class="file-link">
+                                            <v-icon size="small" class="file-icon">mdi-file-document-outline</v-icon>
+                                            <span class="file-name">{{ file.filename }}</span>
+                                        </a>
+                                        <a v-else @click="downloadFile(file)" class="file-link file-link-download">
+                                            <v-icon size="small" class="file-icon">mdi-file-document-outline</v-icon>
+                                            <span class="file-name">{{ file.filename }}</span>
+                                            <v-icon v-if="downloadingFiles.has(file.attachment_id)" size="small" class="download-icon">mdi-loading mdi-spin</v-icon>
+                                            <v-icon v-else size="small" class="download-icon">mdi-download</v-icon>
+                                        </a>
+                                    </div>
+                                </div>
                            </template>
                        </div>
-                        <div class="message-actions" v-if="!msg.content.isLoading">
-                            <v-btn :icon="getCopyIcon(index)" size="small" variant="text" class="copy-message-btn"
+                        <div class="message-actions" v-if="!msg.content.isLoading || index === messages.length - 1">
+                            <span class="message-time" v-if="msg.created_at">{{ formatMessageTime(msg.created_at) }}</span>
+                            <v-btn :icon="getCopyIcon(index)" size="x-small" variant="text" class="copy-message-btn"
                                :class="{ 'copy-success': isCopySuccess(index) }"
                                @click="copyBotMessage(msg.content.message, index)" :title="t('core.common.copy')" />
+                            <v-btn icon="mdi-reply-outline" size="x-small" variant="text" class="reply-message-btn"
+                                @click="$emit('replyMessage', msg, index)" :title="tm('actions.reply')" />
                        </div>
                    </div>
                </div>
@@ -96,6 +138,7 @@ import { useI18n, useModuleI18n } from '@/i18n/composables';
 import MarkdownIt from 'markdown-it';
 import hljs from 'highlight.js';
 import 'highlight.js/styles/github.css';
+import axios from 'axios';

 const md = new MarkdownIt({
    html: false,
@@ -129,7 +172,7 @@ export default {
            default: false
        }
    },
-    emits: ['openImagePreview'],
+    emits: ['openImagePreview', 'replyMessage'],
    setup() {
        const { t } = useI18n();
        const { tm } = useModuleI18n('features/chat');
@@ -147,6 +190,7 @@ export default {
            scrollThreshold: 1,
            scrollTimer: null,
            expandedReasoning: new Set(), // Track which reasoning blocks are expanded
+            downloadingFiles: new Set(), // Track which files are being downloaded
        };
    },
    mounted() {
@@ -163,6 +207,45 @@ export default {
        }
    },
    methods: {
+        // 获取被引用消息的内容
+        getReplyContent(messageId) {
+            const replyMsg = this.messages.find(m => m.id === messageId);
+            if (!replyMsg) {
+                return this.tm('reply.notFound');
+            }
+            let content = '';
+            if (typeof replyMsg.content.message === 'string') {
+                content = replyMsg.content.message;
+            } else if (Array.isArray(replyMsg.content.message)) {
+                const textParts = replyMsg.content.message
+                    .filter(part => part.type === 'plain' && part.text)
+                    .map(part => part.text);
+                content = textParts.join('');
+            }
+            // 截断过长内容
+            if (content.length > 50) {
+                content = content.substring(0, 50) + '...';
+            }
+            return content || '[媒体内容]';
+        },
+
+        // 滚动到指定消息
+        scrollToMessage(messageId) {
+            const msgIndex = this.messages.findIndex(m => m.id === messageId);
+            if (msgIndex === -1) return;
+            
+            const container = this.$refs.messageContainer;
+            const messageItems = container?.querySelectorAll('.message-item');
+            if (messageItems && messageItems[msgIndex]) {
+                messageItems[msgIndex].scrollIntoView({ behavior: 'smooth', block: 'center' });
+                // 高亮一下
+                messageItems[msgIndex].classList.add('highlight-message');
+                setTimeout(() => {
+                    messageItems[msgIndex].classList.remove('highlight-message');
+                }, 2000);
+            }
+        },
+
        // Toggle reasoning expansion state
        toggleReasoning(messageIndex) {
            if (this.expandedReasoning.has(messageIndex)) {
@@ -179,6 +262,35 @@ export default {
            return this.expandedReasoning.has(messageIndex);
        },

+        // 下载文件
+        async downloadFile(file) {
+            if (!file.attachment_id) return;
+            
+            // 标记为下载中
+            this.downloadingFiles.add(file.attachment_id);
+            this.downloadingFiles = new Set(this.downloadingFiles);
+            
+            try {
+                const response = await axios.get(`/api/chat/get_attachment?attachment_id=${file.attachment_id}`, {
+                    responseType: 'blob'
+                });
+                
+                const url = URL.createObjectURL(response.data);
+                const a = document.createElement('a');
+                a.href = url;
+                a.download = file.filename || 'file';
+                document.body.appendChild(a);
+                a.click();
+                document.body.removeChild(a);
+                setTimeout(() => URL.revokeObjectURL(url), 100);
+            } catch (err) {
+                console.error('Download file failed:', err);
+            } finally {
+                this.downloadingFiles.delete(file.attachment_id);
+                this.downloadingFiles = new Set(this.downloadingFiles);
+            }
+        },
+
        // 复制代码到剪贴板
        copyCodeToClipboard(code) {
            navigator.clipboard.writeText(code).then(() => {
@@ -375,6 +487,37 @@ export default {
                clearTimeout(this.scrollTimer);
                this.scrollTimer = null;
            }
+        },
+
+        // 格式化消息时间，支持别名显示
+        formatMessageTime(dateStr) {
+            if (!dateStr) return '';
+            
+            const date = new Date(dateStr);
+            const now = new Date();
+            
+            // 获取本地时间的日期部分
+            const dateDay = new Date(date.getFullYear(), date.getMonth(), date.getDate());
+            const todayDay = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+            const yesterdayDay = new Date(todayDay);
+            yesterdayDay.setDate(yesterdayDay.getDate() - 1);
+            
+            // 格式化时间 HH:MM
+            const hours = date.getHours().toString().padStart(2, '0');
+            const minutes = date.getMinutes().toString().padStart(2, '0');
+            const timeStr = `${hours}:${minutes}`;
+            
+            // 判断是今天、昨天还是更早
+            if (dateDay.getTime() === todayDay.getTime()) {
+                return `${this.tm('time.today')} ${timeStr}`;
+            } else if (dateDay.getTime() === yesterdayDay.getTime()) {
+                return `${this.tm('time.yesterday')} ${timeStr}`;
+            } else {
+                // 更早的日期显示完整格式
+                const month = (date.getMonth() + 1).toString().padStart(2, '0');
+                const day = date.getDate().toString().padStart(2, '0');
+                return `${month}-${day} ${timeStr}`;
+            }
        }
    }
 }
@@ -413,7 +556,7 @@ export default {
 }

 .message-item {
-    margin-bottom: 24px;
+    margin-bottom: 12px;
    animation: fadeIn 0.3s ease-out;
 }

@@ -441,10 +584,23 @@ export default {

 .message-actions {
    display: flex;
-    gap: 4px;
+    align-items: center;
+    gap: 8px;
    opacity: 0;
    transition: opacity 0.2s ease;
-    margin-left: 8px;
+    margin-left: 16px;
+}
+
+/* 最后一条消息始终显示操作按钮 */
+.message-item:last-child .message-actions {
+    opacity: 1;
+}
+
+.message-time {
+    font-size: 12px;
+    color: var(--v-theme-secondaryText);
+    opacity: 0.7;
+    white-space: nowrap;
 }

 .bot-message:hover .message-actions {
@@ -472,6 +628,62 @@ export default {
    background-color: rgba(76, 175, 80, 0.1);
 }

+.reply-message-btn {
+    opacity: 0.6;
+    transition: all 0.2s ease;
+    color: var(--v-theme-secondary);
+}
+
+.reply-message-btn:hover {
+    opacity: 1;
+    background-color: rgba(103, 58, 183, 0.1);
+}
+
+/* 引用消息显示样式 */
+.reply-quote {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    padding: 6px 10px;
+    margin-bottom: 8px;
+    background-color: rgba(103, 58, 183, 0.08);
+    border-left: 3px solid var(--v-theme-secondary);
+    border-radius: 4px;
+    cursor: pointer;
+    transition: background-color 0.2s ease;
+}
+
+.reply-quote:hover {
+    background-color: rgba(103, 58, 183, 0.15);
+}
+
+.reply-quote-icon {
+    color: var(--v-theme-secondary);
+    flex-shrink: 0;
+}
+
+.reply-quote-text {
+    font-size: 13px;
+    color: var(--v-theme-secondaryText);
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+/* 消息高亮动画 */
+.highlight-message {
+    animation: highlightPulse 2s ease-out;
+}
+
+@keyframes highlightPulse {
+    0% {
+        background-color: rgba(103, 58, 183, 0.3);
+    }
+    100% {
+        background-color: transparent;
+    }
+}
+
 .message-bubble {
    padding: 2px 16px;
    border-radius: 12px;
@@ -549,19 +761,14 @@ export default {
 }

 .bot-embedded-image {
-    max-width: 80%;
+    max-width: 40%;
    width: auto;
    height: auto;
    border-radius: 8px;
-    box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
    cursor: pointer;
    transition: transform 0.2s ease;
 }

-.bot-embedded-image:hover {
-    transform: scale(1.02);
-}
-
 .embedded-audio {
    width: 300px;
    margin-top: 8px;
@@ -572,6 +779,71 @@ export default {
    max-width: 300px;
 }

+/* 文件附件样式 */
+.file-attachments,
+.embedded-files {
+    margin-top: 8px;
+    display: flex;
+    flex-direction: column;
+    gap: 6px;
+}
+
+.file-attachment,
+.embedded-file {
+    display: flex;
+    align-items: center;
+}
+
+.file-link {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    padding: 8px 12px;
+    background-color: rgba(var(--v-theme-primary), 0.08);
+    border: 1px solid rgba(var(--v-theme-primary), 0.2);
+    border-radius: 8px;
+    color: rgb(var(--v-theme-primary));
+    text-decoration: none;
+    font-size: 14px;
+    transition: all 0.2s ease;
+    max-width: 300px;
+}
+
+.file-link-download {
+    cursor: pointer;
+}
+
+.download-icon {
+    margin-left: 4px;
+    opacity: 0.7;
+}
+
+.file-icon {
+    flex-shrink: 0;
+    color: rgb(var(--v-theme-primary));
+}
+
+.file-name {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.v-theme--dark .file-link {
+    background-color: rgba(255, 255, 255, 0.05);
+    border-color: rgba(255, 255, 255, 0.1);
+    color: var(--v-theme-secondary);
+}
+
+.v-theme--dark .file-link:hover {
+    background-color: rgba(255, 255, 255, 0.1);
+    border-color: rgba(255, 255, 255, 0.2);
+}
+
+.v-theme--dark .file-icon {
+    color: var(--v-theme-secondary);
+}
+
 /* 动画类 */
 .fade-in {
    animation: fadeIn 0.3s ease-in-out;
@@ -110,9 +110,9 @@ function getSessions() {
 }

 const {
-    stagedImagesName,
    stagedImagesUrl,
    stagedAudioUrl,
+    stagedFiles,
    getMediaFile,
    processAndUploadImage,
    handlePaste,
@@ -164,7 +164,7 @@ async function handleFileSelect(files: FileList) {
 }

 async function handleSendMessage() {
-    if (!prompt.value.trim() && stagedImagesName.value.length === 0 && !stagedAudioUrl.value) {
+    if (!prompt.value.trim() && stagedFiles.value.length === 0 && !stagedAudioUrl.value) {
        return;
    }

@@ -174,8 +174,13 @@ async function handleSendMessage() {
        }

        const promptToSend = prompt.value.trim();
-        const imageNamesToSend = [...stagedImagesName.value];
        const audioNameToSend = stagedAudioUrl.value;
+        const filesToSend = stagedFiles.value.map(f => ({
+            attachment_id: f.attachment_id,
+            url: f.url,
+            original_name: f.original_name,
+            type: f.type
+        }));

        // 清空输入和附件
        prompt.value = '';
@@ -188,7 +193,7 @@ async function handleSendMessage() {

        await sendMsg(
            promptToSend,
-            imageNamesToSend,
+            filesToSend,
            audioNameToSend,
            selectedProviderId,
            selectedModelName
@@ -1,5 +1,6 @@
 <script setup>
 import { useCommonStore } from '@/stores/common';
+import { storeToRefs } from 'pinia';
 </script>

 <template>
@@ -7,8 +8,8 @@ import { useCommonStore } from '@/stores/common';
    <!-- 添加筛选级别控件 -->
    <div class="filter-controls mb-2" v-if="showLevelBtns">
      <v-chip-group v-model="selectedLevels" column multiple>
-        <v-chip v-for="level in logLevels" :key="level" :color="getLevelColor(level)" filter
-          :text-color="level === 'DEBUG' || level === 'INFO' ? 'black' : 'white'">
+        <v-chip v-for="level in logLevels" :key="level" :color="getLevelColor(level)" filter variant="flat" size="small"
+          :text-color="level === 'DEBUG' || level === 'INFO' ? 'black' : 'white'" class="font-weight-medium">
          {{ level }}
        </v-chip>
      </v-chip-group>
@@ -23,6 +24,8 @@ import { useCommonStore } from '@/stores/common';
 export default {
  name: 'ConsoleDisplayer',
  data() {
+    const commonStore = useCommonStore();
+    const { log_cache } = storeToRefs(commonStore);
    return {
      autoScroll: true,  // 默认开启自动滚动
      logColorAnsiMap: {
@@ -35,7 +38,7 @@ export default {
        '\u001b[32m': 'color: #00FF00;',  // green
        'default': 'color: #FFFFFF;'
      },
-      logCache: useCommonStore().getLogCache(),
+      logCache: log_cache,
      historyNum_: -1,
      logLevels: ['DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'],
      selectedLevels: [0, 1, 2, 3, 4], // 默认选中所有级别
@@ -168,6 +171,7 @@ export default {
  flex-wrap: wrap;
  gap: 8px;
  margin-bottom: 8px;
+  margin-left: 20px;
 }

 .fade-in {
@@ -1,10 +1,17 @@
-import { ref } from 'vue';
+import { ref, computed } from 'vue';
 import axios from 'axios';

+export interface StagedFileInfo {
+    attachment_id: string;
+    filename: string;
+    original_name: string;
+    url: string;  // blob URL for preview
+    type: string;  // image, record, file, video
+}
+
 export function useMediaHandling() {
-    const stagedImagesName = ref<string[]>([]);
-    const stagedImagesUrl = ref<string[]>([]);
    const stagedAudioUrl = ref<string>('');
+    const stagedFiles = ref<StagedFileInfo[]>([]);
    const mediaCache = ref<Record<string, string>>({});

    async function getMediaFile(filename: string): Promise<string> {
@@ -32,20 +39,49 @@ export function useMediaHandling() {
        formData.append('file', file);

        try {
-            const response = await axios.post('/api/chat/post_image', formData, {
+            const response = await axios.post('/api/chat/post_file', formData, {
                headers: {
                    'Content-Type': 'multipart/form-data'
                }
            });

-            const img = response.data.data.filename;
-            stagedImagesName.value.push(img);
-            stagedImagesUrl.value.push(URL.createObjectURL(file));
+            const { attachment_id, filename, type } = response.data.data;
+            stagedFiles.value.push({
+                attachment_id,
+                filename,
+                original_name: file.name,
+                url: URL.createObjectURL(file),
+                type
+            });
        } catch (err) {
            console.error('Error uploading image:', err);
        }
    }

+    async function processAndUploadFile(file: File) {
+        const formData = new FormData();
+        formData.append('file', file);
+
+        try {
+            const response = await axios.post('/api/chat/post_file', formData, {
+                headers: {
+                    'Content-Type': 'multipart/form-data'
+                }
+            });
+
+            const { attachment_id, filename, type } = response.data.data;
+            stagedFiles.value.push({
+                attachment_id,
+                filename,
+                original_name: file.name,
+                url: URL.createObjectURL(file),
+                type
+            });
+        } catch (err) {
+            console.error('Error uploading file:', err);
+        }
+    }
+
    async function handlePaste(event: ClipboardEvent) {
        const items = event.clipboardData?.items;
        if (!items) return;
@@ -61,23 +97,54 @@ export function useMediaHandling() {
    }

    function removeImage(index: number) {
-        const urlToRevoke = stagedImagesUrl.value[index];
-        if (urlToRevoke && urlToRevoke.startsWith('blob:')) {
-            URL.revokeObjectURL(urlToRevoke);
+        // 找到第 index 个图片类型的文件
+        let imageCount = 0;
+        for (let i = 0; i < stagedFiles.value.length; i++) {
+            if (stagedFiles.value[i].type === 'image') {
+                if (imageCount === index) {
+                    const fileToRemove = stagedFiles.value[i];
+                    if (fileToRemove.url.startsWith('blob:')) {
+                        URL.revokeObjectURL(fileToRemove.url);
+                    }
+                    stagedFiles.value.splice(i, 1);
+                    return;
+                }
+                imageCount++;
+            }
        }
-
-        stagedImagesName.value.splice(index, 1);
-        stagedImagesUrl.value.splice(index, 1);
    }

    function removeAudio() {
        stagedAudioUrl.value = '';
    }

+    function removeFile(index: number) {
+        // 找到第 index 个非图片类型的文件
+        let fileCount = 0;
+        for (let i = 0; i < stagedFiles.value.length; i++) {
+            if (stagedFiles.value[i].type !== 'image') {
+                if (fileCount === index) {
+                    const fileToRemove = stagedFiles.value[i];
+                    if (fileToRemove.url.startsWith('blob:')) {
+                        URL.revokeObjectURL(fileToRemove.url);
+                    }
+                    stagedFiles.value.splice(i, 1);
+                    return;
+                }
+                fileCount++;
+            }
+        }
+    }
+
    function clearStaged() {
-        stagedImagesName.value = [];
-        stagedImagesUrl.value = [];
        stagedAudioUrl.value = '';
+        // 清理文件的 blob URLs
+        stagedFiles.value.forEach(file => {
+            if (file.url.startsWith('blob:')) {
+                URL.revokeObjectURL(file.url);
+            }
+        });
+        stagedFiles.value = [];
    }

    function cleanupMediaCache() {
@@ -89,15 +156,28 @@ export function useMediaHandling() {
        mediaCache.value = {};
    }

+    // 计算属性：获取图片的 URL 列表（用于预览）
+    const stagedImagesUrl = computed(() => 
+        stagedFiles.value.filter(f => f.type === 'image').map(f => f.url)
+    );
+
+    // 计算属性：获取非图片文件列表
+    const stagedNonImageFiles = computed(() => 
+        stagedFiles.value.filter(f => f.type !== 'image')
+    );
+
    return {
-        stagedImagesName,
        stagedImagesUrl,
        stagedAudioUrl,
+        stagedFiles,
+        stagedNonImageFiles,
        getMediaFile,
        processAndUploadImage,
+        processAndUploadFile,
        handlePaste,
        removeImage,
        removeAudio,
+        removeFile,
        clearStaged,
        cleanupMediaCache
    };
@@ -2,19 +2,52 @@ import { ref, reactive, type Ref } from 'vue';
 import axios from 'axios';
 import { useToast } from '@/utils/toast';

+// 新格式消息部分的类型定义
+export interface MessagePart {
+    type: 'plain' | 'image' | 'record' | 'file' | 'video' | 'reply';
+    text?: string;           // for plain
+    attachment_id?: string;  // for image, record, file, video
+    filename?: string;       // for file (filename from backend)
+    message_id?: number;     // for reply (PlatformSessionHistoryMessage.id)
+}
+
+// 引用信息
+export interface ReplyInfo {
+    messageId: number;
+    messageContent: string;
+}
+
+// 文件信息结构
+export interface FileInfo {
+    url?: string;           // blob URL (可选，点击时才加载)
+    filename: string;
+    attachment_id?: string; // 用于按需下载
+}
+
+// 引用消息信息
+export interface ReplyTo {
+    message_id: number;
+    message_content?: string;  // 被引用消息的内容（解析后填充）
+}
+
 export interface MessageContent {
    type: string;
-    message: string;
+    message: string | MessagePart[];  // 支持旧格式(string)和新格式(MessagePart[])
    reasoning?: string;
    image_url?: string[];
    audio_url?: string;
+    file_url?: FileInfo[];
    embedded_images?: string[];
    embedded_audio?: string;
+    embedded_files?: FileInfo[];
    isLoading?: boolean;
+    reply_to?: ReplyTo;  // 引用的消息
 }

 export interface Message {
+    id?: number;
    content: MessageContent;
+    created_at?: string;
 }

 export function useMessages(
@@ -29,6 +62,7 @@ export function useMessages(
    const isToastedRunningInfo = ref(false);
    const activeSSECount = ref(0);
    const enableStreaming = ref(true);
+    const attachmentCache = new Map<string, string>();  // attachment_id -> blob URL

    // 从 localStorage 读取流式响应开关状态
    const savedStreamingState = localStorage.getItem('enableStreaming');
@@ -41,6 +75,72 @@ export function useMessages(
        localStorage.setItem('enableStreaming', JSON.stringify(enableStreaming.value));
    }

+    // 获取 attachment 文件并返回 blob URL
+    async function getAttachment(attachmentId: string): Promise<string> {
+        if (attachmentCache.has(attachmentId)) {
+            return attachmentCache.get(attachmentId)!;
+        }
+        try {
+            const response = await axios.get(`/api/chat/get_attachment?attachment_id=${attachmentId}`, {
+                responseType: 'blob'
+            });
+            const blobUrl = URL.createObjectURL(response.data);
+            attachmentCache.set(attachmentId, blobUrl);
+            return blobUrl;
+        } catch (err) {
+            console.error('Failed to get attachment:', attachmentId, err);
+            return '';
+        }
+    }
+
+    // 解析新格式消息为旧格式兼容的结构 (用于显示)
+    async function parseMessageContent(content: any): Promise<void> {
+        const message = content.message;
+
+        // 如果 message 是数组 (新格式)
+        if (Array.isArray(message)) {
+            let textParts: string[] = [];
+            let imageUrls: string[] = [];
+            let audioUrl: string | undefined;
+            let fileInfos: FileInfo[] = [];
+            let replyTo: ReplyTo | undefined;
+
+            for (const part of message as MessagePart[]) {
+                if (part.type === 'plain' && part.text) {
+                    textParts.push(part.text);
+                } else if (part.type === 'image' && part.attachment_id) {
+                    const url = await getAttachment(part.attachment_id);
+                    if (url) imageUrls.push(url);
+                } else if (part.type === 'record' && part.attachment_id) {
+                    audioUrl = await getAttachment(part.attachment_id);
+                } else if (part.type === 'file' && part.attachment_id) {
+                    // file 类型不预加载，保留 attachment_id 以便点击时下载
+                    fileInfos.push({
+                        attachment_id: part.attachment_id,
+                        filename: part.filename || 'file'
+                    });
+                } else if (part.type === 'reply' && part.message_id) {
+                    replyTo = { message_id: part.message_id };
+                }
+                // video 类型可以后续扩展
+            }
+
+            // 转换为旧格式兼容的结构
+            content.message = textParts.join('\n');
+            content.reply_to = replyTo;
+            if (content.type === 'user') {
+                content.image_url = imageUrls.length > 0 ? imageUrls : undefined;
+                content.audio_url = audioUrl;
+                content.file_url = fileInfos.length > 0 ? fileInfos : undefined;
+            } else {
+                content.embedded_images = imageUrls.length > 0 ? imageUrls : undefined;
+                content.embedded_audio = audioUrl;
+                content.embedded_files = fileInfos.length > 0 ? fileInfos : undefined;
+            }
+        }
+        // 如果 message 是字符串 (旧格式)，保持原有处理逻辑
+    }
+
    async function getSessionMessages(sessionId: string, router: any) {
        if (!sessionId) return;

@@ -64,35 +164,45 @@ export function useMessages(
            // 处理历史消息中的媒体文件
            for (let i = 0; i < history.length; i++) {
                let content = history[i].content;
-                
-                if (content.message?.startsWith('[IMAGE]')) {
-                    let img = content.message.replace('[IMAGE]', '');
-                    const imageUrl = await getMediaFile(img);
-                    if (!content.embedded_images) {
-                        content.embedded_images = [];
+
+                // 首先尝试解析新格式消息
+                await parseMessageContent(content);
+
+                // 以下是旧格式的兼容处理 (message 是字符串的情况)
+                if (typeof content.message === 'string') {
+                    if (content.message?.startsWith('[IMAGE]')) {
+                        let img = content.message.replace('[IMAGE]', '');
+                        const imageUrl = await getMediaFile(img);
+                        if (!content.embedded_images) {
+                            content.embedded_images = [];
+                        }
+                        content.embedded_images.push(imageUrl);
+                        content.message = '';
+                    }
+
+                    if (content.message?.startsWith('[RECORD]')) {
+                        let audio = content.message.replace('[RECORD]', '');
+                        const audioUrl = await getMediaFile(audio);
+                        content.embedded_audio = audioUrl;
+                        content.message = '';
                    }
-                    content.embedded_images.push(imageUrl);
-                    content.message = '';
-                }
-
-                if (content.message?.startsWith('[RECORD]')) {
-                    let audio = content.message.replace('[RECORD]', '');
-                    const audioUrl = await getMediaFile(audio);
-                    content.embedded_audio = audioUrl;
-                    content.message = '';
                }

+                // 旧格式中的 image_url 和 audio_url 字段处理
                if (content.image_url && content.image_url.length > 0) {
                    for (let j = 0; j < content.image_url.length; j++) {
-                        content.image_url[j] = await getMediaFile(content.image_url[j]);
+                        // 检查是否已经是 blob URL (新格式解析后的结果)
+                        if (!content.image_url[j].startsWith('blob:')) {
+                            content.image_url[j] = await getMediaFile(content.image_url[j]);
+                        }
                    }
                }

-                if (content.audio_url) {
+                if (content.audio_url && !content.audio_url.startsWith('blob:')) {
                    content.audio_url = await getMediaFile(content.audio_url);
                }
            }
-            
+
            messages.value = history;
        } catch (err) {
            console.error(err);
@@ -101,37 +211,45 @@ export function useMessages(

    async function sendMessage(
        prompt: string,
-        imageNames: string[],
+        stagedFiles: { attachment_id: string; url: string; original_name: string; type: string }[],
        audioName: string,
        selectedProviderId: string,
-        selectedModelName: string
+        selectedModelName: string,
+        replyTo: ReplyInfo | null = null
    ) {
        // Create user message
        const userMessage: MessageContent = {
            type: 'user',
            message: prompt,
            image_url: [],
-            audio_url: undefined
+            audio_url: undefined,
+            file_url: [],
+            reply_to: replyTo ? { message_id: replyTo.messageId } : undefined
        };

-        // Convert image filenames to blob URLs
-        if (imageNames.length > 0) {
-            const imagePromises = imageNames.map(name => {
-                if (!name.startsWith('blob:')) {
-                    return getMediaFile(name);
-                }
-                return Promise.resolve(name);
-            });
-            userMessage.image_url = await Promise.all(imagePromises);
+        // 分离图片和文件
+        const imageFiles = stagedFiles.filter(f => f.type === 'image');
+        const nonImageFiles = stagedFiles.filter(f => f.type !== 'image');
+
+        // 使用 attachment_id 获取图片内容（避免 blob URL 被 revoke 后 404）
+        if (imageFiles.length > 0) {
+            const imageUrls = await Promise.all(
+                imageFiles.map(f => getAttachment(f.attachment_id))
+            );
+            userMessage.image_url = imageUrls.filter(url => url !== '');
        }

-        // Convert audio filename to blob URL
+        // 使用 blob URL 作为音频预览（录音不走 attachment）
        if (audioName) {
-            if (!audioName.startsWith('blob:')) {
-                userMessage.audio_url = await getMediaFile(audioName);
-            } else {
-                userMessage.audio_url = audioName;
-            }
+            userMessage.audio_url = audioName;
+        }
+
+        // 文件不预加载，只显示文件名和 attachment_id
+        if (nonImageFiles.length > 0) {
+            userMessage.file_url = nonImageFiles.map(f => ({
+                filename: f.original_name,
+                attachment_id: f.attachment_id
+            }));
        }

        messages.value.push({ content: userMessage });
@@ -151,6 +269,46 @@ export function useMessages(
                isConvRunning.value = true;
            }

+            // 收集所有 attachment_id
+            const files = stagedFiles.map(f => f.attachment_id);
+
+            // 构建 message 参数
+            // 当 files 或 reply 存在时，message 是 list，否则是 str
+            let messageToSend: string | MessagePart[];
+            if (files.length > 0 || replyTo) {
+                const parts: MessagePart[] = [];
+                
+                // 添加引用消息段
+                if (replyTo) {
+                    parts.push({
+                        type: 'reply',
+                        message_id: replyTo.messageId
+                    });
+                }
+                
+                // 添加纯文本消息段
+                if (prompt) {
+                    parts.push({
+                        type: 'plain',
+                        text: prompt
+                    });
+                }
+                
+                // 添加文件消息段
+                for (const f of stagedFiles) {
+                    const partType = f.type === 'image' ? 'image' : 
+                                     f.type === 'record' ? 'record' : 'file';
+                    parts.push({
+                        type: partType as 'image' | 'record' | 'file',
+                        attachment_id: f.attachment_id
+                    });
+                }
+                
+                messageToSend = parts;
+            } else {
+                messageToSend = prompt;
+            }
+
            const response = await fetch('/api/chat/send', {
                method: 'POST',
                headers: {
@@ -158,10 +316,8 @@ export function useMessages(
                    'Authorization': 'Bearer ' + localStorage.getItem('token')
                },
                body: JSON.stringify({
-                    message: prompt,
+                    message: messageToSend,
                    session_id: currSessionId.value,
-                    image_url: imageNames,
-                    audio_url: audioName ? [audioName] : [],
                    selected_provider: selectedProviderId,
                    selected_model: selectedModelName,
                    enable_streaming: enableStreaming.value
@@ -207,6 +363,11 @@ export function useMessages(
                            continue;
                        }

+                        const lastMsg = messages.value[messages.value.length - 1];
+                        if (lastMsg?.content?.isLoading) {
+                            messages.value.pop();
+                        }
+
                        if (chunk_json.type === 'error') {
                            console.error('Error received:', chunk_json.data);
                            continue;
@@ -230,16 +391,26 @@ export function useMessages(
                                embedded_audio: audioUrl
                            };
                            messages.value.push({ content: bot_resp });
+                        } else if (chunk_json.type === 'file') {
+                            // 格式: [FILE]filename|original_name
+                            let fileData = chunk_json.data.replace('[FILE]', '');
+                            let [filename, originalName] = fileData.includes('|') 
+                                ? fileData.split('|', 2) 
+                                : [fileData, fileData];
+                            const fileUrl = await getMediaFile(filename);
+                            let bot_resp: MessageContent = {
+                                type: 'bot',
+                                message: '',
+                                embedded_files: [{
+                                    url: fileUrl,
+                                    filename: originalName
+                                }]
+                            };
+                            messages.value.push({ content: bot_resp });
                        } else if (chunk_json.type === 'plain') {
                            const chain_type = chunk_json.chain_type || 'normal';
-                            
+
                            if (!in_streaming) {
-                                // 移除加载占位符
-                                const lastMsg = messages.value[messages.value.length - 1];
-                                if (lastMsg?.content?.isLoading) {
-                                    messages.value.pop();
-                                }
-                                
                                message_obj = reactive({
                                    type: 'bot',
                                    message: chain_type === 'reasoning' ? '' : chunk_json.data,
@@ -257,6 +428,13 @@ export function useMessages(
                            }
                        } else if (chunk_json.type === 'update_title') {
                            updateSessionTitle(chunk_json.session_id, chunk_json.data);
+                        } else if (chunk_json.type === 'message_saved') {
+                            // 更新最后一条 bot 消息的 id 和 created_at
+                            const lastBotMsg = messages.value[messages.value.length - 1];
+                            if (lastBotMsg && lastBotMsg.content?.type === 'bot') {
+                                lastBotMsg.id = chunk_json.data.id;
+                                lastBotMsg.created_at = chunk_json.data.created_at;
+                            }
                        }

                        if ((chunk_json.type === 'break' && chunk_json.streaming) || !chunk_json.streaming) {
@@ -298,7 +476,8 @@ export function useMessages(
        enableStreaming,
        getSessionMessages,
        sendMessage,
-        toggleStreaming
+        toggleStreaming,
+        getAttachment
    };
 }

@@ -40,7 +40,8 @@
    "deleteChat": "Delete this conversation",
    "editTitle": "Edit Title",
    "fullscreen": "Fullscreen Mode",
-    "exitFullscreen": "Exit Fullscreen"
+    "exitFullscreen": "Exit Fullscreen",
+    "reply": "Reply"
  },
  "conversation": {
    "newConversation": "New Conversation",
@@ -71,6 +72,14 @@
  "reasoning": {
    "thinking": "Thinking Process"
  },
+  "reply": {
+    "replyTo": "Reply to",
+    "notFound": "Message not found"
+  },
+  "time": {
+    "today": "Today",
+    "yesterday": "Yesterday"
+  },
  "connection": {
    "title": "Connection Status Notice",
    "message": "The system detected that the chat connection needs to be re-established.",
@@ -109,6 +109,22 @@
        }
      }
    },
+    "file_extract": {
+      "description": "File Extract",
+      "provider_settings": {
+        "file_extract": {
+          "enable": {
+            "description": "Enable File Extract"
+          },
+          "provider": {
+            "description": "File Extract Provider"
+          },
+          "moonshotai_api_key": {
+            "description": "Moonshot AI API Key"
+          }
+        }
+      }
+    },
    "others": {
      "description": "Other Settings",
      "provider_settings": {
@@ -159,6 +175,10 @@
        "prompt_prefix": {
          "description": "User Prompt",
          "hint": "You can use {{prompt}} as a placeholder for user input. If no placeholder is provided, it will be added before the user input."
+        },
+        "reachability_check": {
+          "description": "Provider Reachability Check",
+          "hint": "When running the /provider command, test provider connectivity in parallel. This actively pings models and may consume extra tokens."
        }
      },
      "provider_tts_settings": {
@@ -379,7 +399,11 @@
        },
        "image_caption": {
          "description": "Auto-understand Images",
-          "hint": "Requires setting a default image caption model."
+          "hint": "Requires setting a group chat image caption model."
+        },
+        "image_caption_provider_id": {
+          "description": "Group Chat Image Caption Model",
+          "hint": "Used for image understanding in group chat context awareness, configured separately from the default image caption model."
        },
        "active_reply": {
          "enable": {
@@ -449,4 +473,4 @@
      }
    }
  }
-}
+}
@@ -32,7 +32,8 @@
    "actions": "Actions",
    "back": "Back",
    "selectFile": "Select File",
-    "refresh": "Refresh"
+    "refresh": "Refresh",
+    "updateAll": "Update All"
  },
  "status": {
    "enabled": "Enabled",
@@ -141,7 +142,9 @@
    "confirmDelete": "Are you sure you want to delete this extension?",
    "fillUrlOrFile": "Please fill in extension URL or upload extension file",
    "dontFillBoth": "Please don't fill in both extension URL and upload file",
-    "supportedFormats": "Supports .zip extension files"
+    "supportedFormats": "Supports .zip extension files",
+    "updateAllSuccess": "All upgradable extensions have been updated!",
+    "updateAllFailed": "{failed} of {total} extensions failed to update:"
  },
  "upload": {
    "fromFile": "Install from File",
@@ -4,6 +4,14 @@
  "adapters": "Platform Adapters",
  "addAdapter": "Add Adapter",
  "emptyText": "No platform adapters yet, click Add Adapter to create one",
+  "viewWebhook": "View Webhook URL",
+  "webhookCopied": "Webhook URL copied to clipboard",
+  "webhookCopyFailed": "Copy failed, please copy manually",
+  "webhookDialog": {
+    "title": "Webhook Callback URL",
+    "description": "The callback address is as follows, please ensure that the network environment can be accessed. You can also view the callback address information in the logs.",
+    "close": "Close"
+  },
  "details": {
    "adapterType": "Adapter Type",
    "token": "Token",
@@ -50,5 +58,22 @@
    "connected": "Connected",
    "disconnected": "Disconnected",
    "error": "Error"
+  },
+  "runtimeStatus": {
+    "running": "Running",
+    "error": "Error",
+    "pending": "Pending",
+    "stopped": "Stopped",
+    "unknown": "Unknown",
+    "errors": "error(s)"
+  },
+  "errorDialog": {
+    "title": "Error Details",
+    "platformId": "Platform ID",
+    "errorCount": "Error Count",
+    "lastError": "Last Error",
+    "occurredAt": "Occurred At",
+    "traceback": "Traceback",
+    "close": "Close"
  }
 } 
@@ -73,6 +73,17 @@
      "title": "Persona Configuration",
      "selectPersona": "Select Persona",
      "hint": "Persona settings affect the conversation style and behavior of the LLM"
+    },
+    "pluginConfig": {
+      "title": "Plugin Configuration",
+      "disabledPlugins": "Disabled Plugins",
+      "hint": "Select plugins to disable for this session. Unselected plugins will remain enabled."
+    },
+    "kbConfig": {
+      "title": "Knowledge Base Configuration",
+      "selectKbs": "Select Knowledge Bases",
+      "topK": "Top K Results",
+      "enableRerank": "Enable Reranking"
    }
  },
  "deleteConfirm": {
@@ -9,7 +9,7 @@
  "chat": "聊天",
  "conversation": "对话数据",
  "sessionManagement": "自定义规则",
-  "console": "控制台",
+  "console": "平台日志",
  "alkaid": "Alkaid",
  "knowledgeBase": "知识库",
  "about": "关于",
@@ -40,7 +40,8 @@
    "deleteChat": "删除此对话",
    "editTitle": "编辑标题",
    "fullscreen": "全屏模式",
-    "exitFullscreen": "退出全屏"
+    "exitFullscreen": "退出全屏",
+    "reply": "引用回复"
  },
  "conversation": {
    "newConversation": "新的聊天",
@@ -71,6 +72,14 @@
  "reasoning": {
    "thinking": "思考过程"
  },
+  "reply": {
+    "replyTo": "引用",
+    "notFound": "无法定位消息"
+  },
+  "time": {
+    "today": "今天",
+    "yesterday": "昨天"
+  },
  "connection": {
    "title": "连接状态提醒",
    "message": "系统检测到聊天连接需要重新建立。",
@@ -11,7 +11,12 @@
        },
        "agent_runner_type": {
          "description": "执行器",
-          "labels": ["内置 Agent", "Dify", "Coze", "阿里云百炼应用"]
+          "labels": [
+            "内置 Agent",
+            "Dify",
+            "Coze",
+            "阿里云百炼应用"
+          ]
        },
        "coze_agent_runner_provider_id": {
          "description": "Coze Agent 执行器提供商 ID"
@@ -109,6 +114,22 @@
        }
      }
    },
+    "file_extract": {
+      "description": "文档解析能力",
+      "provider_settings": {
+        "file_extract": {
+          "enable": {
+            "description": "启用文档解析能力"
+          },
+          "provider": {
+            "description": "文档解析提供商"
+          },
+          "moonshotai_api_key": {
+            "description": "Moonshot AI API Key"
+          }
+        }
+      }
+    },
    "others": {
      "description": "其他配置",
      "provider_settings": {
@@ -142,7 +163,10 @@
        "unsupported_streaming_strategy": {
          "description": "不支持流式回复的平台",
          "hint": "选择在不支持流式回复的平台上的处理方式。实时分段回复会在系统接收流式响应检测到诸如标点符号等分段点时,立即发送当前已接收的内容",
-          "labels": ["实时分段回复", "关闭流式回复"]
+          "labels": [
+            "实时分段回复",
+            "关闭流式回复"
+          ]
        },
        "max_context_length": {
          "description": "最多携带对话轮数",
@@ -159,6 +183,10 @@
        "prompt_prefix": {
          "description": "用户提示词",
          "hint": "可使用 {{prompt}} 作为用户输入的占位符。如果不输入占位符则代表添加在用户输入的前面。"
+        },
+        "reachability_check": {
+          "description": "提供商可达性检测",
+          "hint": "/provider 命令列出模型时并发检测连通性。开启后会主动调用模型测试连通性,可能产生额外 token 消耗。"
        }
      },
      "provider_tts_settings": {
@@ -379,7 +407,11 @@
        },
        "image_caption": {
          "description": "自动理解图片",
-          "hint": "需要设置默认图片转述模型。"
+          "hint": "需要设置群聊图片转述模型。"
+        },
+        "image_caption_provider_id": {
+          "description": "群聊图片转述模型",
+          "hint": "用于群聊上下文感知的图片理解，与默认图片转述模型分开配置。"
        },
        "active_reply": {
          "enable": {
@@ -449,4 +481,4 @@
      }
    }
  }
-}
+}
@@ -1,5 +1,5 @@
 {
-  "title": "控制台",
+  "title": "平台日志",
  "autoScroll": {
    "enabled": "自动滚动已开启",
    "disabled": "自动滚动已关闭"
@@ -1,5 +1,5 @@
 {
-  "title": "控制台",
+  "title": "平台日志",
  "subtitle": "实时监控和统计数据",
  "lastUpdate": "最后更新",
  "status": {
@@ -32,7 +32,8 @@
    "actions": "操作",
    "back": "返回",
    "selectFile": "选择文件",
-    "refresh": "刷新"
+    "refresh": "刷新",
+    "updateAll": "更新全部插件"
  },
  "status": {
    "enabled": "启用",
@@ -93,7 +94,7 @@
  "dialogs": {
    "error": {
      "title": "错误信息",
-      "checkConsole": "详情请检查控制台"
+      "checkConsole": "详情请检查平台日志"
    },
    "config": {
      "title": "插件配置",
@@ -141,7 +142,9 @@
    "confirmDelete": "确定要删除插件吗？",
    "fillUrlOrFile": "请填写插件链接或上传插件文件",
    "dontFillBoth": "请不要同时填写插件链接和上传文件",
-    "supportedFormats": "支持 .zip 格式的插件文件"
+    "supportedFormats": "支持 .zip 格式的插件文件",
+    "updateAllSuccess": "所有可更新的插件都已更新！",
+    "updateAllFailed": "有 {failed}/{total} 个插件更新失败:"
  },
  "upload": {
    "fromFile": "从文件安装",
@@ -4,6 +4,14 @@
  "adapters": "平台适配器",
  "addAdapter": "创建机器人",
  "emptyText": "暂无平台适配器，点击 创建机器人 添加",
+  "viewWebhook": "查看 Webhook 链接",
+  "webhookCopied": "Webhook URL 已复制到剪贴板",
+  "webhookCopyFailed": "复制失败，请手动复制",
+  "webhookDialog": {
+    "title": "Webhook 回调地址",
+    "description": "回调地址如下，请确保网络环境可以公网访问。也可以在日志中查看回调地址信息。建议填写 配置文件 -> 系统 中的「对外可达的回调接口地址」配置项。",
+    "close": "关闭"
+  },
  "details": {
    "adapterType": "适配器类型",
    "token": "Token",
@@ -50,5 +58,22 @@
    "connected": "已连接",
    "disconnected": "已断开",
    "error": "错误"
+  },
+  "runtimeStatus": {
+    "running": "运行中",
+    "error": "发生错误",
+    "pending": "等待启动",
+    "stopped": "已停止",
+    "unknown": "未知",
+    "errors": "个错误"
+  },
+  "errorDialog": {
+    "title": "错误详情",
+    "platformId": "平台 ID",
+    "errorCount": "错误数量",
+    "lastError": "最近错误",
+    "occurredAt": "发生时间",
+    "traceback": "错误堆栈",
+    "close": "关闭"
  }
 } 
@@ -73,6 +73,17 @@
      "title": "人格配置",
      "selectPersona": "选择人格",
      "hint": "应用人格配置后，将会强制该来源的所有对话使用该人格。"
+    },
+    "pluginConfig": {
+      "title": "插件配置",
+      "disabledPlugins": "禁用的插件",
+      "hint": "选择要在此会话中禁用的插件。未选择的插件将保持启用状态。"
+    },
+    "kbConfig": {
+      "title": "知识库配置",
+      "selectKbs": "选择知识库",
+      "topK": "返回结果数量 (Top K)",
+      "enableRerank": "启用重排序"
    }
  },
  "deleteConfirm": {
@@ -37,13 +37,21 @@
            :config_data="config_data"
          />

-          <v-btn icon="mdi-content-save" size="x-large" style="position: fixed; right: 52px; bottom: 52px;"
-            color="darkprimary" @click="updateConfig">
-          </v-btn>
+          <v-tooltip :text="tm('actions.save')" location="left">
+            <template v-slot:activator="{ props }">
+              <v-btn v-bind="props" icon="mdi-content-save" size="x-large" style="position: fixed; right: 52px; bottom: 52px;"
+                color="darkprimary" @click="updateConfig">
+              </v-btn>
+            </template>
+          </v-tooltip>

-          <v-btn icon="mdi-code-json" size="x-large" style="position: fixed; right: 52px; bottom: 124px;" color="primary"
-            @click="configToString(); codeEditorDialog = true">
-          </v-btn>
+          <v-tooltip :text="tm('codeEditor.title')" location="left">
+            <template v-slot:activator="{ props }">
+              <v-btn v-bind="props" icon="mdi-code-json" size="x-large" style="position: fixed; right: 52px; bottom: 124px;" color="primary"
+                @click="configToString(); codeEditorDialog = true">
+              </v-btn>
+            </template>
+          </v-tooltip>

          <v-tooltip text="测试当前配置" location="left" v-if="!isSystemConfig">
            <template v-slot:activator="{ props }">
@@ -13,10 +13,11 @@ const { tm } = useModuleI18n('features/console');
      <h4>{{ tm('title') }}</h4>
      <div class="d-flex align-center">
        <v-switch
-          v-model="autoScrollDisabled"
-          :label="autoScrollDisabled ? tm('autoScroll.disabled') : tm('autoScroll.enabled')"
+          v-model="autoScrollEnabled"
+          :label="autoScrollEnabled ? tm('autoScroll.enabled') : tm('autoScroll.disabled')"
          hide-details
          density="compact"
+          color="primary"
          style="margin-right: 16px;"
        ></v-switch>
        <v-dialog v-model="pipDialog" width="400">
@@ -57,7 +58,7 @@ export default {
  },
  data() {
    return {
-      autoScrollDisabled: false,
+      autoScrollEnabled: true,
      pipDialog: false,
      pipInstallPayload: {
        package: '',
@@ -68,9 +69,9 @@ export default {
    }
  },
  watch: {
-    autoScrollDisabled(val) {
+    autoScrollEnabled(val) {
      if (this.$refs.consoleDisplayer) {
-        this.$refs.consoleDisplayer.autoScroll = !val;
+        this.$refs.consoleDisplayer.autoScroll = val;
      }
    }
  },
@@ -187,7 +187,7 @@
                    </div>

                    <!-- 预览模式 - 聊天界面 -->
-                    <div v-else class="conversation-messages-container">
+                    <div v-else class="conversation-messages-container" style="background-color: var(--v-theme-surface);">
                        <!-- 空对话提示 -->
                        <div v-if="conversationHistory.length === 0" class="text-center py-5">
                            <v-icon size="48" color="grey">mdi-chat-remove</v-icon>
@@ -195,7 +195,7 @@
                        </div>

                        <!-- 消息列表组件 -->
-                        <MessageList v-else :messages="formattedMessages" :isDark="false" />
+                        <MessageList v-else :messages="formattedMessages" :isDark="isDark" />
                    </div>
                </v-card-text>

@@ -320,6 +320,7 @@ import { debounce } from 'lodash';
 import { VueMonacoEditor } from '@guolao/vue-monaco-editor';
 import MarkdownIt from 'markdown-it';
 import { useCommonStore } from '@/stores/common';
+import { useCustomizerStore } from '@/stores/customizer';
 import { useI18n, useModuleI18n } from '@/i18n/composables';
 import MessageList from '@/components/chat/MessageList.vue';

@@ -341,11 +342,13 @@ export default {
    setup() {
        const { t, locale } = useI18n();
        const { tm } = useModuleI18n('features/conversation');
+        const customizerStore = useCustomizerStore();

        return {
            t,
            tm,
-            locale
+            locale,
+            customizerStore
        };
    },

@@ -485,6 +488,12 @@ export default {
            };
        },

+        // 检测是否为暗色模式
+        isDark() {
+            console.log('isDark', this.customizerStore.uiTheme);
+            return this.customizerStore.uiTheme === 'PurpleThemeDark';
+        },
+
        // 将对话历史转换为 MessageList 组件期望的格式
        formattedMessages() {
            return this.conversationHistory.map(msg => {
@@ -987,6 +996,11 @@ export default {
    background-color: #f9f9f9;
 }

+/* 暗色模式下的聊天消息容器 */
+.v-theme--dark .conversation-messages-container {
+    background-color: #1e1e1e;
+}
+
 /* 对话详情卡片 */
 .conversation-detail-card {
    max-height: 90vh;
@@ -42,6 +42,7 @@ const loadingDialog = reactive({
 const showPluginInfoDialog = ref(false);
 const selectedPlugin = ref({});
 const curr_namespace = ref("");
+const updatingAll = ref(false);

 const readmeDialog = reactive({
  show: false,
@@ -137,10 +138,11 @@ const pluginMarketHeaders = computed(() => [

 // 过滤要显示的插件
 const filteredExtensions = computed(() => {
+  const data = Array.isArray(extension_data?.data) ? extension_data.data : [];
  if (!showReserved.value) {
-    return extension_data?.data?.filter(ext => !ext.reserved) || [];
+    return data.filter(ext => !ext.reserved);
  }
-  return extension_data.data || [];
+  return data;
 });

 // 通过搜索过滤插件
@@ -226,6 +228,10 @@ const paginatedPlugins = computed(() => {
  return sortedPlugins.value.slice(start, end);
 });

+const updatableExtensions = computed(() => {
+  return extension_data?.data?.filter(ext => ext.has_update) || [];
+});
+
 // 方法
 const toggleShowReserved = () => {
  showReserved.value = !showReserved.value;
@@ -275,7 +281,8 @@ const checkUpdate = () => {
    onlinePluginsNameMap.set(plugin.name, plugin);
  });

-  extension_data.data.forEach(extension => {
+  const data = Array.isArray(extension_data?.data) ? extension_data.data : [];
+  data.forEach(extension => {
    const repoKey = extension.repo?.toLowerCase();
    const onlinePlugin = repoKey ? onlinePluginsMap.get(repoKey) : null;
    const onlinePluginByName = onlinePluginsNameMap.get(extension.name);
@@ -372,6 +379,56 @@ const updateExtension = async (extension_name) => {
  }
 };

+const updateAllExtensions = async () => {
+  if (updatingAll.value || updatableExtensions.value.length === 0) return;
+  updatingAll.value = true;
+  loadingDialog.title = tm('status.loading');
+  loadingDialog.statusCode = 0;
+  loadingDialog.result = "";
+  loadingDialog.show = true;
+
+  const targets = updatableExtensions.value.map(ext => ext.name);
+  try {
+    const res = await axios.post('/api/plugin/update-all', {
+      names: targets,
+      proxy: localStorage.getItem('selectedGitHubProxy') || ""
+    });
+
+    if (res.data.status === "error") {
+      onLoadingDialogResult(2, res.data.message || tm('messages.updateAllFailed', {
+        failed: targets.length,
+        total: targets.length
+      }), -1);
+      return;
+    }
+
+    const results = res.data.data?.results || [];
+    const failures = results.filter(r => r.status !== 'ok');
+    try {
+      await getExtensions();
+    } catch (err) {
+      const errorMsg = err.response?.data?.message || err.message || String(err);
+      failures.push({ name: 'refresh', status: 'error', message: errorMsg });
+    }
+
+    if (failures.length === 0) {
+      onLoadingDialogResult(1, tm('messages.updateAllSuccess'));
+    } else {
+      const failureText = tm('messages.updateAllFailed', {
+        failed: failures.length,
+        total: targets.length
+      });
+      const detail = failures.map(f => `${f.name}: ${f.message}`).join('\n');
+      onLoadingDialogResult(2, `${failureText}\n${detail}`, -1);
+    }
+  } catch (err) {
+    const errorMsg = err.response?.data?.message || err.message || String(err);
+    onLoadingDialogResult(2, errorMsg, -1);
+  } finally {
+    updatingAll.value = false;
+  }
+};
+
 const pluginOn = async (extension) => {
  try {
    const res = await axios.post('/api/plugin/on', { name: extension.name });
@@ -507,8 +564,9 @@ const trimExtensionName = () => {
 };

 const checkAlreadyInstalled = () => {
-  const installedRepos = new Set(extension_data.data.map(ext => ext.repo?.toLowerCase()));
-  const installedNames = new Set(extension_data.data.map(ext => ext.name));
+  const data = Array.isArray(extension_data?.data) ? extension_data.data : [];
+  const installedRepos = new Set(data.map(ext => ext.repo?.toLowerCase()));
+  const installedNames = new Set(data.map(ext => ext.name));

  for (let i = 0; i < pluginMarketData.value.length; i++) {
    const plugin = pluginMarketData.value[i];
@@ -720,6 +778,12 @@ watch(marketSearch, (newVal) => {
                  {{ showReserved ? tm('buttons.hideSystemPlugins') : tm('buttons.showSystemPlugins') }}
                </v-btn>

+                <v-btn class="ml-2" color="warning" variant="tonal" :disabled="updatableExtensions.length === 0"
+                  :loading="updatingAll" @click="updateAllExtensions">
+                  <v-icon>mdi-update</v-icon>
+                  {{ tm('buttons.updateAll') }}
+                </v-btn>
+
                <v-btn class="ml-2" color="primary" variant="tonal" @click="dialog = true">
                  <v-icon>mdi-plus</v-icon>
                  {{ tm('buttons.install') }}
@@ -29,13 +29,54 @@
            <item-card :item="platform" title-field="id" enabled-field="enable"
              :bglogo="getPlatformIcon(platform.type || platform.id)" @toggle-enabled="platformStatusChange"
              @delete="deletePlatform" @edit="editPlatform">
+              <template #item-details="{ item }">
+                <!-- 平台运行状态 - 只在非运行状态或有错误时显示 -->
+                <div class="platform-status-row mb-2" v-if="getPlatformStat(item.id) && (getPlatformStat(item.id)?.status !== 'running' || getPlatformStat(item.id)?.error_count > 0)">
+                  <!-- 状态 chip - 只在非 running 状态时显示 -->
+                  <v-chip
+                    v-if="getPlatformStat(item.id)?.status !== 'running'"
+                    size="small"
+                    :color="getStatusColor(getPlatformStat(item.id)?.status)"
+                    variant="tonal"
+                    class="status-chip"
+                  >
+                    <v-icon size="small" start>{{ getStatusIcon(getPlatformStat(item.id)?.status) }}</v-icon>
+                    {{ tm('runtimeStatus.' + (getPlatformStat(item.id)?.status || 'unknown')) }}
+                  </v-chip>
+                  <!-- 错误数量提示 -->
+                  <v-chip
+                    v-if="getPlatformStat(item.id)?.error_count > 0"
+                    size="small"
+                    color="error"
+                    variant="tonal"
+                    class="error-chip"
+                    :class="{ 'ms-2': getPlatformStat(item.id)?.status !== 'running' }"
+                    @click.stop="showErrorDetails(item)"
+                  >
+                    <v-icon size="small" start>mdi-bug</v-icon>
+                    {{ getPlatformStat(item.id)?.error_count }} {{ tm('runtimeStatus.errors') }}
+                  </v-chip>
+                </div>
+                <div v-if="item.unified_webhook_mode && item.webhook_uuid" class="webhook-info">
+                  <v-chip
+                    size="small"
+                    color="primary"
+                    variant="tonal"
+                    class="webhook-chip"
+                    @click.stop="openWebhookDialog(item.webhook_uuid)"
+                  >
+                    <v-icon size="small" start>mdi-webhook</v-icon>
+                    {{ tm('viewWebhook') }}
+                  </v-chip>
+                </div>
+              </template>
            </item-card>
          </v-col>
        </v-row>
      </div>

      <!-- 日志部分 -->
-      <v-card elevation="0" class="mt-4">
+      <v-card elevation="0" class="mt-4 mb-10">
        <v-card-title class="d-flex align-center py-3 px-4">
          <v-icon class="me-2">mdi-console-line</v-icon>
          <span class="text-h4">{{ tm('logs.title') }}</span>
@@ -60,6 +101,84 @@
      :updating-mode="updatingMode" :updating-platform-config="updatingPlatformConfig" @update="getConfig"
      @show-toast="showToast" @refresh-config="getConfig"/>

+    <!-- Webhook URL 对话框 -->
+    <v-dialog v-model="showWebhookDialog" max-width="600">
+      <v-card>
+        <v-card-title class="d-flex align-center pa-4">
+          <v-icon class="me-2" color="primary">mdi-webhook</v-icon>
+          {{ tm('webhookDialog.title') }}
+        </v-card-title>
+        <v-card-text class="px-4 pb-2">
+          <p class="text-body-2 text-medium-emphasis mb-3">{{ tm('webhookDialog.description') }}</p>
+          <v-text-field
+            :model-value="currentWebhookUrl"
+            readonly
+            variant="outlined"
+            hide-details
+            class="webhook-url-field"
+          >
+            <template v-slot:append-inner>
+              <v-btn
+                icon
+                size="small"
+                variant="text"
+                @click="copyWebhookUrl(currentWebhookUuid)"
+              >
+                <v-icon>mdi-content-copy</v-icon>
+              </v-btn>
+            </template>
+          </v-text-field>
+        </v-card-text>
+        <v-card-actions class="pa-4 pt-2">
+          <v-spacer></v-spacer>
+          <v-btn variant="tonal" color="primary" @click="showWebhookDialog = false">
+            {{ tm('webhookDialog.close') }}
+          </v-btn>
+        </v-card-actions>
+      </v-card>
+    </v-dialog>
+
+    <!-- 错误详情对话框 -->
+    <v-dialog v-model="showErrorDialog" max-width="700">
+      <v-card>
+        <v-card-title class="d-flex align-center pa-4">
+          <v-icon class="me-2" color="error">mdi-alert-circle</v-icon>
+          {{ tm('errorDialog.title') }}
+        </v-card-title>
+        <v-card-text class="px-4 pb-4" v-if="currentErrorPlatform">
+          <div class="mb-3">
+            <strong>{{ tm('errorDialog.platformId') }}:</strong> {{ currentErrorPlatform.id }}
+          </div>
+          <div class="mb-3">
+            <strong>{{ tm('errorDialog.errorCount') }}:</strong> {{ currentErrorPlatform.error_count }}
+          </div>
+          <div v-if="currentErrorPlatform.last_error" class="error-details">
+            <div class="mb-2">
+              <strong>{{ tm('errorDialog.lastError') }}:</strong>
+            </div>
+            <v-alert type="error" variant="tonal" class="mb-3">
+              <div class="error-message">{{ currentErrorPlatform.last_error.message }}</div>
+              <div class="error-time text-caption text-medium-emphasis mt-1">
+                {{ tm('errorDialog.occurredAt') }}: {{ new Date(currentErrorPlatform.last_error.timestamp).toLocaleString() }}
+              </div>
+            </v-alert>
+            <div v-if="currentErrorPlatform.last_error.traceback">
+              <div class="mb-2">
+                <strong>{{ tm('errorDialog.traceback') }}:</strong>
+              </div>
+              <pre class="traceback-box">{{ currentErrorPlatform.last_error.traceback }}</pre>
+            </div>
+          </div>
+        </v-card-text>
+        <v-card-actions class="pa-4 pt-0">
+          <v-spacer></v-spacer>
+          <v-btn variant="tonal" color="primary" @click="showErrorDialog = false">
+            {{ tm('errorDialog.close') }}
+          </v-btn>
+        </v-card-actions>
+      </v-card>
+    </v-dialog>
+
    <!-- 消息提示 -->
    <v-snackbar :timeout="3000" elevation="24" :color="save_message_success" v-model="save_message_snack"
      location="top">
@@ -97,18 +216,6 @@ export default {
      tm
    };
  },
-  computed: {
-    // 安全访问翻译的计算属性
-    messages() {
-      return {
-        updateSuccess: this.tm('messages.updateSuccess'),
-        addSuccess: this.tm('messages.addSuccess'),
-        deleteSuccess: this.tm('messages.deleteSuccess'),
-        statusUpdateSuccess: this.tm('messages.statusUpdateSuccess'),
-        deleteConfirm: this.tm('messages.deleteConfirm')
-      };
-    }
-  },
  data() {
    return {
      config_data: {},
@@ -125,6 +232,17 @@ export default {

      showConsole: false,

+      showWebhookDialog: false,
+      currentWebhookUuid: '',
+
+      // 平台统计信息
+      platformStats: {},
+      statsRefreshInterval: null,
+
+      // 错误详情对话框
+      showErrorDialog: false,
+      currentErrorPlatform: null,
+
      store: useCommonStore()
    }
  },
@@ -147,6 +265,17 @@ export default {

  mounted() {
    this.getConfig();
+    this.getPlatformStats();
+    // 每 10 秒刷新一次平台状态
+    this.statsRefreshInterval = setInterval(() => {
+      this.getPlatformStats();
+    }, 10000);
+  },
+
+  beforeUnmount() {
+    if (this.statsRefreshInterval) {
+      clearInterval(this.statsRefreshInterval);
+    }
  },

  methods: {
@@ -171,6 +300,53 @@ export default {
      });
    },

+    getPlatformStats() {
+      axios.get('/api/platform/stats').then((res) => {
+        if (res.data.status === 'ok') {
+          // 将数组转换为以 id 为 key 的对象，方便查找
+          const stats = {};
+          for (const platform of res.data.data.platforms || []) {
+            stats[platform.id] = platform;
+          }
+          this.platformStats = stats;
+        }
+      }).catch((err) => {
+        console.warn('获取平台统计信息失败:', err);
+      });
+    },
+
+    getPlatformStat(platformId) {
+      return this.platformStats[platformId] || null;
+    },
+
+    getStatusColor(status) {
+      switch (status) {
+        case 'running': return 'success';
+        case 'error': return 'error';
+        case 'pending': return 'warning';
+        case 'stopped': return 'grey';
+        default: return 'grey';
+      }
+    },
+
+    getStatusIcon(status) {
+      switch (status) {
+        case 'running': return 'mdi-check-circle';
+        case 'error': return 'mdi-alert-circle';
+        case 'pending': return 'mdi-clock-outline';
+        case 'stopped': return 'mdi-stop-circle';
+        default: return 'mdi-help-circle';
+      }
+    },
+
+    showErrorDetails(platform) {
+      const stat = this.getPlatformStat(platform.id);
+      if (stat && stat.error_count > 0) {
+        this.currentErrorPlatform = stat;
+        this.showErrorDialog = true;
+      }
+    },
+
    editPlatform(platform) {
      this.updatingPlatformConfig = JSON.parse(JSON.stringify(platform));
      this.updatingMode = true;
@@ -224,6 +400,47 @@ export default {
      this.save_message = message;
      this.save_message_success = "error";
      this.save_message_snack = true;
+    },
+
+    getWebhookUrl(webhookUuid) {
+      let callbackBase = this.config_data.callback_api_base || '';
+      if (!callbackBase) {
+        callbackBase = "http(s)://<your-domain-or-ip>";
+      }
+      if (callbackBase) {
+        return `${callbackBase.replace(/\/$/, '')}/api/platform/webhook/${webhookUuid}`;
+      }
+      return `/api/platform/webhook/${webhookUuid}`;
+    },
+
+    openWebhookDialog(webhookUuid) {
+      this.currentWebhookUuid = webhookUuid;
+      this.showWebhookDialog = true;
+    },
+
+    async copyWebhookUrl(webhookUuid) {
+      const url = this.getWebhookUrl(webhookUuid);
+      try {
+        await navigator.clipboard.writeText(url);
+        this.showSuccess(this.tm('webhookCopied'));
+      } catch (err) {
+        this.showError(this.tm('webhookCopyFailed'));
+      }
+    }
+  },
+  computed: {
+    // 安全访问翻译的计算属性
+    messages() {
+      return {
+        updateSuccess: this.tm('messages.updateSuccess'),
+        addSuccess: this.tm('messages.addSuccess'),
+        deleteSuccess: this.tm('messages.deleteSuccess'),
+        statusUpdateSuccess: this.tm('messages.statusUpdateSuccess'),
+        deleteConfirm: this.tm('messages.deleteConfirm')
+      };
+    },
+    currentWebhookUrl() {
+      return this.getWebhookUrl(this.currentWebhookUuid);
    }
  }
 }
@@ -233,5 +450,52 @@ export default {
 .platform-page {
  padding: 20px;
  padding-top: 8px;
+  padding-bottom: 40px;
+}
+
+.webhook-info {
+  margin-top: 4px;
+}
+
+.webhook-chip {
+  cursor: pointer;
+}
+
+.platform-status-row {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 4px;
+}
+
+.status-chip {
+  font-size: 12px;
+}
+
+.error-chip {
+  cursor: pointer;
+  font-size: 12px;
+}
+
+.error-details {
+  margin-top: 8px;
+}
+
+.error-message {
+  word-break: break-word;
+}
+
+.traceback-box {
+  background-color: #1e1e1e;
+  color: #d4d4d4;
+  padding: 12px;
+  border-radius: 8px;
+  font-size: 12px;
+  line-height: 1.5;
+  overflow-x: auto;
+  white-space: pre-wrap;
+  word-break: break-word;
+  max-height: 300px;
+  overflow-y: auto;
 }
 </style>
@@ -148,7 +148,7 @@
      </div>

      <!-- 日志部分 -->
-      <v-card elevation="0" class="mt-4">
+      <v-card elevation="0" class="mt-4 mb-10">
        <v-card-title class="d-flex align-center py-3 px-4">
          <v-icon class="me-2">mdi-console-line</v-icon>
          <span class="text-h4">{{ tm('logs.title') }}</span>
@@ -849,6 +849,7 @@ export default {
 .provider-page {
  padding: 20px;
  padding-top: 8px;
+  padding-bottom: 40px;
 }

 .status-card {
@@ -143,11 +143,11 @@
      </v-dialog>

      <!-- 规则编辑对话框 -->
-      <v-dialog v-model="ruleDialog" max-width="700" scrollable>
+      <v-dialog v-model="ruleDialog" max-width="550" scrollable>
        <v-card v-if="selectedUmo" class="d-flex flex-column" height="600">
          <v-card-title class="py-3 px-6 d-flex align-center border-b">
            <span>{{ tm('ruleEditor.title') }}</span>
-            <v-chip size="small" class="ml-4 font-weight-regular" variant="outlined">
+            <v-chip size="x-small" class="ml-2 font-weight-regular" variant="outlined">
              {{ selectedUmo.umo }}
            </v-chip>
            <v-spacer></v-spacer>
@@ -241,6 +241,59 @@
                  {{ tm('buttons.save') }}
                </v-btn>
              </div>
+
+              <!-- Plugin Config Section -->
+              <div class="d-flex align-center mb-4 mt-4">
+                <h3 class="font-weight-bold mb-0">{{ tm('ruleEditor.pluginConfig.title') }}</h3>
+              </div>
+
+              <v-row dense>
+                <v-col cols="12">
+                  <v-select v-model="pluginConfig.disabled_plugins" :items="pluginOptions" item-title="label"
+                    item-value="value" :label="tm('ruleEditor.pluginConfig.disabledPlugins')" variant="outlined"
+                    hide-details multiple chips closable-chips clearable />
+                </v-col>
+                <v-col cols="12">
+                  <v-alert type="info" variant="tonal" class="mt-2" icon="mdi-information-outline">
+                    {{ tm('ruleEditor.pluginConfig.hint') }}
+                  </v-alert>
+                </v-col>
+              </v-row>
+
+              <div class="d-flex justify-end mt-4">
+                <v-btn color="primary" variant="tonal" size="small" @click="savePluginConfig" :loading="saving"
+                  prepend-icon="mdi-content-save">
+                  {{ tm('buttons.save') }}
+                </v-btn>
+              </div>
+
+              <!-- KB Config Section -->
+              <div class="d-flex align-center mb-4 mt-4">
+                <h3 class="font-weight-bold mb-0">{{ tm('ruleEditor.kbConfig.title') }}</h3>
+              </div>
+
+              <v-row dense>
+                <v-col cols="12">
+                  <v-select v-model="kbConfig.kb_ids" :items="kbOptions" item-title="label" item-value="value" :disabled="availableKbs.length === 0"
+                    :label="tm('ruleEditor.kbConfig.selectKbs')" variant="outlined" hide-details multiple chips
+                    closable-chips clearable />
+                </v-col>
+                <v-col cols="12" md="6">
+                  <v-text-field v-model.number="kbConfig.top_k" :label="tm('ruleEditor.kbConfig.topK')"
+                    variant="outlined" hide-details type="number" min="1" max="20" class="mt-3"/>
+                </v-col>
+                <v-col cols="12" md="6">
+                  <v-checkbox v-model="kbConfig.enable_rerank" :label="tm('ruleEditor.kbConfig.enableRerank')"
+                    color="primary" hide-details class="mt-3"/>
+                </v-col>
+              </v-row>
+
+              <div class="d-flex justify-end mt-4">
+                <v-btn color="primary" variant="tonal" size="small" @click="saveKbConfig" :loading="saving"
+                  prepend-icon="mdi-content-save">
+                  {{ tm('buttons.save') }}
+                </v-btn>
+              </div>
            </div>
          </v-card-text>
        </v-card>
@@ -347,6 +400,8 @@ export default {
      availableChatProviders: [],
      availableSttProviders: [],
      availableTtsProviders: [],
+      availablePlugins: [],
+      availableKbs: [],

      // 添加规则
      addRuleDialog: false,
@@ -374,6 +429,19 @@ export default {
        text_to_speech: null,
      },

+      // 插件配置
+      pluginConfig: {
+        enabled_plugins: [],
+        disabled_plugins: [],
+      },
+
+      // 知识库配置
+      kbConfig: {
+        kb_ids: [],
+        top_k: 5,
+        enable_rerank: true,
+      },
+
      // 删除确认
      deleteDialog: false,
      deleteTarget: null,
@@ -447,6 +515,20 @@ export default {
        }))
      ]
    },
+
+    pluginOptions() {
+      return this.availablePlugins.map(p => ({
+        label: p.display_name || p.name,
+        value: p.name
+      }))
+    },
+
+    kbOptions() {
+      return this.availableKbs.map(kb => ({
+        label: `${kb.emoji || '📚'} ${kb.kb_name}`,
+        value: kb.kb_id
+      }))
+    },
  },

  watch: {
@@ -492,6 +574,8 @@ export default {
          this.availableChatProviders = data.available_chat_providers
          this.availableSttProviders = data.available_stt_providers
          this.availableTtsProviders = data.available_tts_providers
+          this.availablePlugins = data.available_plugins || []
+          this.availableKbs = data.available_kbs || []
        } else {
          this.showError(response.data.message || this.tm('messages.loadError'))
        }
@@ -589,6 +673,21 @@ export default {
        text_to_speech: this.editingRules['provider_perf_text_to_speech'] || null,
      }

+      // 初始化插件配置
+      const pluginCfg = this.editingRules.session_plugin_config || {}
+      this.pluginConfig = {
+        enabled_plugins: pluginCfg.enabled_plugins || [],
+        disabled_plugins: pluginCfg.disabled_plugins || [],
+      }
+
+      // 初始化知识库配置
+      const kbCfg = this.editingRules.kb_config || {}
+      this.kbConfig = {
+        kb_ids: kbCfg.kb_ids || [],
+        top_k: kbCfg.top_k ?? 5,
+        enable_rerank: kbCfg.enable_rerank !== false,
+      }
+
      this.ruleDialog = true
    },

@@ -708,6 +807,117 @@ export default {
      this.saving = false
    },

+    async savePluginConfig() {
+      if (!this.selectedUmo) return
+
+      this.saving = true
+      try {
+        const config = {
+          enabled_plugins: this.pluginConfig.enabled_plugins,
+          disabled_plugins: this.pluginConfig.disabled_plugins,
+        }
+
+        // 如果两个列表都为空，删除配置
+        if (config.enabled_plugins.length === 0 && config.disabled_plugins.length === 0) {
+          if (this.editingRules.session_plugin_config) {
+            await axios.post('/api/session/delete-rule', {
+              umo: this.selectedUmo.umo,
+              rule_key: 'session_plugin_config'
+            })
+            delete this.editingRules.session_plugin_config
+            let item = this.rulesList.find(u => u.umo === this.selectedUmo.umo)
+            if (item) delete item.rules.session_plugin_config
+          }
+          this.showSuccess(this.tm('messages.saveSuccess'))
+        } else {
+          const response = await axios.post('/api/session/update-rule', {
+            umo: this.selectedUmo.umo,
+            rule_key: 'session_plugin_config',
+            rule_value: config
+          })
+
+          if (response.data.status === 'ok') {
+            this.showSuccess(this.tm('messages.saveSuccess'))
+            this.editingRules.session_plugin_config = config
+
+            let item = this.rulesList.find(u => u.umo === this.selectedUmo.umo)
+            if (item) {
+              item.rules.session_plugin_config = config
+            } else {
+              this.rulesList.push({
+                umo: this.selectedUmo.umo,
+                platform: this.selectedUmo.platform,
+                message_type: this.selectedUmo.message_type,
+                session_id: this.selectedUmo.session_id,
+                rules: { session_plugin_config: config }
+              })
+            }
+          } else {
+            this.showError(response.data.message || this.tm('messages.saveError'))
+          }
+        }
+      } catch (error) {
+        this.showError(error.response?.data?.message || this.tm('messages.saveError'))
+      }
+      this.saving = false
+    },
+
+    async saveKbConfig() {
+      if (!this.selectedUmo) return
+
+      this.saving = true
+      try {
+        const config = {
+          kb_ids: this.kbConfig.kb_ids,
+          top_k: this.kbConfig.top_k,
+          enable_rerank: this.kbConfig.enable_rerank,
+        }
+
+        // 如果 kb_ids 为空，删除配置
+        if (config.kb_ids.length === 0) {
+          if (this.editingRules.kb_config) {
+            await axios.post('/api/session/delete-rule', {
+              umo: this.selectedUmo.umo,
+              rule_key: 'kb_config'
+            })
+            delete this.editingRules.kb_config
+            let item = this.rulesList.find(u => u.umo === this.selectedUmo.umo)
+            if (item) delete item.rules.kb_config
+          }
+          this.showSuccess(this.tm('messages.saveSuccess'))
+        } else {
+          const response = await axios.post('/api/session/update-rule', {
+            umo: this.selectedUmo.umo,
+            rule_key: 'kb_config',
+            rule_value: config
+          })
+
+          if (response.data.status === 'ok') {
+            this.showSuccess(this.tm('messages.saveSuccess'))
+            this.editingRules.kb_config = config
+
+            let item = this.rulesList.find(u => u.umo === this.selectedUmo.umo)
+            if (item) {
+              item.rules.kb_config = config
+            } else {
+              this.rulesList.push({
+                umo: this.selectedUmo.umo,
+                platform: this.selectedUmo.platform,
+                message_type: this.selectedUmo.message_type,
+                session_id: this.selectedUmo.session_id,
+                rules: { kb_config: config }
+              })
+            }
+          } else {
+            this.showError(response.data.message || this.tm('messages.saveError'))
+          }
+        }
+      } catch (error) {
+        this.showError(error.response?.data?.message || this.tm('messages.saveError'))
+      }
+      this.saving = false
+    },
+
    confirmDeleteRules(item) {
      this.deleteTarget = item
      this.deleteDialog = true
@@ -0,0 +1,4 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: astrbot-standalone-ns
@@ -0,0 +1,14 @@
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: astrbot-data-pvc
+  namespace: astrbot-standalone-ns
+  labels:
+    app: astrbot-standalone
+spec:
+  accessModes:
+    - ReadWriteOnce
+  resources:
+    requests:
+      storage: 10Gi
+  # storageClassName: standard # uncomment and set proper StorageClass
@@ -0,0 +1,49 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: astrbot-standalone
+  namespace: astrbot-standalone-ns
+  labels:
+    app: astrbot-standalone
+spec:
+  replicas: 1
+  strategy:
+    type: Recreate
+  selector:
+    matchLabels:
+      app: astrbot-standalone
+  template:
+    metadata:
+      labels:
+        app: astrbot-standalone
+    spec:
+      containers:
+        - name: astrbot
+          image: soulter/astrbot:latest
+          imagePullPolicy: IfNotPresent
+          env:
+            - name: TZ
+              value: "Asia/Shanghai"
+          ports:
+            - containerPort: 6185
+              name: webui
+            - containerPort: 6199
+              name: qq-ws
+            # - containerPort: 6195
+            #   name: wecom-wh
+            # - containerPort: 6196
+            #   name: qq-off-wh
+          volumeMounts:
+            - name: data
+              mountPath: /AstrBot/data
+            - name: localtime
+              mountPath: /etc/localtime
+              readOnly: true
+      volumes:
+        - name: data
+          persistentVolumeClaim:
+            claimName: astrbot-data-pvc
+        - name: localtime
+          hostPath:
+            path: /etc/localtime
+            type: File
@@ -0,0 +1,28 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: astrbot-standalone-nodeport
+  namespace: astrbot-standalone-ns
+  labels:
+    app: astrbot-standalone
+spec:
+  type: NodePort
+  selector:
+    app: astrbot-standalone
+  ports:
+    - name: webui
+      port: 6185
+      targetPort: 6185
+      nodePort: 30185
+    - name: qq-ws
+      port: 6199
+      targetPort: 6199
+      nodePort: 30199
+    # - name: wecom-wh
+    #   port: 6195
+    #   targetPort: 6195
+    #   nodePort: 30195
+    # - name: qq-off-wh
+    #   port: 6196
+    #   targetPort: 6196
+    #   nodePort: 30196
@@ -0,0 +1,24 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: astrbot-standalone-lb
+  namespace: astrbot-standalone-ns
+  labels:
+    app: astrbot-standalone
+spec:
+  type: LoadBalancer
+  selector:
+    app: astrbot-standalone
+  ports:
+    - name: webui
+      port: 6185
+      targetPort: 6185
+    - name: qq-ws
+      port: 6199
+      targetPort: 6199
+    # - name: wecom-wh
+    #   port: 6195
+    #   targetPort: 6195
+    # - name: qq-off-wh
+    #   port: 6196
+    #   targetPort: 6196
@@ -0,0 +1,4 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: astrbot-ns
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Soulter	e14ed804da	chore: bump version to 4.8.0	2025-12-05 19:09:56 +08:00
Oscar Shaw	8e4e49df20	fix: not invoke on_llm_response hook when LLM request has error (#3871 ) * fix: handle on_agent_done in error responses - Introduced an LLMResponse for error messages to be processed by agent hooks, ensuring better error reporting and handling. * fix: improve error logging in on_agent_done hook --------- Co-authored-by: Soulter <37870767+Soulter@users.noreply.github.com>	2025-12-05 16:13:46 +08:00
Oscar Shaw	5d856900ef	perf: some UI/UX fixes, change `Console` to `Platform Logs` (#3873 ) * refactor: 统一‘平台日志’文案 * perf: 优化自动滚动开关键操作逻辑 * perf: add tooltips to save and code editor buttons	2025-12-05 16:02:20 +08:00
Soulter	380a68b96c	chore: add CONTRIBUTING.md	2025-12-05 15:59:18 +08:00
易推倒白毛	8879bd7e9d	fix: add supports for Whisper with QQ amr audio file * fix: Whisper API对QQ语音amr文件的支持 * Update whisper_api_source.py * fix: cleanup temporary files in Whisper API --------- Co-authored-by: Soulter <905617992@qq.com>	2025-12-05 15:41:37 +08:00
RC-CHN	2cce09400f	feat: add Kubernetes manifests for astrbot and napcat deployment with services and persistent storage (#3901 ) * feat: add Kubernetes manifests for astrbot and napcat deployment with services and persistent storage * chore: remove 11451 port --------- Co-authored-by: Soulter <905617992@qq.com>	2025-12-04 20:36:35 +08:00
Oscar Shaw	54d26dcd38	perf: integrate Pinia store for log cache management (#3852 ) * perf: integrate Pinia store for log cache management * perf: remove unused code	2025-12-04 14:26:05 +08:00
Soulter	205024f27a	fix: correct SQL query syntax in SQLiteDatabase class	2025-12-04 12:51:22 +08:00
Soulter	efde994907	chore: revise badges and language links Updated badge links and language options in README.	2025-12-03 17:21:09 +08:00
Soulter	8ca4f9cb74	feat: update README files for multilingual support and enhanced descriptions - Added French, Russian, and Traditional Chinese README files to support a wider audience. - Updated English and Japanese README files with improved descriptions of AstrBot's capabilities and features. - Enhanced community section in all README files to include QQ, Telegram, and Discord group information. - Adjusted plugin marketplace badge and key features list for clarity and consistency across languages.	2025-12-03 17:01:56 +08:00
Soulter	54e49b997b	feat: enhance platform management with status tracking and error handling - Introduced PlatformStatus enum to manage platform states (pending, running, error, stopped). - Added error recording and retrieval functionality in the Platform class. - Implemented a new method in PlatformManager to gather statistics for all platforms. - Updated the dashboard to display platform statuses and error details, including a dialog for error insights. - Enhanced localization for runtime statuses and error dialogs in both English and Chinese.	2025-12-03 16:48:57 +08:00
Soulter	5714944eef	feat: unified platform webhook url (#3889 ) * feat: unified platform webhook url * chore: ruff format * fix: 修复 Telegram 语音使用 Whisper API 报错 (#3884) * Update whisper_api_source.py * chore: ruff format --------- Co-authored-by: Soulter <905617992@qq.com> * Update astrbot/dashboard/routes/platform.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update astrbot/core/platform/sources/qqofficial_webhook/qo_webhook_adapter.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * chore: ruff format * fix: update webhook dialog descriptions for clarity in English and Chinese locales * fix: update webhook URL paths to include '/api' prefix for consistency across the application --------- Co-authored-by: 易推倒白毛 <zhaixingbi@gmail.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>	2025-12-03 15:44:52 +08:00
Soulter	defc46b6c9	fix: remove unnecessary blocks in Slack reply message (#3897 )	2025-12-03 13:59:41 +08:00
Soulter	4d819546b0	fix: handle message sending in QQOfficialMessageEvent class (#3894 ) - Added a fallback to the `_post_send` method without parameters when the stream payload is not set, ensuring proper message handling in all scenarios. fixes: #3893	2025-12-03 13:15:12 +08:00
易推倒白毛	8006981976	fix: 修复 Telegram 语音使用 Whisper API 报错 (#3884 ) * Update whisper_api_source.py * chore: ruff format --------- Co-authored-by: Soulter <905617992@qq.com>	2025-12-03 02:50:50 +08:00
Soulter	f7a716af43	refactor: message storage format of webchat, support reply and file message segment (#3845 ) * refactor: message storage format of webchat * refactor: update image and record handling in webchat event processing * fix: thinking placeholder in webchat * feat: supports file upload in webchat * feat: supports to delete attachments when webchat session is deleted * perf: improve performance of file downloading * refactor: remove unused import in chat route * feat: add message timestamp formatting and localization support in chat * fix: handle missing filename in file upload for chat route * feat: enhance file handling in chat and webchat, supporting video uploads and improved attachment management * fix: update property name for embedded files in message handling * fix: compute variable errors after uninstalling plugins * feat: supported for reply message and standarlize the message param * fix: ensure message actions are displayed for the last message in the list	2025-12-02 17:11:08 +08:00
Copilot	a708901e7f	fix: fix dark mode white background in conversation preview dialog (#3881 ) * Initial plan * Fix dark mode background issue in conversation data preview Co-authored-by: Soulter <37870767+Soulter@users.noreply.github.com> * style: update conversation messages container background color and add debug log for dark mode detection --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: Soulter <37870767+Soulter@users.noreply.github.com> Co-authored-by: Soulter <905617992@qq.com>	2025-12-02 17:03:59 +08:00
Soulter	e9be8cf69f	chore: bump version to 4.7.4	2025-12-01 18:42:07 +08:00
Soulter	31d53edb9d	refactor: standardize provider test method implementation - Updated the `test` method in all provider classes to remove return values and raise exceptions for failure cases, enhancing clarity and consistency. - Adjusted related logic in the dashboard and command routes to align with the new `test` method behavior, simplifying error handling.	2025-12-01 18:37:08 +08:00
Soulter	2ba0460f19	feat: introduce file extract capability (#3870 ) * feat: introduce file extract capability powered by MoonshotAI * fix: correct indentation in default configuration file * fix: add error handling for file extract application in InternalAgentSubStage * fix: update file name handling in InternalAgentSubStage to correctly associate file names with extracted content * feat: add condition settings for local agent runner in default configuration * fix: enhance file naming logic in File component and update prompt handling in InternalAgentSubStage	2025-12-01 18:12:39 +08:00
雪語	0e034f0fbd	fix: aiocqhttp 适配器 NapCat 文件名获取为空 (#3853 ) * aiocqhttp 适配器 NapCat 文件名获取为空修复使用 NapCat 时，文件消息的 File.name 为空的问题。原代码硬编码 name=""，导致下游插件无法获取文件名和扩展名 * Enhance file name retrieval from message data Updated file name extraction logic to check multiple fields for better accuracy.	2025-12-01 13:36:19 +08:00
Soulter	2a7d03f9e1	fix: fit language and log AI responses more clearly (#3864 ) * fix: fit language and log AI responses more clearly * chore: ruff format	2025-12-01 13:24:52 +08:00
Soulter	72fac4b9f1	feat: implement unified provider availability testing across components (#3865 ) - Added a `test` method to each provider class to standardize availability checks. - Updated the dashboard and command routes to utilize the new `test` method for provider reachability verification, simplifying the logic and improving maintainability. - Removed redundant reachability check logic from the command handler.	2025-12-01 13:17:20 +08:00
Soulter	38281ba2cf	refactor: restore reachability check configuration in default settings and localization files	2025-12-01 00:38:30 +08:00
Soulter	21aa3174f4	fix: disable reachability check in default configuration	2025-12-01 00:16:11 +08:00
邹永赫	dcda871fc0	feat: provider availability reachability improvements (#3708 )	2025-12-01 01:06:10 +09:00
Soulter	c13c51f499	fix: assistant message validation error when tool_call exists but content not exists (#3862 ) * fix: assistant message validation error when tool_call exists but content not exists * fix: enhance content validation in Message model to allow None for assistant role with tool_calls	2025-11-30 23:42:37 +08:00
Dt8333	a130db5cf4	fix: 将 Graceful shutdown 的异常改为 KeyboardInterrupt (#3855 )	2025-11-30 20:31:17 +08:00
邹永赫	7faeb5cea8	Merge pull request #3850 from zouyonghe/feature/plugin-upgrade-all 增加升级所有插件按钮	2025-11-30 15:12:36 +09:00
ZouYonghe	8d3ff61e0d	Format plugin route with ruff	2025-11-30 11:56:24 +08:00
ZouYonghe	4c03e82570	Fix plugin update JSON parsing and concurrency handling	2025-11-30 11:50:46 +08:00
ZouYonghe	e7e8664ab4	chore: tweak update all label	2025-11-30 11:18:30 +08:00
ZouYonghe	1dd1623e7d	feat: batch update plugins via new api	2025-11-30 11:11:36 +08:00
ZouYonghe	80d8161d58	feat: add update all plugins action	2025-11-30 10:40:46 +08:00
Soulter	fc80d7d681	chore: bump version to 4.7.3	2025-11-30 00:42:49 +08:00
Soulter	c2f036b27c	chore: bump vertion to 4.7.2	2025-11-30 00:33:07 +08:00
Soulter	4087bbb512	perf: set content attribute optional to AssistantMessageSegment for enhanced message handling fixes: #3843	2025-11-30 00:32:00 +08:00
Soulter	e1c728582d	chore: bump version to 4.7.2	2025-11-30 00:18:23 +08:00
Oscar Shaw	93c69a639a	feat: 新增群聊模式下的专用图片转述模型配置 (#3822 ) * feat: add image caption provider configuration for group chat - Introduced `image_caption_provider_id` to allow separate configuration for group chat image understanding. - Updated metadata and hints in English and Chinese for clarity on new settings. - Adjusted logic in long term memory to utilize the new provider ID for image captioning. * fix: format * Fix logic for image caption and active reply settings * Fix indentation and formatting in long_term_memory.py * chore: ruff format --------- Co-authored-by: Soulter <37870767+Soulter@users.noreply.github.com> Co-authored-by: Soulter <905617992@qq.com>	2025-11-29 23:53:32 +08:00
Soulter	a7fdc98b29	fix: third party agent runner cannot run properly when using non-default config file fix: #3815	2025-11-29 23:45:12 +08:00
Soulter	85b7f104df	fix: remove unnecessary provider check (#3846 ) fixes: #3815	2025-11-29 23:15:19 +08:00
Oscar Shaw	d76d1bd7fe	perf: adjust padding for PlatformPage and ProviderPage log sections (#3825 ) - Added bottom margin to log card for better spacing.	2025-11-29 19:15:35 +08:00
Soulter	df4412aa80	style: adjust bot-embedded-image max-width and remove hover effect for improved layout	2025-11-29 01:31:25 +08:00
Soulter	ab2c94e19a	chore: comment out error logging in provider sources to reduce verbosity	2025-11-28 19:59:33 +08:00
Oscar Shaw	37cc4e2121	perf: console tag UI improve (#3816 ) - Added yarn.lock to .gitignore to prevent tracking of Yarn lock files. - Updated ConsoleDisplayer.vue to improve chip styling	2025-11-28 17:17:11 +08:00
Soulter	60dfdd0a66	chore: update astrbot cli version	2025-11-28 16:53:20 +08:00
Soulter	bb8b2cb194	chore: bump version to 4.7.1	2025-11-28 15:13:35 +08:00
Soulter	4e29684aa3	fix: add plugin set and knowledge bases selection in custom rules page (#3813 ) fixes: #3806	2025-11-28 13:29:50 +08:00